micropython-branch-manager 1.0.0__tar.gz

micropython_branch_manager-1.0.0/.cache/pip/http-v2/d/4/8/2/b/d482b9a98a05fe6bde057de4d9ca6873d02b38378b2f695e530470f7.body

@@ -0,0 +1,361 @@
+Metadata-Version: 2.4
+Name: uv
+Version: 0.9.17
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: License :: OSI Approved :: MIT License
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Software Development :: Testing
+Classifier: Topic :: Software Development :: Libraries
+License-File: LICENSE-APACHE
+License-File: LICENSE-MIT
+Summary: An extremely fast Python package and project manager, written in Rust.
+Keywords: uv,requirements,packaging
+Home-Page: https://pypi.org/project/uv/
+Author-email: "Astral Software Inc." <hey@astral.sh>
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Repository, https://github.com/astral-sh/uv
+Project-URL: Documentation, https://docs.astral.sh/uv
+Project-URL: Changelog, https://github.com/astral-sh/uv/blob/main/CHANGELOG.md
+Project-URL: Releases, https://github.com/astral-sh/uv/releases
+Project-URL: Discord, https://discord.gg/astral-sh
+
+# uv
+
+[![uv](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json)](https://github.com/astral-sh/uv)
+[![image](https://img.shields.io/pypi/v/uv/0.9.17.svg)](https://pypi.python.org/pypi/uv)
+[![image](https://img.shields.io/pypi/l/uv/0.9.17.svg)](https://pypi.python.org/pypi/uv)
+[![image](https://img.shields.io/pypi/pyversions/uv/0.9.17.svg)](https://pypi.python.org/pypi/uv)
+[![Actions status](https://github.com/astral-sh/uv/actions/workflows/ci.yml/badge.svg)](https://github.com/astral-sh/uv/actions)
+[![Discord](https://img.shields.io/badge/Discord-%235865F2.svg?logo=discord&logoColor=white)](https://discord.gg/astral-sh)
+
+An extremely fast Python package and project manager, written in Rust.
+
+<p align="center">
+  <img alt="Shows a bar chart with benchmark results." src="https://github.com/astral-sh/uv/assets/1309177/629e59c0-9c6e-4013-9ad4-adb2bcf5080d">
+</p>
+
+<p align="center">
+  <i>Installing <a href="https://trio.readthedocs.io/">Trio</a>'s dependencies with a warm cache.</i>
+</p>
+
+## Highlights
+
+- 🚀 A single tool to replace `pip`, `pip-tools`, `pipx`, `poetry`, `pyenv`, `twine`, `virtualenv`,
+  and more.
+- ⚡️ [10-100x faster](https://github.com/astral-sh/uv/blob/main/BENCHMARKS.md) than `pip`.
+- 🗂️ Provides [comprehensive project management](https://github.com/astral-sh/uv/blob/0.9.17/README.md#projects), with a
+  [universal lockfile](https://docs.astral.sh/uv/concepts/projects/layout#the-lockfile).
+- ❇️ [Runs scripts](https://github.com/astral-sh/uv/blob/0.9.17/README.md#scripts), with support for
+  [inline dependency metadata](https://docs.astral.sh/uv/guides/scripts#declaring-script-dependencies).
+- 🐍 [Installs and manages](https://github.com/astral-sh/uv/blob/0.9.17/README.md#python-versions) Python versions.
+- 🛠️ [Runs and installs](https://github.com/astral-sh/uv/blob/0.9.17/README.md#tools) tools published as Python packages.
+- 🔩 Includes a [pip-compatible interface](https://github.com/astral-sh/uv/blob/0.9.17/README.md#the-pip-interface) for a performance boost with a
+  familiar CLI.
+- 🏢 Supports Cargo-style [workspaces](https://docs.astral.sh/uv/concepts/projects/workspaces) for
+  scalable projects.
+- 💾 Disk-space efficient, with a [global cache](https://docs.astral.sh/uv/concepts/cache) for
+  dependency deduplication.
+- ⏬ Installable without Rust or Python via `curl` or `pip`.
+- 🖥️ Supports macOS, Linux, and Windows.
+
+uv is backed by [Astral](https://astral.sh), the creators of
+[Ruff](https://github.com/astral-sh/ruff).
+
+## Installation
+
+Install uv with our standalone installers:
+
+```bash
+# On macOS and Linux.
+curl -LsSf https://astral.sh/uv/install.sh | sh
+```
+
+```bash
+# On Windows.
+powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
+```
+
+Or, from [PyPI](https://pypi.org/project/uv/):
+
+```bash
+# With pip.
+pip install uv
+```
+
+```bash
+# Or pipx.
+pipx install uv
+```
+
+If installed via the standalone installer, uv can update itself to the latest version:
+
+```bash
+uv self update
+```
+
+See the [installation documentation](https://docs.astral.sh/uv/getting-started/installation/) for
+details and alternative installation methods.
+
+## Documentation
+
+uv's documentation is available at [docs.astral.sh/uv](https://docs.astral.sh/uv).
+
+Additionally, the command line reference documentation can be viewed with `uv help`.
+
+## Features
+
+### Projects
+
+uv manages project dependencies and environments, with support for lockfiles, workspaces, and more,
+similar to `rye` or `poetry`:
+
+```console
+$ uv init example
+Initialized project `example` at `/home/user/example`
+
+$ cd example
+
+$ uv add ruff
+Creating virtual environment at: .venv
+Resolved 2 packages in 170ms
+   Built example @ file:///home/user/example
+Prepared 2 packages in 627ms
+Installed 2 packages in 1ms
+ + example==0.1.0 (from file:///home/user/example)
+ + ruff==0.5.0
+
+$ uv run ruff check
+All checks passed!
+
+$ uv lock
+Resolved 2 packages in 0.33ms
+
+$ uv sync
+Resolved 2 packages in 0.70ms
+Audited 1 package in 0.02ms
+```
+
+See the [project documentation](https://docs.astral.sh/uv/guides/projects/) to get started.
+
+uv also supports building and publishing projects, even if they're not managed with uv. See the
+[publish guide](https://docs.astral.sh/uv/guides/publish/) to learn more.
+
+### Scripts
+
+uv manages dependencies and environments for single-file scripts.
+
+Create a new script and add inline metadata declaring its dependencies:
+
+```console
+$ echo 'import requests; print(requests.get("https://astral.sh"))' > example.py
+
+$ uv add --script example.py requests
+Updated `example.py`
+```
+
+Then, run the script in an isolated virtual environment:
+
+```console
+$ uv run example.py
+Reading inline script metadata from: example.py
+Installed 5 packages in 12ms
+<Response [200]>
+```
+
+See the [scripts documentation](https://docs.astral.sh/uv/guides/scripts/) to get started.
+
+### Tools
+
+uv executes and installs command-line tools provided by Python packages, similar to `pipx`.
+
+Run a tool in an ephemeral environment using `uvx` (an alias for `uv tool run`):
+
+```console
+$ uvx pycowsay 'hello world!'
+Resolved 1 package in 167ms
+Installed 1 package in 9ms
+ + pycowsay==0.0.0.2
+  """
+
+  ------------
+< hello world! >
+  ------------
+   \   ^__^
+    \  (oo)\_______
+       (__)\       )\/\
+           ||----w |
+           ||     ||
+```
+
+Install a tool with `uv tool install`:
+
+```console
+$ uv tool install ruff
+Resolved 1 package in 6ms
+Installed 1 package in 2ms
+ + ruff==0.5.0
+Installed 1 executable: ruff
+
+$ ruff --version
+ruff 0.5.0
+```
+
+See the [tools documentation](https://docs.astral.sh/uv/guides/tools/) to get started.
+
+### Python versions
+
+uv installs Python and allows quickly switching between versions.
+
+Install multiple Python versions:
+
+```console
+$ uv python install 3.10 3.11 3.12
+Searching for Python versions matching: Python 3.10
+Searching for Python versions matching: Python 3.11
+Searching for Python versions matching: Python 3.12
+Installed 3 versions in 3.42s
+ + cpython-3.10.14-macos-aarch64-none
+ + cpython-3.11.9-macos-aarch64-none
+ + cpython-3.12.4-macos-aarch64-none
+```
+
+Download Python versions as needed:
+
+```console
+$ uv venv --python 3.12.0
+Using Python 3.12.0
+Creating virtual environment at: .venv
+Activate with: source .venv/bin/activate
+
+$ uv run --python pypy@3.8 -- python --version
+Python 3.8.16 (a9dbdca6fc3286b0addd2240f11d97d8e8de187a, Dec 29 2022, 11:45:30)
+[PyPy 7.3.11 with GCC Apple LLVM 13.1.6 (clang-1316.0.21.2.5)] on darwin
+Type "help", "copyright", "credits" or "license" for more information.
+>>>>
+```
+
+Use a specific Python version in the current directory:
+
+```console
+$ uv python pin 3.11
+Pinned `.python-version` to `3.11`
+```
+
+See the [Python installation documentation](https://docs.astral.sh/uv/guides/install-python/) to get
+started.
+
+### The pip interface
+
+uv provides a drop-in replacement for common `pip`, `pip-tools`, and `virtualenv` commands.
+
+uv extends their interfaces with advanced features, such as dependency version overrides,
+platform-independent resolutions, reproducible resolutions, alternative resolution strategies, and
+more.
+
+Migrate to uv without changing your existing workflows — and experience a 10-100x speedup — with the
+`uv pip` interface.
+
+Compile requirements into a platform-independent requirements file:
+
+```console
+$ uv pip compile docs/requirements.in \
+   --universal \
+   --output-file docs/requirements.txt
+Resolved 43 packages in 12ms
+```
+
+Create a virtual environment:
+
+```console
+$ uv venv
+Using Python 3.12.3
+Creating virtual environment at: .venv
+Activate with: source .venv/bin/activate
+```
+
+Install the locked requirements:
+
+```console
+$ uv pip sync docs/requirements.txt
+Resolved 43 packages in 11ms
+Installed 43 packages in 208ms
+ + babel==2.15.0
+ + black==24.4.2
+ + certifi==2024.7.4
+ ...
+```
+
+See the [pip interface documentation](https://docs.astral.sh/uv/pip/index/) to get started.
+
+## Platform support
+
+See uv's [platform support](https://docs.astral.sh/uv/reference/platforms/) document.
+
+## Versioning policy
+
+See uv's [versioning policy](https://docs.astral.sh/uv/reference/versioning/) document.
+
+## Contributing
+
+We are passionate about supporting contributors of all levels of experience and would love to see
+you get involved in the project. See the
+[contributing guide](https://github.com/astral-sh/uv/blob/main/CONTRIBUTING.md) to get started.
+
+## FAQ
+
+#### How do you pronounce uv?
+
+It's pronounced as "you - vee" ([`/juː viː/`](https://en.wikipedia.org/wiki/Help:IPA/English#Key))
+
+#### How should I stylize uv?
+
+Just "uv", please. See the [style guide](https://github.com/astral-sh/uv/blob/0.9.17/STYLE.md#styling-uv) for details.
+
+## Acknowledgements
+
+uv's dependency resolver uses [PubGrub](https://github.com/pubgrub-rs/pubgrub) under the hood. We're
+grateful to the PubGrub maintainers, especially [Jacob Finkelman](https://github.com/Eh2406), for
+their support.
+
+uv's Git implementation is based on [Cargo](https://github.com/rust-lang/cargo).
+
+Some of uv's optimizations are inspired by the great work we've seen in [pnpm](https://pnpm.io/),
+[Orogene](https://github.com/orogene/orogene), and [Bun](https://github.com/oven-sh/bun). We've also
+learned a lot from Nathaniel J. Smith's [Posy](https://github.com/njsmith/posy) and adapted its
+[trampoline](https://github.com/njsmith/posy/tree/main/src/trampolines/windows-trampolines/posy-trampoline)
+for Windows support.
+
+## License
+
+uv is licensed under either of
+
+- Apache License, Version 2.0, ([LICENSE-APACHE](https://github.com/astral-sh/uv/blob/0.9.17/LICENSE-APACHE) or
+  <https://www.apache.org/licenses/LICENSE-2.0>)
+- MIT license ([LICENSE-MIT](https://github.com/astral-sh/uv/blob/0.9.17/LICENSE-MIT) or <https://opensource.org/licenses/MIT>)
+
+at your option.
+
+Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in uv
+by you, as defined in the Apache-2.0 license, shall be dually licensed as above, without any
+additional terms or conditions.
+
+<div align="center">
+  <a target="_blank" href="https://astral.sh" style="background:none">
+    <img src="https://raw.githubusercontent.com/astral-sh/uv/main/assets/svg/Astral.svg" alt="Made by Astral">
+  </a>
+</div>
+

micropython_branch_manager-1.0.0/.cache/pip/selfcheck/fe300af6f7d708c14827daac3afc81fbb8306b73de8dd6e3f1f8ea3b

@@ -0,0 +1 @@
+{"key":"/usr/local","last_check":"2025-12-11T00:12:10.256978+00:00","pypi_version":"25.3"}

micropython_branch_manager-1.0.0/.gitignore

@@ -0,0 +1,25 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+# Testing
+.coverage
+coverage.xml
+.pytest_cache/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# uv
+uv.lock
+src/micropython_branch_manager/_version.py

micropython_branch_manager-1.0.0/.gitlab-ci.yml

@@ -0,0 +1,58 @@
+image: python:3.11-slim
+
+variables:
+  PIP_CACHE_DIR: "$CI_PROJECT_DIR/.cache/pip"
+  GIT_DEPTH: 0  # Fetch full git history including tags for hatch-vcs
+
+cache:
+  paths:
+    - .cache/pip
+    - .venv
+
+stages:
+  - lint
+  - test
+  - build
+  - deploy
+
+before_script:
+  - apt-get update -qq && apt-get install -y -qq git  # Required for hatch-vcs
+  - pip install uv
+  - git fetch --tags  # Ensure tags are available for hatch-vcs
+  - uv sync
+
+lint:
+  stage: lint
+  script:
+    - uv run ruff check .
+    - uv run ruff format --check .
+    - uv run mypy src/micropython_branch_manager
+
+test:
+  stage: test
+  script:
+    - uv run pytest tests/ -v --cov=micropython_branch_manager --cov-report=xml --cov-report=term
+  coverage: '/TOTAL\s+\d+\s+\d+\s+(\d+)%/'
+  artifacts:
+    reports:
+      coverage_report:
+        coverage_format: cobertura
+        path: coverage.xml
+
+build:
+  stage: build
+  script:
+    - uv build
+  artifacts:
+    paths:
+      - dist/*.whl
+      - dist/*.tar.gz
+
+deploy:
+  stage: deploy
+  dependencies:
+    - build
+  only:
+    - tags
+  script:
+    - uv publish --username "$PYPI_USER" --password "$PYPI_PASS"

micropython_branch_manager-1.0.0/.pre-commit-config.yaml

@@ -0,0 +1,25 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.8.2
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.13.0
+    hooks:
+      - id: mypy
+        additional_dependencies: [pydantic>=2.0, cyclopts>=3.0]
+        args: [--strict]
+        exclude: ^tests/
+
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-json
+      - id: check-toml
+      - id: check-merge-conflict

micropython_branch_manager-1.0.0/.python-version

@@ -0,0 +1 @@
+3.11

micropython_branch_manager-1.0.0/CLAUDE.md

@@ -0,0 +1,163 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Overview
+
+`micropython-branch-manager` (alias: `mbm`) is a Python CLI tool that automates maintaining a MicroPython fork with multiple feature branches integrated on top of upstream. It manages rebasing integration branches with preserved merge commits, adding PRs, tracking branch metadata in JSON config, and generating GitLab MR URLs.
+
+## Development Commands
+
+### Setup
+```bash
+uv sync
+```
+
+### Running the tool locally
+```bash
+uv run mbm --help
+uv run mbm init --integration-branch main
+uv run mbm rebase upstream/master
+uv run mbm add-pr 12345
+uv run mbm sync
+uv run mbm config
+```
+
+### Testing
+```bash
+# Run all tests with coverage
+uv run pytest tests/ -v --cov=micropython_branch_manager --cov-report=xml --cov-report=term
+
+# Run specific test file
+uv run pytest tests/test_specific.py -v
+```
+
+### Linting and Type Checking
+```bash
+# Run all lint/type checks and formatting (recommended)
+uv run pre-commit run --all-files
+
+# Run ruff linter
+uv run ruff check .
+
+# Auto-fix ruff issues
+uv run ruff check . --fix
+
+# Format code
+uv run ruff format .
+
+# Type check with mypy
+uv run mypy src/micropython_branch_manager
+```
+
+### Pre-commit Hooks
+```bash
+# Install hooks
+uv run pre-commit install
+
+# Run on all files
+uv run pre-commit run --all-files
+```
+
+### Building
+```bash
+# Build wheel and sdist
+uv build
+```
+
+## Architecture
+
+### Core Workflow Model
+
+The tool operates on a MicroPython submodule directory containing a JSON config file (`.micropython-branches.json`). The workflow assumes:
+
+1. **Integration branch** - A branch (typically `main`) that contains merge commits of multiple feature branches on top of upstream
+2. **Feature branches** - Individual branches from upstream PRs or local development, tracked in GitHub forks
+3. **Update branches** - Temporary branches created during rebase operations for GitLab MR creation
+4. **Branch metadata** - Stored in JSON config with remote, PR URL, PR number, and title
+
+### Module Responsibilities
+
+- **cli.py** - Command-line interface using cyclopts. Entry point for all commands.
+- **config.py** - Pydantic models for JSON configuration (`MicroPythonConfig`, `BranchConfig`). Handles load/save operations.
+- **git.py** - Git operations wrapper (`GitRepo` class). Executes git commands and detects conflict states.
+- **branch_sync.py** - Branch detection and synchronization. Extracts branch names from merge commit messages using regex pattern `Merge branch '([^']+)'`.
+- **rebase.py** - Orchestrates full rebase workflow via `RebaseManager`. Includes branch validation, PR info lookup, rebase execution, divergence checks, and push operations.
+- **pr.py** - PR addition workflow via `PRManager`. Fetches PR from upstream, merges into update branch, updates config, optionally commits to parent repo.
+- **github.py** - GitHub API wrapper using `gh` CLI for PR metadata lookup.
+- **update_branch.py** - Update branch creation and GitLab MR URL generation.
+- **exceptions.py** - Custom exceptions for git conflicts, divergence, and errors.
+
+### Git Operations Flow
+
+**Rebase workflow:**
+1. Load config and ensure remotes exist
+2. Fetch from remotes (unless `--local`)
+3. Extract branches from merge commits between target and integration branch
+4. Validate detected branches against JSON config
+5. Create update branch from integration branch
+6. Rebase with `--rebase-merges --update-refs` to preserve merge structure
+7. Check for remote divergence before force-pushing
+8. Push feature branches to their configured remotes (GitHub forks)
+9. Push update branch to GitLab for MR creation
+10. Generate GitLab MR URL
+
+**PR addition workflow:**
+1. Parse PR identifier (number, URL, or branch name)
+2. Fetch PR metadata using `gh` CLI
+3. Create update branch from integration branch
+4. Fetch PR branch from upstream: `git fetch upstream pull/{number}/head:{branch}`
+5. Merge PR branch with merge commit
+6. Update JSON config with new branch entry
+7. Optionally commit submodule and config changes to parent repo
+8. Generate GitLab MR URL
+
+### Push Strategy
+
+- **Feature branches** - Pushed to their respective GitHub forks (remote specified in config for that branch)
+- **Integration/update branches** - Pushed to GitLab (remote typically "origin")
+- Update branch is used for creating merge requests back to integration branch
+
+### Error Handling
+
+The tool uses custom exceptions with structured error data:
+
+- `RebaseConflictError` - Raised when rebase encounters conflicts. Includes list of conflicting files and instructions for manual resolution.
+- `MergeConflictError` - Raised when PR merge encounters conflicts. Similar structure to rebase conflicts.
+- `RemoteDivergenceError` - Raised when remote branch has commits not in local branch. Includes commit counts and suggests options (fetch, force-push, abort).
+- `WorkingTreeDirtyError` - Raised when working tree has uncommitted changes.
+
+Conflict detection uses `git status --porcelain` to identify files with conflict markers (`UU`, `AA`, `DD` prefixes).
+
+## Configuration File
+
+`.micropython-branches.json` structure:
+```json
+{
+  "integration_branch": "main",
+  "remotes": {
+    "upstream": "https://github.com/micropython/micropython.git",
+    "origin": "git@github.com:username/micropython.git"
+  },
+  "branches": [
+    {
+      "name": "feature-branch-1",
+      "remote": "origin",
+      "pr_url": "https://github.com/micropython/micropython/pull/12345",
+      "pr_number": 12345,
+      "title": "Add feature X"
+    }
+  ],
+  "gh_author": "username"
+}
+```
+
+## Dependencies
+
+- **pydantic** - Config models with validation
+- **cyclopts** - CLI framework
+- **GitHub CLI (`gh`)** - PR metadata lookup (optional, warnings issued if not found)
+
+## Testing Notes
+
+Test files should be placed in `tests/` directory. The project uses pytest with coverage reporting configured in `pyproject.toml`.

micropython_branch_manager-1.0.0/LICENSE

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