gign 1.0.0

A magical CLI tool that automatically generates and manages .gitignore files

✨ gitignore-gen

A magical CLI tool that automatically generates and manages .gitignore files for your projects. Simply run it in any directory and watch as it intelligently detects your project's technologies and creates the perfect .gitignore file.

Author: Sherin Joseph Roy
Email: [e-mail]
Repository: https://github.com/Sherin-SEF-AI/gitignore-gen

🚀 Features

• 🔍 Smart Detection: Automatically detects 50+ technologies including Python, Node.js, Java, Go, Rust, Swift, Unity, VS Code, JetBrains IDEs, and many more
• 🌐 API Integration: Fetches templates from gitignore.io with intelligent caching
• 🔄 Smart Merging: Combines multiple templates and removes duplicates
• 🛡️ Security Patterns: Optional security-focused patterns for API keys, certificates, and secrets
• 📁 Monorepo Support: Generate per-directory .gitignore files for complex projects
• 💾 Backup & Safety: Automatic backups and dry-run mode for safe experimentation
• 🎨 Beautiful UI: Rich terminal output with progress bars, colors, and emojis
• ⚡ Performance: Async operations for fast scanning and template fetching
• 🔧 Advanced Analysis: Comprehensive project analysis with dependency scanning, security checks, and performance insights
• 📊 Interactive Recommendations: Get actionable suggestions based on your project structure
• 🔄 Real-time Monitoring: Watch mode for automatic updates when files change
• 📦 Custom Templates: Create, manage, and share your own templates
• 🛠️ Auto-fix: Automatically remove tracked files that should be ignored

📦 Installation

From PyPI (Recommended)

pip install gitignore-gen

From Source

git clone https://github.com/Sherin-SEF-AI/gitignore-gen.git
cd gitignore-gen
pip install -e .

Development Installation

git clone https://github.com/Sherin-SEF-AI/gitignore-gen.git
cd gitignore-gen
pip install -e ".[dev]"

🎯 Quick Start

Basic Usage

Simply run gitignore-gen in your project directory:

cd your-project
gitignore-gen

The tool will:

1. 🔍 Scan your project for technologies
2. 🚀 Fetch appropriate templates
3. 🔄 Merge and optimize the content
4. 💾 Save a perfect .gitignore file

Interactive Mode

For more control, use interactive mode:

gitignore-gen --interactive

This will let you:

• Choose which templates to include
• Add custom templates
• Preview changes before applying

📚 Complete Command Reference

Main Commands

gitignore-gen - Main Generation

Generate a .gitignore file for the current directory.

# Basic generation
gitignore-gen

# With options
gitignore-gen --security --backup --dry-run

# Interactive mode
gitignore-gen --interactive

# Minimal mode for cleaner output
gitignore-gen --minimal

# Strict mode for precise patterns
gitignore-gen --strict

Options:

• --verbose, -v: Enable verbose output
• --quiet, -q: Suppress all output except errors
• --dry-run: Preview changes without applying them
• --interactive, -i: Enable interactive mode
• --backup: Create backup of existing .gitignore
• --security: Add common security patterns
• --monorepo: Generate per-directory .gitignore files
• --auto-fix: Automatically remove files that should be ignored from git
• --watch: Watch for file changes and auto-update .gitignore
• --export PATH: Export current .gitignore configuration
• --import PATH: Import .gitignore configuration
• --custom-templates PATH: Path to custom templates directory
• --force: Force overwrite existing .gitignore
• --minimal: Generate minimal .gitignore with only essential patterns
• --strict: Use strict pattern matching for better accuracy

gitignore-gen scan - Technology Detection

Scan directory and detect technologies in use.

# Scan current directory
gitignore-gen scan

# Scan specific path
gitignore-gen scan --path /path/to/project

gitignore-gen version - Version Information

Show version information.

gitignore-gen version

Template Management

gitignore-gen list-templates - List Templates

List available templates (built-in and custom).

# List all templates
gitignore-gen list-templates

# Search for specific templates
gitignore-gen list-templates --template python

# Show only custom templates
gitignore-gen list-templates --custom-only

gitignore-gen templates - Show Template Content

Show content of a specific template.

# Show Python template
gitignore-gen templates --template python

# Save template to file
gitignore-gen templates --template node --output node.gitignore

gitignore-gen create-template - Create Custom Template

