<div align="center">
# 🌟 DocMint
### *Professional README & Documentation Generator*
[](https://badge.fury.io/py/docmint)
[](https://www.python.org/)
[](https://opensource.org/licenses/MIT)
[](https://pepy.tech/project/docmint)
[](https://github.com/psf/black)
*Transform your projects into professionally documented masterpieces with AI-powered README generation* ✨
[🚀 **Quick Start**](#installation) • [📖 **Documentation**](#usage) • [🎯 **Features**](#features) • [🤝 **Contributing**](#contributing)
---
</div>
## 🎯 What is DocMint?
**DocMint** is a powerful Python package that automatically generates comprehensive, professional README files for your projects. Simply point it at your codebase, and watch as it analyzes your files, understands your project structure, and creates beautiful documentation that makes your project shine.
> 💡 **Perfect for developers who want professional documentation without the hassle!**
### ✨ Key Highlights
🔍 **Smart Analysis** - Automatically detects project type and structure
🎨 **Beautiful Output** - Generates professional, well-formatted README files
🌍 **Cross-Platform** - Works seamlessly on Windows, macOS, and Linux
⚡ **Lightning Fast** - Generate comprehensive docs in seconds
🛠️ **Highly Configurable** - Customize output to match your needs
🚫 **Smart Filtering** - Exclude unwanted files and directories with patterns
---
## 🚀 Installation
### Install from PyPI (Recommended)
```bash
pip install docmint
```
### Install from Source
```bash
git clone https://github.com/kingsleyesisi/docmint.git
cd docmint
pip install -e .
```
### Verify Installation
```bash
docmint --help
```
---
## 💻 Usage
### 🎯 Quick Start
Generate a README for your current project:
```bash
docmint
```
### 📁 Analyze Specific Directory
```bash
docmint -d /path/to/your/project
```
### 💬 Generate from Description
```bash
docmint -p "My awesome web application built with Flask and React"
```
### 🚫 Exclude Files and Directories
```bash
# Exclude specific directories
docmint --exclude-dir "temp,cache,logs"
# Exclude specific files (supports wildcards)
docmint --exclude-file "*.log,*.tmp,secret.txt"
# Exclude with patterns
docmint --exclude-file "tests/*,docs/*.md"
# Combine multiple exclusions
docmint --exclude-dir node_modules,dist --exclude-file "*.log,temp*"
```
### 🎨 Advanced Usage
```bash
# Specify project type and output file
docmint -t Python -o MyAwesome-README.md
# Skip contributing section
docmint --no-contributing
# Use custom backend
docmint --url http://localhost:8000
# Silent mode (no banner)
docmint --no-banner
# Show current configuration
docmint --show-config
```
---
## 🛠️ Command Line Options
| Option | Short | Description | Example |
|--------|-------|-------------|---------|
| `--directory` | `-d` | Project directory to analyze | `-d ./my-project` |
| `--prompt` | `-p` | Generate from text description | `-p "Flask API server"` |
| `--type` | `-t` | Specify project type | `-t Python` |
| `--output` | `-o` | Output filename | `-o DOCUMENTATION.md` |
| `--exclude-dir` | | Exclude directories (supports wildcards) | `--exclude-dir "temp*,cache"` |
| `--exclude-file` | | Exclude files (supports wildcards) | `--exclude-file "*.log,secret*"` |
| `--no-contributing` | | Skip contributing section | `--no-contributing` |
| `--url` | | Custom backend URL | `--url http://localhost:8000` |
| `--no-banner` | | Skip banner display | `--no-banner` |
| `--show-config` | | Show current configuration | `--show-config` |
| `--help` | `-h` | Show help message | `--help` |
---
## 🚫 Exclusion Patterns
DocMint provides powerful exclusion capabilities to filter out unwanted files and directories:
### 📁 Directory Exclusions
```bash
# Exclude specific directories
docmint --exclude-dir "node_modules,dist,build"
# Use wildcards
docmint --exclude-dir "temp*,cache*,*_backup"
# Multiple exclude-dir arguments
docmint --exclude-dir node_modules --exclude-dir dist --exclude-dir "temp*"
```
### 📄 File Exclusions
```bash
# Exclude specific files
docmint --exclude-file "secret.txt,config.local.json"
# Use wildcards for file patterns
docmint --exclude-file "*.log,*.tmp,*.cache"
# Exclude files in specific paths
docmint --exclude-file "tests/*,docs/*.md,src/temp*"
```
### 🔧 Default Exclusions
DocMint automatically excludes common directories and files:
**Default Excluded Directories:**
- `node_modules`, `.git`, `__pycache__`, `venv`, `dist`, `build`
- `.next`, `target`, `vendor`, `coverage`, `.vs`, `Pods`
**Default Excluded Files:**
- `*.log`, `*.tmp`, `*.cache`, `*.lock`, `*.pyc`
- `.DS_Store`, `Thumbs.db`, `*.swp`, `*.swo`
---
## 🎨 Features
<div align="center">
| Feature | Description |
|---------|-------------|
| 🤖 **AI-Powered Analysis** | Intelligent project understanding and documentation generation |
| 🔍 **Smart Detection** | Automatically identifies project type, dependencies, and structure |
| 📝 **Professional Templates** | Beautiful, industry-standard README formats |
| 🌈 **Colorful CLI** | Rich terminal output with progress indicators and status updates |
| ⚙️ **Configurable** | Extensive configuration options for customized output |
| 🚫 **Smart Filtering** | Advanced file and directory exclusion with wildcard support |
| 🔗 **API Integration** | Seamless integration with DocMint cloud services |
| 📊 **File Analysis** | Comprehensive project file scanning and summarization |
| 🛡️ **Error Handling** | Robust error handling with helpful diagnostic messages |
</div>
### 🎯 Supported Project Types
- 🐍 **Python** (Django, Flask, FastAPI, etc.)
- 🟨 **JavaScript/TypeScript** (Node.js, React, Vue, Angular)
- ☕ **Java** (Spring, Maven, Gradle)
- 🦀 **Rust** (Cargo projects)
- 🐹 **Go** (Go modules)
- 💎 **Ruby** (Rails, Gems)
- 🐘 **PHP** (Laravel, Composer)
- ⚡ **C/C++** (CMake, Make)
- 🔷 **C#/.NET** (MSBuild projects)
- 🍃 **Swift** (Xcode projects)
- 🎯 **Kotlin** (Android, JVM)
- 🌐 **Web Development** (HTML, CSS, JavaScript)
---
## ⚙️ Configuration
DocMint uses a configuration file located at `~/.docmint/config.json` for persistent settings.
### 📋 Default Configuration
```json
{
"backend_url": "https://docmint.onrender.com",
"default_project_type": "auto",
"include_contributing": true,
"max_file_size": 104857600,
"max_files": 150,
"excluded_dirs": [
"node_modules", ".git", "__pycache__",
"venv", "dist", "build", ".next",
"coverage", ".vs", "Pods"
],
"excluded_files": [
"*.log", "*.tmp", "*.cache", "*.lock",
".DS_Store", "Thumbs.db", "*.pyc"
],
"supported_extensions": [
".py", ".js", ".ts", ".jsx", ".tsx",
".java", ".cpp", ".go", ".rs", ".php"
]
}
```
### 🔧 Customization
Edit the configuration file to customize DocMint's behavior:
```bash
# View current configuration
docmint --show-config
# Open configuration file for editing
nano ~/.docmint/config.json
```
### 📝 Configuration Options
| Option | Type | Description |
|--------|------|-------------|
| `backend_url` | string | API endpoint URL |
| `max_file_size` | integer | Maximum file size in bytes |
| `max_files` | integer | Maximum number of files to analyze |
| `excluded_dirs` | array | Default directories to exclude |
| `excluded_files` | array | Default file patterns to exclude |
| `supported_extensions` | array | File extensions to include |
---
## 🌐 API Integration
DocMint integrates with cloud services for enhanced README generation:
### 🔗 Available Endpoints
| Endpoint | Method | Purpose |
|----------|--------|---------|
| `/api/health/` | GET | Health check |
| `/api/generate/` | POST | Generate from prompt |
| `/api/generate-from-files/` | POST | Generate from files |
### 📡 Example API Usage
```python
import requests
# Generate README from prompt
response = requests.post(
"https://docmint.onrender.com/api/generate/",
json={"message": "Python web scraping tool"}
)
readme_content = response.json()["answer"]
```
---
## 🚀 Development
### 🛠️ Setting Up Development Environment
```bash
# Clone the repository
git clone https://github.com/kingsleyesisi/docmint.git
cd docmint
# Create virtual environment
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
# Install development dependencies
pip install -e .
pip install -r requirements.txt
```
### 🧪 Running Tests
```bash
# Run tests (when available)
python -m pytest
# Run with coverage
python -m pytest --cov=docmint
```
### 📦 Building Package
```bash
# Build distribution packages
python -m build
# Upload to PyPI (maintainers only)
python -m twine upload dist/*
```
---
## 🤝 Contributing
We welcome contributions! Here's how you can help make DocMint even better:
### 🎯 Ways to Contribute
- 🐛 **Report Bugs** - Found an issue? Let us know!
- 💡 **Suggest Features** - Have ideas for improvements?
- 📝 **Improve Documentation** - Help make our docs clearer
- 🔧 **Submit Code** - Fix bugs or add new features
### 📋 Contribution Process
1. **Fork** the repository
2. **Create** a feature branch (`git checkout -b feature/amazing-feature`)
3. **Commit** your changes (`git commit -m 'Add amazing feature'`)
4. **Push** to the branch (`git push origin feature/amazing-feature`)
5. **Open** a Pull Request
### 📜 Code Style
We use [Black](https://github.com/psf/black) for code formatting:
```bash
# Format code
black docmint/
# Check formatting
black --check docmint/
```
---
## 🐛 Troubleshooting
### Common Issues & Solutions
<details>
<summary><strong>🔌 Connection Issues</strong></summary>
**Problem**: Cannot connect to DocMint backend
**Solutions**:
- ✅ Check your internet connection
- ✅ Verify backend URL in configuration
- ✅ Try using `--url` flag with alternative endpoint
- ✅ Check firewall settings
</details>
<details>
<summary><strong>📁 File Encoding Errors</strong></summary>
**Problem**: Encoding errors when reading files
**Solutions**:
- ✅ Ensure files are UTF-8 encoded
- ✅ Check for binary files in project directory
- ✅ Add problematic files to exclusion list with `--exclude-file`
</details>
<details>
<summary><strong>⚡ Performance Issues</strong></summary>
**Problem**: Slow processing for large projects
**Solutions**:
- ✅ Use `--exclude-dir` to exclude large directories
- ✅ Use `--exclude-file` to exclude unnecessary files
- ✅ Reduce max_files in configuration
- ✅ Use specific directory targeting with `-d`
</details>
<details>
<summary><strong>🚫 Too Many Files Excluded</strong></summary>
**Problem**: Important files being excluded
**Solutions**:
- ✅ Check your exclusion patterns with `--show-config`
- ✅ Use more specific patterns instead of broad wildcards
- ✅ Review default exclusions in configuration file
- ✅ Test patterns with smaller directories first
</details>
---
## 📄 License
This project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.
---
## 🙏 Acknowledgments
- 🌟 **Contributors** - Thank you to all who have contributed to this project
- 🛠️ **Open Source Community** - For the amazing tools and libraries
- 🤖 **AI Technology** - Powering intelligent documentation generation
---
<div align="center">
### 🌟 Star us on GitHub!
If DocMint helped you create better documentation, please consider giving us a star ⭐
[](https://github.com/kingsleyesisi/docmint)
---
**Made with ❤️ by the DocMint Team**
[](https://github.com/kingsleyesisi/docmint)
</div>
Raw data
{
"_id": null,
"home_page": "https://github.com/kingsleyesisi/docmint",
"name": "docmint",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "readme documentation generator markdown cli tool python package ai-powered",
"author": "Kingsley Esisi",
"author_email": "kingsleyesisi@yahoo.com",
"download_url": "https://files.pythonhosted.org/packages/33/65/feddd9f8baed160131fb6bc3c45d2ba2b2aa67b37d8b15db4249633679cf/docmint-0.2.0.tar.gz",
"platform": "any",
"description": "<div align=\"center\">\n\n# \ud83c\udf1f DocMint\n\n### *Professional README & Documentation Generator*\n\n[](https://badge.fury.io/py/docmint)\n[](https://www.python.org/)\n[](https://opensource.org/licenses/MIT)\n[](https://pepy.tech/project/docmint)\n[](https://github.com/psf/black)\n\n*Transform your projects into professionally documented masterpieces with AI-powered README generation* \u2728\n\n[\ud83d\ude80 **Quick Start**](#installation) \u2022 [\ud83d\udcd6 **Documentation**](#usage) \u2022 [\ud83c\udfaf **Features**](#features) \u2022 [\ud83e\udd1d **Contributing**](#contributing)\n\n---\n\n</div>\n\n## \ud83c\udfaf What is DocMint?\n\n**DocMint** is a powerful Python package that automatically generates comprehensive, professional README files for your projects. Simply point it at your codebase, and watch as it analyzes your files, understands your project structure, and creates beautiful documentation that makes your project shine.\n\n> \ud83d\udca1 **Perfect for developers who want professional documentation without the hassle!**\n\n### \u2728 Key Highlights\n\n\ud83d\udd0d **Smart Analysis** - Automatically detects project type and structure \n\ud83c\udfa8 **Beautiful Output** - Generates professional, well-formatted README files \n\ud83c\udf0d **Cross-Platform** - Works seamlessly on Windows, macOS, and Linux \n\u26a1 **Lightning Fast** - Generate comprehensive docs in seconds \n\ud83d\udee0\ufe0f **Highly Configurable** - Customize output to match your needs \n\ud83d\udeab **Smart Filtering** - Exclude unwanted files and directories with patterns\n\n---\n\n## \ud83d\ude80 Installation\n\n### Install from PyPI (Recommended)\n\n```bash\npip install docmint\n```\n\n### Install from Source\n\n```bash\ngit clone https://github.com/kingsleyesisi/docmint.git\ncd docmint\npip install -e .\n```\n\n### Verify Installation\n\n```bash\ndocmint --help\n```\n\n---\n\n## \ud83d\udcbb Usage\n\n### \ud83c\udfaf Quick Start\n\nGenerate a README for your current project:\n\n```bash\ndocmint\n```\n\n### \ud83d\udcc1 Analyze Specific Directory\n\n```bash\ndocmint -d /path/to/your/project\n```\n\n### \ud83d\udcac Generate from Description\n\n```bash\ndocmint -p \"My awesome web application built with Flask and React\"\n```\n\n### \ud83d\udeab Exclude Files and Directories\n\n```bash\n# Exclude specific directories\ndocmint --exclude-dir \"temp,cache,logs\"\n\n# Exclude specific files (supports wildcards)\ndocmint --exclude-file \"*.log,*.tmp,secret.txt\"\n\n# Exclude with patterns\ndocmint --exclude-file \"tests/*,docs/*.md\"\n\n# Combine multiple exclusions\ndocmint --exclude-dir node_modules,dist --exclude-file \"*.log,temp*\"\n```\n\n### \ud83c\udfa8 Advanced Usage\n\n```bash\n# Specify project type and output file\ndocmint -t Python -o MyAwesome-README.md\n\n# Skip contributing section\ndocmint --no-contributing\n\n# Use custom backend\ndocmint --url http://localhost:8000\n\n# Silent mode (no banner)\ndocmint --no-banner\n\n# Show current configuration\ndocmint --show-config\n```\n\n---\n\n## \ud83d\udee0\ufe0f Command Line Options\n\n| Option | Short | Description | Example |\n|--------|-------|-------------|---------|\n| `--directory` | `-d` | Project directory to analyze | `-d ./my-project` |\n| `--prompt` | `-p` | Generate from text description | `-p \"Flask API server\"` |\n| `--type` | `-t` | Specify project type | `-t Python` |\n| `--output` | `-o` | Output filename | `-o DOCUMENTATION.md` |\n| `--exclude-dir` | | Exclude directories (supports wildcards) | `--exclude-dir \"temp*,cache\"` |\n| `--exclude-file` | | Exclude files (supports wildcards) | `--exclude-file \"*.log,secret*\"` |\n| `--no-contributing` | | Skip contributing section | `--no-contributing` |\n| `--url` | | Custom backend URL | `--url http://localhost:8000` |\n| `--no-banner` | | Skip banner display | `--no-banner` |\n| `--show-config` | | Show current configuration | `--show-config` |\n| `--help` | `-h` | Show help message | `--help` |\n\n---\n\n## \ud83d\udeab Exclusion Patterns\n\nDocMint provides powerful exclusion capabilities to filter out unwanted files and directories:\n\n### \ud83d\udcc1 Directory Exclusions\n\n```bash\n# Exclude specific directories\ndocmint --exclude-dir \"node_modules,dist,build\"\n\n# Use wildcards\ndocmint --exclude-dir \"temp*,cache*,*_backup\"\n\n# Multiple exclude-dir arguments\ndocmint --exclude-dir node_modules --exclude-dir dist --exclude-dir \"temp*\"\n```\n\n### \ud83d\udcc4 File Exclusions\n\n```bash\n# Exclude specific files\ndocmint --exclude-file \"secret.txt,config.local.json\"\n\n# Use wildcards for file patterns\ndocmint --exclude-file \"*.log,*.tmp,*.cache\"\n\n# Exclude files in specific paths\ndocmint --exclude-file \"tests/*,docs/*.md,src/temp*\"\n```\n\n### \ud83d\udd27 Default Exclusions\n\nDocMint automatically excludes common directories and files:\n\n**Default Excluded Directories:**\n- `node_modules`, `.git`, `__pycache__`, `venv`, `dist`, `build`\n- `.next`, `target`, `vendor`, `coverage`, `.vs`, `Pods`\n\n**Default Excluded Files:**\n- `*.log`, `*.tmp`, `*.cache`, `*.lock`, `*.pyc`\n- `.DS_Store`, `Thumbs.db`, `*.swp`, `*.swo`\n\n---\n\n## \ud83c\udfa8 Features\n\n<div align=\"center\">\n\n| Feature | Description |\n|---------|-------------|\n| \ud83e\udd16 **AI-Powered Analysis** | Intelligent project understanding and documentation generation |\n| \ud83d\udd0d **Smart Detection** | Automatically identifies project type, dependencies, and structure |\n| \ud83d\udcdd **Professional Templates** | Beautiful, industry-standard README formats |\n| \ud83c\udf08 **Colorful CLI** | Rich terminal output with progress indicators and status updates |\n| \u2699\ufe0f **Configurable** | Extensive configuration options for customized output |\n| \ud83d\udeab **Smart Filtering** | Advanced file and directory exclusion with wildcard support |\n| \ud83d\udd17 **API Integration** | Seamless integration with DocMint cloud services |\n| \ud83d\udcca **File Analysis** | Comprehensive project file scanning and summarization |\n| \ud83d\udee1\ufe0f **Error Handling** | Robust error handling with helpful diagnostic messages |\n\n</div>\n\n### \ud83c\udfaf Supported Project Types\n\n- \ud83d\udc0d **Python** (Django, Flask, FastAPI, etc.)\n- \ud83d\udfe8 **JavaScript/TypeScript** (Node.js, React, Vue, Angular)\n- \u2615 **Java** (Spring, Maven, Gradle)\n- \ud83e\udd80 **Rust** (Cargo projects)\n- \ud83d\udc39 **Go** (Go modules)\n- \ud83d\udc8e **Ruby** (Rails, Gems)\n- \ud83d\udc18 **PHP** (Laravel, Composer)\n- \u26a1 **C/C++** (CMake, Make)\n- \ud83d\udd37 **C#/.NET** (MSBuild projects)\n- \ud83c\udf43 **Swift** (Xcode projects)\n- \ud83c\udfaf **Kotlin** (Android, JVM)\n- \ud83c\udf10 **Web Development** (HTML, CSS, JavaScript)\n\n---\n\n## \u2699\ufe0f Configuration\n\nDocMint uses a configuration file located at `~/.docmint/config.json` for persistent settings.\n\n### \ud83d\udccb Default Configuration\n\n```json\n{\n \"backend_url\": \"https://docmint.onrender.com\",\n \"default_project_type\": \"auto\",\n \"include_contributing\": true,\n \"max_file_size\": 104857600,\n \"max_files\": 150,\n \"excluded_dirs\": [\n \"node_modules\", \".git\", \"__pycache__\", \n \"venv\", \"dist\", \"build\", \".next\",\n \"coverage\", \".vs\", \"Pods\"\n ],\n \"excluded_files\": [\n \"*.log\", \"*.tmp\", \"*.cache\", \"*.lock\",\n \".DS_Store\", \"Thumbs.db\", \"*.pyc\"\n ],\n \"supported_extensions\": [\n \".py\", \".js\", \".ts\", \".jsx\", \".tsx\", \n \".java\", \".cpp\", \".go\", \".rs\", \".php\"\n ]\n}\n```\n\n### \ud83d\udd27 Customization\n\nEdit the configuration file to customize DocMint's behavior:\n\n```bash\n# View current configuration\ndocmint --show-config\n\n# Open configuration file for editing\nnano ~/.docmint/config.json\n```\n\n### \ud83d\udcdd Configuration Options\n\n| Option | Type | Description |\n|--------|------|-------------|\n| `backend_url` | string | API endpoint URL |\n| `max_file_size` | integer | Maximum file size in bytes |\n| `max_files` | integer | Maximum number of files to analyze |\n| `excluded_dirs` | array | Default directories to exclude |\n| `excluded_files` | array | Default file patterns to exclude |\n| `supported_extensions` | array | File extensions to include |\n\n---\n\n## \ud83c\udf10 API Integration\n\nDocMint integrates with cloud services for enhanced README generation:\n\n### \ud83d\udd17 Available Endpoints\n\n| Endpoint | Method | Purpose |\n|----------|--------|---------|\n| `/api/health/` | GET | Health check |\n| `/api/generate/` | POST | Generate from prompt |\n| `/api/generate-from-files/` | POST | Generate from files |\n\n### \ud83d\udce1 Example API Usage\n\n```python\nimport requests\n\n# Generate README from prompt\nresponse = requests.post(\n \"https://docmint.onrender.com/api/generate/\",\n json={\"message\": \"Python web scraping tool\"}\n)\n\nreadme_content = response.json()[\"answer\"]\n```\n\n---\n\n## \ud83d\ude80 Development\n\n### \ud83d\udee0\ufe0f Setting Up Development Environment\n\n```bash\n# Clone the repository\ngit clone https://github.com/kingsleyesisi/docmint.git\ncd docmint\n\n# Create virtual environment\npython -m venv venv\nsource venv/bin/activate # On Windows: venv\\Scripts\\activate\n\n# Install development dependencies\npip install -e .\npip install -r requirements.txt\n```\n\n### \ud83e\uddea Running Tests\n\n```bash\n# Run tests (when available)\npython -m pytest\n\n# Run with coverage\npython -m pytest --cov=docmint\n```\n\n### \ud83d\udce6 Building Package\n\n```bash\n# Build distribution packages\npython -m build\n\n# Upload to PyPI (maintainers only)\npython -m twine upload dist/*\n```\n\n---\n\n## \ud83e\udd1d Contributing\n\nWe welcome contributions! Here's how you can help make DocMint even better:\n\n### \ud83c\udfaf Ways to Contribute\n\n- \ud83d\udc1b **Report Bugs** - Found an issue? Let us know!\n- \ud83d\udca1 **Suggest Features** - Have ideas for improvements?\n- \ud83d\udcdd **Improve Documentation** - Help make our docs clearer\n- \ud83d\udd27 **Submit Code** - Fix bugs or add new features\n\n### \ud83d\udccb Contribution Process\n\n1. **Fork** the repository\n2. **Create** a feature branch (`git checkout -b feature/amazing-feature`)\n3. **Commit** your changes (`git commit -m 'Add amazing feature'`)\n4. **Push** to the branch (`git push origin feature/amazing-feature`)\n5. **Open** a Pull Request\n\n### \ud83d\udcdc Code Style\n\nWe use [Black](https://github.com/psf/black) for code formatting:\n\n```bash\n# Format code\nblack docmint/\n\n# Check formatting\nblack --check docmint/\n```\n\n---\n\n## \ud83d\udc1b Troubleshooting\n\n### Common Issues & Solutions\n\n<details>\n<summary><strong>\ud83d\udd0c Connection Issues</strong></summary>\n\n**Problem**: Cannot connect to DocMint backend\n\n**Solutions**:\n- \u2705 Check your internet connection\n- \u2705 Verify backend URL in configuration\n- \u2705 Try using `--url` flag with alternative endpoint\n- \u2705 Check firewall settings\n\n</details>\n\n<details>\n<summary><strong>\ud83d\udcc1 File Encoding Errors</strong></summary>\n\n**Problem**: Encoding errors when reading files\n\n**Solutions**:\n- \u2705 Ensure files are UTF-8 encoded\n- \u2705 Check for binary files in project directory\n- \u2705 Add problematic files to exclusion list with `--exclude-file`\n\n</details>\n\n<details>\n<summary><strong>\u26a1 Performance Issues</strong></summary>\n\n**Problem**: Slow processing for large projects\n\n**Solutions**:\n- \u2705 Use `--exclude-dir` to exclude large directories\n- \u2705 Use `--exclude-file` to exclude unnecessary files\n- \u2705 Reduce max_files in configuration\n- \u2705 Use specific directory targeting with `-d`\n\n</details>\n\n<details>\n<summary><strong>\ud83d\udeab Too Many Files Excluded</strong></summary>\n\n**Problem**: Important files being excluded\n\n**Solutions**:\n- \u2705 Check your exclusion patterns with `--show-config`\n- \u2705 Use more specific patterns instead of broad wildcards\n- \u2705 Review default exclusions in configuration file\n- \u2705 Test patterns with smaller directories first\n\n</details>\n\n---\n\n## \ud83d\udcc4 License\n\nThis project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.\n\n---\n\n## \ud83d\ude4f Acknowledgments\n\n- \ud83c\udf1f **Contributors** - Thank you to all who have contributed to this project\n- \ud83d\udee0\ufe0f **Open Source Community** - For the amazing tools and libraries\n- \ud83e\udd16 **AI Technology** - Powering intelligent documentation generation\n\n---\n\n<div align=\"center\">\n\n### \ud83c\udf1f Star us on GitHub!\n\nIf DocMint helped you create better documentation, please consider giving us a star \u2b50\n\n[](https://github.com/kingsleyesisi/docmint)\n\n---\n\n**Made with \u2764\ufe0f by the DocMint Team**\n\n[](https://github.com/kingsleyesisi/docmint)\n\n</div>\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "\ud83c\udf1f DocMint: Professional README & Documentation Generator - Transform your projects into professionally documented masterpieces with AI-powered README generation",
"version": "0.2.0",
"project_urls": {
"Bug Reports": "https://github.com/kingsleyesisi/docmint/issues",
"Changelog": "https://github.com/kingsleyesisi/docmint/releases",
"Documentation": "https://github.com/kingsleyesisi/docmint#readme",
"Homepage": "https://github.com/kingsleyesisi/docmint",
"Source": "https://github.com/kingsleyesisi/docmint"
},
"split_keywords": [
"readme",
"documentation",
"generator",
"markdown",
"cli",
"tool",
"python",
"package",
"ai-powered"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "bb496d8d1657564ade49ce27a2354114f1b92c42ef1dcaa199ae7d6c2f3a3552",
"md5": "f4aeeb80d7b66be2f3861d54431b25a6",
"sha256": "fd7d5e35c1acb171bc2a259c12aa76afc12b3a26071526e86b7390b66321faae"
},
"downloads": -1,
"filename": "docmint-0.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "f4aeeb80d7b66be2f3861d54431b25a6",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 18993,
"upload_time": "2025-07-13T14:38:00",
"upload_time_iso_8601": "2025-07-13T14:38:00.744769Z",
"url": "https://files.pythonhosted.org/packages/bb/49/6d8d1657564ade49ce27a2354114f1b92c42ef1dcaa199ae7d6c2f3a3552/docmint-0.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "3365feddd9f8baed160131fb6bc3c45d2ba2b2aa67b37d8b15db4249633679cf",
"md5": "6ee9cfe2b317b4f9e78b782ed787ecc2",
"sha256": "6981d8fe9bdf9f97926d541547fd9e6c47e731ff16ce52e564ad96fabbcbc99f"
},
"downloads": -1,
"filename": "docmint-0.2.0.tar.gz",
"has_sig": false,
"md5_digest": "6ee9cfe2b317b4f9e78b782ed787ecc2",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 22679,
"upload_time": "2025-07-13T14:38:02",
"upload_time_iso_8601": "2025-07-13T14:38:02.308044Z",
"url": "https://files.pythonhosted.org/packages/33/65/feddd9f8baed160131fb6bc3c45d2ba2b2aa67b37d8b15db4249633679cf/docmint-0.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-13 14:38:02",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "kingsleyesisi",
"github_project": "docmint",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "click",
"specs": [
[
">=",
"8.2.0"
]
]
},
{
"name": "requests",
"specs": [
[
">=",
"2.32.0"
]
]
},
{
"name": "rich",
"specs": [
[
">=",
"13.9.0"
]
]
},
{
"name": "typer",
"specs": [
[
">=",
"0.15.0"
]
]
},
{
"name": "pydantic",
"specs": [
[
">=",
"2.10.0"
]
]
},
{
"name": "colorama",
"specs": [
[
">=",
"0.4.6"
]
]
}
],
"lcname": "docmint"
}
JSON
