netlistmod 0.5.0__tar.gz

netlistmod-0.5.0/.gitignore

@@ -0,0 +1,47 @@
+temp/
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual Environments
+.env
+.venv
+env/
+venv/
+ENV/
+
+# Testing and Coverage
+.cache/
+.import_linter_cache/
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Editor / IDE specific (Optional but highly recommended)
+.vscode/
+.idea/
+.DS_Store
+Thumbs.db

netlistmod-0.5.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 xdylanm
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

netlistmod-0.5.0/PKG-INFO

@@ -0,0 +1,94 @@
+Metadata-Version: 2.5
+Name: netlistmod
+Version: 0.5.0
+Summary: A source-preserving SPICE netlist editing library
+Project-URL: Homepage, https://github.com/xdylanm/netlistmod
+Project-URL: Repository, https://github.com/xdylanm/netlistmod
+Project-URL: Changelog, https://github.com/xdylanm/netlistmod/blob/main/CHANGELOG.md
+Author: xdylanm
+License-Expression: MIT
+License-File: LICENSE
+Keywords: editor,ltspice,netlist,ngspice,parser,spice
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Scientific/Engineering :: Electronic Design Automation (EDA)
+Classifier: Typing :: Typed
+Requires-Python: >=3.13
+Requires-Dist: interegular>=0.3.3
+Requires-Dist: lark>=1.2.2
+Description-Content-Type: text/markdown
+
+# netlistmod
+
+`netlistmod` is a source-preserving SPICE netlist editing library. Its goal is
+to make permitted value and directive edits while preserving the original text
+and circuit topology.
+
+## Supported dialects
+
+The caller always selects the dialect; there is no default and no detection.
+
+| Dialect | `Dialect` | Input | Elements | Reference | Validated on |
+|---|---|---|---|---|---|
+| ngspice | `NGSPICE` | `.cir`, `.sp`, `.net`, KiCad exports | R, C, L, K, V, I, D, X; Q, M, J, Z (M13); E, F, G, H, S, W (M14); B and the expression forms (M15) | [ngspice manual](docs/references.md) | ngspice 47 |
+| LTspice | `LTSPICE` | `.net`, `.cir` (an `.asc` schematic is [exported first](docs/usage/ltspice-export.md)) | R, C, L, K, V, I, D, X; Q, M, J, Z (M13); E, F, G, H, S, W (M14); B and the expression forms (M15) | [ltspice-reference](docs/references.md) | LTspice 26.1.1, Windows |
+
+Where a solver and the library differ, the file is `docs/grammars/<dialect>/discrepancies.md`. Other
+device letters raise `UnsupportedConstruct` until their phase 2 milestone.
+
+## Quick start
+
+```bash
+pip install netlistmod
+```
+
+To work on the library itself, clone it and run `uv sync`.
+
+```python
+>>> from pathlib import Path
+>>> from tempfile import TemporaryDirectory
+>>> from netlistmod import Dialect, Netlist
+>>> folder = TemporaryDirectory()
+>>> path = Path(folder.name) / "divider.cir"
+>>> _ = path.write_bytes(b"divider\nV1 in 0 DC 3\nR1 in out 1k ; top\nR2 out 0 1k\n.op\n.end\n")
+
+>>> netlist = Netlist.load(path, dialect=Dialect.NGSPICE)
+>>> edited = netlist.set_value("R2", "3k").directives.set(".tran 1u 5u")
+>>> edited.save()
+>>> print(path.read_text(), end="")
+divider
+V1 in 0 DC 3
+R1 in out 1k ; top
+R2 out 0 3k
+.op
+.tran 1u 5u
+.end
+>>> folder.cleanup()
+
+```
+
+Every edit returns a new netlist that has been re-parsed and checked against the topology of the original. `save()` changes only the edited text: comments, spacing, line endings and encoding stay as they were. For the whole cycle with a solver, see [edit_and_simulate.py](docs/usage/examples/edit_and_simulate.py).
+
+## What it does and does not do
+
+- **Reads** titles, comments, the phase 1 elements, `.param`, `.model`, `.subckt`, the analysis, option and output directives, and LTspice's `.step`, into typed nodes with exact source spans. It answers queries about lines, references, nets and connections.
+- **Edits** values, formulas, instance and model parameters, source DC and AC values and functions, `.param` lines and directives, and adds an `.include`.
+- **Preserves** other dot-commands verbatim. `.control`, `.if`, `.include` and `.lib` are opaque: their contents are not read.
+- **Never** changes topology (elements, nodes, subcircuit ports), evaluates a value, or launches a solver.
+- **Refuses loudly.** A line outside the grammar is an error, not a guess. Netlists with Q or M devices are rejected until phase 2.
+
+## Status
+
+Phase 1 is complete, with both dialects validated on their solvers ([M9](docs/design/archive/phase-1/m9-tasks.md)), and phase 2 is under way. The current release is an alpha (`0.5.0`): the public API may still change before 1.0.
+
+Supported platforms are Linux and Windows, with Python 3.13 or newer. LTspice validation runs on Windows. macOS is not tested.
+
+- **Guides:** [usage](docs/usage/README.md), including the [error reference](docs/usage/errors.md).
+- **Design:** [architecture](docs/architecture.md), [phase 2 plan](docs/design/phase-2-plan.md), [phase 1 plan](docs/design/archive/phase-1/phase-1-plan.md).
+- **Development:** [testing](docs/testing.md), [changelog](CHANGELOG.md).

netlistmod-0.5.0/README.md

