vcti-path-format-attributes 1.1.0__tar.gz

vcti_path_format_attributes-1.1.0/LICENSE

@@ -0,0 +1,8 @@
+Copyright (c) 2018-2026 Visual Collaboration Technologies Inc.
+All Rights Reserved.
+
+This software is proprietary and confidential. Unauthorized copying,
+distribution, or use of this software, via any medium, is strictly
+prohibited. Access is granted only to authorized VCollab developers
+and individuals explicitly authorized by Visual Collaboration
+Technologies Inc.

vcti_path_format_attributes-1.1.0/PKG-INFO

@@ -0,0 +1,142 @@
+Metadata-Version: 2.4
+Name: vcti-path-format-attributes
+Version: 1.1.0
+Summary: Domain vocabulary enums for file format classification — path types, structures, content, and analysis categories
+Author: Visual Collaboration Technologies Inc.
+Requires-Python: <3.15,>=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: vcti-enum>=1.0.3
+Provides-Extra: test
+Requires-Dist: pytest; extra == "test"
+Requires-Dist: pytest-cov; extra == "test"
+Provides-Extra: lint
+Requires-Dist: ruff; extra == "lint"
+Dynamic: license-file
+
+# Path Format Attributes
+
+Domain vocabulary enums for file format classification — path types, structures, content, and analysis categories.
+
+Part of the path-format ecosystem:
+**attributes** (this package) · **vcti-python-path-format** (framework) · **vcti-python-path-format-descriptors** (format plugins)
+
+This package is the shared taxonomy — it defines the classification
+dimensions that format descriptors and identification rules use. It lives
+in its own repository so that vocabulary changes are deliberate and
+reviewed across all formats. See [docs/ecosystem.md](docs/ecosystem.md)
+for how the three repos work together, and
+[docs/extending.md](docs/extending.md) for how to add new members and
+enums.
+
+## Installation
+
+```bash
+pip install vcti-path-format-attributes>=1.1.0
+```
+
+### In `pyproject.toml` dependencies
+
+```toml
+dependencies = [
+    "vcti-path-format-attributes>=1.1.0",
+]
+```
+
+---
+
+## Quick Start
+
+```python
+from vcti.pathformat.attribute import (
+    AnalysisType,
+    Attribute,
+    FileContent,
+    FileStructure,
+    PathType,
+)
+
+# Use as metadata keys and values for format descriptors
+attrs = {
+    Attribute.PATH_TYPE: PathType.FILE,
+    Attribute.STRUCTURE: FileStructure.HDF5,
+    Attribute.CONTENT: FileContent.SOLVER_OUTPUTS,
+    Attribute.ANALYSIS_TYPE: AnalysisType.STRUCTURAL,
+}
+
+# Enum values are lowercase strings — usable with vcti-lookup rules
+#   Rule(Attribute.STRUCTURE.value, "==", FileStructure.HDF5.value)
+
+# Lookup by value (useful for deserialization)
+structure = FileStructure("hdf5")
+assert structure is FileStructure.HDF5
+```
+
+---
+
+## Enums
+
+### Attribute
+
+Attribute names for format descriptor metadata:
+
+| Member | Value |
+|--------|-------|
+| `PATH_TYPE` | `"path_type"` |
+| `SOLVER` | `"solver"` |
+| `GENERATOR` | `"generator"` |
+| `STRUCTURE` | `"structure"` |
+| `CONTENT` | `"content"` |
+| `ANALYSIS_TYPE` | `"analysis_type"` |
+| `SOLUTION_TYPE` | `"solution_type"` |
+
+### PathType
+
+| Member | Value |
+|--------|-------|
+| `FILE` | `"file"` |
+| `DIR` | `"dir"` |
+
+### FileStructure
+
+| Member | Value |
+|--------|-------|
+| `ASCII` | `"ascii"` |
+| `BINARY` | `"binary"` |
+| `HDF5` | `"hdf5"` |
+| `JSON` | `"json"` |
+| `CSV` | `"csv"` |
+
+### FileContent
+
+| Member | Value |
+|--------|-------|
+| `MESH` | `"mesh"` |
+| `SOLVER_INPUTS` | `"solver_inputs"` |
+| `SOLVER_OUTPUTS` | `"solver_outputs"` |
+| `FILTERED_DATA` | `"filtered_data"` |
+| `SURFACE_3D_MODEL` | `"surface_3d_model"` |
+| `SURFACE_3D_VIEWS` | `"surface_3d_views"` |
+
+### AnalysisType
+
+| Member | Value |
+|--------|-------|
+| `STRUCTURAL` | `"structural"` |
+| `THERMAL` | `"thermal"` |
+| `FLUID` | `"fluid"` |
+| `CRASH` | `"crash"` |
+
+---
+
+## Extending
+
+To add a new member or a new enum, see [docs/extending.md](docs/extending.md).
+All members use `auto_enum_value()` — values are always lowercase strings
+derived from the member name.
+
+---
+
+## Dependencies
+
+- [vcti-enum](https://pypi.org/project/vcti-enum/) (>=1.0.3) — value-generated string enums

vcti_path_format_attributes-1.1.0/README.md

@@ -0,0 +1,126 @@
+# Path Format Attributes
+
+Domain vocabulary enums for file format classification — path types, structures, content, and analysis categories.
+
+Part of the path-format ecosystem:
+**attributes** (this package) · **vcti-python-path-format** (framework) · **vcti-python-path-format-descriptors** (format plugins)
+
+This package is the shared taxonomy — it defines the classification
+dimensions that format descriptors and identification rules use. It lives
+in its own repository so that vocabulary changes are deliberate and
+reviewed across all formats. See [docs/ecosystem.md](docs/ecosystem.md)
+for how the three repos work together, and
+[docs/extending.md](docs/extending.md) for how to add new members and
+enums.
+
+## Installation
+
+```bash
+pip install vcti-path-format-attributes>=1.1.0
+```
+
+### In `pyproject.toml` dependencies
+
+```toml
+dependencies = [
+    "vcti-path-format-attributes>=1.1.0",
+]
+```
+
+---
+
+## Quick Start
+
+```python
+from vcti.pathformat.attribute import (
+    AnalysisType,
+    Attribute,
+    FileContent,
+    FileStructure,
+    PathType,
+)
+
+# Use as metadata keys and values for format descriptors
+attrs = {
+    Attribute.PATH_TYPE: PathType.FILE,
+    Attribute.STRUCTURE: FileStructure.HDF5,
+    Attribute.CONTENT: FileContent.SOLVER_OUTPUTS,
+    Attribute.ANALYSIS_TYPE: AnalysisType.STRUCTURAL,
+}
+
+# Enum values are lowercase strings — usable with vcti-lookup rules
+#   Rule(Attribute.STRUCTURE.value, "==", FileStructure.HDF5.value)
+
+# Lookup by value (useful for deserialization)
+structure = FileStructure("hdf5")
+assert structure is FileStructure.HDF5
+```
+
+---
+
+## Enums
+
+### Attribute
+
+Attribute names for format descriptor metadata:
+
+| Member | Value |
+|--------|-------|
+| `PATH_TYPE` | `"path_type"` |
+| `SOLVER` | `"solver"` |
+| `GENERATOR` | `"generator"` |
+| `STRUCTURE` | `"structure"` |
+| `CONTENT` | `"content"` |
+| `ANALYSIS_TYPE` | `"analysis_type"` |
+| `SOLUTION_TYPE` | `"solution_type"` |
+
+### PathType
+
+| Member | Value |
+|--------|-------|
+| `FILE` | `"file"` |
+| `DIR` | `"dir"` |
+
+### FileStructure
+
+| Member | Value |
+|--------|-------|
+| `ASCII` | `"ascii"` |
+| `BINARY` | `"binary"` |
+| `HDF5` | `"hdf5"` |
+| `JSON` | `"json"` |
+| `CSV` | `"csv"` |
+
+### FileContent
+
+| Member | Value |
+|--------|-------|
+| `MESH` | `"mesh"` |
+| `SOLVER_INPUTS` | `"solver_inputs"` |
+| `SOLVER_OUTPUTS` | `"solver_outputs"` |
+| `FILTERED_DATA` | `"filtered_data"` |
+| `SURFACE_3D_MODEL` | `"surface_3d_model"` |
+| `SURFACE_3D_VIEWS` | `"surface_3d_views"` |
+
+### AnalysisType
+
+| Member | Value |
+|--------|-------|
+| `STRUCTURAL` | `"structural"` |
+| `THERMAL` | `"thermal"` |
+| `FLUID` | `"fluid"` |
+| `CRASH` | `"crash"` |
+
+---
+
+## Extending
+
+To add a new member or a new enum, see [docs/extending.md](docs/extending.md).
+All members use `auto_enum_value()` — values are always lowercase strings
+derived from the member name.
+
+---
+
+## Dependencies
+
+- [vcti-enum](https://pypi.org/project/vcti-enum/) (>=1.0.3) — value-generated string enums

vcti_path_format_attributes-1.1.0/pyproject.toml

@@ -0,0 +1,40 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "vcti-path-format-attributes"
+version = "1.1.0"
+description = "Domain vocabulary enums for file format classification — path types, structures, content, and analysis categories"
+readme = "README.md"
+authors = [
+    {name = "Visual Collaboration Technologies Inc."}
+]
+requires-python = ">=3.12,<3.15"
+dependencies = [
+    "vcti-enum>=1.0.3",
+]
+
+[project.optional-dependencies]
+test = ["pytest", "pytest-cov"]
+lint = ["ruff"]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["vcti.pathformat.attribute", "vcti.pathformat.attribute.*"]
+
+[tool.setuptools.package-data]
+"vcti.pathformat.attribute" = ["py.typed"]
+
+[tool.setuptools]
+zip-safe = true
+
+[tool.pytest.ini_options]
+addopts = "--cov=vcti.pathformat.attribute --cov-report=term-missing --cov-fail-under=95"
+
+[tool.ruff]
+target-version = "py312"
+line-length = 99
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I", "UP"]

vcti_path_format_attributes-1.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

vcti_path_format_attributes-1.1.0/src/vcti/pathformat/attribute/__init__.py

@@ -0,0 +1,22 @@
+# Copyright Visual Collaboration Technologies Inc. All Rights Reserved.
+# See LICENSE for details.
+"""vcti.pathformat.attribute — Domain vocabulary enums for file format classification."""
+
+from importlib.metadata import version
+
+from .analysis_type import AnalysisType
+from .file_contents import FileContent
+from .file_structure import FileStructure
+from .names import Attribute
+from .path_type import PathType
+
+__version__ = version("vcti-path-format-attributes")
+
+__all__ = [
+    "__version__",
+    "AnalysisType",
+    "Attribute",
+    "FileContent",
+    "FileStructure",
+    "PathType",
+]

vcti_path_format_attributes-1.1.0/src/vcti/pathformat/attribute/analysis_type.py

@@ -0,0 +1,14 @@
+# Copyright Visual Collaboration Technologies Inc. All Rights Reserved.
+# See LICENSE for details.
+"""Analysis type enum for classifying simulation analysis categories."""
+
+from vcti.enum.value_generated_enums import EnumValueLowerCase, auto_enum_value
+
+
+class AnalysisType(EnumValueLowerCase):
+    """Enum of supported analysis types (structural, thermal, fluid, crash)."""
+
+    STRUCTURAL = auto_enum_value()
+    THERMAL = auto_enum_value()
+    FLUID = auto_enum_value()
+    CRASH = auto_enum_value()

vcti_path_format_attributes-1.1.0/src/vcti/pathformat/attribute/file_contents.py

@@ -0,0 +1,16 @@
+# Copyright Visual Collaboration Technologies Inc. All Rights Reserved.
+# See LICENSE for details.
+"""File content type enum for classifying what a file contains."""
+
+from vcti.enum.value_generated_enums import EnumValueLowerCase, auto_enum_value
+
+
+class FileContent(EnumValueLowerCase):
+    """Enum of file content categories (mesh, solver inputs/outputs, 3D data)."""
+
+    MESH = auto_enum_value()
+    SOLVER_INPUTS = auto_enum_value()
+    SOLVER_OUTPUTS = auto_enum_value()
+    FILTERED_DATA = auto_enum_value()
+    SURFACE_3D_MODEL = auto_enum_value()
+    SURFACE_3D_VIEWS = auto_enum_value()

vcti_path_format_attributes-1.1.0/src/vcti/pathformat/attribute/file_structure.py

@@ -0,0 +1,15 @@
+# Copyright Visual Collaboration Technologies Inc. All Rights Reserved.
+# See LICENSE for details.
+"""File structure enum for classifying how data is organized."""
+
+from vcti.enum.value_generated_enums import EnumValueLowerCase, auto_enum_value
+
+
+class FileStructure(EnumValueLowerCase):
+    """Enum of file structure types (ASCII, binary, HDF5, JSON, CSV)."""
+
+    ASCII = auto_enum_value()
+    BINARY = auto_enum_value()
+    HDF5 = auto_enum_value()
+    JSON = auto_enum_value()
+    CSV = auto_enum_value()

vcti_path_format_attributes-1.1.0/src/vcti/pathformat/attribute/names.py

@@ -0,0 +1,17 @@
+# Copyright Visual Collaboration Technologies Inc. All Rights Reserved.
+# See LICENSE for details.
+"""Attribute names enum for format descriptor metadata keys."""
+
+from vcti.enum.value_generated_enums import EnumValueLowerCase, auto_enum_value
+
+
+class Attribute(EnumValueLowerCase):
+    """Enum of format descriptor attribute names used for filtering and metadata."""
+
+    PATH_TYPE = auto_enum_value()
+    SOLVER = auto_enum_value()
+    GENERATOR = auto_enum_value()
+    STRUCTURE = auto_enum_value()
+    CONTENT = auto_enum_value()
+    ANALYSIS_TYPE = auto_enum_value()
+    SOLUTION_TYPE = auto_enum_value()  # e.g. linear/nonlinear — how, vs ANALYSIS_TYPE's what

vcti_path_format_attributes-1.1.0/src/vcti/pathformat/attribute/path_type.py

@@ -0,0 +1,12 @@
+# Copyright Visual Collaboration Technologies Inc. All Rights Reserved.
+# See LICENSE for details.
+"""Path type enum distinguishing files from directories."""
+
+from vcti.enum.value_generated_enums import EnumValueLowerCase, auto_enum_value
+
+
+class PathType(EnumValueLowerCase):
+    """Enum distinguishing file paths from directory paths."""
+
+    FILE = auto_enum_value()
+    DIR = auto_enum_value()

vcti_path_format_attributes-1.1.0/src/vcti_path_format_attributes.egg-info/PKG-INFO

@@ -0,0 +1,142 @@
+Metadata-Version: 2.4
+Name: vcti-path-format-attributes
+Version: 1.1.0
+Summary: Domain vocabulary enums for file format classification — path types, structures, content, and analysis categories
+Author: Visual Collaboration Technologies Inc.
+Requires-Python: <3.15,>=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: vcti-enum>=1.0.3
+Provides-Extra: test
+Requires-Dist: pytest; extra == "test"
+Requires-Dist: pytest-cov; extra == "test"
+Provides-Extra: lint
+Requires-Dist: ruff; extra == "lint"
+Dynamic: license-file
+
+# Path Format Attributes
+
+Domain vocabulary enums for file format classification — path types, structures, content, and analysis categories.
+
+Part of the path-format ecosystem:
+**attributes** (this package) · **vcti-python-path-format** (framework) · **vcti-python-path-format-descriptors** (format plugins)
+
+This package is the shared taxonomy — it defines the classification
+dimensions that format descriptors and identification rules use. It lives
+in its own repository so that vocabulary changes are deliberate and
+reviewed across all formats. See [docs/ecosystem.md](docs/ecosystem.md)
+for how the three repos work together, and
+[docs/extending.md](docs/extending.md) for how to add new members and
+enums.
+
+## Installation
+
+```bash
+pip install vcti-path-format-attributes>=1.1.0
+```
+
+### In `pyproject.toml` dependencies
+
+```toml
+dependencies = [
+    "vcti-path-format-attributes>=1.1.0",
+]
+```
+
+---
+
+## Quick Start
+
+```python
+from vcti.pathformat.attribute import (
+    AnalysisType,
+    Attribute,
+    FileContent,
+    FileStructure,
+    PathType,
+)
+
+# Use as metadata keys and values for format descriptors
+attrs = {
+    Attribute.PATH_TYPE: PathType.FILE,
+    Attribute.STRUCTURE: FileStructure.HDF5,
+    Attribute.CONTENT: FileContent.SOLVER_OUTPUTS,
+    Attribute.ANALYSIS_TYPE: AnalysisType.STRUCTURAL,
+}
+
+# Enum values are lowercase strings — usable with vcti-lookup rules
+#   Rule(Attribute.STRUCTURE.value, "==", FileStructure.HDF5.value)
+
+# Lookup by value (useful for deserialization)
+structure = FileStructure("hdf5")
+assert structure is FileStructure.HDF5
+```
+
+---
+
+## Enums
+
+### Attribute
+
+Attribute names for format descriptor metadata:
+
+| Member | Value |
+|--------|-------|
+| `PATH_TYPE` | `"path_type"` |
+| `SOLVER` | `"solver"` |
+| `GENERATOR` | `"generator"` |
+| `STRUCTURE` | `"structure"` |
+| `CONTENT` | `"content"` |
+| `ANALYSIS_TYPE` | `"analysis_type"` |
+| `SOLUTION_TYPE` | `"solution_type"` |
+
+### PathType
+
+| Member | Value |
+|--------|-------|
+| `FILE` | `"file"` |
+| `DIR` | `"dir"` |
+
+### FileStructure
+
+| Member | Value |
+|--------|-------|
+| `ASCII` | `"ascii"` |
+| `BINARY` | `"binary"` |
+| `HDF5` | `"hdf5"` |
+| `JSON` | `"json"` |
+| `CSV` | `"csv"` |
+
+### FileContent
+
+| Member | Value |
+|--------|-------|
+| `MESH` | `"mesh"` |
+| `SOLVER_INPUTS` | `"solver_inputs"` |
+| `SOLVER_OUTPUTS` | `"solver_outputs"` |
+| `FILTERED_DATA` | `"filtered_data"` |
+| `SURFACE_3D_MODEL` | `"surface_3d_model"` |
+| `SURFACE_3D_VIEWS` | `"surface_3d_views"` |
+
+### AnalysisType
+
+| Member | Value |
+|--------|-------|
+| `STRUCTURAL` | `"structural"` |
+| `THERMAL` | `"thermal"` |
+| `FLUID` | `"fluid"` |
+| `CRASH` | `"crash"` |
+
+---
+
+## Extending
+
+To add a new member or a new enum, see [docs/extending.md](docs/extending.md).
+All members use `auto_enum_value()` — values are always lowercase strings
+derived from the member name.
+
+---
+
+## Dependencies
+
+- [vcti-enum](https://pypi.org/project/vcti-enum/) (>=1.0.3) — value-generated string enums

vcti_path_format_attributes-1.1.0/src/vcti_path_format_attributes.egg-info/SOURCES.txt

@@ -0,0 +1,18 @@
+LICENSE
+README.md
+pyproject.toml
+src/vcti/pathformat/attribute/__init__.py
+src/vcti/pathformat/attribute/analysis_type.py
+src/vcti/pathformat/attribute/file_contents.py
+src/vcti/pathformat/attribute/file_structure.py
+src/vcti/pathformat/attribute/names.py
+src/vcti/pathformat/attribute/path_type.py
+src/vcti/pathformat/attribute/py.typed
+src/vcti_path_format_attributes.egg-info/PKG-INFO
+src/vcti_path_format_attributes.egg-info/SOURCES.txt
+src/vcti_path_format_attributes.egg-info/dependency_links.txt
+src/vcti_path_format_attributes.egg-info/requires.txt
+src/vcti_path_format_attributes.egg-info/top_level.txt
+src/vcti_path_format_attributes.egg-info/zip-safe
+tests/test_attributes.py
+tests/test_version.py

vcti_path_format_attributes-1.1.0/src/vcti_path_format_attributes.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

vcti_path_format_attributes-1.1.0/src/vcti_path_format_attributes.egg-info/requires.txt

@@ -0,0 +1,8 @@
+vcti-enum>=1.0.3
+
+[lint]
+ruff
+
+[test]
+pytest
+pytest-cov

vcti_path_format_attributes-1.1.0/src/vcti_path_format_attributes.egg-info/top_level.txt

@@ -0,0 +1 @@
+vcti

vcti_path_format_attributes-1.1.0/src/vcti_path_format_attributes.egg-info/zip-safe

@@ -0,0 +1 @@
+

vcti_path_format_attributes-1.1.0/tests/test_attributes.py

@@ -0,0 +1,266 @@
+# Copyright Visual Collaboration Technologies Inc. All Rights Reserved.
+# See LICENSE for details.
+"""Tests for pathformat attribute enums.
+
+Covers FileContent, FileStructure, PathType, AnalysisType, and Attribute —
+verifying member presence, pinned auto-generated values, behavioral contracts
+(lookup by value/name, hashing, iteration), and negative cases.
+"""
+
+import pytest
+
+from vcti.pathformat.attribute import (
+    AnalysisType,
+    Attribute,
+    FileContent,
+    FileStructure,
+    PathType,
+)
+
+# ---------------------------------------------------------------------------
+# FileContent
+# ---------------------------------------------------------------------------
+
+
+class TestFileContent:
+    """Tests for the FileContent enum."""
+
+    def test_has_six_members(self):
+        assert len(FileContent) == 6
+
+    def test_expected_members_exist(self):
+        assert hasattr(FileContent, "MESH")
+        assert hasattr(FileContent, "SOLVER_INPUTS")
+        assert hasattr(FileContent, "SOLVER_OUTPUTS")
+        assert hasattr(FileContent, "FILTERED_DATA")
+        assert hasattr(FileContent, "SURFACE_3D_MODEL")
+        assert hasattr(FileContent, "SURFACE_3D_VIEWS")
+
+    def test_pinned_values(self):
+        assert FileContent.MESH.value == "mesh"
+        assert FileContent.SOLVER_INPUTS.value == "solver_inputs"
+        assert FileContent.SOLVER_OUTPUTS.value == "solver_outputs"
+        assert FileContent.FILTERED_DATA.value == "filtered_data"
+        assert FileContent.SURFACE_3D_MODEL.value == "surface_3d_model"
+        assert FileContent.SURFACE_3D_VIEWS.value == "surface_3d_views"
+
+    def test_all_values_are_strings(self):
+        assert all(isinstance(m.value, str) for m in FileContent)
+
+    def test_all_values_are_distinct(self):
+        values = [m.value for m in FileContent]
+        assert len(values) == len(set(values))
+
+    def test_lookup_by_value(self):
+        assert FileContent("mesh") is FileContent.MESH
+        assert FileContent("surface_3d_model") is FileContent.SURFACE_3D_MODEL
+
+    def test_lookup_by_name(self):
+        assert FileContent["MESH"] is FileContent.MESH
+        assert FileContent["SURFACE_3D_VIEWS"] is FileContent.SURFACE_3D_VIEWS
+
+    def test_invalid_value_raises(self):
+        with pytest.raises(ValueError):
+            FileContent("nonexistent")
+
+    def test_invalid_name_raises(self):
+        with pytest.raises(KeyError):
+            FileContent["NONEXISTENT"]
+
+
+# ---------------------------------------------------------------------------
+# FileStructure
+# ---------------------------------------------------------------------------
+
+
+class TestFileStructure:
+    """Tests for the FileStructure enum."""
+
+    def test_has_five_members(self):
+        assert len(FileStructure) == 5
+
+    def test_expected_members_exist(self):
+        assert hasattr(FileStructure, "ASCII")
+        assert hasattr(FileStructure, "BINARY")
+        assert hasattr(FileStructure, "HDF5")
+        assert hasattr(FileStructure, "JSON")
+        assert hasattr(FileStructure, "CSV")
+
+    def test_pinned_values(self):
+        assert FileStructure.ASCII.value == "ascii"
+        assert FileStructure.BINARY.value == "binary"
+        assert FileStructure.HDF5.value == "hdf5"
+        assert FileStructure.JSON.value == "json"
+        assert FileStructure.CSV.value == "csv"
+
+    def test_all_values_are_strings(self):
+        assert all(isinstance(m.value, str) for m in FileStructure)
+
+    def test_all_values_are_distinct(self):
+        values = [m.value for m in FileStructure]
+        assert len(values) == len(set(values))
+
+    def test_lookup_by_value(self):
+        assert FileStructure("hdf5") is FileStructure.HDF5
+
+    def test_lookup_by_name(self):
+        assert FileStructure["HDF5"] is FileStructure.HDF5
+
+    def test_invalid_value_raises(self):
+        with pytest.raises(ValueError):
+            FileStructure("xml")
+
+
+# ---------------------------------------------------------------------------
+# PathType
+# ---------------------------------------------------------------------------
+
+
+class TestPathType:
+    """Tests for the PathType enum."""
+
+    def test_has_two_members(self):
+        assert len(PathType) == 2
+
+    def test_expected_members_exist(self):
+        assert hasattr(PathType, "FILE")
+        assert hasattr(PathType, "DIR")
+
+    def test_pinned_values(self):
+        assert PathType.FILE.value == "file"
+        assert PathType.DIR.value == "dir"
+
+    def test_all_values_are_strings(self):
+        assert all(isinstance(m.value, str) for m in PathType)
+
+    def test_lookup_by_value(self):
+        assert PathType("file") is PathType.FILE
+        assert PathType("dir") is PathType.DIR
+
+    def test_invalid_value_raises(self):
+        with pytest.raises(ValueError):
+            PathType("symlink")
+
+
+# ---------------------------------------------------------------------------
+# AnalysisType
+# ---------------------------------------------------------------------------
+
+
+class TestAnalysisType:
+    """Tests for the AnalysisType enum."""
+
+    def test_has_four_members(self):
+        assert len(AnalysisType) == 4
+
+    def test_expected_members_exist(self):
+        assert hasattr(AnalysisType, "STRUCTURAL")
+        assert hasattr(AnalysisType, "THERMAL")
+        assert hasattr(AnalysisType, "FLUID")
+        assert hasattr(AnalysisType, "CRASH")
+
+    def test_pinned_values(self):
+        assert AnalysisType.STRUCTURAL.value == "structural"
+        assert AnalysisType.THERMAL.value == "thermal"
+        assert AnalysisType.FLUID.value == "fluid"
+        assert AnalysisType.CRASH.value == "crash"
+
+    def test_all_values_are_strings(self):
+        assert all(isinstance(m.value, str) for m in AnalysisType)
+
+    def test_all_values_are_distinct(self):
+        values = [m.value for m in AnalysisType]
+        assert len(values) == len(set(values))
+
+    def test_lookup_by_value(self):
+        assert AnalysisType("structural") is AnalysisType.STRUCTURAL
+
+    def test_invalid_value_raises(self):
+        with pytest.raises(ValueError):
+            AnalysisType("electromagnetic")
+
+
+# ---------------------------------------------------------------------------
+# Attribute
+# ---------------------------------------------------------------------------
+
+
+class TestAttribute:
+    """Tests for the Attribute (attribute names) enum."""
+
+    def test_has_seven_members(self):
+        assert len(Attribute) == 7
+
+    def test_expected_members_exist(self):
+        assert hasattr(Attribute, "PATH_TYPE")
+        assert hasattr(Attribute, "SOLVER")
+        assert hasattr(Attribute, "GENERATOR")
+        assert hasattr(Attribute, "STRUCTURE")
+        assert hasattr(Attribute, "CONTENT")
+        assert hasattr(Attribute, "ANALYSIS_TYPE")
+        assert hasattr(Attribute, "SOLUTION_TYPE")
+
+    def test_pinned_values(self):
+        assert Attribute.PATH_TYPE.value == "path_type"
+        assert Attribute.SOLVER.value == "solver"
+        assert Attribute.GENERATOR.value == "generator"
+        assert Attribute.STRUCTURE.value == "structure"
+        assert Attribute.CONTENT.value == "content"
+        assert Attribute.ANALYSIS_TYPE.value == "analysis_type"
+        assert Attribute.SOLUTION_TYPE.value == "solution_type"
+
+    def test_all_values_are_strings(self):
+        assert all(isinstance(m.value, str) for m in Attribute)
+
+    def test_all_values_are_distinct(self):
+        values = [m.value for m in Attribute]
+        assert len(values) == len(set(values))
+
+    def test_lookup_by_value(self):
+        assert Attribute("path_type") is Attribute.PATH_TYPE
+
+    def test_lookup_by_name(self):
+        assert Attribute["ANALYSIS_TYPE"] is Attribute.ANALYSIS_TYPE
+
+    def test_invalid_value_raises(self):
+        with pytest.raises(ValueError):
+            Attribute("nonexistent")
+
+    def test_values_usable_as_dict_keys(self):
+        d = {Attribute.PATH_TYPE: "file", Attribute.STRUCTURE: "binary"}
+        assert len(d) == 2
+
+    def test_members_usable_as_dict_keys(self):
+        d = {Attribute.PATH_TYPE: PathType.FILE, Attribute.STRUCTURE: FileStructure.HDF5}
+        assert d[Attribute.PATH_TYPE] is PathType.FILE
+
+
+# ---------------------------------------------------------------------------
+# Cross-enum contracts
+# ---------------------------------------------------------------------------
+
+
+class TestCrossEnumContracts:
+    """Tests for invariants that span multiple enums."""
+
+    def test_all_enums_use_lowercase_string_values(self):
+        """Every auto-generated value must be a lowercase string."""
+        for enum_cls in (Attribute, PathType, FileStructure, FileContent, AnalysisType):
+            for member in enum_cls:
+                assert member.value == member.value.lower(), (
+                    f"{enum_cls.__name__}.{member.name} value {member.value!r} is not lowercase"
+                )
+
+    def test_attribute_values_do_not_collide_with_enum_values(self):
+        """Attribute keys must not collide with any value enum member values."""
+        attr_values = {m.value for m in Attribute}
+        for enum_cls in (PathType, FileStructure, FileContent, AnalysisType):
+            enum_values = {m.value for m in enum_cls}
+            collision = attr_values & enum_values
+            assert not collision, f"Attribute values collide with {enum_cls.__name__}: {collision}"
+
+    def test_all_enums_are_hashable(self):
+        """All enum members must be usable as dict keys and set members."""
+        for enum_cls in (Attribute, PathType, FileStructure, FileContent, AnalysisType):
+            members_set = set(enum_cls)
+            assert len(members_set) == len(enum_cls)

vcti_path_format_attributes-1.1.0/tests/test_version.py

@@ -0,0 +1,15 @@
+# Copyright Visual Collaboration Technologies Inc. All Rights Reserved.
+# See LICENSE for details.
+"""Version tests for vcti-path-format-attributes."""
+
+import re
+
+import vcti.pathformat.attribute
+
+
+class TestVersion:
+    def test_version_exists(self):
+        assert hasattr(vcti.pathformat.attribute, "__version__")
+
+    def test_version_is_valid_semver(self):
+        assert re.match(r"^\d+\.\d+\.\d+", vcti.pathformat.attribute.__version__)