Create a custom template.

# Create from content
gitignore-gen create-template --template myproject --content "*.log\n*.tmp"

# Create from file
gitignore-gen create-template --template myproject --file template.txt

gitignore-gen update-template - Update Template

Update an existing custom template.

# Update with new content
gitignore-gen update-template --template myproject --content "*.log\n*.tmp\n*.cache"

# Update from file
gitignore-gen update-template --template myproject --file new-template.txt

gitignore-gen delete-template - Delete Template

Delete a custom template.

# Delete with confirmation
gitignore-gen delete-template --template myproject

# Force delete without confirmation
gitignore-gen delete-template --template myproject --force

gitignore-gen search-templates - Search Templates

Search for templates by name or content.

# Search by name
gitignore-gen search-templates --query python

# Search only custom templates
gitignore-gen search-templates --query myproject --custom-only

Project Analysis

gitignore-gen analyze - Project Analysis

Analyze project structure and generate detailed report.

# Analyze current directory
gitignore-gen analyze

# Analyze specific path
gitignore-gen analyze --path /path/to/project

# Save report to file
gitignore-gen analyze --output analysis_report.json

gitignore-gen scan-dependencies - Dependency Scanning

Scan project dependencies and generate detailed report.

# Scan current directory
gitignore-gen scan-dependencies

# Save as JSON
gitignore-gen scan-dependencies --output deps.json

# Save as YAML
gitignore-gen scan-dependencies --output deps.yaml --format yaml

# Save as CSV
gitignore-gen scan-dependencies --output deps.csv --format csv

gitignore-gen performance-insights - Performance Analysis

Generate performance insights and optimization recommendations.

# Analyze current directory
gitignore-gen performance-insights

# Custom threshold (default: 10MB)
gitignore-gen performance-insights --threshold 50

# Save report
gitignore-gen performance-insights --output perf_report.json

gitignore-gen security-scan - Security Analysis

Perform comprehensive security scan and generate report.

# Full security scan
gitignore-gen security-scan

# Specific severity level
gitignore-gen security-scan --severity high

# Save report
gitignore-gen security-scan --output security_report.json

Advanced Features

gitignore-gen monorepo-setup - Monorepo Configuration

Set up comprehensive .gitignore structure for monorepos.

# Basic setup
gitignore-gen monorepo-setup

# With shared patterns
gitignore-gen monorepo-setup --shared

# Generate per-service files
gitignore-gen monorepo-setup --per-service

# Specific strategy
gitignore-gen monorepo-setup --strategy nested

Strategies:

• flat: Simple flat structure
• nested: Nested directory structure
• hybrid: Mixed approach (default)

gitignore-gen optimize - .gitignore Optimization

Optimize existing .gitignore file for better performance.

# Preview optimizations
gitignore-gen optimize --dry-run

# Apply optimizations
gitignore-gen optimize

# Aggressive optimization
gitignore-gen optimize --aggressive

gitignore-gen auto-fix - Auto-fix Tracked Files

Automatically remove files that should be ignored from git.

# Preview what would be fixed
gitignore-gen auto-fix --dry-run

# Apply fixes
gitignore-gen auto-fix

gitignore-gen clean - Clean Ignored Files

Clean up files that should be ignored from git.

# Preview cleanup
gitignore-gen clean --dry-run

# Apply cleanup
gitignore-gen clean

gitignore-gen watch - File Watching

Watch for file changes and auto-update .gitignore.

# Watch current directory
gitignore-gen watch

# Custom interval (default: 5 seconds)
gitignore-gen watch --interval 10

# Watch specific path
gitignore-gen watch --path /path/to/project

Configuration Management

gitignore-gen export-config - Export Configuration

Export .gitignore and detected technologies to a config file.

# Export to default location
gitignore-gen export-config

# Export to specific file
gitignore-gen export-config --output my-config.json

gitignore-gen import-config - Import Configuration

Import a .gitignore-gen config and regenerate .gitignore.

# Import from file
gitignore-gen import-config --config my-config.json

# Import to specific location
gitignore-gen import-config --config my-config.json --output .gitignore

🎨 Supported Technologies

Programming Languages