@@ -0,0 +1,68 @@
+# netlistmod
+
+`netlistmod` is a source-preserving SPICE netlist editing library. Its goal is
+to make permitted value and directive edits while preserving the original text
+and circuit topology.
+
+## Supported dialects
+
+The caller always selects the dialect; there is no default and no detection.
+
+| Dialect | `Dialect` | Input | Elements | Reference | Validated on |
+|---|---|---|---|---|---|
+| ngspice | `NGSPICE` | `.cir`, `.sp`, `.net`, KiCad exports | R, C, L, K, V, I, D, X; Q, M, J, Z (M13); E, F, G, H, S, W (M14); B and the expression forms (M15) | [ngspice manual](docs/references.md) | ngspice 47 |
+| LTspice | `LTSPICE` | `.net`, `.cir` (an `.asc` schematic is [exported first](docs/usage/ltspice-export.md)) | R, C, L, K, V, I, D, X; Q, M, J, Z (M13); E, F, G, H, S, W (M14); B and the expression forms (M15) | [ltspice-reference](docs/references.md) | LTspice 26.1.1, Windows |
+
+Where a solver and the library differ, the file is `docs/grammars/<dialect>/discrepancies.md`. Other
+device letters raise `UnsupportedConstruct` until their phase 2 milestone.
+
+## Quick start
+
+```bash
+pip install netlistmod
+```
+
+To work on the library itself, clone it and run `uv sync`.
+
+```python
+>>> from pathlib import Path
+>>> from tempfile import TemporaryDirectory
+>>> from netlistmod import Dialect, Netlist
+>>> folder = TemporaryDirectory()
+>>> path = Path(folder.name) / "divider.cir"
+>>> _ = path.write_bytes(b"divider\nV1 in 0 DC 3\nR1 in out 1k ; top\nR2 out 0 1k\n.op\n.end\n")
+
+>>> netlist = Netlist.load(path, dialect=Dialect.NGSPICE)
+>>> edited = netlist.set_value("R2", "3k").directives.set(".tran 1u 5u")
+>>> edited.save()
+>>> print(path.read_text(), end="")
+divider
+V1 in 0 DC 3
+R1 in out 1k ; top
+R2 out 0 3k
+.op
+.tran 1u 5u
+.end
+>>> folder.cleanup()
+
+```
+
+Every edit returns a new netlist that has been re-parsed and checked against the topology of the original. `save()` changes only the edited text: comments, spacing, line endings and encoding stay as they were. For the whole cycle with a solver, see [edit_and_simulate.py](docs/usage/examples/edit_and_simulate.py).
+
+## What it does and does not do
+
+- **Reads** titles, comments, the phase 1 elements, `.param`, `.model`, `.subckt`, the analysis, option and output directives, and LTspice's `.step`, into typed nodes with exact source spans. It answers queries about lines, references, nets and connections.
+- **Edits** values, formulas, instance and model parameters, source DC and AC values and functions, `.param` lines and directives, and adds an `.include`.
+- **Preserves** other dot-commands verbatim. `.control`, `.if`, `.include` and `.lib` are opaque: their contents are not read.
+- **Never** changes topology (elements, nodes, subcircuit ports), evaluates a value, or launches a solver.
+- **Refuses loudly.** A line outside the grammar is an error, not a guess. Netlists with Q or M devices are rejected until phase 2.
+
+## Status
+
+Phase 1 is complete, with both dialects validated on their solvers ([M9](docs/design/archive/phase-1/m9-tasks.md)), and phase 2 is under way. The current release is an alpha (`0.5.0`): the public API may still change before 1.0.
+
+Supported platforms are Linux and Windows, with Python 3.13 or newer. LTspice validation runs on Windows. macOS is not tested.
+
+- **Guides:** [usage](docs/usage/README.md), including the [error reference](docs/usage/errors.md).
+- **Design:** [architecture](docs/architecture.md), [phase 2 plan](docs/design/phase-2-plan.md), [phase 1 plan](docs/design/archive/phase-1/phase-1-plan.md).
+- **Development:** [testing](docs/testing.md), [changelog](CHANGELOG.md).

netlistmod-0.5.0/docs/decisions/README.md

@@ -0,0 +1,22 @@
+# Architecture decisions
+
+Record changes to normative architecture requirements here before implementing
+them. Use [the decision record template](TEMPLATE.md).
+
+- [0001 — Source text policy](0001-source-text-policy.md)
+- [0002 — Grammar structure policy](0002-grammar-structure-policy.md)
+- [0003 — Grammar composition and opaque regions](0003-grammar-composition-and-opaque-regions.md)
+- [0004 — Element and value grammar](0004-element-and-value-grammar.md)
+- [0005 — Statement and directive grammar](0005-statement-and-directive-grammar.md)
+- [0006 — Document layer: names, scope and diagnostics](0006-document-layer-names-scope-and-diagnostics.md)
+- [0007 — Edit lifecycle and edit semantics](0007-edit-lifecycle-and-edit-semantics.md)
+- [0008 — Validation status and solver harnesses](0008-validation-status-and-solver-harnesses.md)
+- [0009 — The LTspice dialect](0009-ltspice-dialect.md)
+- [0010 — Phase 1 close-out](0010-phase-1-close-out.md)
+- [0011 — CI and release scope](0011-ci-and-release-scope.md)
+- [0012 — Carried limits from phase 1](0012-carried-limits.md)
+- [0013 — Stimulus specs](0013-stimulus-specs.md)
+- [0014 — Transistors](0014-transistors.md)
+- [0015 — Linear dependent sources and switches](0015-controlled-sources.md)
+- [0016 — Behavioural expressions](0016-behavioral-expressions.md)
+- [0018 — Publishing to PyPI](0018-pypi-publication.md) (0017 is reserved for M15b)

netlistmod-0.5.0/docs/design/README.md

