Metadata-Version: 2.4
Name: package-installer-cli
Version: 2.4.0
Summary: A powerful CLI tool to bootstrap projects with pre-configured templates and features
Author-email: 0xshariq <khanshariq92213@gmail.com>
Maintainer-email: 0xshariq <khanshariq92213@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/0xshariq/py_package_installer_cli
Project-URL: Documentation, https://github.com/0xshariq/py_package_installer_cli#readme
Project-URL: Repository, https://github.com/0xshariq/py_package_installer_cli.git
Project-URL: Bug Tracker, https://github.com/0xshariq/py_package_installer_cli/issues
Project-URL: Changelog, https://github.com/0xshariq/py_package_installer_cli/blob/main/CHANGELOG.md
Keywords: cli,template,react,nextjs,vuejs,ruby,django,go,golang,ai,aws,analytics,angular,express,nestjs,rust,database,orm,mongodb,postgresql,mysql,prisma,drizzle,typeorm,mongoose,typegoose,starter,project-generator,docker,github,payment,razorpay,stripe,paypal,daisy,ui,shadcn,tailwind,storage,testing,monitoring
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Code Generators
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Utilities
Classifier: Environment :: Console
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
Requires-Dist: black>=22.0.0; extra == "dev"
Requires-Dist: flake8>=4.0.0; extra == "dev"
Requires-Dist: mypy>=0.950; extra == "dev"
Requires-Dist: isort>=5.10.0; extra == "dev"
Requires-Dist: pre-commit>=2.17.0; extra == "dev"
Requires-Dist: twine>=4.0.0; extra == "dev"
Requires-Dist: build>=0.8.0; extra == "dev"
Provides-Extra: test
Requires-Dist: pytest>=7.0.0; extra == "test"
Requires-Dist: pytest-cov>=4.0.0; extra == "test"
Requires-Dist: pytest-mock>=3.7.0; extra == "test"
Dynamic: license-file

# 📦 Package Installer CLI

[![PyPI version](https://img.shields.io/pypi/v/package-installer-cli.svg)](https://pypi.org/project/package-installer-cli/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Python](https://img.shields.io/badge/python-%3E%3D3.8-brightgreen.svg)](https://python.org/)

A **cross-platform, interactive CLI** to scaffold modern web application templates with support for multiple frameworks, languages, and development tools. Create production-ready projects in seconds!

## 🚀 Quick Features

- **🎨 Multiple Frameworks**: React, Next.js, Express, Angular, Vue, Rust
- **🔤 Language Support**: TypeScript & JavaScript variants
- **🎭 UI Libraries**: Tailwind CSS, Material-UI, shadcn/ui
- **⚡ Lightning Fast**: Optimized template generation with intelligent caching
- **🌈 Beautiful CLI**: Gorgeous terminal interface with real-time analytics
- **🔍 Project Analysis**: Advanced dependency analysis and project insights
- **📦 Self-Contained**: No external dependencies required - bundled executables

## ✨ New Features

- **📊 Enhanced Analytics Dashboard**: Real-time usage analytics with detailed insights
- **🎯 Smart Dependency Updates**: Project-specific dependency management for JS, Python, Rust, Go, Ruby, PHP
- **🚀 Intelligent CLI Upgrades**: Separate upgrade system with breaking change detection
- **💾 .package-installer-cli Folder**: All cache and history stored in dedicated folder
- **📈 Usage Tracking**: Comprehensive command and feature usage tracking
- **⚡ Performance Insights**: Productivity scoring and usage patterns

## 📥 Installation

### Global Installation (Recommended)
```bash
# Using pip (system-wide)
pip install package-installer-cli

# Using pip3 (system-wide)
pip3 install package-installer-cli
```

### Local/User Installation
```bash
# Install for current user only
pip install --user package-installer-cli

# Using pip3 for current user only
pip3 install --user package-installer-cli
```

## 🎯 Quick Start

After installation, you can immediately start using the CLI:

```bash
# Create new project interactively
pi create

# Analyze project with enhanced dashboard
pi analyze

# Add features to existing project
pi add feature-name

# Get help
pi --help
```

## 📚 Documentation

| Document | Description |
|----------|-------------|
| [📋 Commands](https://github.com/0xshariq/package-installer-cli/tree/main/docs/commands.md) | Complete command reference with examples |
| [⚡ Features](https://github.com/0xshariq/package-installer-cli/tree/main/docs/features.md) | Detailed feature documentation and usage |
| [🎨 Templates](https://github.com/0xshariq/package-installer-cli/tree/main/docs/templates.md) | Available templates and customization options |
| [🚀 Deployment](https://github.com/0xshariq/package-installer-cli/tree/main/docs/deploy.md) | Deployment options and platform integration |
| [📦 Bundle Info](https://github.com/0xshariq/package-installer-cli/tree/main/docs/bundle-info.md) | Distribution bundle system and cross-platform packaging |

## 🛠️ Command Overview

| Command | Description | Usage |
|---------|-------------|-------|
| `pi create` | Create new project from templates | `pi create [name]` |
| `pi analyze` | Enhanced project analytics dashboard | `pi analyze [--detailed]` |
| `pi update` | Update project dependencies | `pi update [--latest]` |
| `pi upgrade-cli` | Upgrade CLI to latest version | `pi upgrade-cli` |
| `pi add` | Add features to existing projects | `pi add [feature]` |
| `pi doctor` | Diagnose and fix project issues | `pi doctor` |
| `pi clean` | Clean development artifacts | `pi clean [--all]` |

*For complete command documentation, see [commands](https://github.com/0xshariq/package-installer-cli/tree/main/docs/commands.md)*

## 🏗️ Supported Project Types

| Language/Framework | Templates Available |
|-------------------|---------------------|
| **JavaScript/TypeScript** | React, Next.js, Express, Angular, Vue, Remix |
| **Python** | Django, Flask |
| **Rust** | Basic, Advanced Web Applications |
| **Go** | CLI, Web, API Applications |
| **Ruby** | Rails Applications |
| **React Native** | Mobile Applications |

*For detailed template information, see [templates](https://github.com/0xshariq/package-installer-cli/tree/main/docs/templates.md)*

## 🎯 System Requirements

- **Python**: 3.8 or higher
- **Operating Systems**: Windows, macOS, Linux
- **Architecture**: x64 (64-bit systems)

## 🐛 Troubleshooting

### Quick Fixes

```bash
# Reinstall the package
pip uninstall package-installer-cli
pip install package-installer-cli

# For user installation
pip install --user package-installer-cli
```

### Command Not Found Issues

If `package-installer` command is not found after installation:

**For user installation (`--user` flag):**
- **Linux/macOS**: Add `~/.local/bin` to your PATH
- **Windows**: Add `%APPDATA%\Python\Scripts` to your PATH

**For permission issues on Linux/macOS:**
```bash
# Try user installation instead
pip install --user package-installer-cli
```

## 🤝 Contributing

We welcome contributions! Please see our [Contributing Guide](https://github.com/0xshariq/package-installer-cli/tree/main/CONTRIBUTING.md) for details.

## 📄 License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## 🔗 Links

- **PyPI Package**: [package-installer-cli](https://pypi.org/project/package-installer-cli/)
- **GitHub Repository**: [py_package_installer_cli](https://github.com/0xshariq/py_package_installer_cli)
- **Issues & Feedback**: [GitHub Issues](https://github.com/0xshariq/py_package_installer_cli/issues)

---

**Happy coding! 🚀** Create something amazing with Package Installer CLI.
