loopflow 0.1.0__tar.gz

loopflow-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Loopflow Studio
+
+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.

loopflow-0.1.0/PKG-INFO

@@ -0,0 +1,154 @@
+Metadata-Version: 2.4
+Name: loopflow
+Version: 0.1.0
+Summary: Arrange LLMs to code in harmony
+Author-email: Jack Heart <jack@loopflow.studio>
+License: MIT
+Project-URL: Homepage, https://github.com/loopflowstudio/loopflow
+Project-URL: Repository, https://github.com/loopflowstudio/loopflow
+Project-URL: Issues, https://github.com/loopflowstudio/loopflow/issues
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typer>=0.9.0
+Requires-Dist: tiktoken>=0.9.0
+Provides-Extra: dev
+Requires-Dist: pytest>=9.0.0; extra == "dev"
+Dynamic: license-file
+
+# lfcp
+
+A tool for copying codebase context to clipboard for LLM interactions.
+
+## Overview
+
+lfcp gathers files into context for LLM queries, building on e.g. `files-to-prompt`.
+
+## Features
+
+- **Smart Context Gathering**: Automatically includes parent README files up to git root
+- **Gitignore Integration**: Respects `.gitignore` and `.cpignore` patterns
+- **Extension Filtering**: Focus on specific file types with `-e` flags
+- **Token Profiling**: Analyze token usage with detailed breakdowns and interactive flamegraphs
+
+## Installation
+
+```bash
+pip install lf
+```
+
+Or install from source:
+
+```bash
+git clone https://github.com/loopflowstudio/loopflow.git
+cd loopflow
+uv venv
+uv pip install -e .
+```
+
+
+## Usage
+
+### Basic Usage
+
+Copy the current directory to clipboard:
+
+```bash
+lfcp .
+```
+
+### Common Workflows
+
+Copy specific directories:
+```bash
+lfcp src/ tests/
+```
+
+Copy only Python files:
+```bash
+lfcp . -e py
+```
+
+Copy multiple file types:
+```bash
+lfcp . -e py -e js -e tsx
+```
+
+Output to stdout instead of clipboard:
+```bash
+lfcp . -s
+```
+
+Copy only README files (great for project overview):
+```bash
+lfcp . -r
+```
+
+Ignore specific directories:
+```bash
+lfcp . -i build -i dist
+```
+
+### Token Profiling
+
+Analyze token usage across your codebase:
+
+```bash
+lfcp . --profile
+```
+
+Generate an interactive flamegraph visualization:
+
+```bash
+lfcp . --flamegraph
+```
+
+The flamegraph will be saved as `token_flamegraph.html` and can be opened in any browser.
+
+### Advanced Options
+
+```
+Options:
+  -e, --extensions TEXT        Filter by file extension (e.g., -e py -e js)
+  -r, --readmes               Only include README files
+  -s, --stdout                Output to stdout instead of clipboard
+  -i, --ignore TEXT           Additional ignore patterns (can be used multiple times)
+  --profile                   Show detailed token usage statistics
+  --flamegraph               Generate interactive HTML flamegraph visualization
+  --help                      Show help message
+```
+
+## How It Works
+
+1. **Discovery**: Walks through specified directories, respecting gitignore rules
+2. **Context Addition**: Automatically includes parent README files for better context
+3. **Filtering**: Applies extension filters and ignore patterns
+4. **Formatting**: Structures files in XML format with clear source attribution
+5. **Output**: Copies to clipboard or outputs to stdout based on your preference
+
+## File Format
+
+```xml
+<documents>
+<document index="1">
+<source>path/to/file.py</source>
+<document_content>
+# Your file content here
+</document_content>
+</document>
+</documents>
+```
+
+## Gitignore Support
+
+lf respects both `.gitignore` and `.cpignore` files. You can create a `.cpignore` in your project root to specify additional patterns to ignore when gathering code context:
+
+```
+# Example .cpignore
+*.pyc
+__pycache__/
+node_modules/
+*.egg-info
+build/
+dist/
+```

loopflow-0.1.0/README.md