@@ -0,0 +1,48 @@
+# Design documents
+
+Active plans and design notes live in this folder. Completed work records move to
+[archive/](./archive/) so that this folder only shows what is current.
+
+## Conventions
+
+- Every document starts with a `Status:` line: `DRAFT`, `READY` (approved, not started), `ACTIVE`, `READY FOR REVIEW` (implemented, awaiting the maintainer), or `COMPLETE (date)`.
+- When a milestone or design finishes and the maintainer has **approved its review**, `git mv`
+  its task list or design note into `archive/phase-N/` (keep the file name), set the status to
+  `COMPLETE`, and fix relative links. A finished implementation is `READY FOR REVIEW`, not
+  `COMPLETE`, and stays in this folder until then. The plan that owns it keeps a link to the
+  archived record.
+- Archived files are history: do not edit them except to fix links. Changes to
+  normative behavior go through a decision record in `../decisions/`.
+- **Living references** (`elements.md`, `statements.md`, `document-layer.md`, `edit-layer.md`) describe the library as it is, not a piece of work. They stay `ACTIVE` in this folder and are not archived. A change to the public API updates them in the same commit; `tests/architecture/test_design_notes.py` fails if a public name is missing. Their state at each milestone is in Git history. They were renamed in M9 from `m3-elements.md`, `m4-statements.md`, `m5-document.md` and `m6-edits.md`, the names the archived task lists still use in prose.
+- `archive/` is grouped by phase: phase 1's records are in `archive/phase-1/` and phase 2's in `archive/phase-2/`.
+
+## Index
+
+| Document | Status |
+|---|---|
+| [phase-2-plan.md](./phase-2-plan.md) | ACTIVE |
+| [m15b-tasks.md](./m15b-tasks.md) | DRAFT |
+| [elements.md](./elements.md) | ACTIVE (living reference) |
+| [statements.md](./statements.md) | ACTIVE (living reference) |
+| [document-layer.md](./document-layer.md) | ACTIVE (living reference) |
+| [edit-layer.md](./edit-layer.md) | ACTIVE (living reference) |
+| [archive/phase-2/m10-tasks.md](./archive/phase-2/m10-tasks.md) | COMPLETE (2026-11-03) |
+| [archive/phase-2/m12-tasks.md](./archive/phase-2/m12-tasks.md) | COMPLETE (2026-11-04) |
+| [archive/phase-2/m11-tasks.md](./archive/phase-2/m11-tasks.md) | COMPLETE (2026-11-04) |
+| [archive/phase-2/m13-tasks.md](./archive/phase-2/m13-tasks.md) | COMPLETE (2026-11-06) |
+| [archive/phase-2/m14-tasks.md](./archive/phase-2/m14-tasks.md) | COMPLETE (2026-11-06) |
+| [archive/phase-2/m15-tasks.md](./archive/phase-2/m15-tasks.md) | COMPLETE (2026-11-06) |
+| [archive/phase-2/phase-2-code-changes.md](./archive/phase-2/phase-2-code-changes.md) | COMPLETE (2026-11-03) |
+| [archive/phase-1/m0-tasks.md](./archive/phase-1/m0-tasks.md) | COMPLETE (2026-10-20) |
+| [archive/phase-1/m1-tasks.md](./archive/phase-1/m1-tasks.md) | COMPLETE (2026-10-21) |
+| [archive/phase-1/m2-tasks.md](./archive/phase-1/m2-tasks.md) | COMPLETE (2026-10-30) |
+| [archive/phase-1/m2-review2-tasks.md](./archive/phase-1/m2-review2-tasks.md) | COMPLETE (2026-10-30) |
+| [archive/phase-1/m3-tasks.md](./archive/phase-1/m3-tasks.md) | COMPLETE (2026-10-30) |
+| [archive/phase-1/m4-tasks.md](./archive/phase-1/m4-tasks.md) | COMPLETE (2026-10-31) |
+| [archive/phase-1/m5-tasks.md](./archive/phase-1/m5-tasks.md) | COMPLETE (2026-10-31) |
+| [archive/phase-1/m6-tasks.md](./archive/phase-1/m6-tasks.md) | COMPLETE (2026-10-31) |
+| [archive/phase-1/m7-tasks.md](./archive/phase-1/m7-tasks.md) | COMPLETE (2026-10-31) |
+| [archive/phase-1/m8-tasks.md](./archive/phase-1/m8-tasks.md) | COMPLETE (2026-11-02) |
+| [archive/phase-1/m9-tasks.md](./archive/phase-1/m9-tasks.md) | COMPLETE (2026-11-03) |
+| [archive/phase-1/phase-1-review.md](./archive/phase-1/phase-1-review.md) | COMPLETE (2026-11-03) |
+| [archive/phase-1/phase-1-plan.md](./archive/phase-1/phase-1-plan.md) | COMPLETE (2026-11-03) |

netlistmod-0.5.0/docs/grammars/ltspice/README.md

