oh-markdown-tool 0.1.0__tar.gz

oh_markdown_tool-0.1.0/.github/OPENHANDS_REVIEW.md

@@ -0,0 +1,108 @@
+# OpenHands Automated PR Review
+
+This repository uses [OpenHands](https://github.com/All-Hands-AI/OpenHands) for automated pull request reviews.
+
+## How It Works
+
+The OpenHands bot automatically reviews pull requests when:
+
+1. **A new PR is opened** (non-draft)
+2. **A draft PR is marked as ready for review**
+3. **The `review-this` label is added** to any PR
+4. **OpenHands is requested as a reviewer** (`openhands-agent` or `all-hands-bot`)
+
+## Review Triggers
+
+### Automatic Review
+New non-draft PRs are automatically reviewed when opened.
+
+### Manual Trigger Options
+
+**Option 1: Add the label**
+```bash
+gh pr edit <PR_NUMBER> --add-label "review-this"
+```
+
+**Option 2: Request OpenHands as reviewer**
+```bash
+gh pr edit <PR_NUMBER> --add-reviewer openhands-agent
+```
+
+**Option 3: Mark draft as ready**
+If you have a draft PR, marking it as "Ready for review" will trigger the review.
+
+### Re-trigger a Review
+
+To re-run the review after making changes:
+
+1. Remove and re-add the `review-this` label:
+   ```bash
+   gh pr edit <PR_NUMBER> --remove-label "review-this"
+   gh pr edit <PR_NUMBER> --add-label "review-this"
+   ```
+
+2. Or close and re-request the reviewer.
+
+## Review Style
+
+The bot provides **roasted** feedback 🔥 - critical and direct - focusing on:
+- Code quality and best practices
+- Potential bugs or issues
+- What's wrong and how to fix it
+- Documentation completeness
+- Test coverage
+
+Expect honest, no-nonsense reviews that get straight to the point.
+
+## Configuration
+
+### LLM Model
+Currently using: `anthropic/claude-sonnet-4-20250514`
+
+To use a different model, edit `.github/workflows/pr-review-by-openhands.yml`:
+```yaml
+with:
+  llm-model: openai/gpt-4  # or any supported model
+  review-style: roasted # or constructive, concise, detailed
+```
+
+### Review Styles
+- `roasted` - Critical, direct feedback 🔥 (default)
+- `constructive` - Balanced, helpful feedback
+- `concise` - Brief, to-the-point reviews
+- `detailed` - Comprehensive, thorough reviews
+
+### Custom LLM Endpoint
+
+If you want to use a custom LLM endpoint or proxy:
+
+1. Add the secret to your repository:
+   - Go to Settings → Secrets and variables → Actions
+   - Add `LLM_API_KEY` with your API key
+
+2. Update the workflow to use it:
+   ```yaml
+   with:
+     llm-model: litellm_proxy/your-model
+     llm-base-url: https://your-llm-proxy.com
+     llm-api-key: ${{ secrets.LLM_API_KEY }}
+   ```
+
+## Limitations
+
+- Only reviews PRs from the same repository (not forks, for security)
+- Skips draft PRs unless explicitly triggered
+- One review per PR event (use concurrency control)
+
+## Disabling Reviews
+
+To temporarily disable automated reviews:
+
+1. **For a specific PR**: Keep it as a draft until ready
+2. **For the repository**: Disable the workflow in Settings → Actions
+
+## Learn More
+
+- [OpenHands Documentation](https://docs.openhands.dev)
+- [PR Review Plugin](https://github.com/OpenHands/extensions/tree/main/plugins/pr-review)
+- [OpenHands on GitHub](https://github.com/All-Hands-AI/OpenHands)

oh_markdown_tool-0.1.0/.github/dependabot.yml

@@ -0,0 +1,30 @@
+version: 2
+updates:
+  # GitHub Actions dependencies
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    labels:
+      - "dependencies"
+      - "github-actions"
+
+  # Python dependencies
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    labels:
+      - "dependencies"
+      - "python"
+    groups:
+      # Group OpenHands SDK updates together
+      openhands:
+        patterns:
+          - "openhands-*"
+      # Group dev dependencies together
+      dev-dependencies:
+        patterns:
+          - "pytest*"
+          - "ruff"
+          - "coverage"

oh_markdown_tool-0.1.0/.github/pull_request_template.md

@@ -0,0 +1,34 @@
+## Description
+
+<!-- Provide a brief description of the changes in this PR -->
+
+## Type of Change
+
+- [ ] Bug fix (non-breaking change which fixes an issue)
+- [ ] New feature (non-breaking change which adds functionality)
+- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
+- [ ] Documentation update
+- [ ] Code quality improvement (refactoring, style, etc.)
+
+## Testing
+
+<!-- Describe the tests you ran to verify your changes -->
+
+- [ ] Tests pass locally (`make test`)
+- [ ] Added new tests for changes
+- [ ] Updated existing tests if needed
+
+## Checklist
+
+- [ ] My code follows the style guidelines of this project (`make lint` passes)
+- [ ] I have performed a self-review of my code
+- [ ] I have commented my code, particularly in hard-to-understand areas
+- [ ] I have made corresponding changes to the documentation
+- [ ] My changes generate no new warnings
+- [ ] Any dependent changes have been merged and published
+
+## Related Issues
+
+<!-- Link any related issues here using #issue-number -->
+
+Closes #

oh_markdown_tool-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,103 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          version: "latest"
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Create virtual environment
+        run: uv venv
+
+      - name: Install dependencies
+        run: uv pip install -e ".[dev]"
+
+      - name: Run ruff linter
+        run: uv run ruff check src tests
+
+      - name: Run ruff formatter check
+        run: uv run ruff format --check src tests
+
+  test:
+    name: Test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          version: "latest"
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Create virtual environment
+        run: uv venv
+
+      - name: Install dependencies
+        run: uv pip install -e ".[dev]"
+
+      - name: Run tests with coverage
+        run: |
+          uv run pytest tests \
+            --cov=oh_markdown_tool \
+            --cov-report=term-missing \
+            --cov-report=html:htmlcov \
+            --cov-report=xml \
+            --cov-fail-under=80 \
+            -v
+
+      - name: Upload coverage HTML report
+        uses: actions/upload-artifact@v7
+        with:
+          name: coverage-report
+          path: htmlcov/
+          retention-days: 14
+
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v7
+        with:
+          files: ./coverage.xml
+          flags: unittests
+          name: codecov-umbrella
+          fail_ci_if_error: false
+
+      - name: Coverage Summary
+        run: |
+          echo "## Coverage Report" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          uv run coverage report --format=markdown >> $GITHUB_STEP_SUMMARY
+
+  all-checks:
+    name: All Checks Passed
+    runs-on: ubuntu-latest
+    needs: [lint, test]
+    if: always()
+    steps:
+      - name: Check all jobs passed
+        run: |
+          if [[ "${{ needs.lint.result }}" != "success" ]] || \
+             [[ "${{ needs.test.result }}" != "success" ]]; then
+            echo "One or more jobs failed"
+            exit 1
+          fi
+          echo "All checks passed! ✅"

oh_markdown_tool-0.1.0/.github/workflows/pr-review-by-openhands.yml

@@ -0,0 +1,42 @@
+---
+name: PR Review by OpenHands
+
+on:
+  pull_request:
+    types: [opened, ready_for_review, labeled, review_requested]
+
+permissions:
+  contents: read
+  pull-requests: write
+  issues: write
+
+jobs:
+  pr-review:
+    # Skip fork PRs (no access to secrets), draft PRs, and Release Please PRs
+    if: |
+      github.event.pull_request.head.repo.full_name == github.repository &&
+      github.event.pull_request.user.login != 'github-actions[bot]' &&
+      !startsWith(github.event.pull_request.head.ref, 'release-please--') &&
+      (
+        (github.event.action == 'opened' && github.event.pull_request.draft == false) ||
+        github.event.action == 'ready_for_review' ||
+        (github.event.action == 'labeled' && github.event.label.name == 'review-this') ||
+        (
+          github.event.action == 'review_requested' &&
+          (
+            github.event.requested_reviewer.login == 'openhands-agent' ||
+            github.event.requested_reviewer.login == 'all-hands-bot'
+          )
+        )
+      )
+    concurrency:
+      group: pr-review-${{ github.event.pull_request.number }}
+      cancel-in-progress: true
+    runs-on: ubuntu-24.04
+    steps:
+      - name: Run PR Review
+        uses: OpenHands/extensions/plugins/pr-review@main
+        with:
+          llm-model: anthropic/claude-sonnet-4-20250514
+          review-style: roasted
+          github-token: ${{ secrets.GITHUB_TOKEN }}

oh_markdown_tool-0.1.0/.github/workflows/release-please.yml

@@ -0,0 +1,31 @@
+name: Release Please
+
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  release-please:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: googleapis/release-please-action@v4
+        id: release
+        with:
+          release-type: python
+          package-name: oh-markdown-tool
+          
+      # Output release information for debugging
+      - name: Release info
+        if: steps.release.outputs.release_created
+        run: |
+          echo "Release created: ${{ steps.release.outputs.release_created }}"
+          echo "Tag name: ${{ steps.release.outputs.tag_name }}"
+          echo "Version: ${{ steps.release.outputs.version }}"
+          echo "Major: ${{ steps.release.outputs.major }}"
+          echo "Minor: ${{ steps.release.outputs.minor }}"
+          echo "Patch: ${{ steps.release.outputs.patch }}"

oh_markdown_tool-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,85 @@
+name: Release
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  build:
+    name: Build Distribution
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          version: "latest"
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Build package
+        run: uv build
+
+      - name: Store the distribution packages
+        uses: actions/upload-artifact@v7
+        with:
+          name: python-package-distributions
+          path: dist/
+
+  publish-to-pypi:
+    name: Publish to PyPI
+    needs: [build]
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/oh-markdown-tool
+    permissions:
+      id-token: write
+
+    steps:
+      - name: Download all the dists
+        uses: actions/download-artifact@v8
+        with:
+          name: python-package-distributions
+          path: dist/
+
+      - name: Publish distribution to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+  github-release:
+    name: Create GitHub Release
+    needs: [publish-to-pypi]
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      id-token: write
+
+    steps:
+      - name: Download all the dists
+        uses: actions/download-artifact@v8
+        with:
+          name: python-package-distributions
+          path: dist/
+
+      - name: Create GitHub Release
+        env:
+          GITHUB_TOKEN: ${{ github.token }}
+        run: >-
+          gh release create
+          '${{ github.ref_name }}'
+          --repo '${{ github.repository }}'
+          --notes "Release ${{ github.ref_name }}"
+
+      - name: Upload artifact signatures to GitHub Release
+        env:
+          GITHUB_TOKEN: ${{ github.token }}
+        run: >-
+          gh release upload
+          '${{ github.ref_name }}' dist/**
+          --repo '${{ github.repository }}'

oh_markdown_tool-0.1.0/.gitignore

@@ -0,0 +1,80 @@
+# 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/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Virtual environments
+venv/
+env/
+ENV/
+env.bak/
+venv.bak/
+.venv/
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Ruff
+.ruff_cache/
+
+# uv
+.uv/
+uv.lock

oh_markdown_tool-0.1.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.1.0"
+}

oh_markdown_tool-0.1.0/CHANGELOG.md

@@ -0,0 +1,27 @@
+# Changelog
+
+## 0.1.0 (2026-07-06)
+
+
+### Features
+
+* Add automated PR review with OpenHands ([60b5dd0](https://github.com/jpshackelford/oh-markdown-tool/commit/60b5dd0ee8c6fd9556a3b7d7c77854ab22f6fc5f))
+* add automated release workflow with Release Please ([e55618e](https://github.com/jpshackelford/oh-markdown-tool/commit/e55618e23d5165812c6c39e7554c1d181fd71659))
+
+
+### Bug Fixes
+
+* exclude Release Please PRs from automated code review ([8187966](https://github.com/jpshackelford/oh-markdown-tool/commit/8187966941b961527e6197aa6f832ad3a96ae9c9))
+* Update codecov action parameter from 'file' to 'files' ([8df1c85](https://github.com/jpshackelford/oh-markdown-tool/commit/8df1c85aed11b5e03cc3d19791c5463f4eb1ff1e))
+* Use --system flag for uv commands in CI ([#7](https://github.com/jpshackelford/oh-markdown-tool/issues/7)) ([5384527](https://github.com/jpshackelford/oh-markdown-tool/commit/53845273e1485acdf1899424db81821f3b272717))
+
+## 0.1.0 (Initial Release)
+
+### Features
+
+* Initial release of oh-markdown-tool
+* Structural editing and formatting for markdown documents
+* Table of contents generation
+* Heading numbering
+* Document parsing and operations
+* Integration with OpenHands SDK