igntui


Nameigntui JSON
Version 0.0.0 PyPI version JSON
download
home_pageNone
SummaryInteractive Terminal User Interface for GitIgnore template generation
upload_time2025-11-01 17:21:26
maintainerMohammad Abu Mattar
docs_urlNone
authorMohammad Abu Mattar
requires_python>=3.9
licenseNone
keywords gitignore tui terminal git templates cli
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            <div align="center">

# igntui

<div align="center">
  <a href="https://github.com/MKAbuMattar/igntui" target="_blank" rel="noreferrer">
    <img src="https://img.shields.io/badge/github-%23181717.svg?style=for-the-badge&logo=github&logoColor=white" alt="GitHub Repository"/>
  </a>

  <a href="https://github.com/MKAbuMattar/igntui/releases" target="_blank" rel="noreferrer">
    <img alt="GitHub Release" src="https://img.shields.io/github/v/release/MKAbuMattar/igntui?color=%232563eb&label=Latest%20Release&style=for-the-badge&logo=github" />
  </a>

  <a href="https://pypi.org/project/igntui/" target="_blank" rel="noreferrer">
    <img src="https://img.shields.io/pypi/v/igntui?style=for-the-badge&logo=pypi&logoColor=white&color=2563eb&label=PyPI" alt="PyPI Version"/>
  </a>

  <a href="https://pypi.org/project/igntui/" target="_blank" rel="noreferrer">
    <img src="https://img.shields.io/pypi/pyversions/igntui?style=for-the-badge&logo=python&logoColor=white&color=2563eb&label=Python" alt="Python Versions"/>
  </a>

  <a href="/LICENSE" target="_blank" rel="noreferrer">
    <img alt="GPL-3.0 License" src="https://img.shields.io/github/license/MKAbuMattar/igntui?color=%232563eb&style=for-the-badge&label=License">
  </a>

  <a href="https://github.com/MKAbuMattar/igntui/stargazers" target="_blank" rel="noreferrer">
    <img alt="GitHub Stars" src="https://img.shields.io/github/stars/MKAbuMattar/igntui?color=%232563eb&label=Stars&style=for-the-badge&logo=github">
  </a>

  <a href="https://pypi.org/project/igntui/" target="_blank" rel="noreferrer">
    <img alt="PyPI Downloads" src="https://img.shields.io/pypi/dm/igntui?color=%232563eb&style=for-the-badge&logo=pypi&label=Downloads">
  </a>

  <a href="https://github.com/MKAbuMattar/igntui/issues" target="_blank" rel="noreferrer">
    <img alt="GitHub Issues" src="https://img.shields.io/github/issues/MKAbuMattar/igntui?color=%232563eb&style=for-the-badge&logo=github&label=Issues">
  </a>
</div>

<br/>