@@ -0,0 +1,124 @@
+# LTspice grammar
+
+The LTspice grammar (M8, [decision 0009](../../decisions/0009-ltspice-dialect.md)) and its
+conformance records:
+
+- [Device-letter matrix](./devices.md) and its packaged
+  [machine-readable source](../../../src/netlistmod/grammar/ltspice-devices.json).
+- [Numbers and values](./numbers.md): numbers, the embedded decimal and formulas.
+- [Spec entries](./specs/) cite the reference and link to tests.
+- [Names](./names.md) and [scoping](./scoping.md) rules of the document layer.
+- [Discrepancies](./discrepancies.md) records where LTspice and the library differ.
+- [The LTspice export workflow](../../usage/ltspice-export.md).
+
+The manual for this dialect is `analogdevicesinc/ltspice-reference`, cited as
+`[ltspice-ref] <FILE>.md "<heading>"` ([references.md](../../references.md)). The repository records
+only syntax facts about LTspice: never its raw files, logs, or timing or performance numbers
+(decision 0009 item 2). `core_rules` in an entry names the shared rules of `core.lark` and
+`formula.lark` it relies on; `grammar` names the rules of `ltspice.lark`.
+
+## Construct survey (M8 T1)
+
+| Construct | Reference | ngspice form shared? | LTspice overlay |
+|---|---|---|---|
+| Title, `.end` | [SYNTAX] Netlist Structure | yes | `.end` takes a comment |
+| Comments | [SYNTAX] Comments and Line Continuation | `*` and `;` only | `;` lines, ` $ `; no `//` |
+| Continuation | same | `+` only | no `\\` |
+| Separators | element syntax | blanks only | commas in few places |
+| Names | [SYNTAX] Node Naming | no | own character set, Unicode fold, `$G_*` |
+| Numbers | [SYNTAX] Engineering Multipliers | standard form | embedded decimal in every slot, any trailing letters |
+| R | [ELEMENTS] R | value, formula | `tc` list, closed list; no model or keyword form |
+| C, L | [ELEMENTS] C, L | value, formula; C `Q=`, L `Flux=` and the hysteretic core (M15) | closed lists; no parameters on `Flux=` or the hysteretic core |
+| V, I | [ELEMENTS] V, I | DC, AC | `AC=`, `Rser`, `Cpar`, `load`, `R=` |
+| D | [ELEMENTS] D | model | positional area, closed list |
+| X, `.subckt` | [ELEMENTS] X, [COMMANDS] .SUBCKT | yes | `params:` accepted |
+| K | [ELEMENTS] K | yes | |
+| `.param` | [COMMANDS] .PARAM | `=` with a number or formula | no `=`, bare expressions, other names |
+| `.model` | [COMMANDS] .MODEL | yes | `ako:` |
+| `.tran` | [COMMANDS] .TRAN | yes | one argument, modifiers |
+| `.ac` | [COMMANDS] .AC | yes | `list`, `file=` |
+| `.dc` | [COMMANDS] .DC | yes | three sweeps, variation, `list`, `file=` |
+| `.op` | [COMMANDS] .OP | yes | |
+| `.temp` | [COMMANDS] .TEMP | one value | a list |
+| `.options` | [COMMANDS] .OPTIONS | yes | `.opt` |
+| `.ic`, `.nodeset` | [TROUBLE] | `v(n)=` | no `all=` |
+| `.save` | [COMMANDS] .SAVE | `v()`, `i()` | device currents, wildcards; no plain names |
+| `.meas` | [COMMANDS] .MEASURE | yes | optional analysis, `noise`, `op`; no `sp` |
+| `.global` | [COMMANDS] .GLOBAL | yes | |
+| `.step` | [COMMANDS] .STEP | no | new typed node |
+| Other dot-commands | [COMMANDS] | no | closed list |
+
+## Validation status
+
+Status words have the meanings of
+[decision 0008](../../decisions/0008-validation-status-and-solver-harnesses.md);
+`tests/architecture/test_spec_coverage.py` checks each against its evidence and this table against
+the entries. The probes are in `tests/solver/test_ltspice_validation.py`; a part of an entry that the
+reference does not mention is marked observed in the entry's notes (§11.3 rule 3).
+
+| Entry | Construct | Status | Validated on |
+|---|---|---|---|
+| [LT-ACA-001](./specs/LT-ACA-001.yaml) | .ac | validated | ltspice 26.1.1 (2026-11-01) |
+| [LT-BEH-001](./specs/LT-BEH-001.yaml) | behavioral source (B) lines | validated | ltspice 26.1.1 (2026-11-06) |
+| [LT-BJT-001](./specs/LT-BJT-001.yaml) | bipolar transistor (Q) lines | validated | ltspice 26.1.1 (2026-11-05) |
+| [LT-CAP-001](./specs/LT-CAP-001.yaml) | capacitor (C) lines | validated | ltspice 26.1.1 (2026-11-01, 2026-11-06) |
+| [LT-CCC-001](./specs/LT-CCC-001.yaml) | current-dependent current source (F) lines | validated | ltspice 26.1.1 (2026-11-06) |
+| [LT-CCV-001](./specs/LT-CCV-001.yaml) | current-dependent voltage source (H) lines | validated | ltspice 26.1.1 (2026-11-06) |
+| [LT-CNT-001](./specs/LT-CNT-001.yaml) | + continuation lines | validated | ltspice 26.1.1 (2026-11-01) |
+| [LT-COM-001](./specs/LT-COM-001.yaml) | comment lines (* and ;) | validated | ltspice 26.1.1 (2026-11-01) |
+| [LT-COM-002](./specs/LT-COM-002.yaml) | end-of-line comments (; and space-$-space) | validated | ltspice 26.1.1 (2026-11-01) |
+| [LT-CTL-001](./specs/LT-CTL-001.yaml) | shared shape of the linear dependent sources and switches | validated | ltspice 26.1.1 (2026-11-06) |
+| [LT-DCA-001](./specs/LT-DCA-001.yaml) | .dc | validated | ltspice 26.1.1 (2026-11-01) |
+| [LT-DIO-001](./specs/LT-DIO-001.yaml) | diode (D) lines | validated | ltspice 26.1.1 (2026-11-01) |
+| [LT-DIR-001](./specs/LT-DIR-001.yaml) | closed list of dot-commands | validated | ltspice 26.1.1 (2026-11-01) |
+| [LT-END-001](./specs/LT-END-001.yaml) | required final .end | validated | ltspice 26.1.1 (2026-11-01) |
+| [LT-FLD-001](./specs/LT-FLD-001.yaml) | field separators | validated | ltspice 26.1.1 (2026-11-01) |
+| [LT-FML-001](./specs/LT-FML-001.yaml) | formula expression syntax (reference scan only) | validated | ltspice 26.1.1 (2026-11-01) |
+| [LT-FUN-001](./specs/LT-FUN-001.yaml) | source functions, shared syntax | validated | ltspice 26.1.1 (2026-11-04) |
+| [LT-FUN-002](./specs/LT-FUN-002.yaml) | PULSE | validated | ltspice 26.1.1 (2026-11-04) |
+| [LT-FUN-003](./specs/LT-FUN-003.yaml) | SINE and SIN | validated | ltspice 26.1.1 (2026-11-04) |
+| [LT-FUN-004](./specs/LT-FUN-004.yaml) | EXP | validated | ltspice 26.1.1 (2026-11-04) |
+| [LT-FUN-005](./specs/LT-FUN-005.yaml) | SFFM | validated | ltspice 26.1.1 (2026-11-04) |
+| [LT-FUN-006](./specs/LT-FUN-006.yaml) | PWL with its scale factors and file | validated | ltspice 26.1.1 (2026-11-04) |
+| [LT-FUN-007](./specs/LT-FUN-007.yaml) | PWL REPEAT | validated | ltspice 26.1.1 (2026-11-04) |
+| [LT-FUN-008](./specs/LT-FUN-008.yaml) | wave file | validated | ltspice 26.1.1 (2026-11-04) |
+| [LT-FUN-009](./specs/LT-FUN-009.yaml) | I table | validated | ltspice 26.1.1 (2026-11-04) |
+| [LT-FUN-010](./specs/LT-FUN-010.yaml) | I step load | validated | ltspice 26.1.1 (2026-11-04) |
+| [LT-GLB-001](./specs/LT-GLB-001.yaml) | .global | validated | ltspice 26.1.1 (2026-11-01) |
+| [LT-ICN-001](./specs/LT-ICN-001.yaml) | .ic and .nodeset | validated | ltspice 26.1.1 (2026-11-01) |
+| [LT-IND-001](./specs/LT-IND-001.yaml) | inductor (L) lines | validated | ltspice 26.1.1 (2026-11-01, 2026-11-06) |
+| [LT-JFT-001](./specs/LT-JFT-001.yaml) | junction FET (J) lines | validated | ltspice 26.1.1 (2026-11-05) |
+| [LT-MCH-001](./specs/LT-MCH-001.yaml) | .machine blocks | validated | ltspice 26.1.1 (2026-11-01) |
+| [LT-MEA-001](./specs/LT-MEA-001.yaml) | .meas and .measure | validated | ltspice 26.1.1 (2026-11-01) |
+| [LT-MES-001](./specs/LT-MES-001.yaml) | MESFET and IGBT (Z) lines | validated | ltspice 26.1.1 (2026-11-05) |
+| [LT-MOD-001](./specs/LT-MOD-001.yaml) | .model statements | validated | ltspice 26.1.1 (2026-11-01, 2026-11-05) |
+| [LT-MOS-001](./specs/LT-MOS-001.yaml) | MOSFET and VDMOS (M) lines | validated | ltspice 26.1.1 (2026-11-05) |
+| [LT-MUT-001](./specs/LT-MUT-001.yaml) | mutual inductance (K) lines | validated | ltspice 26.1.1 (2026-11-01) |
+| [LT-NLS-001](./specs/LT-NLS-001.yaml) | expression forms of the dependent sources (value= on E, F, G and H) | validated | ltspice 26.1.1 (2026-11-06) |
+| [LT-NOD-001](./specs/LT-NOD-001.yaml) | node, element and subcircuit names | validated | ltspice 26.1.1 (2026-11-01) |
+| [LT-NUM-001](./specs/LT-NUM-001.yaml) | numbers | validated | ltspice 26.1.1 (2026-11-01) |
+| [LT-NUM-002](./specs/LT-NUM-002.yaml) | letters following a number | validated | ltspice 26.1.1 (2026-11-01) |
+| [LT-NUM-003](./specs/LT-NUM-003.yaml) | embedded decimal | validated | ltspice 26.1.1 (2026-11-01) |
+| [LT-NUM-004](./specs/LT-NUM-004.yaml) | micro signs | validated | ltspice 26.1.1 (2026-11-01) |
+| [LT-OPA-001](./specs/LT-OPA-001.yaml) | opaque .include, .inc and .lib, and .lib blocks | validated | ltspice 26.1.1 (2026-11-01) |
+| [LT-OPP-001](./specs/LT-OPP-001.yaml) | .op | validated | ltspice 26.1.1 (2026-11-01) |
+| [LT-OPT-001](./specs/LT-OPT-001.yaml) | .options, .option and .opt | validated | ltspice 26.1.1 (2026-11-01) |
+| [LT-PRM-001](./specs/LT-PRM-001.yaml) | .param assignments | validated | ltspice 26.1.1 (2026-11-01) |
+| [LT-RES-001](./specs/LT-RES-001.yaml) | resistor (R) lines | validated | ltspice 26.1.1 (2026-11-01) |
+| [LT-SAV-001](./specs/LT-SAV-001.yaml) | .save | validated | ltspice 26.1.1 (2026-11-01) |
+| [LT-SBD-001](./specs/LT-SBD-001.yaml) | .subckt ... .ends definitions | validated | ltspice 26.1.1 (2026-11-01) |
+| [LT-SRC-001](./specs/LT-SRC-001.yaml) | independent sources (V, I) | validated | ltspice 26.1.1 (2026-11-01) |
+| [LT-STP-001](./specs/LT-STP-001.yaml) | .step | validated | ltspice 26.1.1 (2026-11-01) |
+| [LT-STR-001](./specs/LT-STR-001.yaml) | top-level source structure | validated | ltspice 26.1.1 (2026-11-01) |
+| [LT-SUB-001](./specs/LT-SUB-001.yaml) | subcircuit calls (X) | validated | ltspice 26.1.1 (2026-11-01) |
+| [LT-SWC-001](./specs/LT-SWC-001.yaml) | current-controlled switch (W) lines | validated | ltspice 26.1.1 (2026-11-06) |
+| [LT-SWV-001](./specs/LT-SWV-001.yaml) | voltage-controlled switch (S) lines | validated | ltspice 26.1.1 (2026-11-06) |
+| [LT-TMP-001](./specs/LT-TMP-001.yaml) | .temp | validated | ltspice 26.1.1 (2026-11-01) |
+| [LT-TRN-001](./specs/LT-TRN-001.yaml) | .tran | validated | ltspice 26.1.1 (2026-11-01) |
+| [LT-TTL-001](./specs/LT-TTL-001.yaml) | implicit first-line title and .title | validated | ltspice 26.1.1 (2026-11-01) |
+| [LT-TXT-001](./specs/LT-TXT-001.yaml) | statement text | validated | ltspice 26.1.1 (2026-11-01) |
+| [LT-UNS-001](./specs/LT-UNS-001.yaml) | recognised but unsupported forms | validated | ltspice 26.1.1 (2026-11-01) |
+| [LT-VAL-001](./specs/LT-VAL-001.yaml) | brace and quoted expressions | validated | ltspice 26.1.1 (2026-11-01) |
+| [LT-VCC-001](./specs/LT-VCC-001.yaml) | voltage-dependent current source (G) lines | validated | ltspice 26.1.1 (2026-11-06) |
+| [LT-VCV-001](./specs/LT-VCV-001.yaml) | voltage-dependent voltage source (E) lines | validated | ltspice 26.1.1 (2026-11-06) |
+| [LT-XTR-001](./specs/LT-XTR-001.yaml) | shared transistor line shape (Q, M, J, Z) | validated | ltspice 26.1.1 (2026-11-05) |

