morphir-python 0.0.1__py3-none-any.whl → 0.0.2__py3-none-any.whl

morphir_python-0.0.2.dist-info/METADATA

@@ -0,0 +1,97 @@
+Metadata-Version: 2.5
+Name: morphir-python
+Version: 0.0.2
+Summary: CLI tools and extensions for Morphir Python
+Project-URL: Homepage, https://github.com/finos/morphir-python
+Project-URL: Documentation, https://morphir.finos.org
+Project-URL: Repository, https://github.com/finos/morphir-python
+Project-URL: Issues, https://github.com/finos/morphir-python/issues
+Author-email: FINOS <morphir@finos.org>
+License-Expression: Apache-2.0
+License-File: LICENSE
+Keywords: cli,code-generation,domain-modeling,morphir,tools
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Typing :: Typed
+Requires-Python: >=3.14
+Requires-Dist: morphir>=0.0.1
+Requires-Dist: pygments>=2.20.0
+Requires-Dist: typer>=0.15
+Description-Content-Type: text/markdown
+
+# Morphir Python
+
+CLI tools and extensions for [Morphir Python](https://github.com/finos/morphir-python).
+
+This package provides:
+
+- Command-line interface for Morphir operations
+- Code generation backends
+- File I/O utilities
+- Development tools
+
+## Installation
+
+```bash
+pip install morphir-python
+```
+
+Or with uv:
+
+```bash
+uv add morphir-python
+```
+
+The `morphir-python` distribution contains the CLI and depends on the separate
+`morphir` library/SDK distribution. Python imports remain `morphir` and
+`morphir_tools`. Version 0.0.1 was a bundle; for migration to CLI-only 0.0.2, see
+the [repository installation guide](../../README.md#migrating-from-the-bundled-001-release).
+
+## Usage
+
+The `morphir-python` command inspects and converts versioned `morphir-ir.json`
+files. It reads format 3.0.x (what morphir-elm writes), format 3.1.x (which adds
+the v3 `Specs` distribution) and draft IR 4.0.x, reads the legacy formats 1 and 2
+to upgrade them, and uses the `morphir` library for every read, write, and
+migration.
+
+```bash
+morphir-python ir inspect morphir-ir.json
+morphir-python ir convert morphir-ir.json --to v4 -o out.json --package-version 1.2.0
+morphir-python ir convert v4.json --to v3 -o out.json --drop-source-locations
+morphir-python ir convert old-format-1.json --to v3 -o out.json
+```
+
+`inspect` prints the normalized format version, the distribution kind
+(`Library`, `Specs` or `Application`), and the package name, and labels v4 as
+draft and formats 1 and 2 as legacy. `convert` handles `Library` and `Specs` in
+both directions. It writes a v3 `Library` as format `3` and a v3 `Specs` as
+`"3.1.0"`, the lowest version that holds each. A legacy format 1 or 2 file
+converts to a format 3.0.0 `Library` or draft v4; nothing writes format 1 or 2.
+`convert` writes through a temporary file and renames it only on success, so a
+failed conversion leaves no output file.
+Diagnostics go to standard error as `code at location: message`.
+
+Exit codes are 0 for success (also with warnings), 1 for a diagnostic, and 2 for
+a usage error. 3.x releases from 3.2.0 on are rejected; see the
+[morphir package README](../morphir/README.md#morphir-ir-versions) for the
+format-version rules and the draft v4 status.
+
+## Requirements
+
+- Python 3.14+
+- `morphir>=0.0.1` (installed as a dependency)
+
+## License
+
+Apache-2.0 - see the [LICENSE](../../LICENSE) file for details.
+
+## Related Packages
+
+- [morphir](https://pypi.org/project/morphir/) - Core library

morphir_python-0.0.2.dist-info/RECORD

@@ -0,0 +1,8 @@
+morphir_tools/__init__.py,sha256=JVDyT-b7VDd27BFNrpWHzl1eOt3Ibu9mKKEc2QY2IRc,348
+morphir_tools/cli.py,sha256=EEq_4VrDozHQ4ZyOLnEUgSu8AG2aMAD6mk5JIusWc58,7802
+morphir_tools/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+morphir_python-0.0.2.dist-info/METADATA,sha256=B8UFDrKxW29qP4NDJPTSM9HdTsMH1xcHewXH-HYygl8,3535
+morphir_python-0.0.2.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+morphir_python-0.0.2.dist-info/entry_points.txt,sha256=ig7-ByPyqCN0S13AuOguSP9qT1npyySP6hVL32naLxA,58
+morphir_python-0.0.2.dist-info/licenses/LICENSE,sha256=tAkwu8-AdEyGxGoSvJ2gVmQdcicWw3j1ZZueVV74M-E,11357
+morphir_python-0.0.2.dist-info/RECORD,,

morphir_tools/__init__.py

@@ -6,8 +6,8 @@ Morphir domain models, including code generation and development tools.
 Example:
     >>> import morphir_tools
     >>> morphir_tools.__version__
-    '0.0.1'
+    '0.0.2'
 """
 
-__version__ = "0.0.1"
+__version__ = "0.0.2"
 __all__ = ["__version__"]

morphir/__init__.py

@@ -1,14 +0,0 @@
-"""Morphir - Functional domain modeling for Python.
-
-Morphir enables you to write business logic once and use it across multiple
-platforms, languages, and runtimes. It provides a strongly-typed intermediate
-representation (IR) that captures the semantics of your domain model.
-
-Example:
-    >>> import morphir
-    >>> morphir.__version__
-    '0.0.1'
-"""
-
-__version__ = "0.0.1"
-__all__ = ["__version__"]

morphir/ir/__init__.py

@@ -1,110 +0,0 @@
-"""Morphir IR.
-
-The default model is IR v4 (`morphir.ir.v4`); every name here is the same object
-as its `morphir.ir.v4` counterpart. Format 3.0.0 lives in `morphir.ir.v3`.
-"""
-
-from . import module, package
-from .v4.access_controlled import AccessControlled
-from .v4.decorations import (
-    DecorationFormat,
-    DecorationValuesFile,
-    LayerManifest,
-    SchemaRef,
-)
-from .v4.distribution import (
-    ApplicationDistribution,
-    Distribution,
-    EntryPoint,
-    EntryPointKind,
-    LibraryDistribution,
-    PackageInfo,
-    SpecsDistribution,
-)
-from .v4.document import (
-    DocArray,
-    DocBool,
-    DocFloat,
-    DocInt,
-    DocNull,
-    DocObject,
-    DocString,
-    Document,
-)
-from .v4.documented import Documented
-from .v4.fqname import FQName
-from .v4.literal import (
-    BoolLiteral,
-    CharLiteral,
-    DecimalLiteral,
-    FloatLiteral,
-    IntegerLiteral,
-    Literal,
-    StringLiteral,
-)
-from .v4.meta import FileMeta, SourceRange
-from .v4.name import Name
-from .v4.path import Path
-from .v4.qname import QName
-from .v4.ref import DefRef, FileWithDefs, PointerRef, Ref
-from .v4.type import Field, Type, TypeAttributes
-from .v4.type_constraints import TypeConstraints
-from .v4.type_def import Definition as TypeDefinition
-from .v4.type_spec import Specification as TypeSpecification
-from .v4.value import Definition as ValueDefinition
-from .v4.value import Pattern, Value, ValueAttributes
-from .v4.value import Specification as ValueSpecification
-
-__all__ = [
-    "AccessControlled",
-    "ApplicationDistribution",
-    "BoolLiteral",
-    "CharLiteral",
-    "DecimalLiteral",
-    "DecorationFormat",
-    "DecorationValuesFile",
-    "DefRef",
-    "Distribution",
-    "DocArray",
-    "DocBool",
-    "DocFloat",
-    "DocInt",
-    "DocNull",
-    "DocObject",
-    "DocString",
-    "Document",
-    "Documented",
-    "EntryPoint",
-    "EntryPointKind",
-    "FQName",
-    "Field",
-    "FileMeta",
-    "FileWithDefs",
-    "FloatLiteral",
-    "IntegerLiteral",
-    "LayerManifest",
-    "LibraryDistribution",
-    "Literal",
-    "Name",
-    "PackageInfo",
-    "Path",
-    "Pattern",
-    "PointerRef",
-    "QName",
-    "Ref",
-    "SchemaRef",
-    "SourceRange",
-    "SpecsDistribution",
-    "StringLiteral",
-    "Type",
-    "TypeAttributes",
-    "TypeConstraints",
-    "TypeDefinition",
-    "TypeSpecification",
-    "Value",
-    "ValueAttributes",
-    "ValueDefinition",
-    "ValueSpecification",
-    "module",
-    "package",
-]

morphir/ir/access_controlled.py

@@ -1,15 +0,0 @@
-"""Compatibility shim: re-exports `morphir.ir.v4.access_controlled`."""
-
-from morphir.ir.v4.access_controlled import (
-    AccessControlled,
-    Private,
-    Public,
-    T,
-)
-
-__all__ = [
-    "AccessControlled",
-    "Private",
-    "Public",
-    "T",
-]

morphir/ir/decorations.py

@@ -1,19 +0,0 @@
-"""Compatibility shim: re-exports `morphir.ir.v4.decorations`."""
-
-from morphir.ir.v4.decorations import (
-    DecorationFormat,
-    DecorationValuesFile,
-    LayerManifest,
-    SchemaRef,
-    deep_merge,
-    merge_decoration_values,
-)
-
-__all__ = [
-    "DecorationFormat",
-    "DecorationValuesFile",
-    "LayerManifest",
-    "SchemaRef",
-    "deep_merge",
-    "merge_decoration_values",
-]

morphir/ir/diagnostics.py

@@ -1,105 +0,0 @@
-"""Structured diagnostics shared by the IR readers, codecs, and migrations.
-
-Every diagnostic code lives in this module so that an upstream rename is a single
-edit. Codes reuse upstream vocabulary where it exists:
-
-- format-version codes come from the finos/morphir format-version contract
-  (``docs/spec/ir/format-version.md``);
-- ``specs_before_3_1`` comes from the finos/morphir v3 specification
-  (``docs/spec/ir/schemas/v3/whats-new.md``, decision record 0018);
-- decoding codes come from the Morphir Compatibility Kit (morphir-rust
-  ``ir/diagnostic.rs``);
-- downgrade codes come from the finos CLI and morphir-moonbit
-  ``migration/v3/migration.mbt``, and may be renamed when finos bead
-  ``morphir-diwy`` settles;
-- ``package_version_dropped``, ``source_location_dropped``,
-  ``input_attributes_dropped``, and ``no_v4_spelling`` are local to
-  morphir-python.
-"""
-
-from __future__ import annotations
-
-from dataclasses import dataclass
-
-# Format version (finos/morphir format-version contract).
-MISSING_FORMAT_VERSION = "missing_format_version"
-DUPLICATE_FORMAT_VERSION = "duplicate_format_version"
-INVALID_FORMAT_VERSION_TYPE = "invalid_format_version_type"
-INVALID_FORMAT_VERSION_SYNTAX = "invalid_format_version_syntax"
-FORMAT_VERSION_OUT_OF_RANGE = "format_version_out_of_range"
-UNSUPPORTED_FORMAT_VERSION_MAJOR = "unsupported_format_version_major"
-UNSUPPORTED_FORMAT_VERSION_MINOR = "unsupported_format_version_minor"
-
-# A v3 Specs distribution declared below 3.1.0 (finos/morphir decision record 0018).
-SPECS_BEFORE_3_1 = "specs_before_3_1"
-
-# Decoding (Morphir Compatibility Kit).
-UNKNOWN_NODE = "unknown_node"
-UNKNOWN_MEMBER = "unknown_member"
-MISSING_MEMBER = "missing_member"
-DUPLICATE_MEMBER = "duplicate_member"
-INVALID_NAME = "invalid_name"
-INVALID_LITERAL = "invalid_literal"
-INVALID_JSON = "invalid_json"
-
-# Encoding a v4 construct that has no spelling in the pinned draft profile.
-NO_V4_SPELLING = "no_v4_spelling"
-
-# Reverse migration (finos CLI, morphir-moonbit).
-UNSUPPORTED_V4_DOWNGRADE = "unsupported_v4_downgrade"
-UNSUPPORTED_ATTRIBUTES_DOWNGRADE = "unsupported_attributes_downgrade"
-MISSING_INFERRED_TYPE = "missing_inferred_type"
-UNSUPPORTED_DOCUMENTATION_DOWNGRADE = "unsupported_documentation_downgrade"
-
-# Warnings (morphir-python).
-PACKAGE_VERSION_DROPPED = "package_version_dropped"
-SOURCE_LOCATION_DROPPED = "source_location_dropped"
-INPUT_ATTRIBUTES_DROPPED = "input_attributes_dropped"
-
-Location = tuple[str | int, ...]
-
-
-@dataclass(frozen=True)
-class Diagnostic:
-    """A machine-readable problem found while reading, writing, or migrating IR.
-
-    Attributes:
-        code: Stable diagnostic code, one of the constants in this module.
-        construct: Name of the IR construct involved, such as ``"Hole"``.
-        location: Path from the document root to the construct.
-        message: Human-readable explanation. Callers must not parse it.
-    """
-
-    code: str
-    construct: str
-    location: Location
-    message: str
-
-    def render(self) -> str:
-        """Render as ``code at location: message`` for terminal output."""
-        where = "/".join(str(part) for part in self.location) or "<root>"
-        return f"{self.code} at {where}: {self.message}"
-
-
-class DiagnosticError(Exception):
-    """Raised by readers and codecs when input cannot be processed.
-
-    Attributes:
-        diagnostics: One or more diagnostics describing the failure.
-    """
-
-    def __init__(self, *diagnostics: Diagnostic) -> None:
-        self.diagnostics: tuple[Diagnostic, ...] = diagnostics
-        super().__init__("; ".join(d.render() for d in diagnostics))
-
-    @property
-    def codes(self) -> tuple[str, ...]:
-        """The diagnostic codes, in order."""
-        return tuple(d.code for d in self.diagnostics)
-
-
-def fail(
-    code: str, construct: str, location: Location, message: str
-) -> DiagnosticError:
-    """Build a `DiagnosticError` holding a single diagnostic."""
-    return DiagnosticError(Diagnostic(code, construct, location, message))

morphir/ir/distribution.py

@@ -1,21 +0,0 @@
-"""Compatibility shim: re-exports `morphir.ir.v4.distribution`."""
-
-from morphir.ir.v4.distribution import (
-    ApplicationDistribution,
-    Distribution,
-    EntryPoint,
-    EntryPointKind,
-    LibraryDistribution,
-    PackageInfo,
-    SpecsDistribution,
-)
-
-__all__ = [
-    "ApplicationDistribution",
-    "Distribution",
-    "EntryPoint",
-    "EntryPointKind",
-    "LibraryDistribution",
-    "PackageInfo",
-    "SpecsDistribution",
-]

morphir/ir/document.py

@@ -1,37 +0,0 @@
-"""Compatibility shim: re-exports `morphir.ir.v4.document`."""
-
-from morphir.ir.v4.document import (
-    DocArray,
-    DocBool,
-    DocFloat,
-    DocInt,
-    DocNull,
-    DocObject,
-    DocString,
-    Document,
-    array,
-    bool_,
-    float_,
-    int_,
-    null,
-    object_,
-    string,
-)
-
-__all__ = [
-    "DocArray",
-    "DocBool",
-    "DocFloat",
-    "DocInt",
-    "DocNull",
-    "DocObject",
-    "DocString",
-    "Document",
-    "array",
-    "bool_",
-    "float_",
-    "int_",
-    "null",
-    "object_",
-    "string",
-]

morphir/ir/documented.py

@@ -1,11 +0,0 @@
-"""Compatibility shim: re-exports `morphir.ir.v4.documented`."""
-
-from morphir.ir.v4.documented import (
-    Documented,
-    T,
-)
-
-__all__ = [
-    "Documented",
-    "T",
-]