@@ -0,0 +1,136 @@
+# lfcp
+
+A tool for copying codebase context to clipboard for LLM interactions.
+
+## Overview
+
+lfcp gathers files into context for LLM queries, building on e.g. `files-to-prompt`.
+
+## Features
+
+- **Smart Context Gathering**: Automatically includes parent README files up to git root
+- **Gitignore Integration**: Respects `.gitignore` and `.cpignore` patterns
+- **Extension Filtering**: Focus on specific file types with `-e` flags
+- **Token Profiling**: Analyze token usage with detailed breakdowns and interactive flamegraphs
+
+## Installation
+
+```bash
+pip install lf
+```
+
+Or install from source:
+
+```bash
+git clone https://github.com/loopflowstudio/loopflow.git
+cd loopflow
+uv venv
+uv pip install -e .
+```
+
+
+## Usage
+
+### Basic Usage
+
+Copy the current directory to clipboard:
+
+```bash
+lfcp .
+```
+
+### Common Workflows
+
+Copy specific directories:
+```bash
+lfcp src/ tests/
+```
+
+Copy only Python files:
+```bash
+lfcp . -e py
+```
+
+Copy multiple file types:
+```bash
+lfcp . -e py -e js -e tsx
+```
+
+Output to stdout instead of clipboard:
+```bash
+lfcp . -s
+```
+
+Copy only README files (great for project overview):
+```bash
+lfcp . -r
+```
+
+Ignore specific directories:
+```bash
+lfcp . -i build -i dist
+```
+
+### Token Profiling
+
+Analyze token usage across your codebase:
+
+```bash
+lfcp . --profile
+```
+
+Generate an interactive flamegraph visualization:
+
+```bash
+lfcp . --flamegraph
+```
+
+The flamegraph will be saved as `token_flamegraph.html` and can be opened in any browser.
+
+### Advanced Options
+
+```
+Options:
+  -e, --extensions TEXT        Filter by file extension (e.g., -e py -e js)
+  -r, --readmes               Only include README files
+  -s, --stdout                Output to stdout instead of clipboard
+  -i, --ignore TEXT           Additional ignore patterns (can be used multiple times)
+  --profile                   Show detailed token usage statistics
+  --flamegraph               Generate interactive HTML flamegraph visualization
+  --help                      Show help message
+```
+
+## How It Works
+
+1. **Discovery**: Walks through specified directories, respecting gitignore rules
+2. **Context Addition**: Automatically includes parent README files for better context
+3. **Filtering**: Applies extension filters and ignore patterns
+4. **Formatting**: Structures files in XML format with clear source attribution
+5. **Output**: Copies to clipboard or outputs to stdout based on your preference
+
+## File Format
+
+```xml
+<documents>
+<document index="1">
+<source>path/to/file.py</source>
+<document_content>
+# Your file content here
+</document_content>
+</document>
+</documents>
+```
+
+## Gitignore Support
+
+lf respects both `.gitignore` and `.cpignore` files. You can create a `.cpignore` in your project root to specify additional patterns to ignore when gathering code context:
+
+```
+# Example .cpignore
+*.pyc
+__pycache__/
+node_modules/
+*.egg-info
+build/
+dist/
+```

loopflow-0.1.0/pyproject.toml

@@ -0,0 +1,44 @@
+[build-system]
+requires = ["setuptools==80.9.0", "wheel==0.45.1"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "loopflow"
+version = "0.1.0"
+description = "Arrange LLMs to code in harmony"
+readme = "README.md"
+requires-python = ">=3.12"
+dependencies = ["typer>=0.9.0", "tiktoken>=0.9.0"]
+license = {text = "MIT"}
+authors = [
+    {name = "Jack Heart", email = "jack@loopflow.studio"}
+]
+keywords = []
+classifiers = []
+
+[project.urls]
+Homepage = "https://github.com/loopflowstudio/loopflow"
+Repository = "https://github.com/loopflowstudio/loopflow"
+Issues = "https://github.com/loopflowstudio/loopflow/issues"
+
+[project.optional-dependencies]
+dev = ["pytest>=9.0.0"]
+
+[project.scripts]
+lf = "lf.cli:app"
+lfcp = "lf.cp.cli:app"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["lf", "lf.*"]
+
+[tool.pytest.ini_options]
+pythonpath = ["src"]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_functions = ["test_*"]
+python_classes = ["Test*"]
+
+[tool.coverage.run]
+source = ["lf"]
+

loopflow-0.1.0/setup.cfg

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

loopflow-0.1.0/src/lf/cli.py

@@ -0,0 +1,36 @@
+"""Main CLI entry point for lf."""
+
+import sys
+
+import typer
+
+app = typer.Typer(
+    name="lf",
+    help="loopflow - arrange LLMs to code in harmony",
+    no_args_is_help=True,
+)
+
+from lf.cp.cli import app as cp_app
+
+@app.command()
+def cp(ctx: typer.Context):
+    """Arrange codebase context for LLM interactions (alias for lfcp).
+
+    This command is an alias that invokes lfcp with the same arguments.
+    All arguments after 'cp' are passed directly to lfcp.
+    """
+    # Import here to avoid circular dependencies
+    # Get all remaining arguments from sys.argv
+    # Find the index of 'cp' and pass everything after it
+    try:
+        cp_index = sys.argv.index('cp')
+        remaining_args = sys.argv[cp_index + 1:]
+    except ValueError:
+        remaining_args = []
+
+    # Invoke the clip app with remaining arguments
+    cp_app(remaining_args, standalone_mode=False)
+
+
+if __name__ == "__main__":
+    app()

loopflow-0.1.0/src/lf/cp/__init__.py

@@ -0,0 +1 @@
+"""cp - Copy codebase context to clipboard for LLM interactions."""