[๐ŸŒ Website](https://mkabumattar.com/) โ€ข [๐Ÿ“ฆ PyPI](https://pypi.org/project/igntui/) โ€ข [๐Ÿš€ Quick Start](#-installation) โ€ข [๐Ÿ’ฌ Support](https://github.com/MKAbuMattar/igntui/issues)

<br/>

---

> A powerful Terminal User Interface (TUI) and CLI for generating `.gitignore` files from [gitignore.io](https://www.toptal.com/developers/gitignore) templates.

</div>

## โœจ 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)

```bash
pip install igntui
```

### Using pipx (Isolated)

[pipx](https://pipx.pypa.io/) installs the package in an isolated environment:

```bash
pipx install igntui
```

### From source

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

### Windows Requirements

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

```bash
pip install windows-curses
```

## ๐Ÿš€ Quick Start

### Launch TUI (Interactive Mode)

```bash
igntui
```

or

```bash
python -m igntui
```

### CLI Commands

#### Generate `.gitignore`

```bash
# Single template
igntui generate python

# Multiple templates
igntui generate python node visualstudiocode

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

#### List Available Templates

```bash
# List all templates
igntui list

# Search templates
igntui list --search python

# Show count only
igntui list --count
```

#### Test API Connection

```bash
igntui test
```

#### Cache Management

```bash
# Show cache info
igntui cache --info

# Clear cache
igntui cache --clear
```

#### Show Version

```bash
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

```bash
# 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

```bash
# 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

```json
{
  "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
  }
}
```

## ๐Ÿงช Development

### Setup Development Environment

```bash
# 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

```bash
# 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](LICENSE) file for details.

## ๐Ÿ‘จโ€๐Ÿ’ป Author

**Mohammad Abu Mattar**

- GitHub: [@MKAbuMattar](https://github.com/MKAbuMattar)
- Website: [MKAbuMattar.com](https://mkabumattar.com)
- Email: info@mkabumattar.com

## ๐Ÿ™ Acknowledgments

- [gitignore.io](https://www.toptal.com/developers/gitignore) - Template source
- [pyfiglet](https://github.com/pwaller/pyfiglet) - ASCII art generation
- [Python curses](https://docs.python.org/3/library/curses.html) - 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)

---

<div align="center">
  <strong>Made with โค๏ธ by Mohammad Abu Mattar</strong>
  <br>
  <sub>Give it a โญ if you like it!</sub>
</div>

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "igntui",
    "maintainer": "Mohammad Abu Mattar",
    "docs_url": null,
    "requires_python": ">=3.9",
    "maintainer_email": "Mohammad Abu Mattar <mohammad.khaled@outlook.com>",
    "keywords": "gitignore, tui, terminal, git, templates, cli",
    "author": "Mohammad Abu Mattar",
    "author_email": "Mohammad Abu Mattar <mohammad.khaled@outlook.com>",
    "download_url": "https://files.pythonhosted.org/packages/1c/9c/620c6d1a40a137af1b22b8c502f6ee7cdcabf368f169f338fdef3ab6c792/igntui-0.0.0.tar.gz",
    "platform": null,
    "description": "<div align=\"center\">\n\n# igntui\n\n<div align=\"center\">\n  <a href=\"https://github.com/MKAbuMattar/igntui\" target=\"_blank\" rel=\"noreferrer\">\n    <img src=\"https://img.shields.io/badge/github-%23181717.svg?style=for-the-badge&logo=github&logoColor=white\" alt=\"GitHub Repository\"/>\n  </a>\n\n  <a href=\"https://github.com/MKAbuMattar/igntui/releases\" target=\"_blank\" rel=\"noreferrer\">\n    <img alt=\"GitHub Release\" src=\"https://img.shields.io/github/v/release/MKAbuMattar/igntui?color=%232563eb&label=Latest%20Release&style=for-the-badge&logo=github\" />\n  </a>\n\n  <a href=\"https://pypi.org/project/igntui/\" target=\"_blank\" rel=\"noreferrer\">\n    <img src=\"https://img.shields.io/pypi/v/igntui?style=for-the-badge&logo=pypi&logoColor=white&color=2563eb&label=PyPI\" alt=\"PyPI Version\"/>\n  </a>\n\n  <a href=\"https://pypi.org/project/igntui/\" target=\"_blank\" rel=\"noreferrer\">\n    <img src=\"https://img.shields.io/pypi/pyversions/igntui?style=for-the-badge&logo=python&logoColor=white&color=2563eb&label=Python\" alt=\"Python Versions\"/>\n  </a>\n\n  <a href=\"/LICENSE\" target=\"_blank\" rel=\"noreferrer\">\n    <img alt=\"GPL-3.0 License\" src=\"https://img.shields.io/github/license/MKAbuMattar/igntui?color=%232563eb&style=for-the-badge&label=License\">\n  </a>\n\n  <a href=\"https://github.com/MKAbuMattar/igntui/stargazers\" target=\"_blank\" rel=\"noreferrer\">\n    <img alt=\"GitHub Stars\" src=\"https://img.shields.io/github/stars/MKAbuMattar/igntui?color=%232563eb&label=Stars&style=for-the-badge&logo=github\">\n  </a>\n\n  <a href=\"https://pypi.org/project/igntui/\" target=\"_blank\" rel=\"noreferrer\">\n    <img alt=\"PyPI Downloads\" src=\"https://img.shields.io/pypi/dm/igntui?color=%232563eb&style=for-the-badge&logo=pypi&label=Downloads\">\n  </a>\n\n  <a href=\"https://github.com/MKAbuMattar/igntui/issues\" target=\"_blank\" rel=\"noreferrer\">\n    <img alt=\"GitHub Issues\" src=\"https://img.shields.io/github/issues/MKAbuMattar/igntui?color=%232563eb&style=for-the-badge&logo=github&label=Issues\">\n  </a>\n</div>\n\n<br/>\n\n[\ud83c\udf10 Website](https://mkabumattar.com/) \u2022 [\ud83d\udce6 PyPI](https://pypi.org/project/igntui/) \u2022 [\ud83d\ude80 Quick Start](#-installation) \u2022 [\ud83d\udcac Support](https://github.com/MKAbuMattar/igntui/issues)\n\n<br/>\n\n---\n\n> A powerful Terminal User Interface (TUI) and CLI for generating `.gitignore` files from [gitignore.io](https://www.toptal.com/developers/gitignore) templates.\n\n</div>\n\n## \u2728 Features\n\n### \ud83c\udfa8 Interactive TUI Mode\n\n- **Smart Search** - Fuzzy, exact, and regex search modes (F1/F2/F3)\n- **Multi-Template Selection** - Select and combine multiple templates\n- **Live Preview** - See generated `.gitignore` content in real-time\n- **Intuitive Navigation** - Tab between panels, arrow keys, vim-style shortcuts\n- **Beautiful Interface** - Animated splash screen with pyfiglet ASCII art\n\n### \u26a1 Performance\n\n- **Intelligent Caching** - Local template caching for instant access\n- **Async Loading** - Non-blocking template loading and generation\n- **Rate Limiting** - Respects API limits automatically\n\n### \ud83d\udcbe Export & Save\n\n- **Save to File** - Save generated `.gitignore` with custom paths\n- **Export Templates** - Export selected templates as JSON\n- **Overwrite Protection** - Confirmation dialogs for existing files\n\n### \ud83d\udee0\ufe0f CLI Mode\n\n- **Quick Generation** - Generate `.gitignore` from command line\n- **List Templates** - Browse 571+ available templates\n- **Test Connection** - Verify API connectivity\n- **Cache Management** - Clear and manage local cache\n\n## \ud83d\udce6 Installation\n\n### Using pip (Standard)\n\n```bash\npip install igntui\n```\n\n### Using pipx (Isolated)\n\n[pipx](https://pipx.pypa.io/) installs the package in an isolated environment:\n\n```bash\npipx install igntui\n```\n\n### From source\n\n```bash\ngit clone https://github.com/MKAbuMattar/igntui.git\ncd igntui\npip install -e .\n```\n\n### Windows Requirements\n\nOn Windows, you'll need the `windows-curses` package:\n\n```bash\npip install windows-curses\n```\n\n## \ud83d\ude80 Quick Start\n\n### Launch TUI (Interactive Mode)\n\n```bash\nigntui\n```\n\nor\n\n```bash\npython -m igntui\n```\n\n### CLI Commands\n\n#### Generate `.gitignore`\n\n```bash\n# Single template\nigntui generate python\n\n# Multiple templates\nigntui generate python node visualstudiocode\n\n# Save to file\nigntui generate python --output .gitignore\n```\n\n#### List Available Templates\n\n```bash\n# List all templates\nigntui list\n\n# Search templates\nigntui list --search python\n\n# Show count only\nigntui list --count\n```\n\n#### Test API Connection\n\n```bash\nigntui test\n```\n\n#### Cache Management\n\n```bash\n# Show cache info\nigntui cache --info\n\n# Clear cache\nigntui cache --clear\n```\n\n#### Show Version\n\n```bash\nigntui --version\n# Output: igntui/1.0.0 Python/3.13.0 Windows/11\n```\n\n## \ud83c\udfae TUI Usage\n\n### Keyboard Shortcuts\n\n#### Navigation\n\n- `Tab` / `Shift+Tab` - Navigate between panels\n- `\u2191` / `\u2193` - Move selection up/down\n- `PgUp` / `PgDn` - Page up/down\n- `Home` / `End` - Jump to top/bottom\n\n#### Search Modes\n\n- `F1` - Fuzzy search (default)\n- `F2` - Exact search\n- `F3` - Regex search\n\n#### Template Management\n\n- `Space` - Select/deselect template\n- `a` - Select all templates\n- `x` - Clear all selections\n- `Enter` - Generate `.gitignore` content\n\n#### Actions\n\n- `s` - Save generated `.gitignore` to file\n- `e` - Export selected templates as JSON\n- `F5` - Refresh template list\n- `h` / `?` - Show help dialog\n- `i` - Show app info\n- `q` / `Esc` - Quit application\n\n### Panel Layout\n\n```\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u2502  Search Panel               \u2502  Generated Content Panel         \u2502\n\u2502  (Filter templates)         \u2502  (Preview .gitignore)            \u2502\n\u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524                                  \u2502\n\u2502  Available Templates        \u2502                                  \u2502\n\u2502  (571+ templates)           \u2502                                  \u2502\n\u2502                             \u2502                                  \u2502\n\u2502  \u2022 Select with Space        \u2502                                  \u2502\n\u2502  \u2022 Multi-select support     \u2502                                  \u2502\n\u2502  \u2022 Smart search             \u2502                                  \u2502\n\u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n\u2502  Selected Templates (Bottom Panel)                             \u2502\n\u2502  \u2022 Shows your current selection                                \u2502\n\u2502  \u2022 Remove with Space                                           \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n\u2502  Status Bar                                                    \u2502\n\u2502  \u2022 Keyboard shortcuts \u2022 Current mode \u2022 Status messages         \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n```\n\n## \ud83c\udfaf Use Cases\n\n### For Developers\n\n```bash\n# Python project\nigntui generate python venv\n\n# Node.js project\nigntui generate node npm yarn\n\n# Full-stack project\nigntui generate python node react visualstudiocode\n\n# Unity game development\nigntui generate unity visualstudio windows\n```\n\n### For Teams\n\n```bash\n# Export team's template selection\nigntui  # Select templates in TUI, press 'e' to export\n\n# Share the JSON file with team\n# Others can import and use the same templates\n```\n\n## \u2699\ufe0f Configuration\n\nConfiguration file location: `~/.igntui.json`\n\n### Default Configuration\n\n```json\n{\n  \"api\": {\n    \"base_url\": \"https://www.toptal.com/developers/gitignore/api\",\n    \"timeout\": 10,\n    \"cache_ttl\": 3600,\n    \"retry_attempts\": 3\n  },\n  \"ui\": {\n    \"theme\": \"default\",\n    \"mouse_support\": true,\n    \"animation_speed\": 150\n  },\n  \"behavior\": {\n    \"fuzzy_search_threshold\": 0.6,\n    \"max_recent_templates\": 10\n  }\n}\n```\n\n## \ud83e\uddea Development\n\n### Setup Development Environment\n\n```bash\n# Clone repository\ngit clone https://github.com/MKAbuMattar/igntui.git\ncd igntui\n\n# Install dependencies\npip install -e \".[dev]\"\n\n# Run tests\npytest\n\n# Format code\nblack src/igntui\nisort src/igntui\n\n# Type checking\nmypy src/igntui\n```\n\n### Running Tests\n\n```bash\n# All tests\npytest\n\n# With coverage\npytest --cov=igntui\n\n# Specific test file\npytest tests/test_api.py\n```\n\n## \ud83e\udd1d Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n## \ud83d\udcdd License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## \ud83d\udc68\u200d\ud83d\udcbb Author\n\n**Mohammad Abu Mattar**\n\n- GitHub: [@MKAbuMattar](https://github.com/MKAbuMattar)\n- Website: [MKAbuMattar.com](https://mkabumattar.com)\n- Email: info@mkabumattar.com\n\n## \ud83d\ude4f Acknowledgments\n\n- [gitignore.io](https://www.toptal.com/developers/gitignore) - Template source\n- [pyfiglet](https://github.com/pwaller/pyfiglet) - ASCII art generation\n- [Python curses](https://docs.python.org/3/library/curses.html) - Terminal UI framework\n\n## \ud83d\udcca Statistics\n\n- **571+ Templates** - Comprehensive template library\n- **Smart Caching** - Reduces API calls by 90%\n- **3 Search Modes** - Fuzzy, exact, and regex\n- **Multi-select** - Combine unlimited templates\n- **Cross-platform** - Windows, macOS, Linux\n\n## \ud83d\udd17 Links\n\n- **Repository**: https://github.com/MKAbuMattar/igntui\n- **Issue Tracker**: https://github.com/MKAbuMattar/igntui/issues\n- **PyPI Package**: https://pypi.org/project/igntui/\n- **Documentation**: https://github.com/MKAbuMattar/igntui/wiki (coming soon)\n\n---\n\n<div align=\"center\">\n  <strong>Made with \u2764\ufe0f by Mohammad Abu Mattar</strong>\n  <br>\n  <sub>Give it a \u2b50 if you like it!</sub>\n</div>\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "Interactive Terminal User Interface for GitIgnore template generation",
    "version": "0.0.0",
    "project_urls": {
        "Documentation": "https://github.com/MKAbuMattar/igntui/blob/main/Module/Utility/GitIgnore/igntui/README.md",
        "Homepage": "https://github.com/MKAbuMattar/igntui",
        "Issues": "https://github.com/MKAbuMattar/igntui/issues",
        "Repository": "https://github.com/MKAbuMattar/igntui"
    },
    "split_keywords": [
        "gitignore",
        " tui",
        " terminal",
        " git",
        " templates",
        " cli"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "b336f99f28f7a373f8d375bf80ef00cffb1443691a045e0e6d685e0b2ff1a150",
                "md5": "092e52f1742955a24bd49281394684f6",
                "sha256": "323d60a9971a6333a34dccbe4fbcde3bbb6a2970d559a9a432895316707babb7"
            },
            "downloads": -1,
            "filename": "igntui-0.0.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "092e52f1742955a24bd49281394684f6",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.9",
            "size": 58654,
            "upload_time": "2025-11-01T17:21:24",
            "upload_time_iso_8601": "2025-11-01T17:21:24.735383Z",
            "url": "https://files.pythonhosted.org/packages/b3/36/f99f28f7a373f8d375bf80ef00cffb1443691a045e0e6d685e0b2ff1a150/igntui-0.0.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "1c9c620c6d1a40a137af1b22b8c502f6ee7cdcabf368f169f338fdef3ab6c792",
                "md5": "2198d6467cee3a3141e8d43befe80d4e",
                "sha256": "d41e493a3767e4199590e289eee175e59af0de16cb2192c7a4ca8a1b36c81a5c"
            },
            "downloads": -1,
            "filename": "igntui-0.0.0.tar.gz",
            "has_sig": false,
            "md5_digest": "2198d6467cee3a3141e8d43befe80d4e",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.9",
            "size": 37660,
            "upload_time": "2025-11-01T17:21:26",
            "upload_time_iso_8601": "2025-11-01T17:21:26.093762Z",
            "url": "https://files.pythonhosted.org/packages/1c/9c/620c6d1a40a137af1b22b8c502f6ee7cdcabf368f169f338fdef3ab6c792/igntui-0.0.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-11-01 17:21:26",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "MKAbuMattar",
    "github_project": "igntui",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "igntui"
}
        
Elapsed time: 2.80444s