Delete directory 'solutions/<taskId>_Плоская_карточка'
This commit is contained in:
@@ -1,85 +0,0 @@
|
||||
# Плоская карточка
|
||||
|
||||
**Плоская карточка** – это небольшое приложение на Python, которое преобразует сырой текст задания в формат «плоской карточки» (с заголовком, списками и примерами).
|
||||
В проекте реализован один скрипт `main.py`, который читает входной файл с заданием, обрабатывает его и выводит результат в консоль или сохраняет в новый файл.
|
||||
|
||||
---
|
||||
|
||||
## 📦 Установка зависимостей
|
||||
|
||||
```bash
|
||||
# Создайте виртуальное окружение (рекомендуется)
|
||||
python -m venv .venv
|
||||
source .venv/bin/activate # Windows: .venv\Scripts\activate
|
||||
|
||||
# Установите зависимости из requirements.txt
|
||||
pip install -r requirements.txt
|
||||
```
|
||||
|
||||
> **Важно**
|
||||
> В `requirements.txt` указаны только стандартные библиотеки, но если вы захотите добавить сторонние пакеты (например, `rich` для красивого вывода), просто добавьте их туда и выполните `pip install -r requirements.txt`.
|
||||
|
||||
---
|
||||
|
||||
## 🚀 Запуск
|
||||
|
||||
### 1. Пример входного файла (`task.txt`)
|
||||
```text
|
||||
Задача: Написать функцию, которая возвращает сумму двух чисел.
|
||||
Параметры:
|
||||
- a (int): первое число
|
||||
- b (int): второе число
|
||||
Пример использования:
|
||||
>>> sum_two(3, 5)
|
||||
8
|
||||
```
|
||||
|
||||
### 2. Запуск скрипта
|
||||
|
||||
```bash
|
||||
# Вариант 1 – вывод в консоль
|
||||
python main.py task.txt
|
||||
|
||||
# Вариант 2 – сохранить результат в файл
|
||||
python main.py task.txt --output result.md
|
||||
```
|
||||
|
||||
> Скрипт автоматически определит формат входного файла (txt, md и т.д.) и преобразует его в «плоскую карточку» с заголовком, списками и блоком кода.
|
||||
|
||||
---
|
||||
|
||||
## 📄 Пример вывода
|
||||
|
||||
```markdown
|
||||
# Задача: Написать функцию, которая возвращает сумму двух чисел.
|
||||
|
||||
**Параметры:**
|
||||
- `a` (int): первое число
|
||||
- `b` (int): второе число
|
||||
|
||||
**Пример использования:**
|
||||
|
||||
```python
|
||||
>>> sum_two(3, 5)
|
||||
8
|
||||
```
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🛠️ Как это работает
|
||||
|
||||
1. **Чтение файла** – скрипт открывает указанный файл и читает его содержимое.
|
||||
2. **Парсинг текста** – с помощью простых регулярных выражений выделяются заголовок, параметры и пример кода.
|
||||
3. **Форматирование** – полученные данные форматируются в Markdown‑карточку.
|
||||
4. **Вывод/Сохранение** – результат выводится в консоль или записывается в файл.
|
||||
|
||||
---
|
||||
|
||||
## 📚 Дальнейшее развитие
|
||||
|
||||
- Добавить поддержку более сложных форматов (JSON, YAML).
|
||||
- Встроить автогенерацию тестов из примеров кода.
|
||||
- Интеграция с GitHub Actions для автоматической генерации карточек при коммите.
|
||||
|
||||
---
|
||||
Reference in New Issue
Block a user