Claude
243416f5ed
- Remove nested .github/.github/workflows/ (duplicate of .github/workflows/) - Move Подшипники/4.16 README.md to docs/podshipniki/4.16/README_ru.md (Russian version) - Merge data/schema/ into data/schemas/ (consolidate SQL + YAML schemas) - Remove WIP/TODO markers from README files (data/raw, data/tables, data/assets, data/database, archive, docs/technical, sources, tools) - Update data/database/README.md to reference new schema location - Update sources/README.md with correct links https://claude.ai/code/session_0176RmB3i3w7NQ23MdddWEgV
3.3 KiB
3.3 KiB
Инструменты и утилиты BearingsInfo
Назначение
Каталог содержит вспомогательные инструменты для работы с репозиторием BearingsInfo.
Текущее состояние
Существующие инструменты
bin/run
- CLI-обертка для запуска обработчика данных подшипников
- Использование:
./tools/bin/run(требует настроенного окружения Python) - Запускает модуль
src.cli.main()
Установка зависимостей
# Клонирование репозитория
git clone https://github.com/ArtemFilin1990/BearingsInfo.git
cd BearingsInfo
# Установка зависимостей
pip install -r requirements-dev.txt
Планируемые инструменты
Планируется разработка инструментов для:
- Валидации данных подшипников (проверка таблиц, ссылок, форматирования)
- Импорта/экспорта каталогов производителей (SKF, NSK, NTN, FAG)
- Работы с базой данных (инициализация, запросы, обновление цен)
- Построения поисковых индексов и автодополнения
- Генерации документации (INDEX.md, PDF-руководства, статистические отчёты)
- Поддержки контрибьюторов (создание секций, проверка Markdown)
- Анализа данных (распределение размеров, сравнение производителей)
Подробности — в issue и roadmap репозитория.
Вклад в развитие инструментов
Если вы хотите добавить новый инструмент или улучшить существующий:
- Создайте issue в репозитории с описанием функциональности
- Напишите скрипт в каталоге
tools/ - Добавьте документацию в этот README.md
- Добавьте тесты (если применимо) в
tests/tools/ - Создайте Pull Request
Требования к инструментам:
- CLI-интерфейс с использованием библиотеки
clickилиargparse - Подробная help-справка (
--help) - Обработка ошибок с понятными сообщениями
- Логирование (с уровнями INFO, WARNING, ERROR)
- Документация в коде (docstrings)
Лицензия
Все инструменты в каталоге tools/ распространяются под той же лицензией, что и основной репозиторий BearingsInfo (см. LICENSE в корне репозитория).
Контакты и поддержка
По вопросам работы инструментов обращайтесь: