onepaste 1.3.0__tar.gz

onepaste-1.3.0/.github/workflows/publish.yml

@@ -0,0 +1,37 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+jobs:
+  build-and-publish:
+    runs-on: ubuntu-latest
+    # Must match the "environment" name configured in the PyPI Trusted Publisher
+    environment: pypi
+    permissions:
+      id-token: write  # OIDC trusted publishing — no API token stored
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build deps
+        run: python -m pip install --upgrade build twine
+
+      - name: Run tests
+        run: |
+          python -m pip install -e '.[dev]'
+          python -m pytest -q
+
+      - name: Build distributions
+        run: python -m build
+
+      - name: Twine check
+        run: twine check dist/*
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

onepaste-1.3.0/.gitignore

@@ -0,0 +1,315 @@
+# ============================================
+# CodeCollector - .gitignore
+# ============================================
+
+# --- Python ---
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# pipenv
+Pipfile.lock
+
+# poetry
+poetry.lock
+
+# pdm
+.pdm-build/
+.pdm.toml
+
+# PEP 582
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# ruff
+.ruff_cache/
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# --- IDE ---
+# PyCharm
+.idea/
+
+# VS Code
+.vscode/
+*.code-workspace
+
+# Eclipse
+.project
+.classpath
+.settings/
+
+# NetBeans
+nbproject/
+nbbuild/
+nbdist/
+
+# Sublime Text
+*.sublime-project
+*.sublime-workspace
+
+# Atom
+.atom/
+
+# Vim
+*.swp
+*.swo
+*~
+.*.swp
+.*.swo
+
+# Emacs
+*~
+\#*\#
+.\#*
+
+# --- OS ---
+# macOS
+.DS_Store
+.AppleDouble
+.LSOverride
+Icon
+._*
+.DocumentRevisions-V100
+.fseventsd
+.Spotlight-V100
+.TemporaryItems
+.Trashes
+.VolumeIcon.icns
+.com.apple.timemachine.donotpresent
+
+# Linux
+*~
+.directory
+.Trash-*
+
+# Windows
+Thumbs.db
+Thumbs.db:encryptable
+ehthumbs.db
+ehthumbs_vista.db
+*.stackdump
+[Dd]esktop.ini
+$RECYCLE.BIN/
+*.cab
+*.msi
+*.msix
+*.msm
+*.msp
+*.lnk
+
+# --- Project Specific ---
+# 输出文件（可以根据需要调整）
+code_collection.txt
+code_collection.md
+code_collection*.txt
+code_collection*.md
+code_collection*.manifest.json
+*.collection.txt
+*.collection.md
+output/
+collected_code/
+
+# 临时文件
+tmp/
+temp/
+*.tmp
+*.temp
+
+# 备份文件
+*.bak
+*.backup
+*.old
+
+# 压缩文件
+*.zip
+*.tar.gz
+*.rar
+*.7z
+
+# 配置文件（保留示例）
+config.local.json
+*.local.cfg
+
+# 日志文件
+*.log
+logs/
+
+# --- Environment ---
+# Conda
+.conda/
+conda/
+Miniconda*/
+Anaconda*/
+
+# NPM (如果项目中有前端部分)
+node_modules/
+package-lock.json
+yarn.lock
+.npm
+.npmrc
+
+# --- Docker ---
+# (如果将来添加 Docker 支持)
+.docker/
+docker-compose.override.yml
+
+# --- Documentation ---
+# 生成的文档
+site/
+docs/_build/
+
+# --- Security ---
+# 私钥和证书
+*.pem
+*.key
+*.crt
+*.p12
+*.pfx
+
+# 密码文件
+credentials.json
+secrets.json
+.env.local
+.env.production
+
+# --- Website ---
+website/node_modules/
+website/dist/
+
+# --- Misc ---
+# CodeCollector 自身的输出
+codecollection.txt
+collected_*.txt
+!collected_example.txt
+
+# 测试输出
+test_output/
+test_results/
+
+# 性能分析
+*.prof
+*.lprof
+
+# 数据库
+*.db
+*.sqlite
+*.sqlite3

onepaste-1.3.0/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.

onepaste-1.3.0/PKG-INFO

@@ -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/PUBLISHING.md

@@ -0,0 +1,41 @@
+# Publishing to PyPI
+
+Package name: **onepaste** (import name stays `codecollector`, command stays `collect`).
+
+## One-time setup (manual first release)
+
+1. Register at <https://pypi.org/account/register/> and verify your email.
+2. Create an API token: <https://pypi.org/manage/account/token/>
+   - Scope: "Entire account" (project-scoped tokens become available after the first upload).
+3. Upload the built artifacts:
+
+   ```bash
+   .venv/bin/twine upload dist/*
+   # Username: __token__
+   # Password: pypi-... (paste your token)
+   ```
+
+4. Verify from a clean environment:
+
+   ```bash
+   pipx install onepaste
+   collect --version   # CodeCollector v1.3.0
+   ```
+
+## Subsequent releases (GitHub Actions, zero tokens)
+
+Uses PyPI Trusted Publishing (OIDC) — no secrets stored in GitHub.
+
+1. On PyPI: your project → *Settings* → *Publishing* → add a **Trusted Publisher**:
+   - Owner: `emVisible`  Repo: `CodeCollector`
+   - Workflow filename: `publish.yml`
+   - Environment name: `pypi`
+2. Release: create a GitHub *Release* (or run the workflow manually via `workflow_dispatch`).
+
+The workflow runs tests, builds, twine-checks, then publishes.
+
+## Bump a version
+
+1. `pyproject.toml` → `version`
+2. `codecollector/__init__.py` → `__version__` (a test enforces both match)
+3. Commit + GitHub Release with tag `vX.Y.Z`