langfuse-cli 0.1.0__tar.gz

langfuse_cli-0.1.0/.github/CODEOWNERS

@@ -0,0 +1,2 @@
+# Default owners for all files
+* @aviadshiber

langfuse_cli-0.1.0/.github/ISSUE_TEMPLATE/bug-report.md

@@ -0,0 +1,42 @@
+---
+name: Bug Report
+about: Report a bug in langfuse-cli
+title: ""
+labels: bug
+assignees: ""
+---
+
+## Describe the bug
+
+A clear and concise description of what the bug is.
+
+## To reproduce
+
+Steps to reproduce the behavior:
+
+```bash
+lf <command> <flags>
+```
+
+## Expected behavior
+
+What you expected to happen.
+
+## Actual behavior
+
+What actually happened. Include the full error output if applicable:
+
+```
+<paste output here>
+```
+
+## Environment
+
+- **langfuse-cli version**: (`lf --version`)
+- **Python version**: (`python --version`)
+- **OS**: (e.g., macOS 14.2, Ubuntu 22.04)
+- **Install method**: (uv, pip, homebrew, source)
+
+## Additional context
+
+Add any other context about the problem here.

langfuse_cli-0.1.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Security Vulnerability
+    url: https://github.com/aviadshiber/langfuse-cli/blob/master/.github/SECURITY.md
+    about: Report security vulnerabilities privately via the security policy
+  - name: Langfuse Platform Issues
+    url: https://github.com/langfuse/langfuse/issues
+    about: For issues with the Langfuse platform itself (not this CLI tool)

langfuse_cli-0.1.0/.github/ISSUE_TEMPLATE/feature-request.md

@@ -0,0 +1,28 @@
+---
+name: Feature Request
+about: Suggest a new feature or improvement
+title: ""
+labels: enhancement
+assignees: ""
+---
+
+## Problem
+
+A clear description of the problem you're trying to solve. Example: "I want to be able to ..."
+
+## Proposed solution
+
+Describe how you'd like this to work:
+
+```bash
+# Example CLI usage
+lf <command> <new-flags>
+```
+
+## Alternatives considered
+
+Any alternative solutions or features you've considered.
+
+## Additional context
+
+Add any other context, mockups, or references here.

langfuse_cli-0.1.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,17 @@
+## What
+
+Brief description of the change.
+
+## Why
+
+Why is this change needed? Link to any related issues.
+
+Closes #
+
+## Checklist
+
+- [ ] Tests added/updated
+- [ ] `uv run ruff check src/ tests/` passes
+- [ ] `uv run mypy src/` passes
+- [ ] `uv run pytest` passes
+- [ ] Documentation updated (if applicable)

langfuse_cli-0.1.0/.github/SECURITY.md

