dndwright 0.2.0__py3-none-any.whl

dndwright-0.2.0.dist-info/METADATA

@@ -0,0 +1,101 @@
+Metadata-Version: 2.4
+Name: dndwright
+Version: 0.2.0
+Summary: Domain-neutral D&D 5e (2024) rules & character-sheet computation engine: a data-driven DAG of formulas (ability mods, proficiency, spell DC/slots, HP, AC).
+Project-URL: Homepage, https://github.com/sligara7/dndwright
+Project-URL: Repository, https://github.com/sligara7/dndwright
+Author: Anthony Sligar
+License: MIT
+License-File: LICENSE
+License-File: NOTICE
+Keywords: character-sheet,computation-graph,dnd,dnd5e,rules-engine,srd,ttrpg
+Classifier: Development Status :: 3 - Alpha
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Games/Entertainment :: Role-Playing
+Requires-Python: >=3.10
+Requires-Dist: pydantic>=2.5
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4; extra == 'dev'
+Requires-Dist: ruff>=0.1; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# dndwright
+
+> ⚠️ **Early development (v0.1, alpha).** The API is still moving and may change without
+> notice between minor versions. Extracted from a working application; usable today, but
+> pin a tag/commit if you depend on it.
+
+**A domain-neutral D&D 5e (2024) rules & character-sheet computation engine.** A character
+sheet is modelled as a **directed acyclic computation graph** — nodes are values, edges are
+dependencies, and formulas are *data* (a JSON-serialisable DSL), not code. Pure Python
+(`pydantic` + stdlib), no application or framework coupling: map your own character data in,
+read computed stats out.
+
+## Install
+
+```bash
+pip install git+https://github.com/sligara7/dndwright.git
+# or, for local development:
+pip install -e ".[dev]"
+```
+
+## Quickstart
+
+```python
+from dndwright import evaluate_character
+
+sheet = evaluate_character({
+    "ability_scores": {"strength": 8, "dexterity": 14, "constitution": 14,
+                       "intelligence": 18, "wisdom": 12, "charisma": 10},
+    "class_data": {"class_name": "wizard"},
+    "species_data": {"name": "Human", "speed": 30},
+    "level": 5,
+})
+
+sheet["proficiency_bonus"]    # 3
+sheet["ability_modifiers"]    # {"intelligence": 4, "dexterity": 2, ...}
+sheet["spellcasting_type"]    # "full_caster"
+# ...plus armor_class, hit_points, hit_dice, initiative, saves, features, ...
+```
+
+Lower level — assemble typed inputs and evaluate against the ruleset:
+
+```python
+from dndwright import DND_5E_2024_RULESET, assemble_character_inputs, evaluate, apply_modifiers
+from dndwright.rules.components import ClassMechanics
+
+inputs   = assemble_character_inputs(class_mechanics=..., ability_scores={...}, level=5)
+computed = apply_modifiers(evaluate(DND_5E_2024_RULESET, inputs), inputs)
+```
+
+## Why a computation graph?
+
+Derived character values form a dependency DAG: ability scores → modifiers → proficiency →
+save DCs / spell slots / AC / HP. dndwright represents that DAG explicitly and stores the
+formulas as **data** (`FormulaSpec`: an op + args), so the rules are inspectable, testable,
+and serialisable — not buried in imperative code. `DND_5E_2024_RULESET` is a 135-node graph.
+
+## What's inside
+
+| Component | What it does |
+|-----------|--------------|
+| `evaluate_character` | One call: character data dict → fully computed sheet. |
+| `DND_5E_2024_RULESET` | The 135-node 5e-2024 computation DAG (formulas as data). |
+| `evaluate` / `assemble_character_inputs` / `apply_modifiers` | The lower-level engine. |
+| `Ruleset` / `ComputationNode` / `FormulaSpec` / `NodeType` | The DAG schema. |
+| `dndwright.rules.components` | Typed inputs (`ClassMechanics`, `SpeciesMechanics`, …). |
+| `dndwright.rules.lookup_tables` | SRD-derived rules tables (hit dice, spell slots, AC, saves). |
+
+## API stability
+
+The public API is exactly `dndwright.__all__`, pinned by `tests/test_api_contract.py`.
+Versioning follows [SemVer](https://semver.org/); at `0.x` minor versions may break, with
+every change recorded in `CHANGELOG.md`.
+
+## Credits & license
+
+MIT licensed (see `LICENSE`). The rules tables encode game *mechanics* derived from the
+**D&D System Reference Document 5.2** (© Wizards of the Coast, **CC-BY-4.0**); see `NOTICE`.
+Not affiliated with or endorsed by Wizards of the Coast. Contains no PHB/DMG/MM content.

dndwright-0.2.0.dist-info/RECORD

@@ -0,0 +1,26 @@
+dndwright/__init__.py,sha256=3AypfLVs2LTP1F9ddNjy8hNLhYDSL75rPaZMWSwwZpk,2668
+dndwright/content/__init__.py,sha256=gp7GuTMOZ5OR8VVaSGwwkbTSwQpalXUNBou1BaPKef4,1669
+dndwright/content/classes.json,sha256=n_bq9TzFA8meCK4uDRY-NNxeSLGV1-WklEJirox1k1s,5029
+dndwright/content/creatures.json,sha256=NjpdckyqRUv88aLGHfdvy2OImvVb6uER0zu7sI02lBk,8980
+dndwright/content/generate.py,sha256=zAIeULBbNHBSYu58GJCm-zoA_fJt5TmsSGzLABFSlXA,5151
+dndwright/content/magic_items.json,sha256=9C6bMuqo6L8UQuV0di925K7DY4uY6CAz9IJqZnBLe-U,204317
+dndwright/content/species.json,sha256=QX_4XW2P9zkgDhMXt7KpiyGm9FBD52fx3olhGLb9gIg,3970
+dndwright/ontology/__init__.py,sha256=PLJuTBiiVBJpHAAy1x_Pz7jRq52in1--40RSzaE1WPg,551
+dndwright/ontology/dnd.yaml,sha256=93rlQ1Ts8X5MYJ_kX0T74GWEQY5MhDX1y9kh5UOyVyQ,5705
+dndwright/ontology/loader.py,sha256=YceqJJ96GZGYJC7xUOPVpy5VD2hhpgd3hTXBRh3uLkk,3497
+dndwright/rules/__init__.py,sha256=32PP2LR_67iEp-MFRj8BNuX8Fi9QjncpRAJvbINptbE,1096
+dndwright/rules/adapters.py,sha256=JFzI0D4acoLo2Oa0EaQgIUb458clerfhZzSKQZS_JRw,26977
+dndwright/rules/assembler.py,sha256=7uu4JdBcezbDSXH66IrmbUyeqA6YuuksIQUtqeVER3Q,14419
+dndwright/rules/character_evaluator.py,sha256=Rvvv2BcMUTrA0m67g8N02E4R_W5J_oz_t_Uypcgosck,8358
+dndwright/rules/components.py,sha256=RuOhKNrQ5JhPIZsD4uy-jzW5rzUnkZCLGw0gm-MFiko,22062
+dndwright/rules/dnd_5e_2024.py,sha256=yUg6yoYPhN7-ENAB3Pb1G5pUPwFOEpUvPiPb0yvsNZw,19057
+dndwright/rules/evaluator.py,sha256=GFUr7xtnemVw43ze84IGMlfO_0yXkBIZOKRL1fsONC8,6373
+dndwright/rules/lookup_tables.py,sha256=G9EauJCXFMdJtPHS6s82FsqJ3NEqldIX6U5cJUhemCg,16181
+dndwright/rules/operations.py,sha256=LskHIA4V608zBhl2YxmYIy-fRDcVB1wN9ZPFX6TQg-w,12941
+dndwright/rules/schema.py,sha256=yguB2nnHKiaqQHlwJHrMZAhrvswt1aHoSI2xqh4U-GU,2606
+dndwright/rules/theme_scaling.py,sha256=_0YGOmflBu1zXlHbqNY3pNflGaAUXZCQQzLwHKECLUY,7975
+dndwright-0.2.0.dist-info/METADATA,sha256=-hBu_IQUmOQVmCS_TWL0P_wLqbSNIVP50nBr2bYSz-8,4228
+dndwright-0.2.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+dndwright-0.2.0.dist-info/licenses/LICENSE,sha256=SH_gQdl3Ihoor4g_7cE-qaRM8o1tGRh1Alo3oPsLJGI,1071
+dndwright-0.2.0.dist-info/licenses/NOTICE,sha256=Ng3qyEeIGYD2HwF84NoQ4qW86EK2NDUsCFEpfyAvMOE,1164
+dndwright-0.2.0.dist-info/RECORD,,

dndwright-0.2.0.dist-info/WHEEL

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

dndwright-0.2.0.dist-info/licenses/LICENSE

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

dndwright-0.2.0.dist-info/licenses/NOTICE

@@ -0,0 +1,24 @@
+dndwright
+Copyright (c) 2026 Anthony Sligar
+Licensed under the MIT License (see LICENSE).
+
+------------------------------------------------------------------------------
+Game-rules content
+------------------------------------------------------------------------------
+
+dndwright's rules tables (hit dice, spellcasting progression / spell slots,
+armor base AC, save proficiencies, class spellcasting abilities, etc.) encode
+game *mechanics* — facts about how D&D 5e (2024) characters are computed. Where
+those facts come from published game content, they derive from the:
+
+    Dungeons & Dragons System Reference Document 5.2 (SRD 5.2)
+    © Wizards of the Coast LLC, licensed under
+    Creative Commons Attribution 4.0 International (CC-BY-4.0).
+    https://creativecommons.org/licenses/by/4.0/
+
+This project is not affiliated with, endorsed, or sponsored by Wizards of the
+Coast. It contains no content from the Player's Handbook, Dungeon Master's
+Guide, Monster Manual, or any other non-SRD source.
+
+"Dungeons & Dragons" and "D&D" are trademarks of Wizards of the Coast; they are
+used here only nominatively to describe the rules system this engine computes.