datamax-dpl 0.1.0__tar.gz

datamax_dpl-0.1.0/.claude-plugin/marketplace.json

@@ -0,0 +1,16 @@
+{
+  "name": "datamax-dpl",
+  "owner": {
+    "name": "bitranox"
+  },
+  "metadata": {
+    "description": "datamax-dpl as a single Claude Code plugin: a skill to build, check, preview and print Datamax DPL labels."
+  },
+  "plugins": [
+    {
+      "name": "datamax-dpl",
+      "source": ".",
+      "description": "Use the datamax-dpl CLI and library: label JSON, model profiles and fallbacks, cutter jobs, data-driven batches, preview, print and camera verification."
+    }
+  ]
+}

datamax_dpl-0.1.0/.claude-plugin/plugin.json

@@ -0,0 +1,11 @@
+{
+  "name": "datamax-dpl",
+  "description": "Design, check and print Datamax DPL labels from Claude Code: write a label as JSON, validate it against the printer model, preview it as a PNG, print it over tcp or serial, and photograph the result for comparison. Ships the datamax-dpl skill.",
+  "version": "0.1.0",
+  "author": {
+    "name": "bitranox"
+  },
+  "homepage": "https://github.com/bitranox/datamax-dpl",
+  "repository": "https://github.com/bitranox/datamax-dpl",
+  "license": "MIT"
+}

datamax_dpl-0.1.0/.gitignore

@@ -0,0 +1,216 @@
+# ====================================
+# 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/datamax_dpl/__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
+
+# Local session notes and memory (never committed)
+.remember/
+handover*.md
+OPEN-WORK*.md
+EXECUTION-USER-REVIEW*.md
+USER-DECISIONS.jsonl
+
+# Vendor manual: copyrighted, kept locally as the reference only, never redistributed
+docs/*.pdf

datamax_dpl-0.1.0/CHANGELOG.md

@@ -0,0 +1,43 @@
+# Changelog
+
+All notable changes to this project are documented here. The format follows
+[Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and the project uses
+[Semantic Versioning](https://semver.org/).
+
+## [Unreleased]
+
+## [0.1.0] - 2026-10-23
+
+First release. Built from the 1998 DPL programmer's manual and tested against
+simulated printers and cameras only; no real printer or camera has been
+attached yet.
+
+### Added
+
+- Label format in JSON (millimetres or inches, DPL-native bottom-left origin):
+  text in the internal and scalable fonts, lines, boxes, circles, polygons,
+  images, and barcodes including Code 128, EAN, UPC, Code 39, PDF417, MaxiCode
+  and DataMatrix. `datamax-dpl schema` prints its JSON Schema.
+- 20 profiles for the 18 printer models of the manual, with firmware- and
+  option-dependent features; `models` and `capabilities` list them, and
+  `docs/capabilities.md` is generated from them.
+- Capability checks per model with a `degrade` policy (documented fallbacks,
+  such as a circle sent as a downloaded bitmap, reported as findings) and a
+  `strict` policy that refuses instead.
+- Data batches: `{name}` placeholders filled from CSV or JSON records, one label
+  per record, with cutting every N labels.
+- Commands `render`, `validate`, `explain` (DPL back to JSON), `preview` (PNG at
+  the printer's resolution; lettered text with the `preview` extra on Python
+  3.11+), `print`, `status`, `detect`, `feed`, `cut`, `pause`, `cancel` and
+  `reset`.
+- Transports: TCP (port 9100), serial, a device file (USB printer class), a
+  file and stdout. A TCP or serial write times out when the printer stops
+  taking data for longer than the timeout, on Windows and macOS too; a timed
+  out serial write drops what the port had not sent yet.
+- Camera feedback: `capture` takes a photo, `verify` prints a label and puts the
+  photo next to the expected preview.
+- `--json` / `--json-bare` envelopes and exit codes 0 / 1 / 2 on every label and
+  printer command, for scripts and LLM agents.
+- Public library API for rendering, validating and printing from Python.
+- A Claude Code skill (`skills/datamax-dpl/`), installable from this repository
+  as a plugin marketplace.