blueprint-dsl 0.1.0__tar.gz

blueprint_dsl-0.1.0/LICENSE

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

blueprint_dsl-0.1.0/PKG-INFO

@@ -0,0 +1,92 @@
+Metadata-Version: 2.4
+Name: blueprint-dsl
+Version: 0.1.0
+Summary: A narrow DSL that compiles structured-output contracts to strict JSON Schema.
+Keywords: ai,dsl,json-schema,structured-output
+Author: Robert Sharp
+Author-email: Robert Sharp <webmaster@sharpdesigndigital.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.12
+Project-URL: Homepage, https://github.com/siliconsociety/blueprint-dsl
+Project-URL: Issues, https://github.com/siliconsociety/blueprint-dsl/issues
+Project-URL: Repository, https://github.com/siliconsociety/blueprint-dsl
+Description-Content-Type: text/markdown
+
+# Blueprint DSL
+
+Blueprint is a small language for declaring the exact JSON object an AI model must return.
+It compiles to strict JSON Schema and fails with line-oriented diagnostics when a contract is
+invalid or exceeds common structured-output provider limits.
+
+```text
+Schema Friend:
+  name: String(min=1)
+  closeness: Float(min=0.0, max=1.0)
+
+Return Person:
+  name: String(min=1)
+  age: Optional[Integer]
+  address:
+    street: String
+    city: String
+  tags: List[String]
+  status: Enum["draft", "final"]
+  friends: List[Friend]
+```
+
+```python
+from blueprint_dsl import compile_blueprint
+
+compiled = compile_blueprint(source)
+print(compiled.name)
+print(compiled.schema)
+```
+
+## Language
+
+A Blueprint contains exactly one `Return Name:` declaration and may contain reusable
+`Schema Name:` declarations. Every declared field is required. `Optional[T]` means the
+field value may be null; it does not make the field absent.
+
+Supported primitives are `String`, `Integer`, `Float`, and `Boolean`. `None` is available
+for nullable unions. Formatted strings include `Date`, `Time`, `Datetime`, `Duration`,
+`Email`, `Hostname`, `IPv4`, `IPv6`, and `Uuid`. Containers include `List[T]`, `Enum[...]`,
+`Optional[T]`, and unions such as `String | None`.
+
+String and formatted-string `min`/`max` arguments constrain length. Numeric types support
+`min`, `max`, `exclusive_min`, `exclusive_max`, and `multiple_of`. Lists support `min` and
+`max` item counts. Two-space-indented bare fields create inline objects; `List:` creates an
+inline list of objects. Trailing comments become schema descriptions.
+
+`blueprint_spec_card()` returns the complete compact language reference used by Blueprint
+editors. `blueprint_editor_metadata()` and `blueprint_types_by_category()` expose the same
+canonical type registry for UI tooling.
+
+## Stability
+
+Blueprint is intentionally narrow and feature complete. Version `0.1.0` establishes the
+public package API and `blueprint/1` language semantics. Future releases are expected to be
+bug fixes unless an actual language defect requires a documented change.
+
+## Development
+
+Blueprint supports Python 3.12 through 3.14 and has no runtime dependencies.
+
+```bash
+./gate.sh
+```
+
+The gate runs linting, static analysis, the complete compiler suite with branch coverage,
+and a distribution build. PyPI publication is a separate, deliberate release action.
+
+## License
+
+MIT

blueprint_dsl-0.1.0/README.md

@@ -0,0 +1,70 @@
+# Blueprint DSL
+
+Blueprint is a small language for declaring the exact JSON object an AI model must return.
+It compiles to strict JSON Schema and fails with line-oriented diagnostics when a contract is
+invalid or exceeds common structured-output provider limits.
+
+```text
+Schema Friend:
+  name: String(min=1)
+  closeness: Float(min=0.0, max=1.0)
+
+Return Person:
+  name: String(min=1)
+  age: Optional[Integer]
+  address:
+    street: String
+    city: String
+  tags: List[String]
+  status: Enum["draft", "final"]
+  friends: List[Friend]
+```
+
+```python
+from blueprint_dsl import compile_blueprint
+
+compiled = compile_blueprint(source)
+print(compiled.name)
+print(compiled.schema)
+```
+
+## Language
+
+A Blueprint contains exactly one `Return Name:` declaration and may contain reusable
+`Schema Name:` declarations. Every declared field is required. `Optional[T]` means the
+field value may be null; it does not make the field absent.
+
+Supported primitives are `String`, `Integer`, `Float`, and `Boolean`. `None` is available
+for nullable unions. Formatted strings include `Date`, `Time`, `Datetime`, `Duration`,
+`Email`, `Hostname`, `IPv4`, `IPv6`, and `Uuid`. Containers include `List[T]`, `Enum[...]`,
+`Optional[T]`, and unions such as `String | None`.
+
+String and formatted-string `min`/`max` arguments constrain length. Numeric types support
+`min`, `max`, `exclusive_min`, `exclusive_max`, and `multiple_of`. Lists support `min` and
+`max` item counts. Two-space-indented bare fields create inline objects; `List:` creates an
+inline list of objects. Trailing comments become schema descriptions.
+
+`blueprint_spec_card()` returns the complete compact language reference used by Blueprint
+editors. `blueprint_editor_metadata()` and `blueprint_types_by_category()` expose the same
+canonical type registry for UI tooling.
+
+## Stability
+
+Blueprint is intentionally narrow and feature complete. Version `0.1.0` establishes the
+public package API and `blueprint/1` language semantics. Future releases are expected to be
+bug fixes unless an actual language defect requires a documented change.
+
+## Development
+
+Blueprint supports Python 3.12 through 3.14 and has no runtime dependencies.
+
+```bash
+./gate.sh
+```
+
+The gate runs linting, static analysis, the complete compiler suite with branch coverage,
+and a distribution build. PyPI publication is a separate, deliberate release action.
+
+## License
+
+MIT