netlistmod-0.5.0/docs/grammars/ngspice/README.md

@@ -0,0 +1,87 @@
+# ngspice grammar
+
+The ngspice grammar (M2 structure, M3 elements and values) and its conformance
+records are tracked here:
+
+- [Device-letter matrix](./devices.md) and its packaged
+  [machine-readable source](../../../src/netlistmod/grammar/ngspice-devices.json).
+- [Numbers and values](./numbers.md): number, RKM and formula rules.
+- [Spec entries](./specs/) cite the ngspice manual and link to tests.
+- [Names](./names.md) and [scoping](./scoping.md) rules of the document layer.
+- [Discrepancies](./discrepancies.md) records probe results that differ from
+  or extend the manual.
+
+## Validation status
+
+Status words have the meanings of
+[decision 0008](../../decisions/0008-validation-status-and-solver-harnesses.md);
+`tests/architecture/test_spec_coverage.py` checks each against its solver evidence and this
+table against the entries. Re-validating appends a version to an entry (docs/testing.md).
+
+| Entry | Construct | Status | Validated on |
+|---|---|---|---|
+| [NG-ACA-001](./specs/NG-ACA-001.yaml) | .ac small-signal analysis | validated | ngspice 47 (2026-10-30, 2026-10-31) |
+| [NG-BEH-001](./specs/NG-BEH-001.yaml) | behavioral source (B) lines | validated | ngspice 47 (2026-11-06) |
+| [NG-BJT-001](./specs/NG-BJT-001.yaml) | bipolar transistor (Q) lines | validated | ngspice 47 (2026-11-05) |
+| [NG-CAP-001](./specs/NG-CAP-001.yaml) | capacitor (C) lines | validated | ngspice 47 (2026-10-30, 2026-10-31, 2026-11-06) |
+| [NG-CCC-001](./specs/NG-CCC-001.yaml) | current-controlled current source (F) lines | validated | ngspice 47 (2026-11-06) |
+| [NG-CCV-001](./specs/NG-CCV-001.yaml) | current-controlled voltage source (H) lines | validated | ngspice 47 (2026-11-06) |
+| [NG-CNT-001](./specs/NG-CNT-001.yaml) | immediately adjacent continuation lines (+ and trailing \\) | validated | ngspice 47 (2026-10-30, 2026-10-31) |
+| [NG-COM-001](./specs/NG-COM-001.yaml) | full-line star comments | observed | ngspice 47 (2026-10-30, 2026-10-31) |
+| [NG-CTL-001](./specs/NG-CTL-001.yaml) | shared shape of the linear dependent sources and switches | validated | ngspice 47 (2026-11-06) |
+| [NG-DCA-001](./specs/NG-DCA-001.yaml) | .dc transfer function | validated | ngspice 47 (2026-10-30, 2026-10-31) |
+| [NG-DIO-001](./specs/NG-DIO-001.yaml) | junction diode (D) lines | validated | ngspice 47 (2026-10-30, 2026-10-31) |
+| [NG-DIR-001](./specs/NG-DIR-001.yaml) | unknown dot-commands and stray block terminators | validated | ngspice 47 (2026-10-31) |
+| [NG-END-001](./specs/NG-END-001.yaml) | required final .end statement | validated | ngspice 47 (2026-10-30, 2026-10-31) |
+| [NG-FLD-001](./specs/NG-FLD-001.yaml) | element field separators: blanks, one comma, = with blanks, continuation | validated | ngspice 47 (2026-10-30, 2026-10-31) |
+| [NG-FML-001](./specs/NG-FML-001.yaml) | Formula expression syntax (reference scan only) | validated | ngspice 47 (2026-10-31) |
+| [NG-FUN-001](./specs/NG-FUN-001.yaml) | source functions, shared syntax | validated | ngspice 47 (2026-11-04) |
+| [NG-FUN-002](./specs/NG-FUN-002.yaml) | PULSE | validated | ngspice 47 (2026-11-04) |
+| [NG-FUN-003](./specs/NG-FUN-003.yaml) | SIN, and SINE | validated | ngspice 47 (2026-11-04) |
+| [NG-FUN-004](./specs/NG-FUN-004.yaml) | EXP | validated | ngspice 47 (2026-11-04) |
+| [NG-FUN-005](./specs/NG-FUN-005.yaml) | PWL with r= and td= | validated | ngspice 47 (2026-11-04) |
+| [NG-FUN-006](./specs/NG-FUN-006.yaml) | SFFM | validated | ngspice 47 (2026-11-04) |
+| [NG-FUN-007](./specs/NG-FUN-007.yaml) | AM | validated | ngspice 47 (2026-11-04) |
+| [NG-FUN-008](./specs/NG-FUN-008.yaml) | TRNOISE | validated | ngspice 47 (2026-11-04) |
+| [NG-FUN-009](./specs/NG-FUN-009.yaml) | TRRANDOM | validated | ngspice 47 (2026-11-04) |
+| [NG-FUN-010](./specs/NG-FUN-010.yaml) | EXTERNAL | validated | ngspice 47 (2026-11-04) |
+| [NG-FUN-011](./specs/NG-FUN-011.yaml) | DISTOF1 and DISTOF2 | validated | ngspice 47 (2026-11-04) |
+| [NG-FUN-012](./specs/NG-FUN-012.yaml) | RF port parameters | validated | ngspice 47 (2026-11-04) |
+| [NG-GLB-001](./specs/NG-GLB-001.yaml) | .global node declarations | validated | ngspice 47 (2026-10-31) |
+| [NG-ICN-001](./specs/NG-ICN-001.yaml) | .ic and .nodeset | validated | ngspice 47 (2026-10-30, 2026-10-31) |
+| [NG-IND-001](./specs/NG-IND-001.yaml) | inductor (L) lines | validated | ngspice 47 (2026-10-30, 2026-10-31) |
+| [NG-JFT-001](./specs/NG-JFT-001.yaml) | junction FET (J) lines | validated | ngspice 47 (2026-11-05) |
+| [NG-MEA-001](./specs/NG-MEA-001.yaml) | .meas / .measure (shallow) | validated | ngspice 47 (2026-10-30, 2026-10-31) |
+| [NG-MES-001](./specs/NG-MES-001.yaml) | MESFET (Z) lines | validated | ngspice 47 (2026-11-05) |
+| [NG-MOD-001](./specs/NG-MOD-001.yaml) | .model statements | validated | ngspice 47 (2026-10-30, 2026-10-31, 2026-11-05) |
+| [NG-MOS-001](./specs/NG-MOS-001.yaml) | MOSFET and VDMOS (M) lines | validated | ngspice 47 (2026-11-05) |
+| [NG-MUT-001](./specs/NG-MUT-001.yaml) | mutual coupling (K) lines | validated | ngspice 47 (2026-10-30, 2026-10-31) |
+| [NG-NLS-001](./specs/NG-NLS-001.yaml) | expression forms of the dependent sources (E vol= and value, G cur= and value) | validated | ngspice 47 (2026-11-06) |
+| [NG-NOD-001](./specs/NG-NOD-001.yaml) | node, model, subcircuit and parameter names | validated | ngspice 47 (2026-10-31) |
+| [NG-NUM-001](./specs/NG-NUM-001.yaml) | numbers: sign, mantissa, exponent and scale factor | validated | ngspice 47 (2026-10-30, 2026-10-31) |
+| [NG-NUM-002](./specs/NG-NUM-002.yaml) | letters following a number | validated | ngspice 47 (2026-10-30, 2026-10-31) |
+| [NG-NUM-003](./specs/NG-NUM-003.yaml) | RKM notation for R and C values (parser option rkm) | validated | ngspice 47 (2026-10-30, 2026-10-31) |
+| [NG-NUM-004](./specs/NG-NUM-004.yaml) | micro sign as a scale factor | observed | ngspice 47 (2026-10-30, 2026-10-31) |
+| [NG-OPA-001](./specs/NG-OPA-001.yaml) | opaque .control and nested .if blocks | validated | ngspice 47 (2026-10-22, 2026-10-31) |
+| [NG-OPA-002](./specs/NG-OPA-002.yaml) | opaque .include and .lib statements, and .lib blocks | validated | ngspice 47 (2026-10-30, 2026-10-31) |
+| [NG-OPP-001](./specs/NG-OPP-001.yaml) | .op operating point | validated | ngspice 47 (2026-10-30, 2026-10-31) |
+| [NG-OPT-001](./specs/NG-OPT-001.yaml) | .options / .option | validated | ngspice 47 (2026-10-30, 2026-10-31) |
+| [NG-PAR-001](./specs/NG-PAR-001.yaml) | instance parameters, model references and the off flag | validated | ngspice 47 (2026-10-31) |
+| [NG-PRM-001](./specs/NG-PRM-001.yaml) | .param assignments | validated | ngspice 47 (2026-10-30, 2026-10-31) |
+| [NG-RES-001](./specs/NG-RES-001.yaml) | resistor (R) lines | validated | ngspice 47 (2026-10-30, 2026-10-31) |
+| [NG-SAV-001](./specs/NG-SAV-001.yaml) | .save output vectors | validated | ngspice 47 (2026-10-31) |
+| [NG-SBD-001](./specs/NG-SBD-001.yaml) | .subckt ... .ends definitions and their bodies | validated | ngspice 47 (2026-10-30, 2026-10-31) |
+| [NG-SRC-001](./specs/NG-SRC-001.yaml) | independent sources (V, I): DC value and AC magnitude and phase | validated | ngspice 47 (2026-10-30, 2026-10-31) |
+| [NG-STR-001](./specs/NG-STR-001.yaml) | top-level source structure | validated | ngspice 47 (2026-10-31) |
+| [NG-SUB-001](./specs/NG-SUB-001.yaml) | subcircuit calls (X) | validated | ngspice 47 (2026-10-30, 2026-10-31) |
+| [NG-SWC-001](./specs/NG-SWC-001.yaml) | current-controlled switch (W) lines | validated | ngspice 47 (2026-11-06) |
+| [NG-SWV-001](./specs/NG-SWV-001.yaml) | voltage-controlled switch (S) lines | validated | ngspice 47 (2026-11-06) |
+| [NG-TMP-001](./specs/NG-TMP-001.yaml) | .temp | validated | ngspice 47 (2026-10-30, 2026-10-31) |
+| [NG-TRN-001](./specs/NG-TRN-001.yaml) | .tran transient analysis | validated | ngspice 47 (2026-10-30, 2026-10-31) |
+| [NG-TTL-001](./specs/NG-TTL-001.yaml) | implicit first-line title and explicit .title | validated | ngspice 47 (2026-10-22, 2026-10-31) |
+| [NG-TXT-001](./specs/NG-TXT-001.yaml) | free text, quoted and braced segments, and trailing comments | observed | ngspice 47 (2026-10-30, 2026-10-31) |
+| [NG-UNS-001](./specs/NG-UNS-001.yaml) | recognised but unsupported element forms | validated | ngspice 47 (2026-10-31) |
+| [NG-VAL-001](./specs/NG-VAL-001.yaml) | brace and quoted expressions, and string parameter values | validated | ngspice 47 (2026-10-31) |
+| [NG-VCC-001](./specs/NG-VCC-001.yaml) | voltage-controlled current source (G) lines | validated | ngspice 47 (2026-11-06) |
+| [NG-VCV-001](./specs/NG-VCV-001.yaml) | voltage-controlled voltage source (E) lines | validated | ngspice 47 (2026-11-06) |
+| [NG-XTR-001](./specs/NG-XTR-001.yaml) | shared transistor line shape (Q, M, J, Z) | validated | ngspice 47 (2026-11-05) |

