code-assembler-pro 4.2.1__tar.gz → 4.3.0__tar.gz

{code_assembler_pro-4.2.1 → code_assembler_pro-4.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code-assembler-pro
-Version: 4.2.1
+Version: 4.3.0
 Summary: Consolidate your codebase into structured Markdown context for LLMs (Claude, GPT, Gemini).
 Author-email: Xavier Mehaut <xavier.mehaut@gmail.com>
 License: MIT
@@ -29,11 +29,13 @@ Requires-Dist: jinja2>=3.1.0
 
 > **Turn your codebase into structured, LLM-ready context with one command.**
 
-![Version](https://img.shields.io/badge/version-4.1.0-blue)
+![Version](https://img.shields.io/badge/version-4.3.0-blue)
 ![Python](https://img.shields.io/badge/python-3.9%2B-blue)
 ![License](https://img.shields.io/badge/license-MIT-green)
+[![PyPI version](https://badge.fury.io/py/code-assembler-pro.svg)](https://badge.fury.io/py/code-assembler-pro)
 
-**Code Assembler Pro** is a high-grade engineering utility designed to bridge the gap between your source code and Large Language Models (Claude 3.5, GPT-4o, Gemini 1.5). 
+
+**Code Assembler Pro** is a high-grade engineering utility designed to bridge the gap between your source code and Large Language Models (Claude, GPT-4o, Gemini, DeepSeek).
 
 It doesn't just concatenate files; it generates a **contextual technical document** optimized for LLM ingestion, preserving project structure, identifying architectural patterns, and managing token limits through intelligent truncation.
 
@@ -41,7 +43,7 @@ It doesn't just concatenate files; it generates a **contextual technical documen
 
 ## 🎯 Why Code Assembler Pro?
 
-Copy-pasting raw files into a chat window leads to context loss (who calls what? where is this file located?). 
+Copy-pasting raw files into a chat window leads to context loss (who calls what? where is this file located?).
 
 **Code Assembler Pro solves this by:**
 1.  **🗺️ Project Mapping:** Automatically generates a clickable Table of Contents and architectural overview.
@@ -55,18 +57,24 @@ Copy-pasting raw files into a chat window leads to context loss (who calls what?
 
 - **🧠 Architecture Analysis:** Detects design patterns (MVC, API, Testing structures) and provides file distribution stats.
 - **📊 Token Metrics:** Real-time estimation of token count to stay within model limits.
-- **🔌 Dual Interface:** Use it as a powerful CLI tool or integrate it as a Python library.
+- **📌 Dual Interface:** Use it as a powerful CLI tool or integrate it as a Python library.
 - **📝 Multi-Language Support:** Syntax highlighting for 50+ extensions (.py, .rs, .ts, .go, .toml, etc.).
+- **📄 Exact Filename Matching:** **(v4.3)** Include files like `Dockerfile`, `Makefile`, `.env` by exact name.
 - **ℹ️ README Integration:** Automatically injects local READMEs into the flow to provide folder-level context to the AI.
+- **🖥️ Cross-Platform:** Works on Windows (PowerShell, cmd), macOS, and Linux with automatic emoji/ASCII adaptation.
 
 ---
 
 ## 🚀 Installation
 
-Clone the repository and install in editable mode:
+### From PyPI
+```bash
+pip install code-assembler-pro
+```
 
+### From source (development)
 ```bash
-git clone https://github.com/yourusername/code-assembler-pro.git
+git clone https://github.com/xmehaut/code-assembler-pro.git
 cd code-assembler-pro
 pip install -e .
 ```
@@ -86,7 +94,14 @@ Consolidate all Python and Markdown files in the current directory:
 code-assembler . --ext py md
 ```
 
-### 2. Targeted Usage
+### 2. Include special files
+Include `Dockerfile`, `.env`, and Jinja2 templates alongside Python:
+
+```bash
+code-assembler . --ext py md yml Dockerfile .env .env.j2 .j2
+```
+
+### 3. Targeted Usage
 Exclude tests, target a specific source folder, and define a custom output:
 
 ```bash
@@ -96,16 +111,51 @@ code-assembler ./src \
   --output project_context.md
 ```
 
+### 4. Save your CLI as a reusable config
+```bash
+code-assembler . --ext py md Dockerfile --exclude tests --save-config my_project.json
+```
+Reuse it later:
+```bash
+code-assembler --config my_project.json
+```
+
+### 5. Show default exclusions
+```bash
+code-assembler --show-excludes
+```
+
+---
+
+## 🧙‍♂️ Interactive Mode
+
+**Don't want to remember CLI arguments?** Use the interactive wizard!
+
+```bash
+code-assembler --interactive
+# or
+code-assembler -i
+```
+
+The wizard will guide you through:
+1. 📂 **Path selection** — Choose directories or specific files
+2. 📝 **Extension presets** — Python, JS/TS, Rust, Go, Java, C/C++, or custom
+3. 🚫 **Smart exclusions** — Use defaults or add custom patterns
+4. 💾 **Output config** — Name your file, auto-detect conflicts
+5. ⚙️ **Advanced options** — Truncation, recursion, README inclusion
+
+👉 **[Full Interactive Mode Guide](INTERACTIVE_MODE.md)** | **[5-Minute Quickstart](QUICKSTART_INTERACTIVE.md)**
+
 ---
 
 ## ⚙️ Advanced Configuration (JSON)
 
-For complex projects, use a JSON configuration file (`assembler_config.json`) for full control:
+For complex projects, use a JSON configuration file for full control:
 
 ```json
 {
-  "paths": ["./src", "./docs"],
-  "extensions": [".py", ".ts", ".tsx", ".sql"],
+  "paths": ["./src", "./infra"],
+  "extensions": [".py", ".ts", ".tsx", ".sql", "Dockerfile", ".env.j2"],
   "exclude_patterns": [
     "migrations",
     "__pycache__",
@@ -125,19 +175,37 @@ Run it using:
 code-assembler --config assembler_config.json
 ```
 
-### 📖 Configuration Options Reference
+### 📖 CLI Options Reference
+
+| Option | Description |
+|--------|-------------|
+| `paths` | Files or directories to analyze |
+| `--ext` / `-e` | Extensions and filenames to include (e.g., `py md Dockerfile`) |
+| `--output` / `-o` | Output file name (default: `codebase.md`) |
+| `--exclude` / `-x` | Patterns to exclude (added to defaults) |
+| `--config` / `-c` | Load a JSON configuration file |
+| `--interactive` / `-i` | Launch the interactive wizard |
+| `--save-config FILE` | **(v4.3)** Save CLI args as reusable JSON config |
+| `--show-excludes` | **(v4.3)** Display default exclusion patterns |
+| `--no-recursive` | Do not traverse subdirectories |
+| `--no-readmes` | Do not auto-include README files |
+| `--no-default-excludes` | Disable default exclusion patterns |
+| `--max-size` | Maximum file size in MB (default: 10.0) |
+| `--version` | Show version and exit |
+
+### 📖 JSON Configuration Options
 
 | Option | Type | Description | Default |
 |--------|------|-------------|---------|
 | **`paths`** | `List` | Root directories or files to analyze. | **Required** |
-| **`extensions`** | `List` | File extensions to include (e.g., `[".py", ".js"]`). | **Required** |
+| **`extensions`** | `List` | File extensions and exact filenames (e.g., `[".py", "Dockerfile"]`). | **Required** |
 | **`output`** | `str` | Name of the generated Markdown file. | `"codebase.md"` |
-| **`exclude_patterns`** | `List` | Patterns to ignore (e.g., `"tests"`, `"build/"`). | `[]` |
+| **`exclude_patterns`** | `List` | Patterns to ignore (e.g., `"tests"`, `"*.log"`, `"build/"`). | `[]` |
 | **`recursive`** | `bool` | Whether to traverse subdirectories. | `true` |
 | **`include_readmes`** | `bool` | Automatically include `README.md` for folder context. | `true` |
 | **`max_file_size_mb`** | `float` | Size limit before a file is truncated or skipped. | `10.0` |
-| **`truncate_large_files`** | `bool` | **(v4.1)** If true, cuts large files instead of skipping them. | `true` |
-| **`truncation_limit_lines`** | `int` | **(v4.1)** Number of lines to keep when truncating. | `500` |
+| **`truncate_large_files`** | `bool` | If true, cuts large files instead of skipping them. | `true` |
+| **`truncation_limit_lines`** | `int` | Number of lines to keep when truncating. | `500` |
 
 ---
 
@@ -151,7 +219,7 @@ from code_assembler import assemble_codebase
 # Configure and execute
 markdown_content = assemble_codebase(
     paths=["./src"],
-    extensions=[".py"],
+    extensions=[".py", "Dockerfile"],
     output="ai_docs.md",
     truncate_large_files=True,
     truncation_limit_lines=200,
@@ -163,95 +231,40 @@ print(f"Generated context: {len(markdown_content)} characters.")
 
 ---
 
-## 🧙‍♂️ Interactive Mode (New!)
-
-**Don't want to remember CLI arguments?** Use the interactive wizard!
-
-```bash
-code-assembler --interactive
-# or
-code-assembler -i
-```
-
-The wizard will guide you through:
-1. 📂 **Path selection** - Choose directories or specific files
-2. 📝 **Extension presets** - Python, JS/TS, Rust, Go, Java, C/C++, or custom
-3. 🚫 **Smart exclusions** - Use defaults or add custom patterns
-4. 💾 **Output config** - Name your file, auto-detect conflicts
-5. ⚙️ **Advanced options** - Truncation, recursion, README inclusion
-
-**Example session:**
-```
-🚀 Code Assembler Pro - Interactive Mode
-═════════════════════════════════════════════════════
-
-🎯 Step 1: Select Paths to Analyze
-──────────────────────────────────────────────────────
-You can analyze:
-  1. Current directory (.)
-  2. Specific directory/directories
-  3. Specific files
-
-Your choice [1-3]: 1
-✅ Selected: current directory
-
-🎯 Step 2: Select File Extensions
-──────────────────────────────────────────────────────
-Common presets:
-  1. Python projects (.py)
-  2. Python + Config + Docs (.py, .md, .toml, .yaml)
-  3. JavaScript/TypeScript (.js, .ts, .jsx, .tsx)
-  ...
-
-Your choice [1-8]: 2
-✅ Selected: Python + Config + Docs
-
-... [wizard continues]
-
-🎯 Configuration Summary
-──────────────────────────────────────────────────────
-📂 Paths: .
-📝 Extensions: .py, .md, .toml, .yaml
-💾 Output: codebase.md
-🔧 Recursive: True
-✂️  Truncate large files: True (keep first 500 lines)
-
-🚀 Start assembly? [Y/n]: y
-
-💾 Save this configuration for future use? [y/N]: y
-✅ Configuration saved to: assembler_config.json
-   Reuse it with: code-assembler --config assembler_config.json
-```
-
-👉 **[Full Interactive Mode Guide](INTERACTIVE_MODE.md)**
-
----
-
 ## 💡 Recommended Use Cases
 
 ### 1. Onboarding & Audit
 > *"Analyze this codebase and summarize the architecture, then list potential technical debt."*
-👉 Provide the generated `codebase.md` to Claude/GPT-4.
 
 ### 2. Massive Refactoring
 > *"I want to migrate this module from `requests` to `httpx`. Here is the relevant code. Propose a migration plan."*
-👉 Target specific folders to reduce noise and stay within token limits.
 
 ### 3. Complex Debugging
 > *"I have a circular import error between these three files. Find the root cause and fix it."*
-👉 The tool preserves import structures, making it easy for the AI to trace dependencies.
+
+### 4. Infrastructure as Code
+> *"Review my Docker + Kubernetes setup and suggest improvements."*
+Include `Dockerfile`, `.yml`, `.env.j2` in your extensions.
 
 ---
 
 ## 🤝 Contributing
 
-Contributions are welcome! 
+Contributions are welcome!
 1. Fork the Project.
 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.
 
+### Development Setup
+```bash
+git clone https://github.com/xmehaut/code-assembler-pro.git
+cd code-assembler-pro
+pip install -e ".[dev]"
+pytest tests/ -v
+```
+
 ---
 
 ## 📄 License