onepaste 1.3.0__py3-none-any.whl

onepaste-1.3.0.dist-info/METADATA

@@ -0,0 +1,241 @@
+Metadata-Version: 2.5
+Name: onepaste
+Version: 1.3.0
+Summary: Collect project code files into a single output for AI assistants
+Project-URL: Homepage, https://github.com/emVisible/codecollector
+Project-URL: Repository, https://github.com/emVisible/codecollector.git
+Project-URL: Issues, https://github.com/emVisible/codecollector/issues
+Author: emVisible
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai,cli,code,collector,context,developer-tools,llm,prompt
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+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 :: Utilities
+Requires-Python: >=3.8
+Requires-Dist: questionary>=2.0.0
+Requires-Dist: rich>=13.0.0
+Provides-Extra: dev
+Requires-Dist: black>=23.0; extra == 'dev'
+Requires-Dist: mypy>=1.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Requires-Dist: tiktoken>=0.5; extra == 'dev'
+Provides-Extra: tokens
+Requires-Dist: tiktoken>=0.5; extra == 'tokens'
+Description-Content-Type: text/markdown
+
+# CodeCollector
+
+Collect project code into LLM-ready Markdown. Select a directory, press Enter, copy and paste.
+
+## Installation
+
+### pipx (recommended)
+
+```bash
+brew install pipx
+pipx ensurepath
+pipx install onepaste
+
+# Optional: exact token counting via tiktoken
+pipx install "onepaste[tokens]"
+```
+
+Without the `tokens` extra, token counts use a fast characters/4 estimate.
+
+### From source (for development)
+
+```bash
+git clone https://github.com/emVisible/codecollector.git
+cd codecollector
+pipx install -e .
+```
+
+### Uninstall / reinstall (for updates & debugging)
+
+```bash
+# Uninstall package
+collect --uninstall
+
+# Uninstall and remove ~/.config/codecollector
+collect --uninstall --purge-config
+
+# Reinstall editable from local source
+cd /path/to/CodeCollector
+pipx install -e .
+```
+
+## Quick Start
+
+```bash
+# Interactive: navigate to folder → select "Collect this directory" → Enter
+collect
+
+# Collect current directory (.gitignore filtering on automatically inside git repos)
+collect .
+
+# Pipe straight into another tool — no file written
+collect . --stdout | llm "Explain what this project does"
+
+# Only TypeScript sources, skip tests
+collect . --include "src/**/*.ts" --exclude-pattern "*.test.ts"
+```
+
+Output is a single Markdown file (`code_collection.md`) ready to copy-paste into any LLM.
+
+## Usage
+
+```bash
+# Interactive mode
+collect
+collect -i                    # force .gitignore filter (deprecated: auto inside git)
+
+# Collect a specific directory
+collect /path/to/project
+collect . --no-gitignore      # include gitignored files too
+
+# Non-recursive (current directory only)
+collect . -n
+
+# Custom output
+collect . -o my_project.md
+collect . -d ./collected
+
+# Glob filtering (repeatable)
+collect . --include "src/**"
+collect . --include "*.py" --include "*.md"
+collect . --exclude-pattern "*.min.js" --exclude-pattern "tests/*"
+
+# Split large output (default: 2MB per part)
+collect . --max-output-size 5
+
+# Preview without writing
+collect . --dry-run
+
+# Extra exclusions
+collect . --exclude vendor --exclude tmp
+```
+
+## Options
+
+| Option                       | Description                                                                        |
+| ---------------------------- | ---------------------------------------------------------------------------------- |
+| `path`                       | Directory to collect (default: interactive picker)                                 |
+| `-i`                         | Force-enable `.gitignore` filtering (deprecated alias; see below)                  |
+| `--no-gitignore`             | Disable `.gitignore` filtering                                                     |
+| `-n, --non-recursive`        | Only current directory, skip subdirectories                                        |
+| `-o, --output`               | Output filename (default: `code_collection.md`)                                    |
+| `-d, --output-dir`           | Output directory (default: current working directory)                              |
+| `--max-output-size MB`       | Max output size per file; auto-split when exceeded (default: 2)                    |
+| `--exclude DIR`              | Extra directory to exclude (repeatable)                                            |
+| `--include GLOB`             | Only collect files matching glob (repeatable; overrides extension whitelist)       |
+| `--exclude-pattern GLOB`     | Skip files matching glob (repeatable)                                              |
+| `--stdout`                   | Write collection to stdout; progress goes to stderr; no file written               |
+| `--dry-run`                  | Preview collection without writing output                                          |
+| `--force`                    | Overwrite existing output instead of auto-incrementing                             |
+| `--config`                   | Path to config file (merged with global config)                                    |
+| `--init-config`              | Generate default config at `~/.config/codecollector/config.json`                   |
+| `--uninstall`                | Uninstall codecollector via pipx and/or pip                                        |
+| `--purge-config`             | Also remove `~/.config/codecollector` (with `--uninstall`)                         |
+| `-v, --version`              | Show version                                                                       |
+| `-h, --help`                 | Show help                                                                          |
+
+### .gitignore defaults
+
+Inside a git work tree, `.gitignore` filtering is **on by default**. Outside git repos it is off.
+Explicit flags win over the default: `-i` forces it on, `--no-gitignore` forces it off.
+(`-i` used to be required to enable filtering; it still works but the default has changed.)
+
+### Glob patterns
+
+`--include` / `--exclude-pattern` match against paths relative to the collected root using
+[fnmatch](https://docs.python.org/3/library/fnmatch.html) semantics:
+
+| Pattern          | Matches                                             |
+| ---------------- | --------------------------------------------------- |
+| `*.py`           | any `.py` file anywhere                             |
+| `src/**`         | everything under `src/`                             |
+| `tests/*`        | files directly inside `tests/`                      |
+| `*_test.go`      | Go test files anywhere                              |
+
+When `--include` patterns are given they **replace** the extension whitelist — you get exactly
+the matched files (still respecting excludes, size limits and binary detection).
+
+### Token counting
+
+Summaries show total tokens plus per-file counts, with a Top-10 table of the largest files.
+With the optional `tokens` extra installed, counts are exact (`tiktoken`, `o200k_base`);
+otherwise an estimate (~4 chars/token) is shown and labelled as such.
+
+## Output Format
+
+All output is **detailed Markdown** optimized for LLM consumption:
+
+- Summary with metadata, token totals, top files by tokens, directory tree, and file list
+- Each source file as a `###` heading with line count, size, tokens, and a fenced code block
+  (fences auto-lengthen so source containing backticks never breaks rendering)
+- Auto-split into parts for large projects, each with `Part X of N` header
+
+## Output Behavior
+
+### Auto-increment (no overwrite)
+
+If `code_collection.md` already exists, the next run writes to `code_collection_1.md`, then `_2.md`, etc.
+
+Use `--force` to overwrite.
+
+### Auto-split
+
+When output exceeds the size limit, files are split at source-file boundaries. A manifest JSON is written alongside multi-part output.
+
+`--stdout` never splits; it warns on stderr if the limit would have been exceeded.
+It also requires an explicit `path` — the interactive picker would otherwise mix its
+own output into the piped stream.
+
+## Configuration
+
+```bash
+collect --init-config
+```
+
+Edit `~/.config/codecollector/config.json`:
+
+```json
+{
+  "exclude_dirs": [
+    "node_modules",
+    ".git",
+    "__pycache__",
+    "venv",
+    "dist",
+    "build"
+  ],
+  "include_extensions": [".py", ".js", ".ts", ".go", ".rs", ".java"],
+  "include_patterns": [],
+  "exclude_patterns": [],
+  "max_file_size_mb": 5.0,
+  "max_output_size_mb": 2.0,
+  "auto_increment_output": true,
+  "write_manifest": true
+}
+```
+
+`.gitignore` filtering is intentionally not stored in the config file — it resolves
+automatically per run (on inside git work trees) unless overridden by `-i` or
+`--no-gitignore`.
+
+## Requirements
+
+- Python 3.8+
+- pipx (for installation)

onepaste-1.3.0.dist-info/RECORD

@@ -0,0 +1,17 @@
+codecollector/__init__.py,sha256=DRtzgke5Y6Q3e2WYXjns38g2PQ4eMI9vENa0122fuFo,294
+codecollector/__main__.py,sha256=0-xhMaaMJ6PJN8eMH8EsnJQ8-dPGr9KwtgicQ7iol7g,116
+codecollector/cli.py,sha256=uzvUEySPxHqvSz9JoUgGXXH73QFfNdmTyzrbvEuJthE,20937
+codecollector/collector.py,sha256=mslgqRt6rPfxWsVA19XfAxUSAd46-IEYO-UsEU9n6QM,8744
+codecollector/config.py,sha256=_nQZ08VEcz29bHF362LErihUpuW_vmrY0aUShlkuXjI,5271
+codecollector/formatter.py,sha256=iwMBcY4K79n7fG5bFTFScFthPjNwNsn-4cRK7VLsK-0,6723
+codecollector/gitignore.py,sha256=6gn8-6zns12k4oNf79Ztpf5k2u5lpQFUQOLZBO8bQws,5078
+codecollector/output.py,sha256=wVFl2zwDN7CueLN2T4pVgqxludl_8_3aLKNKU5t42F0,1811
+codecollector/selector.py,sha256=bxRjihH23VCDegG7qvt7qqvSCKTIqqVSNDprUxBgC6U,3974
+codecollector/splitter.py,sha256=G_ULLZZMfGSawyDpNjQ8dufQiVKdDzaf0hIEk-Gms8c,4062
+codecollector/tokens.py,sha256=o4MYi4Hnq4w24PV9yRXccqg-cWpJlsQZiM4inWyAapk,1651
+codecollector/uninstall.py,sha256=PG9taITRtuQvJRPBYl2GgTuz2PtPHaFgLtDaoncMCYg,3415
+onepaste-1.3.0.dist-info/METADATA,sha256=zbF2MNi_OfW1LiXSd-b-ABMMgL66EtpxOsm-ExNUly8,9104
+onepaste-1.3.0.dist-info/WHEEL,sha256=zOwg4jB6zX2kU910N-cMawjivD6tO8NEWvE12je1bVk,87
+onepaste-1.3.0.dist-info/entry_points.txt,sha256=1tXkvu6rGR7aGcqvTal7w0DDIFzIxYVMRFnJ2mGCWmc,51
+onepaste-1.3.0.dist-info/licenses/LICENSE,sha256=5pK0Vz4RfP3iXLaF1qsqpHD8-r4JzMnIG1qNLJUI5bs,1066
+onepaste-1.3.0.dist-info/RECORD,,

onepaste-1.3.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.32.0
+Root-Is-Purelib: true
+Tag: py3-none-any

onepaste-1.3.0.dist-info/entry_points.txt

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

onepaste-1.3.0.dist-info/licenses/LICENSE

@@ -0,0 +1,22 @@
+
+MIT License
+
+Copyright (c) 2024 Your Name
+
+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.