combicode 1.0.0__tar.gz

combicode-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 A. Aurelions
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

combicode-1.0.0/PKG-INFO

@@ -0,0 +1,137 @@
+Metadata-Version: 2.4
+Name: combicode
+Version: 1.0.0
+Summary: A CLI tool to combine a project's codebase into a single file for LLM context.
+Author: A. Aurelions
+License: MIT License
+        
+        Copyright (c) 2025 A. Aurelions
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/aaurelions/combicode
+Project-URL: Bug Tracker, https://github.com/aaurelions/combicode/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Utilities
+Classifier: Environment :: Console
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.0
+Requires-Dist: pathspec>=0.9
+Dynamic: license-file
+
+# Combicode
+
+[![NPM Version](https://img.shields.io/npm/v/combicode.svg)](https://www.npmjs.com/package/combicode)
+[![PyPI Version](https://img.shields.io/pypi/v/combicode.svg)](https://pypi.org/project/combicode/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+<img align="center" src="https://github.com/aaurelions/combicode/raw/main/screenshot.png" width="600"/>
+
+**Combicode** is a zero-dependency CLI tool that intelligently combines your project's source code into a single, LLM-friendly text file.
+
+Paste the contents of `combicode.txt` into ChatGPT, Claude, or any other LLM to give it the full context of your repository instantly.
+
+## Why use Combicode?
+
+- **Maximum Context:** Give your LLM a complete picture of your project structure and code.
+- **Intelligent Ignoring:** Automatically skips `node_modules`, `.venv`, `dist`, `.git`, binary files, and other common junk.
+- **`.gitignore` Aware:** Respects your project's existing `.gitignore` rules out of the box.
+- **Zero-Install Usage:** Run it directly with `npx` or `pipx` without polluting your environment.
+- **Customizable:** Easily filter by file extension or add custom ignore patterns.
+
+## Quick Start
+
+Navigate to your project's root directory in your terminal and run one of the following commands:
+
+#### For Node.js/JavaScript/TypeScript projects (via `npx`):
+
+```bash
+npx combicode
+```
+
+#### For Python projects (or general use, via `pipx`):
+
+```bash
+pipx run combicode
+```
+
+This will create a `combicode.txt` file in your project directory.
+
+## Usage and Options
+
+### Preview which files will be included
+
+Use the `--dry-run` or `-d` flag to see a list of files without creating the output file.
+
+```bash
+# npx
+npx combicode --dry-run
+
+# pipx
+pipx run combicode -d
+```
+
+### Specify an output file
+
+Use the `--output` or `-o` flag.
+
+```bash
+npx combicode -o my_project_context.md
+```
+
+### Include only specific file types
+
+Use the `--include-ext` or `-i` flag with a comma-separated list of extensions.
+
+```bash
+# Include only TypeScript, TSX, and CSS files
+npx combicode -i .ts,.tsx,.css
+
+# Include only Python and YAML files
+pipx run combicode -i .py,.yaml
+```
+
+### Add custom exclude patterns
+
+Use the `--exclude` or `-e` flag with comma-separated glob patterns.
+
+```bash
+# Exclude all test files and anything in a 'docs' folder
+npx combicode -e "**/*_test.py,docs/**"
+```
+
+## All CLI Options
+
+| Option           | Alias | Description                                                  | Default         |
+| ---------------- | ----- | ------------------------------------------------------------ | --------------- |
+| `--output`       | `-o`  | The name of the output file.                                 | `combicode.txt` |
+| `--dry-run`      | `-d`  | Preview files without creating the output file.              | `false`         |
+| `--include-ext`  | `-i`  | Comma-separated list of extensions to exclusively include.   | (include all)   |
+| `--exclude`      | `-e`  | Comma-separated list of additional glob patterns to exclude. | (none)          |
+| `--no-gitignore` |       | Do not use patterns from the project's `.gitignore` file.    | `false`         |
+| `--version`      | `-v`  | Show the version number.                                     |                 |
+| `--help`         | `-h`  | Show the help message.                                       |                 |
+
+## License
+
+This project is licensed under the MIT License.

combicode-1.0.0/README.md

@@ -0,0 +1,96 @@
+# Combicode
+
+[![NPM Version](https://img.shields.io/npm/v/combicode.svg)](https://www.npmjs.com/package/combicode)
+[![PyPI Version](https://img.shields.io/pypi/v/combicode.svg)](https://pypi.org/project/combicode/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+<img align="center" src="https://github.com/aaurelions/combicode/raw/main/screenshot.png" width="600"/>
+
+**Combicode** is a zero-dependency CLI tool that intelligently combines your project's source code into a single, LLM-friendly text file.
+
+Paste the contents of `combicode.txt` into ChatGPT, Claude, or any other LLM to give it the full context of your repository instantly.
+
+## Why use Combicode?
+
+- **Maximum Context:** Give your LLM a complete picture of your project structure and code.
+- **Intelligent Ignoring:** Automatically skips `node_modules`, `.venv`, `dist`, `.git`, binary files, and other common junk.
+- **`.gitignore` Aware:** Respects your project's existing `.gitignore` rules out of the box.
+- **Zero-Install Usage:** Run it directly with `npx` or `pipx` without polluting your environment.
+- **Customizable:** Easily filter by file extension or add custom ignore patterns.
+
+## Quick Start
+
+Navigate to your project's root directory in your terminal and run one of the following commands:
+
+#### For Node.js/JavaScript/TypeScript projects (via `npx`):
+
+```bash
+npx combicode
+```
+
+#### For Python projects (or general use, via `pipx`):
+
+```bash
+pipx run combicode
+```
+
+This will create a `combicode.txt` file in your project directory.
+
+## Usage and Options
+
+### Preview which files will be included
+
+Use the `--dry-run` or `-d` flag to see a list of files without creating the output file.
+
+```bash
+# npx
+npx combicode --dry-run
+
+# pipx
+pipx run combicode -d
+```
+
+### Specify an output file
+
+Use the `--output` or `-o` flag.
+
+```bash
+npx combicode -o my_project_context.md
+```
+
+### Include only specific file types
+
+Use the `--include-ext` or `-i` flag with a comma-separated list of extensions.
+
+```bash
+# Include only TypeScript, TSX, and CSS files
+npx combicode -i .ts,.tsx,.css
+
+# Include only Python and YAML files
+pipx run combicode -i .py,.yaml
+```
+
+### Add custom exclude patterns
+
+Use the `--exclude` or `-e` flag with comma-separated glob patterns.
+
+```bash
+# Exclude all test files and anything in a 'docs' folder
+npx combicode -e "**/*_test.py,docs/**"
+```
+
+## All CLI Options
+
+| Option           | Alias | Description                                                  | Default         |
+| ---------------- | ----- | ------------------------------------------------------------ | --------------- |
+| `--output`       | `-o`  | The name of the output file.                                 | `combicode.txt` |
+| `--dry-run`      | `-d`  | Preview files without creating the output file.              | `false`         |
+| `--include-ext`  | `-i`  | Comma-separated list of extensions to exclusively include.   | (include all)   |
+| `--exclude`      | `-e`  | Comma-separated list of additional glob patterns to exclude. | (none)          |
+| `--no-gitignore` |       | Do not use patterns from the project's `.gitignore` file.    | `false`         |
+| `--version`      | `-v`  | Show the version number.                                     |                 |
+| `--help`         | `-h`  | Show the help message.                                       |                 |
+
+## License
+
+This project is licensed under the MIT License.

combicode-1.0.0/combicode/__init__.py

@@ -0,0 +1 @@
+__version__ = "1.0.0" 

combicode-1.0.0/combicode/main.py

@@ -0,0 +1,101 @@
+import os
+import sys
+from pathlib import Path
+import click
+import pathspec
+from importlib import metadata
+
+DEFAULT_IGNORE_PATTERNS = [
+    ".git/", ".vscode/", ".idea/", "*.log", ".env", "*.lock",
+    ".venv/", "venv/", "env/", "__pycache__/", "*.pyc", "*.egg-info/", "build/", "dist/", ".pytest_cache/",
+    "node_modules/", ".npm/", "pnpm-lock.yaml", "package-lock.json", ".next/",
+    ".DS_Store", "Thumbs.db",
+    "*.png", "*.jpg", "*.jpeg", "*.gif", "*.ico", "*.svg", "*.webp",
+    "*.mp3", "*.wav", "*.flac",
+    "*.mp4", "*.mov", "*.avi",
+    "*.zip", "*.tar.gz", "*.rar",
+    "*.pdf", "*.doc", "*.docx", "*.xls", "*.xlsx",
+    "*.dll", "*.exe", "*.so", "*.a", "*.lib", "*.o",
+    "*.bin", "*.iso",
+]
+
+def is_likely_binary(path: Path) -> bool:
+    try:
+        with path.open('rb') as f:
+            return b'\0' in f.read(1024)
+    except IOError:
+        return True
+
+@click.command(context_settings=dict(help_option_names=['-h', '--help']))
+@click.option("-o", "--output", default="combicode.txt", help="The name of the output file.", show_default=True)
+@click.option("-d", "--dry-run", is_flag=True, help="Preview files without creating the output file.")
+@click.option("-i", "--include-ext", help="Comma-separated list of extensions to exclusively include (e.g., .py,.js).")
+@click.option("-e", "--exclude", help="Comma-separated list of additional glob patterns to exclude.")
+@click.option("--no-gitignore", is_flag=True, help="Do not use patterns from the project's .gitignore file.")
+@click.version_option(version=metadata.version("combicode"), prog_name="Combicode")
+def cli(output, dry_run, include_ext, exclude, no_gitignore):
+    """Combicode combines your project's code into a single file for LLM context."""
+    project_root = Path.cwd()
+    click.echo(f"✨ Running Combicode in: {project_root}")
+
+    all_ignore_patterns = DEFAULT_IGNORE_PATTERNS.copy()
+    if not no_gitignore:
+        gitignore_path = project_root / ".gitignore"
+        if gitignore_path.exists():
+            click.echo("🔎 Found and using .gitignore")
+            with gitignore_path.open("r", encoding='utf-8') as f:
+                all_ignore_patterns.extend(line for line in f.read().splitlines() if line and not line.startswith('#'))
+    
+    if exclude:
+        all_ignore_patterns.extend(exclude.split(','))
+
+    spec = pathspec.PathSpec.from_lines(pathspec.patterns.GitWildMatchPattern, all_ignore_patterns)
+
+    all_paths = project_root.rglob("*")
+    
+    included_files = []
+    allowed_extensions = {f".{ext.strip('.')}" for ext in include_ext.split(',')} if include_ext else None
+
+    for path in all_paths:
+        if not path.is_file():
+            continue
+        relative_path_str = str(path.relative_to(project_root))
+        if spec.match_file(relative_path_str) or is_likely_binary(path):
+            continue
+        if allowed_extensions and path.suffix not in allowed_extensions:
+            continue
+        included_files.append(path)
+
+    if not included_files:
+        click.echo("❌ No files to include. Check your path or filters.", err=True)
+        sys.exit(1)
+
+    # Sort files for deterministic output
+    sorted_files = sorted(included_files)
+
+    if dry_run:
+        click.echo("\n📋 Files to be included (Dry Run):")
+        for path in sorted_files:
+            click.echo(f"  - {path.relative_to(project_root).as_posix()}")
+        click.echo(f"\nTotal: {len(sorted_files)} files.")
+        return
+
+    try:
+        with open(output, "w", encoding="utf-8", errors='replace') as outfile:
+            for path in sorted_files:
+                relative_path = path.relative_to(project_root).as_posix()
+                outfile.write(f"// FILE: {relative_path}\n")
+                outfile.write("```\n")
+                try:
+                    content = path.read_text(encoding="utf-8")
+                    outfile.write(content)
+                except Exception as e:
+                    outfile.write(f"... (error reading file: {e}) ...")
+                outfile.write("\n```\n\n")
+        click.echo(f"\n✅ Success! Combined {len(sorted_files)} files into '{output}'.")
+    except IOError as e:
+        click.echo(f"\n❌ Error writing to output file: {e}", err=True)
+        sys.exit(1)
+
+if __name__ == "__main__":
+    cli() 

combicode-1.0.0/combicode.egg-info/PKG-INFO

@@ -0,0 +1,137 @@
+Metadata-Version: 2.4
+Name: combicode
+Version: 1.0.0
+Summary: A CLI tool to combine a project's codebase into a single file for LLM context.
+Author: A. Aurelions
+License: MIT License
+        
+        Copyright (c) 2025 A. Aurelions
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/aaurelions/combicode
+Project-URL: Bug Tracker, https://github.com/aaurelions/combicode/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Utilities
+Classifier: Environment :: Console
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.0
+Requires-Dist: pathspec>=0.9
+Dynamic: license-file
+
+# Combicode
+
+[![NPM Version](https://img.shields.io/npm/v/combicode.svg)](https://www.npmjs.com/package/combicode)
+[![PyPI Version](https://img.shields.io/pypi/v/combicode.svg)](https://pypi.org/project/combicode/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+<img align="center" src="https://github.com/aaurelions/combicode/raw/main/screenshot.png" width="600"/>
+
+**Combicode** is a zero-dependency CLI tool that intelligently combines your project's source code into a single, LLM-friendly text file.
+
+Paste the contents of `combicode.txt` into ChatGPT, Claude, or any other LLM to give it the full context of your repository instantly.
+
+## Why use Combicode?
+
+- **Maximum Context:** Give your LLM a complete picture of your project structure and code.
+- **Intelligent Ignoring:** Automatically skips `node_modules`, `.venv`, `dist`, `.git`, binary files, and other common junk.
+- **`.gitignore` Aware:** Respects your project's existing `.gitignore` rules out of the box.
+- **Zero-Install Usage:** Run it directly with `npx` or `pipx` without polluting your environment.
+- **Customizable:** Easily filter by file extension or add custom ignore patterns.
+
+## Quick Start
+
+Navigate to your project's root directory in your terminal and run one of the following commands:
+
+#### For Node.js/JavaScript/TypeScript projects (via `npx`):
+
+```bash
+npx combicode
+```
+
+#### For Python projects (or general use, via `pipx`):
+
+```bash
+pipx run combicode
+```
+
+This will create a `combicode.txt` file in your project directory.
+
+## Usage and Options
+
+### Preview which files will be included
+
+Use the `--dry-run` or `-d` flag to see a list of files without creating the output file.
+
+```bash
+# npx
+npx combicode --dry-run
+
+# pipx
+pipx run combicode -d
+```
+
+### Specify an output file
+
+Use the `--output` or `-o` flag.
+
+```bash
+npx combicode -o my_project_context.md
+```
+
+### Include only specific file types
+
+Use the `--include-ext` or `-i` flag with a comma-separated list of extensions.
+
+```bash
+# Include only TypeScript, TSX, and CSS files
+npx combicode -i .ts,.tsx,.css
+
+# Include only Python and YAML files
+pipx run combicode -i .py,.yaml
+```
+
+### Add custom exclude patterns
+
+Use the `--exclude` or `-e` flag with comma-separated glob patterns.
+
+```bash
+# Exclude all test files and anything in a 'docs' folder
+npx combicode -e "**/*_test.py,docs/**"
+```
+
+## All CLI Options
+
+| Option           | Alias | Description                                                  | Default         |
+| ---------------- | ----- | ------------------------------------------------------------ | --------------- |
+| `--output`       | `-o`  | The name of the output file.                                 | `combicode.txt` |
+| `--dry-run`      | `-d`  | Preview files without creating the output file.              | `false`         |
+| `--include-ext`  | `-i`  | Comma-separated list of extensions to exclusively include.   | (include all)   |
+| `--exclude`      | `-e`  | Comma-separated list of additional glob patterns to exclude. | (none)          |
+| `--no-gitignore` |       | Do not use patterns from the project's `.gitignore` file.    | `false`         |
+| `--version`      | `-v`  | Show the version number.                                     |                 |
+| `--help`         | `-h`  | Show the help message.                                       |                 |
+
+## License
+
+This project is licensed under the MIT License.

combicode-1.0.0/combicode.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+LICENSE
+README.md
+pyproject.toml
+combicode/__init__.py
+combicode/main.py
+combicode.egg-info/PKG-INFO
+combicode.egg-info/SOURCES.txt
+combicode.egg-info/dependency_links.txt
+combicode.egg-info/entry_points.txt
+combicode.egg-info/requires.txt
+combicode.egg-info/top_level.txt

combicode-1.0.0/combicode.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

combicode-1.0.0/combicode.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+combicode = combicode.main:cli

combicode-1.0.0/combicode.egg-info/requires.txt

@@ -0,0 +1,2 @@
+click>=8.0
+pathspec>=0.9

combicode-1.0.0/combicode.egg-info/top_level.txt

@@ -0,0 +1 @@
+combicode

combicode-1.0.0/pyproject.toml

@@ -0,0 +1,30 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "combicode"
+dynamic = ["version"]
+authors = [{ name = "A. Aurelions" }]
+description = "A CLI tool to combine a project's codebase into a single file for LLM context."
+readme = "README.md"
+license = { file = "LICENSE" }
+requires-python = ">=3.8"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Topic :: Utilities",
+    "Environment :: Console",
+]
+dependencies = ["click>=8.0", "pathspec>=0.9"]
+
+[project.urls]
+Homepage = "https://github.com/aaurelions/combicode"
+"Bug Tracker" = "https://github.com/aaurelions/combicode/issues"
+
+[project.scripts]
+combicode = "combicode.main:cli"
+
+[tool.setuptools.dynamic]
+version = { attr = "combicode.__version__" }

combicode-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+