@@ -0,0 +1,24 @@
+# Security Policy
+
+## Reporting a Vulnerability
+
+If you discover a security vulnerability in langfuse-cli, please report it responsibly.
+
+**Email**: [aviadshiber@gmail.com](mailto:aviadshiber@gmail.com)
+
+Please include:
+- Description of the vulnerability
+- Steps to reproduce
+- Potential impact
+
+You will receive an acknowledgment within 48 hours and a detailed response within 7 days.
+
+## Supported Versions
+
+| Version | Supported |
+|---------|-----------|
+| Latest  | Yes       |
+
+## Scope
+
+This policy covers the `langfuse-cli` tool itself. For vulnerabilities in the Langfuse platform, please report to [Langfuse](https://langfuse.com).

langfuse_cli-0.1.0/.github/dependabot.yml

@@ -0,0 +1,21 @@
+version: 2
+updates:
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    commit-message:
+      prefix: "deps"
+    labels:
+      - "dependencies"
+    open-pull-requests-limit: 10
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    commit-message:
+      prefix: "ci"
+    labels:
+      - "ci"
+    open-pull-requests-limit: 5

langfuse_cli-0.1.0/.github/release-drafter.yml

@@ -0,0 +1,45 @@
+name-template: "v$RESOLVED_VERSION"
+tag-template: "v$RESOLVED_VERSION"
+categories:
+  - title: "New Features"
+    labels:
+      - "enhancement"
+      - "feature"
+  - title: "Bug Fixes"
+    labels:
+      - "bug"
+      - "fix"
+  - title: "Dependencies"
+    labels:
+      - "dependencies"
+  - title: "Documentation"
+    labels:
+      - "documentation"
+  - title: "CI/CD"
+    labels:
+      - "ci"
+  - title: "Other Changes"
+    labels:
+      - "*"
+change-template: "- $TITLE @$AUTHOR (#$NUMBER)"
+change-title-escapes: '\<*_&'
+version-resolver:
+  major:
+    labels:
+      - "breaking"
+  minor:
+    labels:
+      - "enhancement"
+      - "feature"
+  patch:
+    labels:
+      - "bug"
+      - "fix"
+      - "dependencies"
+  default: patch
+template: |
+  ## Changes
+
+  $CHANGES
+
+  **Full Changelog**: https://github.com/$OWNER/$REPOSITORY/compare/$PREVIOUS_TAG...v$RESOLVED_VERSION

langfuse_cli-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,30 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  id-token: write
+  contents: read
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build dependencies
+        run: pip install build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

langfuse_cli-0.1.0/.github/workflows/release-drafter.yml

@@ -0,0 +1,19 @@
+name: Release Drafter
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+    types: [opened, reopened, synchronize]
+
+permissions:
+  contents: read
+  pull-requests: write
+
+jobs:
+  update-release-draft:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: release-drafter/release-drafter@v6
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

langfuse_cli-0.1.0/.github/workflows/stale.yml

@@ -0,0 +1,31 @@
+name: Stale Issues
+
+on:
+  schedule:
+    - cron: "0 6 * * 1"
+
+permissions:
+  issues: write
+  pull-requests: write
+
+jobs:
+  stale:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/stale@v9
+        with:
+          stale-issue-message: >
+            This issue has been automatically marked as stale because it has not
+            had recent activity. It will be closed in 14 days if no further
+            activity occurs. If this issue is still relevant, please comment
+            to keep it open.
+          stale-pr-message: >
+            This PR has been automatically marked as stale because it has not
+            had recent activity. It will be closed in 14 days if no further
+            activity occurs.
+          days-before-stale: 60
+          days-before-close: 14
+          stale-issue-label: "stale"
+          stale-pr-label: "stale"
+          exempt-issue-labels: "pinned,security"
+          exempt-pr-labels: "pinned"

langfuse_cli-0.1.0/.github/workflows/test.yml

@@ -0,0 +1,37 @@
+name: Test
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+    branches: [master]
+
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, macos-latest]
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Install dependencies
+        run: uv sync
+
+      - name: Lint
+        run: uv run ruff check src/ tests/
+
+      - name: Type check
+        run: uv run mypy src/
+
+      - name: Test
+        run: uv run pytest -q

langfuse_cli-0.1.0/.github/workflows/update-homebrew.yml