• Python (Django, Flask, FastAPI, Jupyter)
• Node.js (React, Vue, Angular, Express)
• Java (Spring, Maven, Gradle, Android)
• Go (Go modules, Go workspaces)
• Rust (Cargo, Rust projects)
• Swift (iOS, macOS development)
• C# (.NET, Unity, Xamarin)
• PHP (Laravel, WordPress, Composer)
• Ruby (Rails, Bundler, RVM)
• Dart (Flutter, Dart projects)
• Kotlin (Android, JVM)
• Scala (SBT, Scala projects)

Frameworks & Libraries

• Frontend: React, Vue, Angular, Svelte, Next.js, Nuxt.js
• Backend: Django, Flask, FastAPI, Express, Spring, Laravel
• Mobile: Flutter, React Native, Ionic
• Desktop: Electron, Tauri, PyQt, Tkinter

Build Tools & Package Managers

• JavaScript: npm, yarn, pnpm, webpack, vite, rollup
• Python: pip, poetry, pipenv, conda
• Java: Maven, Gradle, Ant
• Go: go mod, go work
• Rust: Cargo, Cargo workspaces

IDEs & Editors

• VS Code (.vscode, settings, extensions)
• JetBrains (IntelliJ IDEA, PyCharm, WebStorm, Android Studio)
• Eclipse (.metadata, .project, .classpath)
• Vim/Neovim (.vim, .nvim, swap files)
• Emacs (.emacs, .emacs.d)

Operating Systems

• macOS (.DS_Store, Spotlight, Time Machine)
• Windows (Thumbs.db, desktop.ini, Recycle Bin)
• Linux (core dumps, temporary files)

Cloud & DevOps

• Docker (Dockerfile, docker-compose, .dockerignore)
• Kubernetes (k8s manifests, helm charts)
• Terraform (.tfstate, .tfvars, modules)
• Ansible (playbooks, inventory, roles)
• Jenkins (workspace, builds, logs)

Version Control

• Git (.git, .gitignore, .gitattributes)
• GitHub (GitHub Actions, .github)
• GitLab (GitLab CI, .gitlab-ci.yml)

Testing & Quality

• Jest (coverage, snapshots)
• Cypress (videos, screenshots)
• Playwright (test-results, playwright-report)
• Pytest (.pytest_cache, coverage)
• Coverage (htmlcov, .coverage)

🔧 Configuration

Create a configuration file at ~/.gitignore-gen.toml:

[api]
base_url = "https://www.tgitignore.io/api"
timeout = 30

[cache]
enabled = true
ttl = 86400  # 24 hours

[security]
auto_add = false
patterns = [
    "*.key",
    "*.pem",
    "*.env"
]

[detection]
scan_depth = 3
ignore_dirs = [".git", "node_modules", "venv"]

🧪 Examples

Python Project

$ gitignore-gen
🔍 Scanning project...
🚀 Generating .gitignore...
💾 Saving .gitignore...

✅ .gitignore generated successfully!

Detected technologies:
• python
• vscode

React + Node.js Project

$ gitignore-gen --interactive
🔍 Scanning project...
🎯 Template Selection:
Include python template? [y/N]: n
Include node template? [y/N]: y
Include react template? [y/N]: y
Include vscode template? [y/N]: y

📋 Generated .gitignore Preview:
# Generated by gitignore-gen
# Technologies detected: node, react, vscode

node_modules/
.env
dist/
build/
.vscode/
*.log
...

Apply this .gitignore? [y/N]: y
✅ .gitignore generated successfully!

Monorepo with Security

$ gitignore-gen --monorepo --security --backup
🔍 Scanning project...
🚀 Generating .gitignore...
💾 Saving .gitignore...

✅ .gitignore generated successfully!
📁 Created per-directory .gitignore files
🔒 Added security patterns
💾 Backup created: .gitignore.backup

Advanced Analysis

$ gitignore-gen analyze --output report.json
🔍 Analyzing project: /path/to/project

📊 Project Analysis Results

🔧 Detected Technologies:
┏━━━━━━━━━━━━┳━━━━━━━━━━━━┓
┃ Technology ┃ Confidence ┃
┡━━━━━━━━━━━━╇━━━━━━━━━━━━┩
│ python     │ 100.0%     │
│ node       │ 30.0%      │
│ docker     │ 10.0%      │
└────────────┴────────────┘

📦 Dependencies:
  • python: pyproject.toml

🏗️ Project Structure:
  • Type: desktop
  • Depth: 8 levels

📈 File Statistics:
  • Total files: 1250
  • Total directories: 45

