vibecoding_git_parser

0
7 месяцев назад
7 месяцев назад
7 месяцев назад
7 месяцев назад
7 месяцев назад
7 месяцев назад
7 месяцев назад
7 месяцев назад
7 месяцев назад
7 месяцев назад
7 месяцев назад
7 месяцев назад
7 месяцев назад
7 месяцев назад
README.md

GitHub Profile Analyzer 📊

Простой анализатор активности GitHub профилей с экспортом в CSV.

🚀 Возможности

  • Анализ активности - коммиты, issues, pull requests, репозитории
  • Экспорт данных - CSV файлы с детальной статистикой
  • Простой запуск - одна команда для анализа
  • Гибкие настройки - анализ за любой период (1-12 месяцев)

📦 Установка

  1. Клонирование репозитория:
  1. Установка зависимостей:
  1. Настройка GitHub токена:

Получите токен на https://github.com/settings/tokens

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

1. Установка

2. Настройка токена

Создайте файл

.env
:

GITHUB_TOKEN=ваш_токен_здесь

3. Настройка профилей

Отредактируйте

profiles.csv
:

4. Запуск

Готово! Результаты сохранятся в

analysis_*.csv
файлы.

📊 Результаты анализа

CSV экспорт

  • *_users.csv
    - основная статистика пользователей
  • *_monthly.csv
    - статистика по месяцам
  • *_daily_activity.csv
    - детальная активность по дням
  • *_summary.json
    - сводная статистика в JSON

Пример реальных результатов

📊 СВОДНАЯ СТАТИСТИКА ================================================== Всего профилей: 1 Период анализа: 4 месяцев С 2025-06-03 по 2025-09-12 👤 dayekb (BioMed): Репозиториев: 23 Подписчиков: 12 Коммиты: 7 Репозиториев создано: 10

Графики и визуализация (опционально)

  • Календарь активности в стиле GitHub
  • Сравнение активности пользователей
  • Месячные тренды
  • Распределение по типам активности

🛠️ Использование

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

Параметры командной строки

ПараметрОписаниеПо умолчанию
-f, --csv-file
Путь к CSV файлу с профилямиОбязательно
-o, --output
Префикс для выходных файлов
github_analysis
-m, --months
Период анализа в месяцах (1-12)
4
--quick
Быстрый режим
False
--max-repos
Максимум репозиториев в быстром режиме
50
--dashboard
Создать дашборд с графиками
False
--visualize
Показать графики
False
--summary
Создать JSON сводку
False
--calendar
Создать календарь активности
False

Переменные окружения

ПеременнаяОписаниеПо умолчанию
GITHUB_TOKEN
GitHub Personal Access TokenОбязательно
ANALYSIS_MONTHS
Период анализа в месяцах
4
QUICK_MODE
Быстрый режим
false
MAX_REPOSITORIES
Максимум репозиториев
50

📈 Типы анализируемой активности

Коммиты

  • Push события в репозиториях
  • Коммиты в чужих репозиториях
  • Детальная информация по дням

Issues

  • Создание issues
  • Закрытие issues
  • Статистика по репозиториям

Pull Requests

  • Создание PR
  • Мерж PR
  • Анализ активности

Репозитории

  • Создание репозиториев
  • Обновления репозиториев
  • Статистика по владельцам

🔧 Структура проекта

github_profile_parser/ ├── simple_analyzer.py # Основной анализатор ├── run_analysis.py # Расширенный анализатор с графиками ├── profiles.csv # Ваши профили для анализа ├── requirements.txt # Зависимости ├── .env # Токен GitHub (создать) └── README.md # Документация

📝 Примеры использования

Анализ ваших профилей

Анализ с графиками

Быстрый анализ

📁 Управление файлами

Файлы, которые игнорируются Git (.gitignore):

  • .env
    - файл с секретными токенами
  • analysis_*.csv
    - результаты анализа
  • *_dashboard/
    - папки с графиками
  • __pycache__/
    - кэш Python
  • *.png
    ,
    *.jpg
    - изображения графиков

Важные файлы для Git:

  • profiles.csv
    - ваши профили для анализа
  • simple_analyzer.py
    - основной анализатор
  • requirements.txt
    - зависимости
  • README.md
    - документация

⚠️ Ограничения

  • Rate Limits: GitHub API имеет ограничения на количество запросов. Используйте задержки между запросами.
  • Токен: Требуется GitHub Personal Access Token с соответствующими правами.
  • Время выполнения: Полный анализ может занять значительное время для профилей с большим количеством репозиториев.