firmware-lifter 0.1.1__tar.gz

firmware_lifter-0.1.1/.bumpversion.toml

@@ -0,0 +1,15 @@
+[tool.bumpversion]
+current_version = "0.1.1"
+commit = true
+tag = true
+
+[[tool.bumpversion.files]]
+filename = "VERSION"
+
+[[tool.bumpversion.files]]
+filename = "pyproject.toml"
+
+[[tool.bumpversion.files]]
+filename = "firmware_lifter/__init__.py"
+search = 'VERSION = "{current_version}"'
+replace = 'VERSION = "{new_version}"'

firmware_lifter-0.1.1/.gitignore

@@ -0,0 +1,15 @@
+# builds
+/dist
+/build
+
+__pycache__
+
+# test results
+/.pytest_cache
+
+# coverage files
+.coverage*
+
+# style and linting
+/.mypy_cache
+/.ruff_cache

firmware_lifter-0.1.1/.gitlab-ci.yml

@@ -0,0 +1,26 @@
+default:
+  image: debian:trixie-slim
+
+before_script:
+  - apt-get update --yes
+  - apt-get install --yes just pipx
+  - PIPX_BIN_DIR=/usr/local/bin PIPX_HOME=/opt/pipx pipx install hatch
+
+stages:
+  - build
+  - test
+
+build:
+  stage: build
+  script:
+    - hatch build
+
+test:pytest:
+  stage: test
+  script:
+    - hatch test
+
+lint:
+  stage: test
+  script:
+    - just lint

firmware_lifter-0.1.1/AGENTS.md

@@ -0,0 +1,47 @@
+# AGENTS.md
+
+## Project
+`firmware-lifter` is a small CLI for project-local firmware transfer operations.
+
+## Working Rules
+- Keep changes minimal and focused.
+- Prefer `apply_patch` for edits.
+- Do not use destructive git commands.
+- Preserve existing repo conventions unless a change is required.
+- Keep ASCII unless the file already uses Unicode.
+
+## Architecture Notes
+- YAML config is split into:
+  - `.firmware-lifter-profiles.yaml` for project-shared profile data
+  - `.firmware-lifter-transport.yaml` for local transport data
+- YAML parsing uses `ruamel.yaml`.
+- Validation uses strict `pydantic v2` models.
+- One local transport applies to all profiles.
+- Supported transports:
+  - `gdb`
+  - `openocd`
+  - `stm32flash`
+  - `custom`
+
+## Execution Behavior
+- `pre_transfer` runs before transport execution.
+- Execution failures should not show Python tracebacks.
+- Backend stderr must remain visible.
+- Distinguish `pre_transfer` failures from transfer failures in CLI output.
+
+## Examples
+- Example configs live in `examples/`.
+- The shared profile example file is `examples/.firmware-lifter-profiles.yaml`.
+- Transport-specific examples live in transport subdirectories.
+
+## Testing
+- Prefer updating existing tests in place.
+- Run tests with `hatch test` when available.
+- If hatch is unavailable, use the local venv pytest path when present.
+- A quick syntax check can be done with:
+  - `python3 -m compileall firmware_lifter tests`
+
+## Code Quality
+- Keep command construction explicit and readable.
+- Validate config early and fail with clear messages.
+- Avoid adding compatibility layers unless there is a concrete need.

firmware_lifter-0.1.1/CHANGELOG.md

@@ -0,0 +1,13 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] - 2026-07-23
+
+### Changed
+
+- Support multiple transfer profiles.
+- Assume `gdb-multiarch`, if `gdb_binary` is not specified.

firmware_lifter-0.1.1/CONTRIBUTING.md

@@ -0,0 +1,22 @@
+# Development
+
+firmware-lifter uses [`hatch`](https://hatch.pypa.io/) and the `pyproject.toml` to organise the project.
+
+Dependencies are listed in the `pyproject.toml` and will be installed upon running python commands within the virtual environment created by `hatch`.
+
+
+# Linting, formatting & testing
+
+- formatting: `just apply-style`
+- linting: `just lint`
+- test: `just test`
+    - with coverage check: `just test --cover`
+
+
+# Release workflow
+
+1. Update `CHANGELOG.md` by moving relevant entries from `Unreleased` into a
+   new version section.
+1. Run the *just* target "release" with a version part, e.g. `just release minor`
+1. Push commit and tags manually: `git push && git push --tags`
+1. Upload to [pypi](https://pypi.org/): `just publish`