@@ -0,0 +1,63 @@
+name: Update Homebrew Formula
+
+on:
+  workflow_run:
+    workflows: ["Publish to PyPI"]
+    types: [completed]
+
+jobs:
+  update-formula:
+    runs-on: ubuntu-latest
+    if: ${{ github.event.workflow_run.conclusion == 'success' }}
+    steps:
+      - name: Get release version
+        id: version
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          VERSION=$(gh api "repos/${{ github.repository }}/releases/latest" --jq .tag_name)
+          echo "version=${VERSION#v}" >> "$GITHUB_OUTPUT"
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Wait for PyPI availability
+        env:
+          PKG_VERSION: ${{ steps.version.outputs.version }}
+        run: |
+          for i in $(seq 1 30); do
+            if pip index versions langfuse-cli 2>/dev/null | grep -q "$PKG_VERSION"; then
+              echo "langfuse-cli==$PKG_VERSION available on PyPI"
+              break
+            fi
+            echo "Waiting for PyPI... attempt $i/30"
+            sleep 20
+          done
+
+      - name: Generate formula with poet
+        env:
+          PKG_VERSION: ${{ steps.version.outputs.version }}
+        run: |
+          pip install "langfuse-cli==$PKG_VERSION" homebrew-pypi-poet
+          poet -f langfuse-cli > langfuse-cli.rb
+
+      - name: Checkout tap repo
+        uses: actions/checkout@v4
+        with:
+          repository: aviadshiber/homebrew-tap
+          token: ${{ secrets.TAP_GITHUB_TOKEN }}
+          path: homebrew-tap
+
+      - name: Update formula
+        env:
+          PKG_VERSION: ${{ steps.version.outputs.version }}
+        run: |
+          cp langfuse-cli.rb homebrew-tap/Formula/langfuse-cli.rb
+          cd homebrew-tap
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add Formula/langfuse-cli.rb
+          git diff --cached --quiet || git commit -m "Update langfuse-cli to $PKG_VERSION"
+          git push

langfuse_cli-0.1.0/.gitignore

@@ -0,0 +1,19 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+.eggs/
+.venv/
+.uv/
+.mypy_cache/
+.ruff_cache/
+.pytest_cache/
+htmlcov/
+.coverage
+*.egg
+*.zip
+
+# Claude Code
+.claude/

langfuse_cli-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,79 @@
+# Contributing to langfuse-cli
+
+Thanks for your interest in contributing! This guide will help you get started.
+
+## Development Setup
+
+### Prerequisites
+
+- Python 3.10+
+- [uv](https://docs.astral.sh/uv/) (recommended) or pip
+
+### Getting Started
+
+```bash
+# Fork and clone the repository
+git clone https://github.com/<your-username>/langfuse-cli.git
+cd langfuse-cli
+
+# Install dependencies
+uv sync
+
+# Run tests
+uv run pytest
+
+# Run linter
+uv run ruff check src/ tests/
+
+# Run type checker
+uv run mypy src/
+```
+
+## Making Changes
+
+1. **Create a branch** from `master`:
+   ```bash
+   git checkout -b feat/my-feature
+   ```
+
+2. **Write your code** following existing patterns:
+   - CLI commands go in `src/langfuse_cli/commands/`
+   - Formatters go in `src/langfuse_cli/formatters/`
+   - Follow [gh-ux patterns](https://cli.github.com/manual/) for CLI design
+
+3. **Add tests** for any new functionality:
+   - Tests live in `tests/`
+   - Use `pytest` with `respx` for HTTP mocking
+   - Aim for high coverage (current: 96%+)
+
+4. **Ensure all checks pass**:
+   ```bash
+   uv run ruff check src/ tests/
+   uv run mypy src/
+   uv run pytest
+   ```
+
+## Pull Request Guidelines
+
+- Keep PRs focused on a single change
+- Write a clear description of what and why
+- Reference any related issues
+- All CI checks must pass
+- A maintainer review is required before merge
+
+## Code Style
+
+- Formatter and linter: [Ruff](https://docs.astral.sh/ruff/)
+- Max line length: 120 characters
+- Type annotations required for all public functions (`mypy --strict`)
+- Use `from __future__ import annotations` in all files
+
+## Reporting Issues
+
+- **Bugs**: Use the [bug report template](https://github.com/aviadshiber/langfuse-cli/issues/new?template=bug-report.md)
+- **Features**: Use the [feature request template](https://github.com/aviadshiber/langfuse-cli/issues/new?template=feature-request.md)
+- **Security**: See [SECURITY.md](.github/SECURITY.md)
+
+## License
+
+By contributing, you agree that your contributions will be licensed under the [MIT License](LICENSE).

langfuse_cli-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Aviad S.
+
+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.