modelica 0.0.1__py3-none-any.whl

modelica/__init__.py

@@ -0,0 +1,21 @@
+"""Pure-Python Modelica toolchain: parse, flatten, simulate, exchange.
+
+The package is layered, and each layer is usable without the ones above it:
+
+* ``modelica.lang``  -- Modelica source -> tokens -> AST (hand-written lexer/parser).
+* ``modelica.ir``    -- AST -> flat model: variables, equations, an expression IR;
+  then matching/BLT sorting and index reduction down to a solvable system.
+* ``modelica.sim``   -- the flat model as an ODE/DAE problem plus solver backends and
+  event (zero-crossing) handling.
+* ``modelica.fmi``   -- FMI 3.0: read/simulate an existing FMU, and export a flat model
+  as one.
+* ``modelica.ssp``   -- SSP 2.0: system composition (.ssd/.ssv/.ssb inside a .ssp) and a
+  co-simulation master over the components it names.
+
+``import modelica`` pulls in no third-party dependency; numerics live behind the ``sim``
+extra so that tooling which only reads model *structure* stays cheap to install.
+"""
+
+__version__ = "0.0.1"
+
+__all__ = ["__version__"]

modelica-0.0.1.dist-info/METADATA

@@ -0,0 +1,106 @@
+Metadata-Version: 2.4
+Name: modelica
+Version: 0.0.1
+Summary: Pure-Python Modelica toolchain: parse, flatten, simulate, and exchange via FMI 3.0 and SSP 2.0
+Project-URL: Homepage, https://gitlab.com/jorgeecardona/pymodelica
+Project-URL: Repository, https://gitlab.com/jorgeecardona/pymodelica
+Project-URL: Changelog, https://gitlab.com/jorgeecardona/pymodelica/-/blob/main/CHANGELOG.md
+Project-URL: Documentation, https://jorgeecardona.gitlab.io/pymodelica/
+Author-email: Jorge Cardona <jorgeecardona@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: co-simulation,dae,digital-twin,fmi,fmu,modelica,simulation,ssp,system-modeling
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Provides-Extra: docs
+Requires-Dist: mkdocs-material>=9.5; extra == 'docs'
+Requires-Dist: mkdocs>=1.6; extra == 'docs'
+Provides-Extra: sim
+Requires-Dist: numpy>=2.0; extra == 'sim'
+Requires-Dist: scipy>=1.13; extra == 'sim'
+Provides-Extra: sundials
+Requires-Dist: scikit-sundae>=1.0; extra == 'sundials'
+Description-Content-Type: text/markdown
+
+# modelica
+
+A pure-Python Modelica toolchain: **parse** Modelica, **flatten** it to a DAE, **simulate**
+it, and interoperate with the two Modelica Association exchange standards — **FMI 3.0**
+for single components and **SSP 2.0** for systems of them.
+
+> Distribution name is `modelica`; the git repo keeps its historical name `pymodelica`.
+> (PyPI's `pymodelica` is held by an abandoned Modelon/JModelica.org upload.)
+
+```bash
+pip install modelica          # core: parse + model structure, zero dependencies
+pip install "modelica[sim]"   # + numpy/scipy for simulation
+```
+
+## Status
+
+Pre-alpha. This is a **full rewrite** of a 2010 Python 2 experiment — none of that code
+survives, only the goal. Python 3.11+.
+
+## Why
+
+The Python side of Modelica is split: [FMPy](https://github.com/CATIA-Systems/FMPy) and
+[PyFMI](https://github.com/modelon-community/PyFMI) *consume* FMUs that some other tool
+compiled, and the tools that actually compile Modelica (Dymola, OpenModelica, JModelica)
+are large non-Python programs. Nothing in Python takes Modelica source all the way to a
+running simulation, and nothing treats the model — flat equations, the incidence structure,
+the index — as an ordinary Python data structure you can inspect and rewrite.
+
+That gap is the project: a readable, dependency-light implementation where every stage is a
+value you can hold.
+
+## Layers
+
+Each layer is usable without the ones above it.
+
+| Module | Does |
+| --- | --- |
+| `modelica.lang` | Modelica source → tokens → AST (hand-written lexer/parser, positions carried for diagnostics) |
+| `modelica.ir` | AST → flat model (variables, equations, expression IR), then matching / BLT sorting / index reduction |
+| `modelica.sim` | flat model → ODE/DAE problem, solver backends, event (zero-crossing) handling |
+| `modelica.fmi` | FMI 3.0 — read and simulate an FMU; export a flat model as one |
+| `modelica.ssp` | SSP 2.0 — `.ssd`/`.ssv`/`.ssb` inside a `.ssp`, and a co-simulation master over the components |
+
+See [the architecture notes](docs/architecture.md) for the data model and the order things
+get built in.
+
+## Development
+
+```bash
+make install-hooks   # once after cloning: pre-commit (auto version bump + ruff), pre-push (full check)
+make check           # lint + typecheck + test, exactly what CI gates on
+make docs            # build the mkdocs site strictly
+```
+
+The toolchain is pinned in `.prototools` (moon + uv) — `proto install` brings up
+everything. All task ordering lives in `moon.yml`; CI is a single `moon run :ci`.
+
+## Releasing
+
+There is no manual release step. `pyproject.toml`'s `version` is the single source of
+truth:
+
+* the pre-commit hook auto-bumps the patch version whenever `src/**/*.py` changes;
+* `scripts/ci-version-guard` fails the pipeline if shipped source moved without a bump
+  (the non-bypassable counterpart);
+* on `main`, `moon run :release` publishes to PyPI **only if that version isn't there
+  yet**, via GitLab OIDC Trusted Publishing — no API token is stored anywhere.
+
+Docs are published to GitLab Pages from the same pipeline.
+
+## License
+
+MIT © Jorge Cardona

modelica-0.0.1.dist-info/RECORD

@@ -0,0 +1,6 @@
+modelica/__init__.py,sha256=FrTYlgAimTOlrPajKHYRF6QRK5yJguqurEQf9Glz7-I,978
+modelica/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+modelica-0.0.1.dist-info/METADATA,sha256=4Qdx074A_oKOqpCYAPzR_IzDqz4AATlG6iFqGnRurUc,4585
+modelica-0.0.1.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
+modelica-0.0.1.dist-info/licenses/LICENSE,sha256=6dP7w8m4xJH1IQumkEnTTCY4BJO16jnKEG-xPIj9y90,1070
+modelica-0.0.1.dist-info/RECORD,,

modelica-0.0.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.31.0
+Root-Is-Purelib: true
+Tag: py3-none-any

modelica-0.0.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jorge Cardona
+
+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.