sosig 0.2.0

A command-line tool for analyzing GitHub repositories and calculating social signals based on various metrics.

SOSIG (Social Signal) Command Line Tool

A command-line tool for analyzing GitHub repositories and calculating social signals based on various metrics.

Features

• Analyze local Git repositories for various metrics and social signals
• Store and manage repository analysis data in a local database
• Configure analysis weights and parameters
• View repository statistics and comparisons
• Database management and optimization utilities

Installation

# Clone the repository
git clone https://github.com/will-wright-eng/sosig.git
cd sosig

# Install dependencies
pip install -r requirements.lock

# For development
pip install -r requirements-dev.lock

Usage

SOSIG provides three main command groups:

GitHub Metrics Operations (gh)

# Analyze repositories
sosig gh analyze path/to/repo1 path/to/repo2

# List analyzed repositories (sorted by social signal by default)
sosig gh list
sosig gh list --sort stars  # Sort by stars

Available sort options:

• social_signal (default)
• stars
• age_days
• name
• username
• last_analyzed
• commit_count

Database Operations (db)

# View database statistics
sosig db stats

# Show database schema
sosig db schema

# Remove specific repository
sosig db remove repo-name

# Clear all data
sosig db clear

# Optimize database
sosig db vacuum

Configuration Operations (config)

# Show current configuration
sosig config show

# Update configuration values
sosig config set metrics.weights.age 0.3

Project Structure

sosig/
├── src/sosig/
│   ├── commands/          # CLI command implementations
│   ├── core/             # Core functionality and models
│   └── utils/            # Utility functions and services
├── scripts/              # Helper scripts
│   └── results/          # Analysis results
└── requirements.lock     # Locked dependencies

Scripts

The project includes several utility scripts:

• analyze-repo-file.sh: Batch analyze repositories from a file
• fetch-repos.sh: Fetch repository information from GitHub

Development

Setup

rye add pip
rye sync
rye build
python -m pip install -e .

Debug Mode

All commands support a --debug flag for additional logging:

sosig gh analyze path/to/repo --debug

Workspace Configuration

Analysis operations use a workspace directory (default: ~/.local/share/ssig/workspace):

sosig gh analyze path/to/repo --workspace /custom/path