fontlab-python-pens 1.0.8__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (64) hide show
  1. fontlab_python_pens-1.0.8/.gitignore +222 -0
  2. fontlab_python_pens-1.0.8/CHANGELOG.md +382 -0
  3. fontlab_python_pens-1.0.8/DEPENDENCIES.md +35 -0
  4. fontlab_python_pens-1.0.8/LICENSE +201 -0
  5. fontlab_python_pens-1.0.8/NOTICE +46 -0
  6. fontlab_python_pens-1.0.8/PKG-INFO +225 -0
  7. fontlab_python_pens-1.0.8/README.md +211 -0
  8. fontlab_python_pens-1.0.8/Scripts/Contours/Recording Pen Demo.py +44 -0
  9. fontlab_python_pens-1.0.8/Scripts/Contours/Stroke Plan Demo.py +58 -0
  10. fontlab_python_pens-1.0.8/Scripts/Contours/Transform Pen Demo.py +45 -0
  11. fontlab_python_pens-1.0.8/Scripts/Pen Basics/01 Draw a Box.py +23 -0
  12. fontlab_python_pens-1.0.8/Scripts/Pen Basics/02 Print the Outline.py +38 -0
  13. fontlab_python_pens-1.0.8/Scripts/Pen Basics/03 Print the Points.py +30 -0
  14. fontlab_python_pens-1.0.8/Scripts/Pen Basics/04 Count Points.py +40 -0
  15. fontlab_python_pens-1.0.8/Scripts/Pen Basics/05 Bounds and Area.py +25 -0
  16. fontlab_python_pens-1.0.8/Scripts/Pen Basics/06 Record and Copy.py +26 -0
  17. fontlab_python_pens-1.0.8/Scripts/Pen Basics/07 Shifted Copy.py +43 -0
  18. fontlab_python_pens-1.0.8/Scripts/Pen Basics/08 Flattened Copy.py +52 -0
  19. fontlab_python_pens-1.0.8/Scripts/README.md +56 -0
  20. fontlab_python_pens-1.0.8/Scripts/Reports/Outline Measurements Demo.py +61 -0
  21. fontlab_python_pens-1.0.8/install.vfpy +39 -0
  22. fontlab_python_pens-1.0.8/pyproject.toml +38 -0
  23. fontlab_python_pens-1.0.8/src/fontlab_pens/__init__.py +168 -0
  24. fontlab_python_pens-1.0.8/src/fontlab_pens/_native.py +227 -0
  25. fontlab_python_pens-1.0.8/src/fontlab_pens/base.py +332 -0
  26. fontlab_python_pens-1.0.8/src/fontlab_pens/filter.py +181 -0
  27. fontlab_python_pens-1.0.8/src/fontlab_pens/fontgate.py +276 -0
  28. fontlab_python_pens-1.0.8/src/fontlab_pens/fontlab.py +275 -0
  29. fontlab_python_pens-1.0.8/src/fontlab_pens/measure.py +423 -0
  30. fontlab_python_pens-1.0.8/src/fontlab_pens/point.py +536 -0
  31. fontlab_python_pens-1.0.8/src/fontlab_pens/qt.py +82 -0
  32. fontlab_python_pens-1.0.8/src/fontlab_pens/recording.py +159 -0
  33. fontlab_python_pens-1.0.8/src/fontlab_pens/reverse.py +103 -0
  34. fontlab_python_pens-1.0.8/src/fontlab_pens/rounding.py +116 -0
  35. fontlab_python_pens-1.0.8/src/fontlab_pens/stroke.py +420 -0
  36. fontlab_python_pens-1.0.8/src/fontlab_pens/transform.py +225 -0
  37. fontlab_python_pens-1.0.8/test.sh +7 -0
  38. fontlab_python_pens-1.0.8/tests/__init__.py +1 -0
  39. fontlab_python_pens-1.0.8/tests/conftest.py +23 -0
  40. fontlab_python_pens-1.0.8/tests/fakes.py +305 -0
  41. fontlab_python_pens-1.0.8/tests/ported/__init__.py +1 -0
  42. fontlab_python_pens-1.0.8/tests/ported/test_area.py +190 -0
  43. fontlab_python_pens-1.0.8/tests/ported/test_base.py +201 -0
  44. fontlab_python_pens-1.0.8/tests/ported/test_bounds.py +79 -0
  45. fontlab_python_pens-1.0.8/tests/ported/test_filter.py +267 -0
  46. fontlab_python_pens-1.0.8/tests/ported/test_point.py +540 -0
  47. fontlab_python_pens-1.0.8/tests/ported/test_point_inside.py +223 -0
  48. fontlab_python_pens-1.0.8/tests/ported/test_recording.py +84 -0
  49. fontlab_python_pens-1.0.8/tests/ported/test_reverse.py +519 -0
  50. fontlab_python_pens-1.0.8/tests/ported/test_rounding.py +93 -0
  51. fontlab_python_pens-1.0.8/tests/ported/test_transform.py +119 -0
  52. fontlab_python_pens-1.0.8/tests/test_first_contour.py +139 -0
  53. fontlab_python_pens-1.0.8/tests/test_fontgate.py +479 -0
  54. fontlab_python_pens-1.0.8/tests/test_fontlab.py +619 -0
  55. fontlab_python_pens-1.0.8/tests/test_installer_archive.py +64 -0
  56. fontlab_python_pens-1.0.8/tests/test_node_kinds_linear.py +84 -0
  57. fontlab_python_pens-1.0.8/tests/test_package.py +82 -0
  58. fontlab_python_pens-1.0.8/tests/test_parity.py +670 -0
  59. fontlab_python_pens-1.0.8/tests/test_public_adapter.py +104 -0
  60. fontlab_python_pens-1.0.8/tests/test_qt.py +134 -0
  61. fontlab_python_pens-1.0.8/tests/test_scripts_basics.py +121 -0
  62. fontlab_python_pens-1.0.8/tests/test_scripts_demos.py +232 -0
  63. fontlab_python_pens-1.0.8/tests/test_staging.py +238 -0
  64. fontlab_python_pens-1.0.8/tests/test_stroke.py +635 -0
