👨‍💻 Разработка и вклад в Flux

Присоединяйтесь к разработке! Этот раздел для разработчиков, которые хотят внести свой вклад.

📁 Структура исходного кода

source/
├── main.py                 # Основной исполняемый файл
├── config/                 # Настройки проекта
│   ├── settings.py        # Общие настройки
│   ├── URLS.txt           # Список URL
│   ├── URLS_base64.txt    # Base64 подписки
│   ├── whitelist-all.txt  # SNI домены
│   └── cidrwhitelist.txt  # CIDR адреса
├── fetchers/fetcher.py    # Загрузка конфигов
├── processors/config_processor.py  # Обработка
└── utils/                 # Вспомогательные модули
    ├── logger.py          # Логирование
    ├── file_utils.py      # Файловые операции
    └── github_handler.py  # GitHub API

✨ Новые функции и улучшения

Все функции обработки теперь используют валидацию, чтобы избежать включения неподходящих строк (текстовых комментариев) в итоговые файлы.

🚀 Запуск локально

# Клонирование репозитория
git clone https://github.com/username/flux
cd flux/source

# Установка зависимостей
pip install -r requirements.txt

# Настройка токена
export MY_TOKEN=<GITHUB_TOKEN>  # токен с правом repo

# Запуск генератора
python main.py  # конфиги появятся в ../githubmirror

python main.py --dry-run

🤝 Внесение изменений

1. Форкните репозиторий
2. Создайте ветку: git checkout -b feature/новая-функция
3. Внесите изменения
4. Сделайте коммит: git commit -m 'Добавил новую функцию'
5. Запушьте: git push origin feature/новая-функция
6. Создайте Pull Request

🧪 Тестирование

# Тестовый запуск
python main.py --dry-run

# Запуск тестов
python -m pytest tests/

# Конкретный тест
python -m pytest tests/test_fetchers.py

# С покрытием кода
python -m pytest --cov=src tests/

**Описание проблемы**
**Шаги для воспроизведения**
**Ожидаемое поведение**
**Версия:** 1.0.0
**ОС:** Windows/Linux/Mac

## Описание изменений
## Тип изменения
## Чеклист
- [ ] Код соответствует стилю
- [ ] Добавлены тесты
- [ ] Обновлена документация

📋 Требования

🎯 Архитектурные принципы

📈 Дорожная карта