Features
- TUI editor with a tool-section outline, file browser, live word/modal-state inspector, find & replace with preview, bookmarks, snippets and a command palette.
- Safe by default — every transform prints a diff and writes nothing unless you
pass
-i/-o. Writes are atomic;--backupkeeps a.bak. - Exact arithmetic —
Decimalthroughout; untouched lines round-trip byte for byte. - Transforms — renumber, strip, case, shift, scale, mirror, rotate, address math, feed/speed scaling, limited to a line, block or tool range.
- Analysis — stats, tool list, 21 validation rules, NC-aware diff.
- Machine profiles for Fanuc (mill/turn), Haas, Siemens ISO and generic ISO, plus your own TOML profiles.
- CI-friendly — versioned
--jsonoutput and meaningful exit codes.
Installation
Requires Python 3.13+.
uv tool install nctab # or: pipx install nctab
# one-off, without installing:
uvx nctab --help
Optional DNC/serial support: uv tool install "nctab[dnc]".
Quick start
nctab part.nc # open the editor
nctab stats part.nc # summary: axes, codes, tools, feeds
nctab check part.nc --strict # validate; non-zero exit on problems
nctab shift part.nc --z -0.02 # preview the change as a diff
nctab shift part.nc --z -0.02 -o part_z.nc # write it
nctab diff --ignore-n old.nc new.nc # compare ignoring block numbers
Documentation
| Guide | Contents |
|---|---|
| Editor | Layout, key bindings, find & replace |
| CLI reference | All commands, ranges, JSON output, exit codes |
| Configuration | Config layers, machine profiles, snippets |
| Architecture | Package layout and design rules |
| Development | Setup, testing, releasing |
Contributing
Contributions are welcome — please read CONTRIBUTING.md and the Code of Conduct. Security issues: see SECURITY.md. Changes are tracked in CHANGELOG.md.
License
MIT © 0ndrec
1 maintainer
Metadata
1 maintainer
Release files for nctab 0.1.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 | |
|---|---|---|---|
| nctab-0.1.2.tar.gz | 78.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| nctab-0.1.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 186.2 kB
Release files / nctab-0.1.2.tar.gz
| Download URL | nctab-0.1.2.tar.gz |
|---|---|
| Size | 78.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
073f9880d988d255cbe78ec408214996e965756aa587e1af387062a13e5679d1
|
|
BLAKE2b-256 checksum How to use checksums |
41864875f18490c44d51eadc604ec6159c42a60548a1080d4622b86aa42541dc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.22 {"installer":{"name":"uv","version":"0.12.22","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / nctab-0.1.2-py3-none-any.whl
| Download URL | nctab-0.1.2-py3-none-any.whl |
|---|---|
| Size | 108.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c8b1ce97ebbc5bb88f70b1701879734122094e0207a5e5ac3ed981521a9bfe7f
|
|
BLAKE2b-256 checksum How to use checksums |
f7b5a41d14d42596366adc5252aa05abfdc169c1b3ada2632f45ae9ac8a3670d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.22 {"installer":{"name":"uv","version":"0.12.22","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
