this_file: README.md
fontlab-python-instamix
Installs extensions, scripts and Python packages into FontLab 9. Stdlib only, runs inside FontLab's embedded Python 3.11 and from an ordinary terminal.
- Extensions:
.fontlabextfolders and.fontlabextzzips are copied to<data>/Extensions/Library/<id>.fontlabext, then their files are linked intoScripts,Encoding,Codepage,Actions,Dataandpython/3.11/site-packages. A ledger records every path, so uninstall removes exactly what was installed and keeps files you changed. - Packages: PyPI and
git+packages go into FontLab's site-packages through uv, run as its own binary (never throughsys.executable, which is FontLab itself on Windows). - Projects: a repository with
[tool.fontlab-install]in itspyproject.tomlinstalls itself with a two-lineinstall.vfpy.
<data> is FontLab's data folder: --data-dir, else $FONTLAB_DATA_DIR,
else fontlab.flPreferences().dataPathDefault, else
~/Library/Application Support/FontLab/FontLab 9 (macOS) or
Documents\FontLab\FontLab 9 (Windows).
Install inside FontLab
Open install.vfpy from this repository in FontLab 9 (File > Open). From a
git checkout it symlinks src/fontlab_instamix into
<data>/python/3.11/site-packages (edits are live after a restart); otherwise
it copies the package. Then in FontLab's Python panel:
import fontlab_instamix as im
im.install("/path/to/com.example.hello.fontlabextz")
im.uninstall("com.example.hello")
Command line
uvx fontlab-python-instamix --help # or: python -m fontlab_instamix
fontlab-instamix env # Python, platform, FontLab folders
fontlab-instamix ext install Hello.fontlabextz some.fontlabext [--copy]
fontlab-instamix ext list
fontlab-instamix ext uninstall com.example.hello
fontlab-instamix pkg install fonttools "git+https://github.com/o/r"
fontlab-instamix pkg list | pkg uninstall fonttools
fontlab-instamix wrap MyScript.py --id com.me.myscript --zip
fontlab-instamix bootstrap path/to/project
fontlab-instamix uv fetch # find uv or download it to <data>/python/uv
fontlab-instamix venv # <data>/.venv for Python 3.11
Every command takes --data-dir, so you can try it on a scratch folder.
Extension format
A com.example.hello.fontlabext folder (reverse-DNS name) holds
manifest.fontlabextj at its root:
{"id": "com.example.hello", "name": "Hello", "version": "1.0.0",
"min_fontlab": "9.0",
"python": {"requires": ["fonttools>=4"], "packages": ["src/hello"]},
"vars": {"family": "adamtrix"},
"install": [{"from": "scripts", "to": "Scripts/{}"},
{"from": "encoding/*.enc", "to": "Encoding/{}"},
{"from": "data", "to": "Data/{family}/"}]}
Destinations start with a target (Scripts, Actions, Codepage, Data,
Encoding, site-packages, any case). . is the target root, {} the
extension name without .fontlabext, {var} a value from vars. Unknown
variables, unknown targets and .. are errors. Files are linked one by one
(copied on Windows or when a symlink fails). A .fontlabextz is a zip holding
one or more .fontlabext folders; absolute, drive-letter and .. members are
refused. Optional install.vfpy hooks in a zip run only with --run-hooks.
Unknown manifest keys are errors, except this_file.
See examples/com.example.hello.fontlabext.
Stub install.vfpy for other projects
fontlab-instamix stub DIR writes the standard 40-line install.vfpy into a
project folder (--force replaces an existing one; the template is
stub/install.vfpy). When opened in FontLab it gets instamix in this order:
an installed copy, a sibling ../fontlab-python-instamix checkout copied into
site-packages, or the PyPI wheel (sha256 checked, only fontlab_instamix/
extracted). Then it calls bootstrap.install_project(__file__).
install_project reads [tool.fontlab-install]:
[tool.fontlab-install]
id = "com.example.tool" # required, reverse-DNS
name = "Tool"
packages = ["src/tool"] # default: [tool.hatch.build.targets.wheel] packages
scripts = ["tools/Extra"] # top-level Scripts/ is always included
extensions = "Extensions" # .fontlabext folders and <kind>/<Name>.fontlab<Kind> bundles
dependencies = ["fontlab-fly>=1"] # default: [project] dependencies
init-script = false # default: true only for com.fontlab.fontlabapp
It matches the legacy install.vfpy:
- Top-level
Scripts/maps onto FontLab'sScripts/; other listed folders map toScripts/<path>.__pycache__,*.pyc,*.vfpycand.DS_Storeare skipped. - Bundles go to
Extensions/<kind>/<Name>.fontlab<Kind>. - Dependency markers are evaluated for FontLab's Python 3.11 on the host OS. Specs that do not apply are skipped;
METADATAkeeps all of them. - The version comes from the static
[project].version, then the hatch-vcs version file,PKG-INFO,git describeand the fallback version. <dist>-<version>.dist-info(INSTALLERfontlab-instamix) is written soimportlib.metadatafinds the package. Uninstall removes it and never follows the editable package link.Scripts/Instamix/holdsList Extensions.pyandUninstall <id>.py.- For fontlabapp, the
fontlabapp.pluginsblock is added toinitScript.py, and removed again on uninstall;initScript.pyis deleted if nothing else is in it. Empty folders underScripts/that instamix created are pruned too (neverScripts/itself, never a folder that existed before install). - Dependencies uv installed from PyPI (for example fonttools) stay after uninstall: other extensions may share them, and the legacy installer also kept them. Sibling checkouts are detected only if their pyproject has a
[tool.fontlab-install]table with a validid; anything else (such as TypeRig) goes to uv. - A legacy
install.vfpyinstall of the same id is migrated first. Files it logged are removed; changed files are kept. If a kept file would collide with the new install, the install stops before it changes anything. Shared legacy tools (fontlab_install.py,Scripts/Extensions/) are removed once no legacy install remains.
Development
./test.sh # uv run --with pytest pytest -q
./build.sh # wheel + sdist into dist/
./publish.sh # tagged, clean tree only
Apache-2.0. platformdirs.py vendors part of platformdirs (MIT, notice kept).
Metadata
Release files for fontlab-python-instamix 1.0.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| fontlab_python_instamix-1.0.2.tar.gz | 57.2 kB | Without provenance | Details for fontlab_python_instamix-1.0.2.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| fontlab_python_instamix-1.0.2-py3-none-any.whl | Python 3 | none | any | Details for fontlab_python_instamix-1.0.2-py3-none-any.whl |
Total release size: 108.2 kB
Release files / fontlab_python_instamix-1.0.2.tar.gz
| Download URL | fontlab_python_instamix-1.0.2.tar.gz |
|---|---|
| Size | 57.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1d46621771f29d70f99e40c1c34c324c3781b1ceaeb40d63ff4f95d15b8dd88b
|
|
BLAKE2b-256 checksum How to use checksums |
d79eae25dffdbec66f7bfab60326b60a31e64d0dc5292d30707e40b284a7ba7a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / fontlab_python_instamix-1.0.2-py3-none-any.whl
| Download URL | fontlab_python_instamix-1.0.2-py3-none-any.whl |
|---|---|
| Size | 51.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d921def45c2dbaf6bfe3fd99377c770adde39a81b5c44158887c960a4f767985
|
|
BLAKE2b-256 checksum How to use checksums |
5f45d1b8cca345e4a9a6c918250bb048f5abaf90b4aed9922673a7494bb1480e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for fontlab-python-instamix 1.0.2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.