@@ -0,0 +1,222 @@
1
+ # Byte-compiled / optimized / DLL files
2
+ __pycache__/
3
+ *.py[codz]
4
+ *$py.class
5
+
6
+ # C extensions
7
+ *.so
8
+
9
+ # Distribution / packaging
10
+ .Python
11
+ build/
12
+ develop-eggs/
13
+ dist/
14
+ downloads/
15
+ eggs/
16
+ .eggs/
17
+ lib/
18
+ lib64/
19
+ parts/
20
+ sdist/
21
+ var/
22
+ wheels/
23
+ share/python-wheels/
24
+ *.egg-info/
25
+ .installed.cfg
26
+ *.egg
27
+ MANIFEST
28
+
29
+ # PyInstaller
30
+ # Usually these files are written by a python script from a template
31
+ # before PyInstaller builds the exe, so as to inject date/other infos into it.
32
+ *.manifest
33
+ *.spec
34
+
35
+ # Installer logs
36
+ pip-log.txt
37
+ pip-delete-this-directory.txt
38
+
39
+ # Unit test / coverage reports
40
+ htmlcov/
41
+ .tox/
42
+ .nox/
43
+ .coverage
44
+ .coverage.*
45
+ .cache
46
+ nosetests.xml
47
+ coverage.xml
48
+ *.cover
49
+ *.py.cover
50
+ *.lcov
51
+ .hypothesis/
52
+ .pytest_cache/
53
+ cover/
54
+
55
+ # Translations
56
+ *.mo
57
+ *.pot
58
+
59
+ # Django stuff:
60
+ *.log
61
+ local_settings.py
62
+ db.sqlite3
63
+ db.sqlite3-journal
64
+
65
+ # Flask stuff:
66
+ instance/
67
+ .webassets-cache
68
+
69
+ # Scrapy stuff:
70
+ .scrapy
71
+
72
+ # Sphinx documentation
73
+ docs/_build/
74
+
75
+ # PyBuilder
76
+ .pybuilder/
77
+ target/
78
+
79
+ # Jupyter Notebook
80
+ .ipynb_checkpoints
81
+
82
+ # IPython
83
+ profile_default/
84
+ ipython_config.py
85
+
86
+ # pyenv
87
+ # For a library or package, you might want to ignore these files since the code is
88
+ # intended to run in multiple environments; otherwise, check them in:
89
+ # .python-version
90
+
91
+ # pipenv
92
+ # According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
93
+ # However, in case of collaboration, if having platform-specific dependencies or dependencies
94
+ # having no cross-platform support, pipenv may install dependencies that don't work, or not
95
+ # install all needed dependencies.
96
+ # Pipfile.lock
97
+
98
+ # uv
99
+ # Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
100
+ # This is especially recommended for binary packages to ensure reproducibility, and is more
101
+ # commonly ignored for libraries.
102
+ # uv.lock
103
+
104
+ # poetry
105
+ # Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
106
+ # This is especially recommended for binary packages to ensure reproducibility, and is more
107
+ # commonly ignored for libraries.
108
+ # https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
109
+ # poetry.lock
110
+ # poetry.toml
111
+
112
+ # pdm
113
+ # Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
114
+ # pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.
115
+ # https://pdm-project.org/en/latest/usage/project/#working-with-version-control
116
+ # pdm.lock
117
+ # pdm.toml
118
+ .pdm-python
119
+ .pdm-build/
120
+
121
+ # pixi
122
+ # Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.
123
+ # pixi.lock
124
+ # Pixi creates a virtual environment in the .pixi directory, just like venv module creates one
125
+ # in the .venv directory. It is recommended not to include this directory in version control.
126
+ .pixi/*
127
+ !.pixi/config.toml
128
+
129
+ # PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
130
+ __pypackages__/
131
+
132
+ # Celery stuff
133
+ celerybeat-schedule*
134
+ celerybeat.pid
135
+
136
+ # Redis
137
+ *.rdb
138
+ *.aof
139
+ *.pid
140
+
141
+ # RabbitMQ
142
+ mnesia/
143
+ rabbitmq/
144
+ rabbitmq-data/
145
+
146
+ # ActiveMQ
147
+ activemq-data/
148
+
149
+ # SageMath parsed files
150
+ *.sage.py
151
+
152
+ # Environments
153
+ .env
154
+ .envrc
155
+ .venv
156
+ env/
157
+ venv/
158
+ ENV/
159
+ env.bak/
160
+ venv.bak/
161
+
162
+ # Spyder project settings
163
+ .spyderproject
164
+ .spyproject
165
+
166
+ # Rope project settings
167
+ .ropeproject
168
+
169
+ # mkdocs/Zensical documentation
170
+ /site
171
+
172
+ # mypy
173
+ .mypy_cache/
174
+ .dmypy.json
175
+ dmypy.json
176
+
177
+ # Pyre type checker
178
+ .pyre/
179
+
180
+ # pytype static type analyzer
181
+ .pytype/
182
+
183
+ # Cython debug symbols
184
+ cython_debug/
185
+
186
+ # PyCharm
187
+ # JetBrains specific template is maintained in a separate JetBrains.gitignore that can
188
+ # be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
189
+ # and can be added to the global gitignore or merged into this file. For a more nuclear
190
+ # option (not recommended) you can uncomment the following to ignore the entire idea folder.
191
+ # .idea/
192
+
193
+ # Abstra
194
+ # Abstra is an AI-powered process automation framework.
195
+ # Ignore directories containing user credentials, local state, and settings.
196
+ # Learn more at https://abstra.io/docs
197
+ .abstra/
198
+
199
+ # Visual Studio Code
200
+ # Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore that
201
+ # can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
202
+ # and can be added to the global gitignore or merged into this file. However, if you prefer, you
203
+ # could uncomment the following to ignore the entire vscode folder
204
+ # .vscode/
205
+ # Temporary file for partial code execution
206
+ tempCodeRunnerFile.py
207
+
208
+ # Ruff stuff:
209
+ .ruff_cache/
210
+
211
+ # PyPI configuration file
212
+ .pypirc
213
+
214
+ # Marimo
215
+ marimo/_static/
216
+ marimo/_lsp/
217
+ __marimo__/
218
+
219
+ # Streamlit
220
+ .streamlit/secrets.toml
221
+ .superpowers/
222
+ .omc/
@@ -0,0 +1,382 @@
1
+ ---
2
+ this_file: CHANGELOG.md
3
+ ---
4
+
5
+ ## 1.0.8 (2026-11-16)
6
+
7
+ - `install.vfpy` is now the short fontlab-instamix stub. It installs
8
+ fontlab-instamix from PyPI when it is missing, then installs this checkout from
9
+ its `[tool.fontlab-install]` table. The large legacy installer is gone.
10
+ - `tests/test_installer_archive.py` tests the stub, the install table and the sdist.
11
+ - README describes the stub install.
12
+
13
+ ## 2026-11-15 — Shared installer source alignment
14
+
15
+ Copied the reviewed shared installer exactly: dependency constraints and managed origins remain protected; inactive conditional dependencies are filtered before sibling execution in the resolver target Python. FontLab imports remain standard-library-only. Package identity, runtime APIs, dependency declarations, scripts, bundles and legal files are unchanged. Existing source-archive installer selection is retained.
16
+
17
+ Focused checks: 7 passed in 0.55s. This qualifies the local source candidate only. Independent review, combined-main/full delivery gates, genuine release/downloads, installed provider closure and admitted FontLab/native workflows remain separate. No owner-folder installation or native operation ran.
18
+
19
+
20
+
21
+ ## 2026-11-15 — Shared installer source and archive input
22
+
23
+ - Use the reviewed shared installer that preserves declared dependency constraints, protects managed origins and refuses unverifiable no-uv installations; keep Pens-specific metadata and zero library runtime dependencies.
24
+ - Include the standalone `install.vfpy` in source archives. The actual archive regression reproduces its omission before the allowlist change and checks exact installer bytes and genuine PKG-INFO version afterward; all seven focused package/archive checks pass.
25
+ - This qualifies the local source candidate only. Release, installed-provider/cohort and native acceptance are separate; shared false-marker sibling staging remains open.
26
+
27
+
28
+
29
+ ## 2026-11-13 — Issue 255 verified release qualification
30
+
31
+ - [fontlab-python-pens v1.0.5](https://github.com/fontlabcom/fontlab-python-pens/releases/tag/v1.0.5) is released at `e80672ff2d51e2fec77f4b73f0c7e01d93b9a37f`. Reviewed main/tag delivery, applicable CI and actual downloads match the qualified artifacts.
32
+ - All 12 Scripts and runnable README examples use Fly while the Pens library stays dependency-free.
33
+ - 869 source tests and all 12 complete changed-script coverage gates pass. Independent artifact review, genuine wheel/sdist ordinary installation and actual release downloads are qualified; real Pens child identity and exports are preserved.
34
+ - Ordinary external installation is qualified; installed FontLab/native acceptance remains unproved under D43. Consumer setup still requires separately installing matching Fly >=1.3 in the same interpreter. Provider source installers do not automatically supply or enforce this prerequisite; no reverse mandatory Fly dependency is claimed.
35
+
36
+ # Changelog
37
+
38
+
39
+ ## 2026-11-13 — Issue 255 Fly script source migration
40
+
41
+ - Route all 12 user-facing Scripts and three runnable README examples through
42
+ `fly.pens`; Scripts access the native API through `fly.fl` with their existing
43
+ local binding. Document separate current-Fly installation, keeping Pens library
44
+ source and zero-runtime-dependency metadata unchanged.
45
+ - Retain all fake-host geometry/history/refusal assertions through a Fly namespace
46
+ double using real canonical Pens modules; add 12 script import regressions.
47
+ - Source checks on arm64 Python 3.11: unchanged baseline 857 passes; migrated
48
+ source 869 passes, 95.76% coverage with the unchanged 80% gate; Ruff 0.16.7 clean.
49
+ Reviewed Fly source preserves canonical Pens root/reader identity and runs the
50
+ README recording example. Native identity uses a fake provider only.
51
+ - Graph change analysis retains dynamic-call limitations, checked against current
52
+ source. Independent review, integration, release/installation and native
53
+ acceptance are separate and remain open; the existing host fence stays active.
54
+
55
+ ## 2026-11-12 — D46 documentation pass (Issue 250)
56
+
57
+ - Landed this session, all on `main`: `install.vfpy` synced with the App installer for Extensions bundles (`0bc7884`, App `5cac0d6`, Issue 254); M-10 install sync without the unreachable blocked skip (`668de30`); App gate pens wiring closed in TODO (`89611c4`); `v1.0.2` recorded as tag-only, superseded by published `v1.0.3` (`a2efd35`).
58
+ - README install example now names `v1.0.3`. PLAN no longer lists the `v1.0.0` tag as future work. TODO adds the Issue 254 native check. WORK.md is a short status note; its previous bytes are archived on the owner's data volume (sha256 `07f3661f972b5f4dede921f0a10e3b78e3abc2d331e7c4190e00f16171e8327a`, 3,284 bytes).
59
+ - No code changed.
60
+
61
+ ## 2026-11-12 — install.vfpy matches the App's installer, with Extensions bundle support (Issue 254)
62
+
63
+ - `install.vfpy` is now byte-identical to `fontlab-fontlabapp/install.vfpy` (pushed in App `5cac0d6`).
64
+ The new code places `[tool.fontlab-install] extensions` bundles; this repository declares none, so
65
+ installs behave as before. `tools/check_install_copies.py` in the App compares the copies by sha256.
66
+
67
+ ## 2026-11-12 — v1.0.2 recorded as a tag-only release (Issue 250)
68
+
69
+ - Tag `v1.0.2` (292dbf5e, with-block segment-pen fix) stays tag-only: it has no GitHub release and none will be published. The published release [v1.0.3](https://github.com/fontlabcom/fontlab-python-pens/releases/tag/v1.0.3) (89611c47) supersedes it and contains its fix. Closes the TODO row "Publish the GitHub release for tag `v1.0.2` … or record why it is a tag-only point release".
70
+
71
+ ## 2026-11-12 — Pens suite in the App pre-push gate (Issue 250)
72
+
73
+ - `.metaswarm/repos.sh` (sha256 `8e6a4cb23c34bd96157b76d436340d2047dcf2d30457665037baf22db03dd9e3`)
74
+ now runs `run_pens_suite` after the App suite, as for Fontport and Glyport; an App
75
+ failure returns before the pens suite. Real App gate: 15203 passed, 22 skipped,
76
+ then pens 857 passed at 95.76% (80% floor), Suite exit 0. Closes the two App
77
+ gate-wiring TODO rows.
78
+
79
+ ## 2026-11-12 — Installer: unreachable blocked skip removed (Issue 250, review M-10)
80
+
81
+ - `install.vfpy` synced byte-identically from App (sha256 `2eb71691…` → `bbe8104e…`):
82
+ `remove_old_dist` drops the `path.name in blocked` skip. Every blocked top-level
83
+ name is also held, and a non-empty held refuses before anything is deleted, so the
84
+ skip never ran. App's `tests/test_install_superseded.py` pins that invariant.
85
+
86
+ ## 2026-11-11 — Pens suite in the Fontport and Glyport pre-push gates (Issue 250)
87
+
88
+ - The workspace gate recipe (`.metaswarm/repos.sh`) now runs this package's suite (80% coverage floor) after the Fontport and Glyport suites. Real pre-push gate runs on the merged trees: Fontport 5110 passed then pens 857 passed at 95.76% (pushed 54ffe80), Glyport 7434 passed, 7 skipped, then pens 857 passed at 95.76% (pushed 87f39f4).
89
+ - App is not wired yet, so the two gate-wiring TODO rows are narrowed to the App case rather than closed.
90
+
91
+ ## 2026-11-11 — v1.0.0 and v1.0.1 tags and releases verified (Issue 250)
92
+
93
+ - `git ls-remote origin refs/tags/v1.0.0` gives db6b4557 ("docs: release documents for 1.0.0"), and `refs/tags/v1.0.1` gives 6dbb88de. Both commits are ancestors of `origin/main`.
94
+ - `gh release view v1.0.0`: published 2026-11-09T03:27:46Z, not a draft. `gh release view v1.0.1`: published 2026-11-10T21:47:05Z, not a draft, marked Latest.
95
+ - Closes the TODO row "Tag `v1.0.0` on `main` and publish the GitHub release". The later tag v1.0.2 (292dbf5e) exists on `main` but has no GitHub release.
96
+
97
+ ## 2026-11-11 — Consumer locks stay path-editable (owner decision, Issue 250)
98
+
99
+ - Owner decision (2026-11-11): Fontport, Glyport and the FontLab App keep the path-editable `[tool.uv.sources]` entry for `fontlab-python-pens`, with no version pin and no git tag reference. Their lock files therefore record an editable path and are not refreshed against `v1.0.0`; the TODO row for that refresh is removed and PLAN item 1 records the decision.
100
+ - Fontport and Glyport gates will run this suite (80% coverage floor) after their own suite once the reviewed `repos.sh` change and their wiring commits land; that is tracked in their TODO. The FontLab App gate is not wired yet (TODO row).
101
+ - Decision source: owner, owner answer to team-lead, Issue 250 controller session, 2026-11-11.
102
+
103
+ ## 2026-11-11 — install.vfpy synced to the App WP11A installer (Issue 250)
104
+
105
+ - `install.vfpy` is now byte-identical to fontlab-fontlabapp 79f7485 (WP11A): it records file hashes in `install.log`, removes only superseded files whose current hash matches the logged hash, keeps edited ones and reports them, refuses entries with `..` or outside the data folder and any unowned entry in the old RECORD, and supports `FONTLAB_INSTALL_DRY_RUN`. Verify with `tools/check_install_copies.py` in the App repository. The native reinstall check is owner-run and stays open in the App TODO.
106
+
107
+ ## 2026-11-11 — Segment pens clear the open contour on a failed with-block (Issue 250)
108
+
109
+ - M-2: `FontGatePen` and `FlPen` set `contour = None` when a `with` block exits
110
+ on an exception, so a later `close()` on the reused pen no longer raises
111
+ "Unfinished contour". Tests: `test_segment_pen_when_exception_inside_with_then_open_contour_state_is_cleared`
112
+ and `test_flpen_when_exception_inside_with_then_open_contour_state_is_cleared`.
113
+ - M-1 was stale: `FontGatePointPen`/`FontGatePen.addComponent` always raise
114
+ `ComponentError` (glyph-level components), also after `close()`; pinned by
115
+ `test_add_component_when_pen_closed_then_component_error_names_glyph_level`.
116
+
117
+ ## 2026-11-11 — CI workflow (Issue 250)
118
+
119
+ - First hosted run of `ci.yml` is green: run 43031352878 on `292dbf5`.
120
+ - Add `.github/workflows/ci.yml` (ubuntu-latest, Python 3.11, runs `./test.sh`: tests plus the 80% coverage gate) on push and pull request to main. macos-14 was rejected by the hosted runner pool ("macos-14-arm64-us-default is not supported"), so the job runs on ubuntu-latest. First hosted run on 3bb17ae: success.
121
+
122
+ ## 2026-11-11 — with-block fix gate counts (Issue 250)
123
+
124
+ - Landed a7a479d on main: full suite 854 passed, 0 failed, 96% coverage; Ruff 0.16.7 clean. Repo has no CI; the pre-push gate is the only check. Follow-ups M-1 and M-2 are open in TODO.
125
+
126
+ ## 2026-11-11 — Issue 250 recorded counts and CI status
127
+
128
+ - Full suite on current main (`60e6a69`), `uv run --python 3.11 --with-editable . --with fonttools --with pytest --with pytest-cov pytest --cov=fontlab_pens`: 846 passed, 0 failed, 96% coverage (1,903 statements). The 7 failures recorded in the lint-round entry (711 passed, 95.02%) were the same pre-existing subprocess import failures from a non-installed checkout; they are gone with the editable install, not fixed by lint changes. Earlier lint-round pushes were gated by the local pre-push hook only.
129
+ - This repository has no CI: `.github/workflows` does not exist, so no exact-SHA CI evidence is possible. Tracked as an open TODO.
130
+
131
+ ## 2026-11-11 — Issue 250 test environment qualification
132
+
133
+ - The seven inherited subprocess failures were environmental: the test interpreter must install this checkout (the recipe's `--with-editable`). Full suite via the workspace recipe: 718 passed. README documents the requirement; no production or test changes.
134
+
135
+
136
+ ## 1.0.8 (2026-11-16)
137
+
138
+ - `FontGatePointPen` and `FontGatePen` now work as context managers, like
139
+ `FlPointPen` and `FlPen`. FontGate pens still write each contour at its
140
+ `endPath`; `close()` and a clean `with` exit raise `PenError` for an
141
+ unfinished contour, and drawing after close raises `PenError`. If the block
142
+ raises, the open contour is dropped, finished contours stay written and the
143
+ exception propagates. `FontGatePen.pointPen` is now set. In FontLab 9.0.9808,
144
+ `-0.0` coordinates read back from pen writes come from the native
145
+ `flContour` constructor, not from the pens, so the write path is unchanged.
146
+
147
+ - Add eight short `Scripts/Pen Basics` examples modelled on the RoboFab pen
148
+ how-tos: drawing, printing, counting, measuring, recording, filtering and
149
+ flattening on the current glyph. All eight ran in FontLab 9 on a test font.
150
+ - Add immutable stroke/cap styles, Proteus variant conversion, QPen application,
151
+ capability-gated full strokes/expansion, staged multi-layer stroke plans and
152
+ recording compatibility checks. Unsupported legacy-host fields fail before
153
+ shape mutation; plans resolve and prepare targets before live commits.
154
+ - Replace detached report demos with current-glyph Recording, Transform and
155
+ Measurements scripts; add a Stroke Plan demo using QPen-compatible defaults.
156
+ Drawing scripts enroll history and notify once; Measurements prints to Output.
157
+ - Add fake-host tests for variants, validation, both capability paths, mutation
158
+ refusal, history/failure handling, compatibility and every demo entry point.
159
+ - Writes `join` as an integer and both caps explicitly when `penParameters`
160
+ exists, because FontLab misreads join names
161
+ ([fl#8630](https://github.com/Fontlab/fl/issues/8630)). Applies native
162
+ parameters before the QPen, so a refusal leaves the shape unchanged.
163
+ `expand_stroke` raises `PenError` when FontLab reports a failed expansion.
164
+ Legacy hosts compare scaled values. The Stroke Plan demo refuses a non-master
165
+ active layer, and the Transform demo counts contours by their closing operation.
166
+ - Update `install.vfpy` to the shared workspace installer.
167
+ - Offline Python 3.11 gate after merging with main: 846 tests pass, 95.64%
168
+ overall coverage and 100% for the stroke module; broad Ruff is clean. An independent review found two high-severity and
169
+ three medium-severity issues, all fixed here.
170
+ - FontLab 9 native check (owned in-memory glyph, no document touched):
171
+ `apply_stroke` turned a NoPen shape into a solid 33-unit round-join stroke with
172
+ miter limit 5, and refused `contrast` without changing the shape. `apply_plan`
173
+ copied the open centreline into `Bold` with a 60-unit stroke, skipped the closed
174
+ contour and left `Regular` unchanged. This build has no `penParameters` or
175
+ `expandStroke`; those paths are covered only by fakes until Fontlab/Proteus#13
176
+ ships.
177
+ - FontLab 9 open-font check: `CurrentGlyph()` returns a FontGate glyph, so
178
+ every script now wraps it with `flGlyph(CurrentGlyph(), CurrentFont())`.
179
+ All eight Pen Basics scripts ran on Lslash in `Lato3Upr2Ma.vfj`; Bounds and
180
+ Area draws components as outlines, and Undo restored the glyph.
181
+
182
+ ## 2026-11-10 — live font editing rule (Issue 250, D44)
183
+
184
+ - AGENTS.md: agents test and edit the font open in FontLab 9, starting from the Desktop VFJs, and may save them.
185
+
186
+ ## 2026-11-10 — Issue 250 Ruff lint debt
187
+
188
+ - Clear all 72 Ruff 0.16.7 findings across 19 files (72 before, 0 after):
189
+ safe fixes, equivalent string formatting, context-manager annotations,
190
+ explicit class variables and simplified condition/context syntax.
191
+ - Keep one justified `BLE001` suppression in `tests/test_parity.py`: the
192
+ fontTools parity oracle deliberately compares any exception type.
193
+ Public exports and Ruff configuration are unchanged.
194
+ - Run the full pytest coverage payload from `test.sh` before and after with
195
+ an existing Python 3.11 environment: baseline 709 passed and final 711 passed (two added numeric-formatting
196
+ regression cases), with the same 7 failures and 95.02% coverage
197
+ (80% gate passed). All seven unchanged failures are package
198
+ import failures in subprocesses because this worktree is not installed;
199
+ five use isolated Python (`-I`). No new test failures.
200
+ - Run `python -m pytest -q --cov=fontlab_pens --cov-fail-under=80 tests` and
201
+ the existing uv-managed Ruff executable's `check .`; `uvx` itself cannot
202
+ acquire its cache lock in this sandbox. Do not run `test.sh`'s editable
203
+ installation because this round prohibits installs. Additional Transform
204
+ output checks cover integers, negative zero, precision, exponents, infinity
205
+ and NaN. Decimal/Fraction parity regressions first fail, then pass after
206
+ retaining the original float coercion for `%g` formatting. No whole-file
207
+ formatting or native FontLab checks.
208
+
209
+ ## 2026-11-10 — Issue 250 documentation round
210
+
211
+ - AGENTS.md describes the delegation, integration and release workflow.
212
+ - WORK.md reset to the current round; the earlier bytes are archived on the owner's workspace data volume, not public.
213
+
214
+ ## 2026-11-10 — isolated graph guidance proposal
215
+
216
+ Prepare append-only AGENTS guidance for separate task-owned graph HOME and storage, ordinary-analysis scope and independently reviewed bounded recovery. Preserve existing integration rules and acceptance holds. This documentation proposal records no new runtime, test, native, integration or publication result.
217
+
218
+ ## 2026-11-10 — Proteus lifecycle-test source proposal reconciled
219
+
220
+ - Publish [the PR12 reconciliation](https://github.com/Fontlab/Proteus/commit/5bca76c79811ede8bca2bdc097366158061c1bdb)
221
+ to its existing draft branch, preserving current master and all three
222
+ upstream commits/103 changed paths. The production focus guard is already
223
+ upstream; this proposal retains only two unchanged prior-PR native test
224
+ blobs and has no production C++ delta against current master.
225
+ - Verify the complete remote source tree and ancestry. Distinguish the
226
+ two-test-file actual-master comparison from the PR API's historical `90cf9c0`
227
+ base and 105-file listing; the published body now states both scopes.
228
+ - Keep PR12 open, draft and unmerged. Bounded graph results retain C++ impact
229
+ UNKNOWN, callable caps and sampled/truncated flows. Zero exact-head
230
+ checks/statuses/runs is not green CI.
231
+ - Keep matching SDK/build-cohort qualification, native compilation/linking,
232
+ full-suite/harness execution, lifetime/shutdown/exit0 and ordinary/canonical
233
+ adoption open. No Pens code, runtime installation or native acceptance
234
+ follows from this source-proposal publication.
235
+
236
+ ## 2026-11-10 — actual-client transport experiment source-qualified
237
+
238
+ - Complete independent source review of the separate transport experiment:
239
+ 954 cases pass; a distinct-path controller repeat passes 217 cases and is
240
+ nonadditive. Keep these experiment counts separate from the package suite.
241
+ - Exercise the unchanged actual client and encoder/decoder with fake dispatch
242
+ and host APIs. Select only proven consumed wire fields while retaining the
243
+ complete literal host, operations, controller and approval checks.
244
+ - Measure accepted FG requests of at most 32,723 bytes in the full run and
245
+ 32,724 in the controller repeat, including bounded escaped/Unicode paths.
246
+ Exactly 32,768 bytes dispatches to the fake sink; greater payloads refuse
247
+ before dispatch. Preserve the original oversized request and earlier
248
+ modeled/static observations as history. No arbitrary-path or mask capacity
249
+ follows from these existing-mode measurements.
250
+ - Preserve every original FONT field except the recorded build-metadata
251
+ change, and account separately for the added service layer. Preserve the
252
+ service sequence: 3,814 requests, 19 saved snapshots, six positive modeled
253
+ closes, original 2,151 registry rows, four 615-layer inventories and all 15
254
+ extension categories.
255
+ - Retain current native/runtime admission, ordinary/canonical adoption,
256
+ real-mask setup and subsequent literal-source/data growth checks. This
257
+ experiment changes no package code and supplies no native authority,
258
+ installation, publication or whole-goal acceptance.
259
+
260
+ ## 2026-11-10 — reviewed Pens source integrated into main
261
+
262
+ - Integrate [the reviewed source change](https://github.com/fontlabcom/fontlab-python-pens/commit/59b7c3a593011002ab7bf345973f5a2f168c8809)
263
+ into actual upstream main through the installed Pens pre-push gate.
264
+ - Current source suite: 716 passes, including demos, versus the prior 669.
265
+ Independent controller and real pre-push runs repeat the same cases.
266
+ Complete changed-module combined coverage is 186/188 and 106/107, with
267
+ no exclusions and no module below the 80% gate.
268
+ - Complete the exact inherited-diagnostic comparison, independent source review
269
+ and controller repetition. Differential lint qualification passed; broad
270
+ Ruff still fails with all 72 findings across 19 files retained as open debt.
271
+ - Keep native first-contour failure behavior, publication/re-fetch partial-write
272
+ risk, native subclass behavior and canonical adoption open. No installation,
273
+ native acceptance, release or publication follows from source integration.
274
+
275
+ ## 2026-11-10 — prospective bounded lint policy; verification pending
276
+
277
+ - Record the adopted policy change for the exact seven-file source cohort.
278
+ It replaces the earlier baseline-first milestone policy; all other gates stay.
279
+ - Two new complete executable-pinned Ruff 0.17.4 scans retain exit 1 and the
280
+ same 72 diagnostic records across 19 files, with zero added, removed or
281
+ shifted records. Broad lint still fails; all findings remain open debt.
282
+ - Retain the earlier blocked result below. Independent verification and
283
+ controller repetition remain pending; no differential-lint or final source
284
+ qualification is claimed. Native subclass and failure behavior, adoption
285
+ and delivery remain separate.
286
+
287
+ ## 2026-11-10 — staged classification and FontGate contour publication
288
+
289
+ - Preserve cyclic staged-node results with a bounded seed scan and reverse pass,
290
+ without slicing the input. This bounds classifier work, not contour validation.
291
+ - Refuse native-named glyph targets even when an explicit layer/element kind is
292
+ supplied; wrapper targets and lazy native imports remain supported.
293
+ - Populate the first detached FontGate shape before publishing it to a layer,
294
+ then retain its stored copy for later contours. Exceptions propagate once.
295
+ A successful publication followed by failed re-fetch can still leave geometry.
296
+ - Current source tests on arm64 Python 3.11 pass 716 cases, including demos.
297
+ Complete changed-module combined coverage is 98.94% and 99.07%, without
298
+ exclusions. Native failure behavior, adoption and delivery are separate gates.
299
+ - Broad Ruff currently reports 72 identical inherited diagnostics on both the
300
+ untouched main baseline and this source tree; no new diagnostic was introduced.
301
+ The lint qualification blocker remains open.
302
+
303
+ ## 2026-11-10 — verified integration-round guidance
304
+
305
+ - Record current-main reconciliation in a new isolated successor, preservation
306
+ of concurrent work and exact reviewed staging, combined repository/graph
307
+ checks, independent merge review, required hooks and actual remote proof.
308
+ - Keep solved tasks in cumulative history and unfinished acceptance in the
309
+ future queue. Native, installation, adoption, Issue 123 and private Pages
310
+ boundaries remain unchanged. This entry records documentation only.
311
+
312
+ ## 2026-11-10 — service-layer source experiment; native gates retained
313
+
314
+ - Record a separately reviewed current-reference experiment: 129 input keys,
315
+ 126 unchanged values, three reference digests refreshed and unchanged
316
+ executable bodies after path headers. Its 737 source passes and nonadditive
317
+ 21-case controller repeat are separate from this package's suite and code.
318
+ - Record the reference refresh as source-complete in the experiment's history. Retain current native-cohort and ordinary/canonical adoption,
319
+ actual initial-state approval, full preservation/history/UI/lifetime/SDK and
320
+ normal retirement; preserve all original 2,151/four 615/all 15 denominators.
321
+ - Distinguish modeled transaction prechecks from unmeasured actual-data/client
322
+ envelopes. Keep transport qualification, unchanged-cap boundary tests, real
323
+ mask association/flags13 and the five other source gaps open. No mask
324
+ capacity, native authority, package-code delivery or installation is claimed.
325
+
326
+ ## 1.0.0 — 2026-11-09
327
+
328
+ First release.
329
+
330
+ ### Pen protocols
331
+
332
+ - The fontTools pen protocol core, ported with zero runtime dependencies:
333
+ base, point, transform, recording, filter, measure (bounds, area,
334
+ point-inside), reverse and rounding pens.
335
+ - `QPainterPathPen` and `draw_onoff_contours` in `fontlab_pens.qt`.
336
+ - `PenError` subclasses `fontTools.pens.basePen.PenError` when fontTools is
337
+ installed, and `Exception` otherwise. Code that catches the fontTools error
338
+ also catches errors raised by these pens.
339
+
340
+ ### Native pens
341
+
342
+ - Native pens write to a layer or an element, never to a glyph. Resolve the
343
+ layer first, for example with `layer_of(glyph, master)`.
344
+ - FontGate: `FontGatePointPen`, `FontGatePen` and the
345
+ `fontlab_pens.fontgate` readers.
346
+ - FontLab: `FlPointPen`, `FlPen` and the `fontlab_pens.fontlab` readers.
347
+ - Shared: `ComponentError`, `IncompleteContour` and `layer_of`.
348
+ - Native targets are recognised by type name. Native objects are never probed
349
+ or formatted, which can crash FontLab. `FontGatePointPen(target, kind=...)`
350
+ accepts `"layer"` or `"element"` to skip detection for wrappers and test
351
+ doubles.
352
+ - Public staging API for adapters that resolve their own target:
353
+ `StagingPointPen` (with `append_contour` and `check_component`),
354
+ `StagedPoint`, `staged_node_kinds`, `FONTGATE_NODE_TYPES` and
355
+ `invert_transform`.
356
+ - `FlPointPen` sets smooth metadata through the raw native Smooth bit rather
357
+ than the property setter, which can move neighbouring handles. Input
358
+ coordinates, names, types and unrelated node bits are kept as given.
359
+ - Notified `FlPointPen` and `FlPen` writes start layer and glyph history before
360
+ writing and finish it once afterwards, so the first Undo can restore the
361
+ previous geometry. Whole-font history safety is not claimed. Write errors
362
+ are kept; a failure while finishing is chained to them. Notified writes to a bare element and direct writes to an
363
+ automatic layer are refused. A failed write may be partial, and a spent pen
364
+ cannot replay it.
365
+ - Layer appends that do not notify keep the raw payload. Cached glyph
366
+ snapshots and dependent expanded views can stay stale until FontLab
367
+ refreshes them.
368
+
369
+ ### Packaging and tests
370
+
371
+ - hatch-vcs build, `test.sh`, NOTICE and `uv.lock`.
372
+ - `install.vfpy` installs the package into FontLab 9 under the extension id
373
+ `com.fontlab.pens`.
374
+ - The ported fontTools pen tests, parity tests that compare recordings,
375
+ bounds and areas with fontTools, and native-pen tests on fake doubles that
376
+ enforce the no-probing rule. 662 tests pass with 94.89% line coverage.
377
+
378
+ ## 2026-11-10 — categorized package demos
379
+
380
+ - Add three functional Scripts-menu demos using detached package data and existing functional category names.
381
+ - Include Scripts in source distributions; document optional Fly/App snapshot reporting and host-free result access.
382
+ - Add real API result, menu wiring and report-failure tests. Native UI acceptance is separate from offline execution.
@@ -0,0 +1,35 @@
1
+ ---
2
+ this_file: DEPENDENCIES.md
3
+ ---
4
+
5
+ ## Conditional installer requirements
6
+
7
+ Only conditional installer requirements use `packaging==26.3` in an external uv-managed Python environment. FontLab itself imports only the standard library; no permanent project dependency was added. An unavailable helper fails before sibling execution.
8
+
9
+
10
+
11
+ # Dependencies
12
+
13
+ ## Runtime
14
+
15
+ None. The package uses only the Python standard library, so it installs into
16
+ FontLab's Python 3.11 without pulling in anything else. The native `fontgate`,
17
+ `fontlab` and `PythonQt` modules (used by later native pens) belong to FontLab
18
+ itself and are imported lazily inside functions.
19
+
20
+ ## Scripts only
21
+
22
+ The user-facing Scripts and README examples require `fontlab-fly` with the
23
+ `fly.pens` alias. Install Fly separately in the script environment; it is not
24
+ a Pens runtime dependency because Fly itself depends on Pens. Host-free script
25
+ tests supply a Fly namespace double pointing at the real Pens modules.
26
+
27
+ ## Test only
28
+
29
+ | Package | Why |
30
+ | --- | --- |
31
+ | `pytest` | Test runner. |
32
+ | `pytest-cov` | Enforces the 80% coverage gate. |
33
+ | `fontTools` | Parity oracle. The tests compare our recordings, bounds and areas with the fontTools pens of the same name, and use `floatToFixedToFloat` in one ported rounding test. `src/` imports it only optionally: when it is installed, `PenError` subclasses its `PenError`. |
34
+
35
+ `fontPens` and `ufoLib2` are not used. `test.sh` installs the test packages unpinned through `uv run --with`.