igntui 0.0.1

Interactive Terminal User Interface for GitIgnore template generation

igntui

🌐 Website • 📦 PyPI • 🚀 Quick Start • 💬 Support

---

A powerful Terminal User Interface (TUI) and CLI for generating .gitignore files from gitignore.io templates.

✨ Features

🎨 Interactive TUI Mode

• Smart Search - Fuzzy, exact, and regex search modes (F1/F2/F3)
• Multi-Template Selection - Select and combine multiple templates
• Live Preview - See generated .gitignore content in real-time
• Intuitive Navigation - Tab between panels, arrow keys, vim-style shortcuts
• Beautiful Interface - Animated splash screen with pyfiglet ASCII art

⚡ Performance

• Intelligent Caching - Local template caching for instant access
• Async Loading - Non-blocking template loading and generation
• Rate Limiting - Respects API limits automatically

💾 Export & Save

• Save to File - Save generated .gitignore with custom paths
• Export Templates - Export selected templates as JSON
• Overwrite Protection - Confirmation dialogs for existing files

🛠️ CLI Mode

• Quick Generation - Generate .gitignore from command line
• List Templates - Browse 571+ available templates
• Test Connection - Verify API connectivity
• Cache Management - Clear and manage local cache

📦 Installation

Using pip (Standard)

pip install igntui

Using pipx (Isolated)

pipx installs the package in an isolated environment:

pipx install igntui

From source

git clone https://github.com/MKAbuMattar/igntui.git
cd igntui
pip install -e .

Windows Requirements

On Windows, you'll need the windows-curses package:

pip install windows-curses

🚀 Quick Start

Launch TUI (Interactive Mode)

igntui

or

python -m igntui

CLI Commands

Generate .gitignore

# Single template
igntui generate python

# Multiple templates
igntui generate python node visualstudiocode

# Save to file
igntui generate python --output .gitignore

List Available Templates

# List all templates
igntui list

# Search templates
igntui list --search python

# Show count only
igntui list --count

Test API Connection

igntui test

Cache Management

# Show cache info
igntui cache --info

# Clear cache
igntui cache --clear

Show Version

igntui --version
# Output: igntui/1.0.0 Python/3.13.0 Windows/11

🎮 TUI Usage

Keyboard Shortcuts

Navigation

• Tab / Shift+Tab - Navigate between panels
• ↑ / ↓ - Move selection up/down
• PgUp / PgDn - Page up/down
• Home / End - Jump to top/bottom

Search Modes

• F1 - Fuzzy search (default)
• F2 - Exact search
• F3 - Regex search

Template Management

• Space - Select/deselect template
• a - Select all templates
• x - Clear all selections
• Enter - Generate .gitignore content

Actions

• s - Save generated .gitignore to file
• e - Export selected templates as JSON
• F5 - Refresh template list
• h / ? - Show help dialog
• i - Show app info
• q / Esc - Quit application

Panel Layout

┌─────────────────────────────┬──────────────────────────────────┐
│  Search Panel               │  Generated Content Panel         │
│  (Filter templates)         │  (Preview .gitignore)            │
├─────────────────────────────┤                                  │
│  Available Templates        │                                  │
│  (571+ templates)           │                                  │
│                             │                                  │
│  • Select with Space        │                                  │
│  • Multi-select support     │                                  │
│  • Smart search             │                                  │
├─────────────────────────────┴──────────────────────────────────┤
│  Selected Templates (Bottom Panel)                             │
│  • Shows your current selection                                │
│  • Remove with Space                                           │
└────────────────────────────────────────────────────────────────┘
│  Status Bar                                                    │
│  • Keyboard shortcuts • Current mode • Status messages         │
└────────────────────────────────────────────────────────────────┘

🎯 Use Cases

For Developers

# Python project
igntui generate python venv

# Node.js project
igntui generate node npm yarn

# Full-stack project
igntui generate python node react visualstudiocode

# Unity game development
igntui generate unity visualstudio windows

For Teams

# Export team's template selection
igntui  # Select templates in TUI, press 'e' to export

# Share the JSON file with team
# Others can import and use the same templates

⚙️ Configuration

Configuration file location: ~/.igntui.json

Default Configuration

{
  "api": {
    "base_url": "https://www.toptal.com/developers/gitignore/api",
    "timeout": 10,
    "cache_ttl": 3600,
    "retry_attempts": 3
  },
  "ui": {
    "theme": "default",
    "mouse_support": true,
    "animation_speed": 150
  },
  "behavior": {
    "fuzzy_search_threshold": 0.6,
    "max_recent_templates": 10
  }
}

🐛 Troubleshooting

Windows: "igntui is not recognized"

If you see 'igntui' is not recognized as an internal or external command, the Scripts directory is not in your PATH.

Quick Fix - Use Python Module:

python -m igntui

Permanent Fix - Add to PATH:

1. Press Win + X and select "System"
2. Click "Advanced system settings" → "Environment Variables"
3. Under "User variables", select "Path" and click "Edit"
4. Click "New" and add: C:\Users\YOUR_USERNAME\AppData\Roaming\Python\Python3XX\Scripts
5. Click "OK" and restart your terminal

Or use PowerShell (as Administrator):

$currentPath = [Environment]::GetEnvironmentVariable("Path", "User")
$newPath = $currentPath + ";C:\Users\$env:USERNAME\AppData\Roaming\Python\Python313\Scripts"
[Environment]::SetEnvironmentVariable("Path", $newPath, "User")

Linux/macOS: Permission Denied

If you get permission errors:

# Use --user flag
pip install --user igntui

# Or add ~/.local/bin to PATH
export PATH="$HOME/.local/bin:$PATH"

ImportError: No module named 'curses'

On Windows, install windows-curses:

pip install windows-curses

API Connection Issues

If templates won't load:

1. Check internet connection
2. Test API: igntui test
3. Clear cache: igntui cache --clear
4. Try with verbose: igntui --verbose

🧪 Development

Setup Development Environment

# Clone repository
git clone https://github.com/MKAbuMattar/igntui.git
cd igntui

# Install dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Format code
black src/igntui
isort src/igntui

# Type checking
mypy src/igntui

Running Tests

# All tests
pytest

# With coverage
pytest --cov=igntui

# Specific test file
pytest tests/test_api.py

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📝 License

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

👨‍💻 Author

Mohammad Abu Mattar

• GitHub: @MKAbuMattar
• Website: MKAbuMattar.com
• Email: [e-mail]

🙏 Acknowledgments

• gitignore.io - Template source
• pyfiglet - ASCII art generation
• Python curses - Terminal UI framework

📊 Statistics

• 571+ Templates - Comprehensive template library
• Smart Caching - Reduces API calls by 90%
• 3 Search Modes - Fuzzy, exact, and regex
• Multi-select - Combine unlimited templates
• Cross-platform - Windows, macOS, Linux

🔗 Links

• Repository: https://github.com/MKAbuMattar/igntui
• Issue Tracker: https://github.com/MKAbuMattar/igntui/issues
• PyPI Package: https://pypi.org/project/igntui/
• Documentation: https://github.com/MKAbuMattar/igntui/wiki (coming soon)

---

Made with ❤️ by Mohammad Abu Mattar
_{Give it a ⭐ if you like it!}