netlistmod-0.5.0/docs/usage/README.md

@@ -0,0 +1,20 @@
+# Usage guides
+
+The examples in these guides are executed by the test suite. Each guide says which dialect it covers.
+
+| Guide | Covers |
+|---|---|
+| [Parsing structural source](./structural-parse.md) | Titles, comments, continuations and opaque items |
+| [Parsing element lines](./elements.md) | R, C, L, K, V, I, D and X |
+| [Parsing statements and directives](./statements.md) | `.param`, `.model`, `.subckt` and the directives |
+| [Reading a netlist](./document.md) | Lines, references, nets and diagnostics |
+| [Editing a netlist](./editing.md) | Every edit, verification and `save()` |
+| [Errors and diagnostics](./errors.md) | Each exception and diagnostic code, and what to do |
+| [Exporting from LTspice](./ltspice-export.md) | From an `.asc` schematic to a netlist, and batch runs |
+
+Examples you can run:
+
+- [read_only_demo.py](./examples/read_only_demo.py): what the library sees in a KiCad export.
+- [edit_and_simulate.py](./examples/edit_and_simulate.py): load, edit, save and run `.op` in a solver, on a built-in divider or your own netlist, and print a net's voltage. It takes `--dialect`, `--edit-value`, `--probe` and `--rkm`.
+
+See [the architecture](../architecture.md) for the design and its constraints.