blueprint_dsl-0.1.0/pyproject.toml

@@ -0,0 +1,65 @@
+[project]
+name = "blueprint-dsl"
+version = "0.1.0"
+description = "A narrow DSL that compiles structured-output contracts to strict JSON Schema."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [
+    { name = "Robert Sharp", email = "webmaster@sharpdesigndigital.com" },
+]
+requires-python = ">=3.12"
+keywords = ["ai", "dsl", "json-schema", "structured-output"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Software Development :: Libraries",
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://github.com/siliconsociety/blueprint-dsl"
+Repository = "https://github.com/siliconsociety/blueprint-dsl"
+Issues = "https://github.com/siliconsociety/blueprint-dsl/issues"
+
+[dependency-groups]
+dev = [
+    "pyright>=1.1.411",
+    "pytest>=9.1",
+    "pytest-cov>=7.0",
+    "ruff>=0.14",
+    "twine>=6.2",
+]
+
+[build-system]
+requires = ["uv_build>=0.9.11,<0.10.0"]
+build-backend = "uv_build"
+
+[tool.ruff]
+line-length = 100
+target-version = "py312"
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I", "UP", "B", "SIM"]
+
+[tool.pyright]
+include = ["src/blueprint_dsl", "tests"]
+extraPaths = ["src"]
+pythonVersion = "3.12"
+typeCheckingMode = "standard"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+filterwarnings = ["error"]
+
+[tool.coverage.run]
+source = ["src/blueprint_dsl"]
+branch = true
+
+[tool.coverage.report]
+show_missing = true
+fail_under = 88

blueprint_dsl-0.1.0/src/blueprint_dsl/__init__.py

@@ -0,0 +1,43 @@
+"""Compile Blueprint structured-output contracts to strict JSON Schema."""
+
+from importlib.metadata import version
+
+from blueprint_dsl.compiler import (
+    BLUEPRINT_DECLARATION_KEYWORDS,
+    BLUEPRINT_SPEC_EXAMPLE,
+    BLUEPRINT_TYPE_REGISTRY,
+    BlueprintTypeInfo,
+    CompiledStructuredOutputSchema,
+    StructuredOutputDslError,
+    blueprint_editor_metadata,
+    blueprint_spec_card,
+    blueprint_types_by_category,
+    compile_structured_output_dsl,
+)
+
+__version__ = version("blueprint-dsl")
+BLUEPRINT_LANGUAGE_VERSION = "blueprint/1"
+BLUEPRINT_COMPILER_VERSION = __version__
+
+BlueprintCompileError = StructuredOutputDslError
+CompiledBlueprint = CompiledStructuredOutputSchema
+compile_blueprint = compile_structured_output_dsl
+
+__all__ = [
+    "BLUEPRINT_COMPILER_VERSION",
+    "BLUEPRINT_DECLARATION_KEYWORDS",
+    "BLUEPRINT_LANGUAGE_VERSION",
+    "BLUEPRINT_SPEC_EXAMPLE",
+    "BLUEPRINT_TYPE_REGISTRY",
+    "BlueprintCompileError",
+    "BlueprintTypeInfo",
+    "CompiledBlueprint",
+    "CompiledStructuredOutputSchema",
+    "StructuredOutputDslError",
+    "__version__",
+    "blueprint_editor_metadata",
+    "blueprint_spec_card",
+    "blueprint_types_by_category",
+    "compile_blueprint",
+    "compile_structured_output_dsl",
+]