dap-mux 0.9.0__tar.gz

dap_mux-0.9.0/.envrc.sample

@@ -0,0 +1,9 @@
+# .envrc — project-level direnv configuration
+#
+# Copy or symlink this to .envrc at the project root.
+# .envrc is gitignored — add local overrides there.
+#
+# Requires layout_uv in ~/.config/direnv/direnvrc:
+#   layout_uv() { source "$(uv python find)/../../activate"; }
+
+layout uv

dap_mux-0.9.0/.github/workflows/ci.yml

@@ -0,0 +1,32 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+permissions: {}
+
+jobs:
+  test:
+    name: Test (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.12", "3.13", "3.14"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: astral-sh/setup-uv@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - run: uv sync --group dev
+
+      - run: uv run ruff format --check .
+      - run: uv run ruff check .
+      - run: uv run ty check
+      - run: uv run pytest

dap_mux-0.9.0/.github/workflows/publish.yml

@@ -0,0 +1,44 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v[0-9]*"
+
+permissions: {}
+
+jobs:
+  build:
+    name: Build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0  # hatch-vcs needs full tag history
+
+      - uses: astral-sh/setup-uv@v5
+
+      - run: uv build
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    name: Publish to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/dap-mux/
+    permissions:
+      id-token: write  # required for trusted publishing
+
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - uses: pypa/gh-action-pypi-publish@release/v1

dap_mux-0.9.0/.gitignore

@@ -0,0 +1,37 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+# Generated by hatch-vcs
+src/dap_mux/_version.py
+
+# direnv (may contain credentials)
+.envrc
+
+# Editor files
+*.swp
+*.swo
+*~
+.idea/
+.vscode/
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# Local-only files (not tracked)
+*.local-only.*
+
+# Test coverage artifacts
+.coverage
+htmlcov/
+
+# Spike artifacts (not part of the project)
+SPIKE-CONCLUSIONS.md

dap_mux-0.9.0/.pre-commit-config.yaml

@@ -0,0 +1,37 @@
+# .pre-commit-config.yaml — standard hook sequence
+#
+# Managed by prek (not pre-commit). Install: prek install
+# Run manually: prek run --all-files
+#
+# Hook order matters: format first, then lint, then type-check, then test.
+# Each stage must pass before code enters history.
+
+repos:
+  - repo: https://github.com/Yelp/detect-secrets
+    rev: v1.5.0
+    hooks:
+      - id: detect-secrets
+        args: ['--baseline', '.secrets.baseline']
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.15.10
+    hooks:
+      - id: ruff-format
+      - id: ruff
+        args: [--fix, --exit-non-zero-on-fix]
+
+  - repo: local
+    hooks:
+      - id: ty
+        name: ty
+        entry: uv run ty check
+        language: system
+        pass_filenames: false
+        always_run: true
+
+      - id: pytest
+        name: pytest
+        entry: uv run pytest --doctest-modules
+        language: system
+        pass_filenames: false
+        always_run: true

dap_mux-0.9.0/.secrets.baseline

@@ -0,0 +1,127 @@
+{
+  "version": "1.5.0",
+  "plugins_used": [
+    {
+      "name": "ArtifactoryDetector"
+    },
+    {
+      "name": "AWSKeyDetector"
+    },
+    {
+      "name": "AzureStorageKeyDetector"
+    },
+    {
+      "name": "Base64HighEntropyString",
+      "limit": 4.5
+    },
+    {
+      "name": "BasicAuthDetector"
+    },
+    {
+      "name": "CloudantDetector"
+    },
+    {
+      "name": "DiscordBotTokenDetector"
+    },
+    {
+      "name": "GitHubTokenDetector"
+    },
+    {
+      "name": "GitLabTokenDetector"
+    },
+    {
+      "name": "HexHighEntropyString",
+      "limit": 3.0
+    },
+    {
+      "name": "IbmCloudIamDetector"
+    },
+    {
+      "name": "IbmCosHmacDetector"
+    },
+    {
+      "name": "IPPublicDetector"
+    },
+    {
+      "name": "JwtTokenDetector"
+    },
+    {
+      "name": "KeywordDetector",
+      "keyword_exclude": ""
+    },
+    {
+      "name": "MailchimpDetector"
+    },
+    {
+      "name": "NpmDetector"
+    },
+    {
+      "name": "OpenAIDetector"
+    },
+    {
+      "name": "PrivateKeyDetector"
+    },
+    {
+      "name": "PypiTokenDetector"
+    },
+    {
+      "name": "SendGridDetector"
+    },
+    {
+      "name": "SlackDetector"
+    },
+    {
+      "name": "SoftlayerDetector"
+    },
+    {
+      "name": "SquareOAuthDetector"
+    },
+    {
+      "name": "StripeDetector"
+    },
+    {
+      "name": "TelegramBotTokenDetector"
+    },
+    {
+      "name": "TwilioKeyDetector"
+    }
+  ],
+  "filters_used": [
+    {
+      "path": "detect_secrets.filters.allowlist.is_line_allowlisted"
+    },
+    {
+      "path": "detect_secrets.filters.common.is_ignored_due_to_verification_policies",
+      "min_level": 2
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_indirect_reference"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_likely_id_string"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_lock_file"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_not_alphanumeric_string"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_potential_uuid"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_prefixed_with_dollar_sign"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_sequential_string"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_swagger_file"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_templated_secret"
+    }
+  ],
+  "results": {},
+  "generated_at": "2026-05-29T20:16:27Z"
+}

dap_mux-0.9.0/CHANGELOG.md

@@ -0,0 +1,18 @@
+# Changelog
+
+## v0.9.0 (2026-05-30)
+
+First release. The core multiplexer is complete and live-tested: connect Helix or VS Code and an IPython REPL to the same debugpy session and debug from both simultaneously.
+
+**Features:**
+* DAP multiplexer with full protocol support — framing, sequence rewriting, multi-client routing, event broadcasting
+* Late-join state replay — a client connecting to an already-running session receives the initialized handshake and current stop position immediately
+* Launch mode (`dmux script.py`) spawns debugpy and opens the IPython REPL in one command
+* Attach mode (`dmux --attach host:port`) connects to an already-running debug adapter
+* IPython extension with debug magics: `%step`, `%next`, `%continue_`, `%finish`, `%bt`, `%frame`, `%eval`, `%break`, `%clear`, `%sync`, `%connect`, `%disconnect`
+* Headless mode (`--no-repl`) for scripted setups or external REPL frontends
+* Configurable mux port (`-p`), log level (`-l`), and log file
+
+**Internal:**
+* CI/CD via GitHub Actions: Python 3.14 test matrix, trusted publisher workflow for PyPI releases
+* 114 tests covering protocol framing, sequence rewriting, multi-client routing, late-join state replay, and the IPython extension

dap_mux-0.9.0/CONTRIBUTING.md

@@ -0,0 +1,63 @@
+# Contributing
+
+dap-mux is a small, focused tool. Contributions that help it do its one thing better are welcome.
+
+## Ways to contribute
+
+Not all contributions are code. Bug reports, documentation improvements, and notes on editors or debug adapters you've tested against are all genuinely useful — especially for a project whose compatibility surface is larger than its test suite.
+
+## Start with an issue
+
+Before writing code, open an issue. Describe the problem you're trying to solve or the use case you want to support. Good things happen in issues: the problem gets refined, edge cases surface, and you learn whether the project will accept a solution before you spend time building one.
+
+A pull request with no linked issue gives us nothing to evaluate it against. We can't know if it solves the right problem, if this is the right solution, or if the problem is something this project should solve at all. We'll close it and ask you to open an issue first.
+
+Exception: if you're fixing a clear, unambiguous bug, you can open the PR directly — just describe the behavior you observed and what you changed.
+
+## Scope
+
+dap-mux is a router. It connects debug clients to debug adapters. It is not a platform, and it's not trying to become one.
+
+The right question to ask before proposing a feature: *does this help connect things, or does it add capability that belongs in the client or adapter?* The project will grow, but slowly and deliberately. Proposals that significantly expand scope need to clear a higher bar — start with an issue and make the case.
+
+## What makes a good PR
+
+**It addresses the issue and nothing more.** Small incidental cleanups are fine; sweeping refactors bundled with a feature are not. Focused changes are easier to review, easier to revert, and easier to understand six months later.
+
+**It is good code.** Clear names, no dead code, no commented-out experiments. Code that requires a long explanation to justify is usually code that needs to be changed.
+
+**It comes with tests.** Behavior changes need test coverage. Tests should verify promises — what the code is supposed to do — not implementation details.
+
+**You can defend it.** If AI helped you write the code, that's fine. But you are responsible for it. You should be able to explain every line, debug a failure in it, and adapt it when requirements change. If you can't, the PR can't be proven safe to merge — regardless of how it was written.
+
+## Development setup
+
+You need [uv](https://docs.astral.sh/uv/) and [prek](https://github.com/drmikehenry/prek).
+
+```
+git clone https://github.com/dap-mux/dap-mux
+cd dap-mux
+uv sync --group dev
+prek install
+```
+
+If you use [direnv](https://direnv.net/), a `.envrc.sample` is committed. Copy or symlink it to `.envrc` and direnv will activate the virtualenv automatically whenever you enter the project directory.
+
+`prek install` sets up the pre-commit hooks. After that, every commit automatically runs secret scanning, linting, formatting, type checking, and the test suite. If any of them fail, the commit doesn't happen.
+
+## Tests and code quality
+
+The pre-commit hooks run everything automatically. To run tools individually:
+
+```
+uv run pytest          # test suite
+uv run ruff check .    # lint
+uv run ruff format .   # format
+uv run ty check        # type check
+```
+
+All four must pass before a PR is ready to review.
+
+## License
+
+By submitting a pull request, you agree that your contribution will be licensed under the [MIT License](LICENSE.md) that covers this project, and that you have the right to grant that license.

dap_mux-0.9.0/LICENSE.md

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