BasicTemplates

BasicTemplates — легковесный CLI-инструмент для создания новых Python-проектов из готовых шаблонов.

Что делает

• Показывает доступные шаблоны
• Создаёт проект из выбранного шаблона
• Автоматически настраивает виртуальное окружение
• Устанавливает зависимости из requirements.txt
• Сохраняет проект в ~/Documents по умолчанию
• Позволяет выбрать альтернативную папку для проекта

Быстрый старт

Установка

Доступны три варианта установки:

1. Через shell-скрипт (Linux/macOS)
2. Через batch-скрипт (Windows)
3. Через Python-скрипт (install.py)

Linux / macOS

chmod +x install.sh
./install.sh

или

./install.sh --user

Windows

install.bat

или

install.bat --user

Установщик на Python

python install.py
python install.py --user

install.py создаёт виртуальное окружение и ставит пакет в editable режиме, если не указана опция --user.

Запуск

После установки пакет предоставляет команду bt. Если вы не хотите ставить пакет глобально, используйте:

python -m basictemplates <шаблон> <версия Python> <название проекта>

CLI-параметры

bt <template> <python_version> <project_name> [--output DIR]

Дополнительные команды:

bt --template
bt --list-python
bt -save <шаблон> [--author AUTHOR] [--version VERSION]

Описание параметров

• <template> — имя шаблона: Basic, TGBotClassic, TGBotModules
• Алиас TGBot автоматически отображается как TGBotModules
• <python_version> — версия Python или команда Python: 3.8, 3.10, python3.11, py -3.10
• <project_name> — имя создаваемого проекта
• --output DIR — папка, в которую будет создан проект. По умолчанию: ~/Documents
• --template — показать доступные шаблоны и их статус
• --list-python — показать найденные версии Python на системе
• -save / --save — проверить шаблон на наличие обязательных файлов и сохранить метаданные

Примеры

bt Basic 3.10 MyBasicApp
bt TGBotClassic 3.11 MyTGBot
bt TGBotModules 3.11 MyAdvancedBot --output ~/projects
bt TGBot 3.9 MyAdvancedBot

Показать доступные шаблоны:

bt --template

Показать версии Python:

bt --list-python

Проверить шаблон и сохранить метаданные:

bt -save Basic --author "Ivan Ivanov" --version "1.0"

Как это работает

• Шаблоны хранятся в basictemplates/templates/
• Для каждого шаблона проверяются файлы requirements.txt и .gitignore
• Проект копируется из папки project/ внутри шаблона
• В корне проекта создаётся виртуальное окружение venv
• Зависимости устанавливаются через pip install -r requirements.txt
• Метаданные проекта сохраняются в файл .bt-meta.json

Требования

• Python 3.8+
• Рекомендуется использовать Python 3.10+ для максимальной совместимости с типами
• Работает на Linux, macOS и Windows

Установщик

Linux / macOS

chmod +x install.sh
./install.sh
./install.sh --user

Windows

install.bat
install.bat --user

Python-установщик

python install.py
python install.py --user

Версия

1.2.0

Лицензия

MIT