netlistmod 0.5.0__py3-none-any.whl

netlistmod/__init__.py

@@ -0,0 +1,211 @@
+"""Source-preserving SPICE netlist editing."""
+
+from importlib.metadata import version
+
+from netlistmod.dialects import Dialect
+from netlistmod.document import (
+    Connection,
+    Diagnostic,
+    DiagnosticCode,
+    ExpressionRead,
+    Line,
+    Lines,
+    Net,
+    Reference,
+    Scope,
+    TopologySignature,
+    TopologyView,
+)
+from netlistmod.edit import (
+    Batch,
+    DirectiveEditor,
+    Edit,
+    EditPlan,
+    Netlist,
+    ParamTable,
+    Placement,
+    SlotCheck,
+    apply_edits,
+)
+from netlistmod.errors import (
+    EditError,
+    EncodingError,
+    ParseError,
+    SpiceNetlistError,
+    TopologyError,
+    TopologyViolation,
+    UnsupportedConstruct,
+)
+from netlistmod.model import (
+    AcDirective,
+    AcSpec,
+    BehavioralSource,
+    BipolarTransistor,
+    BlankLine,
+    Capacitor,
+    Cccs,
+    Ccvs,
+    CommentLine,
+    Component,
+    ControlledSource,
+    CurrentSource,
+    CurrentSwitch,
+    DcDirective,
+    DcSweep,
+    Diode,
+    Directive,
+    ElementReference,
+    End,
+    EndsLine,
+    Flag,
+    Formula,
+    GlobalDirective,
+    IcDirective,
+    Identifier,
+    Inductor,
+    Jfet,
+    MeasureDirective,
+    Mesfet,
+    ModelReference,
+    ModelStatement,
+    Mosfet,
+    MutualCoupling,
+    Node,
+    NodeCondition,
+    NodesetDirective,
+    NumericValue,
+    OpaqueBlock,
+    OpaqueStatement,
+    OpDirective,
+    OptionItem,
+    OptionsDirective,
+    OutputVector,
+    ParamAssignment,
+    ParamStatement,
+    ParseResult,
+    Resistor,
+    SaveDirective,
+    SourceSpec,
+    StepDirective,
+    SubcktDefinition,
+    SubcktInstance,
+    SubcktReference,
+    Switch,
+    TempDirective,
+    Title,
+    TitleDirective,
+    TranDirective,
+    Transistor,
+    UnknownDirective,
+    Value,
+    ValueList,
+    Vccs,
+    Vcvs,
+    VoltageSource,
+    VoltageSwitch,
+)
+from netlistmod.model.transform import parse
+from netlistmod.source import SourceText, Span
+
+__version__ = version("netlistmod")
+
+__all__ = [
+    "AcDirective",
+    "AcSpec",
+    "Batch",
+    "BlankLine",
+    "Capacitor",
+    "CommentLine",
+    "Component",
+    "Connection",
+    "ExpressionRead",
+    "CurrentSource",
+    "DcDirective",
+    "DcSweep",
+    "Diagnostic",
+    "DiagnosticCode",
+    "Dialect",
+    "BehavioralSource",
+    "BipolarTransistor",
+    "Diode",
+    "Jfet",
+    "Mesfet",
+    "Mosfet",
+    "Directive",
+    "DirectiveEditor",
+    "Edit",
+    "EditError",
+    "EditPlan",
+    "ElementReference",
+    "EncodingError",
+    "End",
+    "EndsLine",
+    "Flag",
+    "Formula",
+    "GlobalDirective",
+    "IcDirective",
+    "Identifier",
+    "Inductor",
+    "Line",
+    "Lines",
+    "MeasureDirective",
+    "ModelReference",
+    "ModelStatement",
+    "MutualCoupling",
+    "Net",
+    "Netlist",
+    "Node",
+    "NodeCondition",
+    "NodesetDirective",
+    "NumericValue",
+    "OpDirective",
+    "OpaqueBlock",
+    "OpaqueStatement",
+    "OptionItem",
+    "OptionsDirective",
+    "OutputVector",
+    "ParamAssignment",
+    "ParamStatement",
+    "ParamTable",
+    "ParseError",
+    "ParseResult",
+    "Placement",
+    "Reference",
+    "Resistor",
+    "SaveDirective",
+    "StepDirective",
+    "Scope",
+    "SlotCheck",
+    "SourceText",
+    "Span",
+    "SpiceNetlistError",
+    "SubcktDefinition",
+    "SourceSpec",
+    "SubcktInstance",
+    "Transistor",
+    "Cccs",
+    "ControlledSource",
+    "Ccvs",
+    "CurrentSwitch",
+    "Switch",
+    "Vccs",
+    "Vcvs",
+    "VoltageSwitch",
+    "SubcktReference",
+    "TempDirective",
+    "Title",
+    "TitleDirective",
+    "TopologyError",
+    "TopologySignature",
+    "TopologyView",
+    "TopologyViolation",
+    "TranDirective",
+    "UnknownDirective",
+    "UnsupportedConstruct",
+    "Value",
+    "ValueList",
+    "VoltageSource",
+    "__version__",
+    "apply_edits",
+    "parse",
+]

netlistmod/dialects.py

@@ -0,0 +1,25 @@
+"""SPICE dialect names supported by netlistmod."""
+
+from enum import Enum
+
+
+class Dialect(str, Enum):
+    """A supported SPICE dialect; callers must select one explicitly."""
+
+    NGSPICE = "ngspice"
+    LTSPICE = "ltspice"
+
+    @property
+    def display_name(self) -> str:
+        """Return the conventional display name for this dialect."""
+        return "LTspice" if self is Dialect.LTSPICE else "ngspice"
+
+    @classmethod
+    def from_name(cls, name: str) -> "Dialect":
+        """Parse a dialect value or enum name, without regard to case."""
+        normalized = name.strip().casefold()
+        for dialect in cls:
+            if normalized in {dialect.value.casefold(), dialect.name.casefold()}:
+                return dialect
+        valid_names = ", ".join(dialect.value for dialect in cls)
+        raise ValueError(f"Unknown dialect {name!r}; valid names are: {valid_names}")

netlistmod/document/__init__.py

@@ -0,0 +1,36 @@
+"""Netlist document and read-only indexes."""
+
+from netlistmod.document.diagnostics import Diagnostic, DiagnosticCode, Severity
+from netlistmod.document.document import Netlist
+from netlistmod.document.index import Reference, ReferenceKind, Scope
+from netlistmod.document.lines import Line, Lines, ScopePath
+from netlistmod.document.names import GROUND, fold, is_ground, net_name
+from netlistmod.document.topology import (
+    Connection,
+    ExpressionRead,
+    Net,
+    TopologySignature,
+    TopologyView,
+)
+
+__all__ = [
+    "GROUND",
+    "Connection",
+    "ExpressionRead",
+    "Diagnostic",
+    "DiagnosticCode",
+    "Line",
+    "Lines",
+    "Net",
+    "Netlist",
+    "Reference",
+    "ReferenceKind",
+    "Scope",
+    "ScopePath",
+    "Severity",
+    "TopologySignature",
+    "TopologyView",
+    "fold",
+    "is_ground",
+    "net_name",
+]