netlistmod-0.5.0/pyproject.toml

@@ -0,0 +1,101 @@
+[build-system]
+requires = ["hatchling>=1.26"]
+build-backend = "hatchling.build"
+
+[project]
+name = "netlistmod"
+version = "0.5.0"
+description = "A source-preserving SPICE netlist editing library"
+readme = "README.md"
+requires-python = ">=3.13"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "xdylanm" }]
+keywords = ["spice", "netlist", "ngspice", "ltspice", "parser", "editor"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Science/Research",
+    "Operating System :: Microsoft :: Windows",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Scientific/Engineering :: Electronic Design Automation (EDA)",
+    "Typing :: Typed",
+]
+dependencies = ["lark>=1.2.2", "interegular>=0.3.3"]
+
+[project.urls]
+Homepage = "https://github.com/xdylanm/netlistmod"
+Repository = "https://github.com/xdylanm/netlistmod"
+Changelog = "https://github.com/xdylanm/netlistmod/blob/main/CHANGELOG.md"
+
+[dependency-groups]
+dev = [
+    "build>=1.2",
+    "hypothesis>=6.100",
+    "import-linter>=2.1",
+    "mypy>=1.13",
+    "pre-commit>=4.0",
+    "pytest>=8.3",
+    "pytest-cov>=6.0",
+    "PyYAML>=6.0",
+    "ruff>=0.8",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/netlistmod"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "src/netlistmod",
+    "README.md",
+    "LICENSE",
+]
+
+[tool.ruff]
+target-version = "py313"
+line-length = 100
+extend-exclude = ["prototype/**", "docs/architecture.md"]
+
+[tool.ruff.lint]
+select = ["E", "F", "I"]
+
+[tool.mypy]
+python_version = "3.13"
+strict = true
+files = ["src/netlistmod"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = ["--strict-markers", "--cov=netlistmod", "--cov-report=term-missing"]
+markers = [
+    "solver(name): test requiring a local solver (ngspice or ltspice)",
+    "ngspice_only: text only ngspice accepts; deselected in the LTspice run (M8 decision 16)",
+    "ltspice_only: text only LTspice accepts; deselected in the ngspice run (M8 decision 16)",
+]
+
+[tool.coverage.run]
+branch = true
+source = ["netlistmod"]
+
+[tool.coverage.report]
+fail_under = 90
+show_missing = true
+
+[tool.importlinter]
+root_package = "netlistmod"
+
+[[tool.importlinter.contracts]]
+name = "Package layers follow the architecture"
+type = "layers"
+layers = [
+    "netlistmod.edit",
+    "netlistmod.document",
+    "netlistmod.model",
+    "netlistmod.grammar",
+    "netlistmod.source",
+    "netlistmod.errors",
+    "netlistmod.dialects",
+]