Metadata-Version: 2.4
Name: ponytool
Version: 2.0.1
Summary: CLI toolbox to reduce everyday Python project setup routine
License: MIT
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: rich<15.0,>=13.0
Dynamic: license-file

# PonyTool

PonyTool — это небольшой CLI-инструмент для Python-разработчиков,  
которых **достала ежедневная рутина** при работе с проектами.

Он не пытается быть фреймворком, магией или «умным помощником».  
Он просто убирает повторяющиеся действия, которые раздражают и отнимают время каждый день.

---

## Зачем он нужен

PonyTool появился из очень конкретной боли:

- каждый раз вручную создавать одни и те же папки и файлы
- каждый раз писать `.gitignore` с нуля
- постоянно ловить глюки `pytest` из-за виртуального окружения
- страдать с зависимостями, не понимая, что относится к стандартной библиотеке, а что — нет

Если тебе знакомо хоть что-то из этого — инструмент, скорее всего, будет полезен.

---

## Для кого этот инструмент

PonyTool — для Python-разработчиков,  
**которые устали от рутины и хотят тратить время на код, а не на подготовку проекта**.

Он особенно полезен, если ты:
- часто создаёшь новые проекты
- пишешь небольшие утилиты, библиотеки или pet-проекты
- не хочешь каждый раз вспоминать одни и те же команды и файлы

---

## Чего PonyTool НЕ делает

Это важно понимать заранее:

- PonyTool **не пишет код вместо вас**
- PonyTool **не думает за вас**
- PonyTool **не учит вас Python**
- PonyTool **не навязывает архитектуру**
- PonyTool **не является фреймворком**

Он делает только одно — **упрощает ежедневную рутину**.

---

## Основные команды

### `pony init`

Создаёт структуру проекта.

- использует дефолтную структуру
- либо читает её из `.ponyinit`
- безопасен при повторном запуске

```bash
pony init
```

### `pony bootstrap`

Создаёт базовые файлы проекта:

- .gitignore
- README.md
- LICENSE (MIT, с текущим годом)

**Ничего не перезаписывает, если файлы уже существуют.**

```bash
pony bootstrap
```

### `pony deps`

- Анализирует проект и генерирует requirements.txt
на основе реально используемых импортов, а не pip freeze.

```bash
pony deps
```

### `pony test`

- Запускает тесты корректно внутри активного виртуального окружения.
- Поддерживает дополнительные режимы:

```bash
pony test
pony test --coverage
pony test --coverage --html
```

## Типичный сценарий использования

### В идеале PonyTool используют так:

```text
я создаю проект →
пишу код →
тестирую →
создаю полиш-файлы (gitignore, README, license, зависимости)
```
Без лишних шагов и постоянного гугления.

## Статус проекта

### PonyTool — живой pet-проект, который развивается по мере реальных потребностей.

- Он не пытается понравиться всем.
- Он решает конкретные проблемы — и делает это честно.

## Лицензия

### MIT

---
