mcp-stata 1.2.2__tar.gz → 1.7.7__tar.gz

mcp_stata-1.7.7/.codex/skills/mcp-stata/SKILL.md

@@ -0,0 +1 @@
+../../../skill/SKILL.md

mcp_stata-1.7.7/.github/workflows/build-test.yml

@@ -0,0 +1,88 @@
+name: Build Integration Tests
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main ]
+  workflow_dispatch:  # Allow manual trigger
+
+jobs:
+  build-test:
+    name: Test Build & Installation
+    # runs-on: ${{ matrix.os }}
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        # os: [ubuntu-latest, macos-latest, windows-latest]
+        os: [ubuntu-latest]
+        python-version: ["3.12"]
+      fail-fast: false
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0  # Fetch all history including tags
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install build dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install build pytest pytest-cov packaging
+
+      - name: Install package dependencies
+        run: |
+          pip install -e .[dev]
+        timeout-minutes: 5
+
+      - name: Run all tests that don't require Stata
+        run: |
+          # Run all tests except those marked as requiring Stata
+          # This includes discovery, parsing, and build integration tests
+          pytest -v -m "not requires_stata"
+        timeout-minutes: 15
+        continue-on-error: false
+
+      - name: Build package
+        run: |
+          python -m build
+        timeout-minutes: 5
+
+      - name: Test installation in clean environment
+        shell: bash
+        run: |
+          # Create fresh venv
+          python -m venv test_venv
+
+          # Activate and install
+          if [[ "$RUNNER_OS" == "Windows" ]]; then
+            source test_venv/Scripts/activate
+          else
+            source test_venv/bin/activate
+          fi
+
+          # Install built wheel
+          pip install dist/*.whl
+
+          # Test critical imports
+          python -c "from mcp_stata.server import main; print('[OK] Import successful')"
+
+          # Verify entry point
+          which mcp-stata || where mcp-stata
+          echo "[OK] Entry point installed"
+        timeout-minutes: 10
+
+      - name: Upload build artifacts
+        if: failure()
+        uses: actions/upload-artifact@v4
+        with:
+          name: build-artifacts-${{ matrix.os }}-py${{ matrix.python-version }}
+          path: |
+            dist/
+            *.log
+          retention-days: 7

{mcp_stata-1.2.2 → mcp_stata-1.7.7}/.github/workflows/version-sync.yml

@@ -22,7 +22,7 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v5
         with:
-          python-version: "3.11"
+          python-version: "3.12"
 
       - name: Install hatch
         run: pip install --upgrade pip hatch

{mcp_stata-1.2.2 → mcp_stata-1.7.7}/.gitignore

@@ -10,4 +10,9 @@ py.typed
 /ideas
 .cursor
 .vscode
-.gemini
+.gemini
+.claude
+.coverage
+test_external_do_file_full.py
+mcp.json
+scripts/test.do

mcp_stata-1.7.7/CONTRIBUTING.md

@@ -0,0 +1,217 @@
+# Contributing to mcp-stata
+
+Thank you for your interest in contributing to mcp-stata! This guide will help you set up your development environment, run tests, and understand the project structure.
+
+## Table of Contents
+
+- [Development Setup](#development-setup)
+- [Building the Package](#building-the-package)
+- [Testing](#testing)
+- [Submitting Changes](#submitting-changes)
+
+## Development Setup
+
+### Prerequisites
+
+- **Stata 17+** (required for integration tests)
+- **Python 3.12+**
+- **uv** (recommended) or pip
+
+### Installation
+
+1. Clone the repository:
+```bash
+git clone https://github.com/tmonk/mcp-stata.git
+cd mcp-stata
+```
+
+2. Install dependencies with uv:
+```bash
+# Install main dependencies
+uv sync --no-install-project
+
+# Install with development dependencies
+uv sync --extra dev --no-install-project
+```
+
+Or with pip:
+```bash
+pip install -e .[dev]
+```
+
+3. Set up Stata path (if auto-discovery doesn't work):
+```bash
+# macOS
+export STATA_PATH="/Applications/StataNow/StataMP.app/Contents/MacOS/stata-mp"
+
+# Windows
+set STATA_PATH="C:\Program Files\Stata18\StataMP-64.exe"
+```
+
+## Building the Package
+
+### Local Build
+
+Build the package locally to test distribution:
+
+```bash
+python -m build
+```
+
+This creates wheel (`.whl`) and source distribution (`.tar.gz`) files in the `dist/` directory.
+
+### Build Integration Tests
+
+We have comprehensive build integration tests to catch dependency issues before release:
+
+```bash
+# Run all build integration tests
+pytest tests/test_build_integration.py -v -m slow
+
+# Or use the convenience script
+./scripts/test_build.sh
+```
+
+These tests:
+- Build the package from source
+- Install in a clean virtual environment
+- Verify all critical imports work
+- Check that entry points are installed correctly
+- Catch dependency compatibility issues (like the httpx 0.28 incident)
+
+## Testing
+
+### Test Organization
+
+Tests are organized with pytest markers:
+
+- **`requires_stata`**: Tests that need Stata installed (integration, server, token efficiency tests)
+- **`slow`**: Long-running tests (build integration tests)
+- **`integration`**: Integration tests requiring external resources
+
+### Running Tests
+
+#### All Tests (requires Stata)
+
+```bash
+pytest
+```
+
+#### Tests Without Stata
+
+Run all tests that don't require Stata (useful for CI or systems without Stata):
+
+```bash
+pytest -v -m "not requires_stata"
+```
+
+This runs:
+- Discovery tests (finding Stata installations)
+- SMCL/help parsing tests
+- Build integration tests
+
+### Test Coverage
+
+Generate a coverage report:
+
+```bash
+pytest --cov=mcp_stata --cov-report=html
+open htmlcov/index.html  # View the report
+```
+
+### Writing Tests
+
+When adding new tests:
+
+1. **Mark Stata-dependent tests**:
+```python
+import pytest
+
+# At module level for all tests
+pytestmark = pytest.mark.requires_stata
+
+# Or for individual tests
+@pytest.mark.requires_stata
+def test_my_stata_feature():
+    pass
+```
+
+2. **Mark slow tests**:
+```python
+@pytest.mark.slow
+def test_expensive_operation():
+    pass
+```
+
+3. **Platform-specific tests**:
+```python
+import sys
+pytestmark = pytest.mark.skipif(sys.platform != "win32", reason="Windows only")
+```
+
+### Dependency Management
+
+- Dependencies are managed in `pyproject.toml`
+- Lock file: `uv.lock`
+
+When adding dependencies:
+
+1. Add to `pyproject.toml`
+2. Run `uv lock` to update lock file
+3. Add build integration tests if the dependency is critical
+
+## Submitting Changes
+
+### Pull Request Process
+
+1. **Create a feature branch**:
+```bash
+git checkout -b feature/my-feature
+```
+
+2. **Make your changes** and add tests
+
+3. **Run the full test suite**:
+```bash
+# With Stata
+pytest
+
+# Without Stata (as CI does)
+pytest -v -m "not requires_stata"
+```
+
+4. **Run build integration tests**:
+```bash
+./scripts/test_build.sh
+```
+
+5. **Commit with clear messages**:
+```bash
+git commit -m "Add feature: description of change"
+```
+
+6. **Push and create a pull request**:
+```bash
+git push origin feature/my-feature
+```
+
+### CI/CD
+
+GitHub Actions automatically runs on all PRs:
+
+- Runs all non-Stata tests (`pytest -v -m "not requires_stata"`)
+- Tests on Ubuntu with Python 3.12
+- Builds the package and tests installation
+- Verifies critical imports and entry points
+
+The CI workflow is defined in `.github/workflows/build-test.yml`.
+
+## Getting Help
+
+- **Issues**: [GitHub Issues](https://github.com/tmonk/mcp-stata/issues)
+- **Discussions**: [GitHub Discussions](https://github.com/tmonk/mcp-stata/discussions)
+- **Author**: [Thomas Monk](https://tdmonk.com)
+
+## License
+
+By contributing to mcp-stata, you agree that your contributions will be licensed under the GNU Affero General Public License v3.0 or later.