🔒 Security Analysis:
  • ⚠️ Sensitive files found: 3
  • Recommendations:
    - Ensure .env files are in .gitignore

⚡ Performance Analysis:
  • ⚠️ Deep directory nesting detected
  • Recommendations:
    - Consider flattening directory structure

💡 Recommendations:
  1. Consider adding __pycache__/ and *.pyc to .gitignore
  2. Ensure node_modules/ is in .gitignore
  3. Ensure .env files are in .gitignore

✅ Report saved to: report.json

Custom Template Management

# Create a custom template
$ gitignore-gen create-template --template myproject --content "*.log\n*.tmp\n.env.local"

# List templates (custom template will show with ✓)
$ gitignore-gen list-templates
📚 Available Templates:
Custom (1): myproject
Built-in (32): python, node, java, go, rust, php, ruby, csharp, swift, kotlin, scala, dart, flutter, react, vue, angular, svelte, docker, kubernetes, terraform, ansible, jenkins, github, gitlab, vscode, intellij, eclipse, vim, emacs, macos, windows, linux
  ✓ myproject
  ● python
  ● node
  ...

# Search for templates
$ gitignore-gen search-templates --query myproject
🔍 Search Results for "myproject":
  ✓ myproject (custom template)

Performance Optimization

$ gitignore-gen optimize --dry-run
⚡ Optimizing .gitignore in: /path/to/project
Original .gitignore: 150 lines

🔍 Optimization Analysis:
  • Duplicate patterns: 5
    Line 145: .coverage
    Line 146: htmlcov/
    Line 147: .pytest_cache/
  • Redundant patterns: 2
    Line 140: .cache/
  • Inefficient patterns: 1
    Line 25: *.egg-info/

Potential optimization: Remove 8 lines
Dry run mode - no changes applied

Security Scanning

$ gitignore-gen security-scan --severity high
🔒 Performing security scan in: /path/to/project
Severity level: high

🔒 Security Analysis Results:
  • ⚠️ Sensitive files found: 5
    - /path/to/project/.env
    - /path/to/project/config/private.key
    - /path/to/project/secrets/database.yml
    - /path/to/project/certificates/server.crt
    - /path/to/project/.aws/credentials

💡 Security Recommendations:
  1. Ensure .env files are in .gitignore
  2. Add *.key and *.pem to .gitignore
  3. Consider using environment variables for secrets
  4. Review certificate files for sensitive data

✅ Security report saved to: security_report.json

🔍 How It Works

1. Directory Scanning: Recursively scans your project directory
2. Pattern Matching: Uses intelligent patterns to detect technologies
3. Template Fetching: Retrieves templates from gitignore.io API
4. Smart Merging: Combines templates and removes duplicates
5. Content Generation: Creates optimized .gitignore content
6. File Writing: Saves the result with optional backup

🐛 Troubleshooting

No Technologies Detected

If no technologies are detected, try:

# Use interactive mode to manually select templates
gitignore-gen --interactive

# Or specify a template directly
gitignore-gen templates --template python

API Connection Issues

The tool includes fallback templates for common technologies. If the API is unavailable, it will use bundled templates.

Permission Errors

Ensure you have read permissions for the directory you're scanning:

# Check permissions
ls -la

# Run with appropriate permissions
sudo gitignore-gen  # if needed

Template Fetch Errors

If templates fail to fetch, the tool will use built-in fallbacks:

# Check network connectivity
ping www.tgitignore.io

# Use offline mode (built-in templates)
gitignore-gen --offline

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

Development Setup

git clone https://github.com/Sherin-SEF-AI/gitignore-gen.git
cd gitignore-gen
pip install -e ".[dev]"
pre-commit install

Running Tests

# Run all tests
pytest

# Run with coverage
pytest --cov=gitignore_gen

# Run specific test file
pytest tests/test_detector.py

Code Quality

# Format code
black gitignore_gen tests

# Sort imports
isort gitignore_gen tests

# Lint code
flake8 gitignore_gen tests

# Type checking
mypy gitignore_gen

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• gitignore.io for providing the template API
• Click for the CLI framework
• Rich for beautiful terminal output
• Watchdog for file system monitoring

📞 Support

• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Email: [e-mail]

🔄 Changelog

See CHANGELOG.md for a detailed history of changes.

---

By Sherin Joseph Roy