value-object-sindri 0.1.0__tar.gz

value_object_sindri-0.1.0/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 dimanu-py
+
+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.
+

value_object_sindri-0.1.0/PKG-INFO

@@ -0,0 +1,122 @@
+Metadata-Version: 2.4
+Name: value-object-sindri
+Version: 0.1.0
+Summary: Value Object pattern implementation for Python
+Author-email: dimanu-py <dimanu.py@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2026 dimanu-py
+        
+        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.
+        
+        
+Project-URL: documentation, https://dimanu-py.github.io/value-object/home/
+Project-URL: repository, https://github.com/dimanu-py/value-object/
+Project-URL: homepage, https://dimanu-py.github.io/value-object/home/
+Project-URL: issues, https://github.com/dimanu-py/value-object/issues/
+Keywords: value object,value-object,value objects,value-objects,Value Object,domain driven design,ddd,clean architecture,hexagonal architecture,design patterns
+Classifier: Typing :: Typed
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typing-extensions>=4.0; python_version < "3.12"
+Provides-Extra: build
+Requires-Dist: uv>=0.11.17; extra == "build"
+Dynamic: license-file
+
+# Value Objects Sindri
+
+### Value Object pattern for Python and Domain Driven Design applications
+
+Easy use and customizable implementation for the Value Object pattern.
+
+<p align="center">
+  <a href="https://dimanu-py.github.io/value-object/getting_started/">Getting Started</a>&nbsp;&nbsp;•&nbsp;
+  <a href="https://dimanu-py.github.io/value-object/value_objects/">Value Object Pattern</a>
+</p>
+
+<div align="center"><table><tr><td>
+Sindri value object replaces ad hoc primitives and fragile validators with a consistent Value Object and Aggregate 
+toolkit you can adopt quickly. 
+Spin up validated value objects and aggregates with a simple and a small, focused API.
+
+<br>
+
+<b>Why use it?</b> Building your domain with Sindri lets you:
+
+<ul style="list-style-type: none">
+  <li>⏱️ Cut domain modeling and validation to seconds</li>
+  <li>🛡️ Declare immutable, validated value objects with clear error messages</li>
+  <li>🧩 Model aggregates with explicit invariants and composition</li>
+  <li>🧰 Start from ready made primitives and identifiers or extend with your own</li>
+  <li>🔧 Plug in custom validators, decorators, and typed primitives</li>
+</ul>
+
+</td></tr></table></div>
+
+<div style="background-color: #1e2d3d; border: 1px solid #00d9ff; border-radius: 8px; padding: 16px; margin: 16px 0; display: flex; align-items: flex-start; gap: 12px;">
+  <div style="font-size: 20px; color: #00d9ff; flex-shrink: 0;">💧</div>
+  <div>
+    <strong style="color: #00d9ff;">Created with Instant Python</strong><br>
+    <span style="color: #a0a0a0;">This project was generated using <a href="https://github.com/dimanu-py/instant-python" style="color: #00d9ff; text-decoration: none;">Instant Python</a>, a fast, easy and reliable project generator for Python projects.</span>
+  </div>
+</div>
+
+## Fast Kickstart
+
+```bash
+pip install value-object-sindri      # zero dependencies
+```
+
+Create a value object and use it in your domain:
+
+```python
+from value_object import Integer, String
+
+age = Integer(30)
+name = String("John Doe")
+
+print(f"Name: {name.value}, Age: {age.value}")
+```
+
+## Next Steps
+
+- [Installation](https://dimanu-py.github.io/value-object/getting_started/installation/)
+- [First Steps](https://dimanu-py.github.io/value-object/getting_started/first_steps/)
+- [Value Object Pattern](https://dimanu-py.github.io/value-object/value_objects/)
+- [Contributing Guide](https://dimanu-py.github.io/value-object/contributing/contributing_guide/)
+
+<div style="background-color: #1e2d3d; border: 1px solid #00d9ff; border-radius: 8px; padding: 16px; margin: 16px 0; display: flex; align-items: flex-start; gap: 12px;">
+  <div style="font-size: 20px; color: #00d9ff; flex-shrink: 0;">ℹ️</div>
+  <div>
+    <strong style="color: #00d9ff;">Learn More</strong><br>
+    <span style="color: #a0a0a0;">To learn more about advanced usage of value objects, including validation, custom value objects, complex objects like aggregates, visit the <a href="https://dimanu-py.github.io/sindri/value_objects/" style="color: #00d9ff; text-decoration: none;">Value Object Pattern</a> section of the documentation.</span>
+  </div>
+</div>

value_object_sindri-0.1.0/README.md

@@ -0,0 +1,69 @@
+# Value Objects Sindri
+
+### Value Object pattern for Python and Domain Driven Design applications
+
+Easy use and customizable implementation for the Value Object pattern.
+
+<p align="center">
+  <a href="https://dimanu-py.github.io/value-object/getting_started/">Getting Started</a>&nbsp;&nbsp;•&nbsp;
+  <a href="https://dimanu-py.github.io/value-object/value_objects/">Value Object Pattern</a>
+</p>
+
+<div align="center"><table><tr><td>
+Sindri value object replaces ad hoc primitives and fragile validators with a consistent Value Object and Aggregate 
+toolkit you can adopt quickly. 
+Spin up validated value objects and aggregates with a simple and a small, focused API.
+
+<br>
+
+<b>Why use it?</b> Building your domain with Sindri lets you:
+
+<ul style="list-style-type: none">
+  <li>⏱️ Cut domain modeling and validation to seconds</li>
+  <li>🛡️ Declare immutable, validated value objects with clear error messages</li>
+  <li>🧩 Model aggregates with explicit invariants and composition</li>
+  <li>🧰 Start from ready made primitives and identifiers or extend with your own</li>
+  <li>🔧 Plug in custom validators, decorators, and typed primitives</li>
+</ul>
+
+</td></tr></table></div>
+
+<div style="background-color: #1e2d3d; border: 1px solid #00d9ff; border-radius: 8px; padding: 16px; margin: 16px 0; display: flex; align-items: flex-start; gap: 12px;">
+  <div style="font-size: 20px; color: #00d9ff; flex-shrink: 0;">💧</div>
+  <div>
+    <strong style="color: #00d9ff;">Created with Instant Python</strong><br>
+    <span style="color: #a0a0a0;">This project was generated using <a href="https://github.com/dimanu-py/instant-python" style="color: #00d9ff; text-decoration: none;">Instant Python</a>, a fast, easy and reliable project generator for Python projects.</span>
+  </div>
+</div>
+
+## Fast Kickstart
+
+```bash
+pip install value-object-sindri      # zero dependencies
+```
+
+Create a value object and use it in your domain:
+
+```python
+from value_object import Integer, String
+
+age = Integer(30)
+name = String("John Doe")
+
+print(f"Name: {name.value}, Age: {age.value}")
+```
+
+## Next Steps
+
+- [Installation](https://dimanu-py.github.io/value-object/getting_started/installation/)
+- [First Steps](https://dimanu-py.github.io/value-object/getting_started/first_steps/)
+- [Value Object Pattern](https://dimanu-py.github.io/value-object/value_objects/)
+- [Contributing Guide](https://dimanu-py.github.io/value-object/contributing/contributing_guide/)
+
+<div style="background-color: #1e2d3d; border: 1px solid #00d9ff; border-radius: 8px; padding: 16px; margin: 16px 0; display: flex; align-items: flex-start; gap: 12px;">
+  <div style="font-size: 20px; color: #00d9ff; flex-shrink: 0;">ℹ️</div>
+  <div>
+    <strong style="color: #00d9ff;">Learn More</strong><br>
+    <span style="color: #a0a0a0;">To learn more about advanced usage of value objects, including validation, custom value objects, complex objects like aggregates, visit the <a href="https://dimanu-py.github.io/sindri/value_objects/" style="color: #00d9ff; text-decoration: none;">Value Object Pattern</a> section of the documentation.</span>
+  </div>
+</div>

value_object_sindri-0.1.0/pyproject.toml

@@ -0,0 +1,148 @@
+[project]
+name = "value-object-sindri"
+version = "0.1.0"
+description = "Value Object pattern implementation for Python"
+authors = [{name = "dimanu-py", email = "dimanu.py@gmail.com"}]
+dependencies = ["typing-extensions>=4.0; python_version < \"3.12\""]
+requires-python = ">=3.10"
+readme = "README.md"
+license = { file = "LICENSE" }
+keywords = [
+    "value object",
+    "value-object",
+    "value objects",
+    "value-objects",
+    "Value Object",
+    "domain driven design",
+    "ddd",
+    "clean architecture",
+    "hexagonal architecture",
+    "design patterns",
+]
+classifiers = [
+    "Typing :: Typed",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Software Development :: Libraries",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Topic :: Software Development",
+]
+
+[project.urls]
+documentation = "https://dimanu-py.github.io/value-object/home/"
+repository = "https://github.com/dimanu-py/value-object/"
+homepage = "https://dimanu-py.github.io/value-object/home/"
+issues = "https://github.com/dimanu-py/value-object/issues/"
+
+[project.optional-dependencies]
+build = ["uv>=0.11.17"]
+
+
+[dependency-groups]
+dev = [
+    {include-group = "lint"},
+    {include-group = "test"},
+    {include-group = "release"},
+    {include-group = "doc"},
+]
+release = [
+    "python-semantic-release",
+]
+lint = [
+    "mypy",
+    "ruff",
+    "pip-audit",
+    "pre-commit",
+]
+test = [
+    "expects>=0.9.0",
+    "pytest",
+    "pytest-sugar>=1.1.1",
+    "object-mother-sindri==0.1.0"
+]
+doc = [
+    "mkdocs>=1.6.1",
+    "mkdocs-literate-nav>=0.6.2",
+    "mkdocs-macros-plugin>=1.3.7",
+    "mkdocs-material>=9.6.8",
+    "mkdocs-section-index>=0.3.10",
+]
+
+[tool.pytest.ini_options]
+markers = [
+    "unit: mark a test as a unit test",
+    "acceptance: mark a test as an acceptance test",
+    "integration: mark a test as an integration test",
+]
+testpaths = ["test"]
+pythonpath = ["src"]
+
+
+[tool.ruff]
+line-length = 120
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "B", "C4", "UP", "I"]
+ignore = ["B008"]
+
+[tool.ruff.lint.isort]
+known-first-party = ["src", "test"]
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+skip-magic-trailing-comma = false
+
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/value_object"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "src/value_object",
+    "LICENSE",
+    "README.md",
+    "CHANGELOG.md",
+    "CITATION.cff",
+]
+
+
+[tool.semantic_release]
+version_toml = ["pyproject.toml:project.version"]
+version_variables = ["src/value_object/__init__.py:__version__"]
+commit_message = "bump: new version {version} created"
+commit_parser = "conventional"
+major_on_zero = false
+allow_zero_version = true
+no_git_verify = false
+tag_format = "{version}"
+build_command = """
+    pip install -e '.[build]'
+    uv lock --upgrade-package "$PACKAGE_NAME"
+    git add uv.lock
+    uv build
+"""
+
+[tool.semantic_release.commit_parser_options]
+minor_tags = ["feat"]
+patch_tags = ["fix", "perf", "refactor", "test", "build"]
+allowed_tags = ["feat", "fix", "refactor", "perf", "build"]
+default_bump_level = 0
+parse_squash_commits = false
+ignore_merge_commits = true
+
+[tool.semantic_release.changelog]
+exclude_commit_patterns = ['''^Merge pull request #''', '''^Merge branch ''']
+mode = "update"
+#template_dir = "docs/changelog"
+
+[tool.semantic_release.changelog.default_templates]
+changelog_file = "CHANGELOG.md"
+output_format = "md"
+mask_initial_release = false

value_object_sindri-0.1.0/setup.cfg

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

value_object_sindri-0.1.0/src/value_object/__init__.py

@@ -0,0 +1,31 @@
+"""Public facade for value object implementations.
+
+This module re-exports the most common value objects so they can be
+imported directly from :mod:`value_objects`.
+"""
+
+__version__ = "0.1.0"
+
+from value_object.aggregate import Aggregate
+from value_object.decorators.validation import validate
+from value_object.errors.sindri_validation_error import SindriValidationError
+from value_object.identifiers.string_uuid import StringUuid
+from value_object.primitives.boolean import Boolean
+from value_object.primitives.float import Float
+from value_object.primitives.integer import Integer
+from value_object.primitives.list import List
+from value_object.primitives.string import String
+from value_object.value_object import ValueObject
+
+__all__ = [
+    "Aggregate",
+    "validate",
+    "StringUuid",
+    "Boolean",
+    "Float",
+    "Integer",
+    "List",
+    "String",
+    "ValueObject",
+    "SindriValidationError",
+]

value_object_sindri-0.1.0/src/value_object/_compat.py

@@ -0,0 +1,15 @@
+"""Compatibility helpers for typing features across Python versions."""
+
+from __future__ import annotations
+
+try:
+    from typing import Self
+except ImportError:
+    from typing_extensions import Self
+
+try:
+    from typing import override
+except ImportError:
+    from typing_extensions import override
+
+__all__ = ["Self", "override"]