sercomm-printserver 0.1.0__tar.gz

sercomm_printserver-0.1.0/.gitignore

@@ -0,0 +1,212 @@
+# ====================================
+# PYCHARM SPEZIFISCH: Git commands you might run once
+# git add .gitignore && git commit -m "Ignore IDE settings"
+# git push
+# git rm -r --cached .idea
+# git commit -m "Remove .idea and add to .gitignore"
+# git push
+# alternative : BE CAREFUL: overwrites remote history
+# git push origin master --force
+
+# ====================================
+# APP
+# ====================================
+website/build/
+website/.docusaurus/
+website/node_modules/
+node_modules/
+web-local-preview/
+translation_app*.log
+translation_web*.log
+tmp_github_web_pages/
+tmp_linkcheck_web_pages/
+.eslintcache
+.vitest/
+npm-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+.env.*
+!.env.example
+todo.md
+tmp_*
+
+# ====================================
+# IDEs & Editors
+# ====================================
+# IntelliJ, PyCharm, etc.
+.idea/
+# VS Code workspace settings
+.vscode/
+*.code-workspace
+
+# ====================================
+# Python bytecode & caches
+# ====================================
+# __pycache__: compiled .pyc files at any depth
+# *.py[cod]: catches .pyc, .pyo, .pyd
+__pycache__/
+src/sercomm_printserver/__pycache__/
+*.py[cod]
+# other compiled artifacts
+*$py.class
+
+# pytest, coverage, MyPy, Hypothesis
+.pytest_cache/
+.mypy_cache/
+.pyright/
+.coverage*
+htmlcov/
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+.tox/
+.nox/
+
+# general cache directories (any project-level caching)
+.cache/
+.run/
+.import_linter_cache/
+
+# ====================================
+# Build & distribution artifacts
+# ====================================
+# source/package builds
+build/
+dist/
+# metadata for pip installs
+*.egg-info/
+*.egg
+*.whl
+pip-wheel-metadata/
+# PyInstaller metadata
+*.manifest
+# PyInstaller spec files
+*.spec
+
+# Eggs, parts, wheels, sdist, etc.
+develop-eggs/
+.eggs/
+parts/
+sdist/
+wheels/
+downloads/
+var/
+
+# pip logs & installer leftovers
+pip-log.txt
+pip-delete-this-directory.txt
+.installed.cfg
+
+# ====================================
+# Virtual environments & secrets
+# ====================================
+# common venv folder names
+env/
+venv/
+ENV/
+.venv/
+# backups, alternate names
+env.bak/
+venv.bak/
+# dotenv files with credentials
+.env
+
+# ====================================
+# Project-specific & framework files
+# ====================================
+# Django logs & local overrides
+*.log
+local_settings.py
+
+# Flask instance folder
+instance/
+.webassets-cache
+
+# Scrapy cache
+.scrapy
+
+# Sphinx docs
+docs/_build/
+
+# PyBuilder output
+target/
+
+# Jupyter notebooks checkpoints
+.ipynb_checkpoints
+
+# pyenv Python version file
+.python-version
+
+# Celery beat schedule
+celerybeat-schedule
+
+# SageMath parsed files
+*.sage.py
+
+# Spyder IDE
+.spyderproject
+.spyproject
+
+# Rope IDE
+.ropeproject
+
+# MkDocs static site folder
+/site
+
+# ====================================
+# OS-specific files
+# ====================================
+# macOS
+.DS_Store
+# Windows
+Thumbs.db
+ehthumbs.db
+
+# Archives
+*.zip
+
+# Thunderbird build artifact (created temporarily by pack script)
+sources/manifest.json
+
+# ====================================
+# Tool-specific extras
+# ====================================
+# Codecov uploader script (downloaded during local uploads)
+codecov.sh
+codecov.xml
+
+# Nix build result symlink
+result
+
+# Optional lockfiles (for alternative managers)
+poetry.lock
+pdm.lock
+
+# div
+# .devcontainer/ # needed for github codespaces
+.claude/
+CLAUDE.md
+prompts.md
+.grimp_cache/
+
+# Local, per-developer settings (Claude Code etc.) - never commit
+*.local.json
+# bitranox curated memory (local; CLAUDE.local.md @imports it)
+CLAUDE.local.md
+
+# Python virtual environments (managed by bmk)
+.venv-win/
+.venv-bmk/
+
+# Python virtual environments (managed by bmk)
+.venv*/
+
+# Autonomous-execution decision log (never committed)
+EXECUTION-USER-REVIEW.md
+
+# Real values of the local test print server (template: test-device.example.json)
+test-device.json
+
+# End-to-end test snapshots of the real device configuration
+.e2e/

sercomm_printserver-0.1.0/CHANGELOG.md

@@ -0,0 +1,43 @@
+# Changelog
+
+All notable changes to this project will be documented in this file following
+the [Keep a Changelog](https://keepachangelog.com/) format.
+
+
+## [Unreleased]
+
+## [0.1.0] 2026-10-24
+
+### Added
+
+- Project created from `bitranox_template_py_cli` and renamed to `sercomm-printserver`.
+- `docs/Manual-PS301.md`: what is known about the SerComm PS301 print server family.
+- Device commands for the SerComm print-server family: `discover` (by the FTP greeting, no login),
+  `device-info`, `firmware`, `status`, `queue`, `device-config show/get/set/export/import`, `reset`,
+  `password set/clear`, `store-ip`, `factory-default`, and `print lpd/raw`. Every one answers with
+  `--json` / `--json-bare`; changes need `--yes`, the dangerous ones also `--confirm-name`.
+  `print lpd/raw` report the transport (`lpd` or `raw`) and its queue or printer number as
+  separate JSON fields. `discover` lists each local network it left out (more than 4096
+  addresses) as a network string in `data.skipped`; the envelope's `skipped` says why.
+- `arp reach/assign-ip/factory-reset`: reach a device by its MAC through a borrowed address (the
+  vendor's ARP trick), with the static ARP entry written natively through ipscout and removed
+  again in every case. Needs root or `CAP_NET_ADMIN`, root on macOS, Administrator on Windows
+  (exit 13 without). `--mac` and `--ip` are checked before anything is written (exit 22).
+- A typed model of the device's CONFIG file, `docs/config-keys.md` with the keys of each model
+  and firmware version, and writes that restart the device and wait for it by its SNMP uptime.
+- `print raw` reaches logical printers 1..3, the only ones with a RAW port. Measured on a PS301:
+  9100-9102 and the vendor's 4010/4020/4030 both feed L1..L3 and follow each printer's routing.
+- Python library surface: `open_print_server`, `discover_print_servers`, `PrintServer`,
+  `DeviceEndpoint`, `PrintJob`, `arp_trick`, `IpscoutNeighborTable`, `MacAddress`,
+  `normalise_mac` and the domain exceptions. The `arp_trick` functions take the borrowed address
+  as `ip: IPv4Address`; MACs are normalised once, on entry. `DiscoveryReport.skipped` holds the
+  left-out networks as `IPv4Network` values.
+- Claude Code plugin with the `sercomm-printserver` skill.
+- End-to-end tests against a real device (`-m device`, opt-in), which save the device's
+  configuration before any change and restore it.
+
+### Fixed
+
+- TFTP on Windows: a device that closes its port during a transfer (as it does when a `RESET`
+  restarts it) no longer reads as a broken transfer. Windows reports the ICMP "port unreachable"
+  on the next read of the UDP socket; it is now treated like the silence Linux and macOS see.