wzrdbrain 0.1.0__py3-none-any.whl

wzrdbrain/__init__.py

@@ -0,0 +1,10 @@
+from .wzrdbrain import generate_combo, generate_trick
+
+"""
+wzrdbrain: Basic APIs to generate tricks for wizard skating.
+"""
+
+
+__all__ = ["generate_trick", "generate_combo"]
+
+__version__ = "0.1.0"

wzrdbrain/wzrdbrain.py

@@ -0,0 +1,93 @@
+import random
+from typing import Optional
+
+# Trick data definitions
+direction = ["front", "back"]
+stance = ["open", "closed"]
+move = [
+    "predator",
+    "predator one",
+    "parallel",
+    "tree",
+    "gazelle",
+    "gazelle s",
+    "lion",
+    "lion s",
+    "toe press",
+    "heel press",
+    "toe roll",
+    "heel roll",
+    "360",
+    "180",
+    "parallel slide",
+    "soul slide",
+    "acid slide",
+    "mizu slide",
+    "star slide",
+    "fast slide",
+    "back slide",
+]
+exclude_stance = [
+    "predator",
+    "predator one",
+    "toe press",
+    "toe roll",
+    "heel press",
+    "heel roll",
+    "360",
+    "180",
+    "parallel slide",
+    "soul slide",
+    "acid slide",
+    "mizu slide",
+    "star slide",
+    "fast slide",
+    "back slide",
+]
+use_fakie = [
+    "toe press",
+    "toe roll",
+    "heel press",
+    "heel roll",
+    "360",
+    "180",
+    "parallel slide",
+    "soul slide",
+    "acid slide",
+    "mizu slide",
+    "star slide",
+    "fast slide",
+    "back slide",
+]
+
+
+# Generate a trick
+def generate_trick() -> list[str]:
+    selected_move = random.choice(move)
+    trick = [random.choice(direction)]
+
+    if selected_move not in exclude_stance:
+        trick.append(random.choice(stance))
+
+    trick.append(selected_move)
+    return trick
+
+
+# Generate a combination of tricks. Default setting is random, between 1-5 tricks.
+def generate_combo(num_of_tricks: Optional[int] = None) -> list[str]:
+    if num_of_tricks is None:
+        num_of_tricks = random.randint(1, 5)
+
+    trick_line: list[str] = []
+    for i in range(num_of_tricks):
+        trick_parts = generate_trick()
+        # If the move uses the fakie semantics, convert the direction "front"/"back" to "forward"/"fakie"
+        if trick_parts:
+            move_name = trick_parts[-1]
+            if move_name in use_fakie:
+                if trick_parts[0] == "back":
+                    trick_parts[0] = "fakie"
+                elif trick_parts[0] == "front":
+                    trick_parts[0] = "forward"
+        trick_line.append(" ".join(trick_parts))
+    return trick_line

wzrdbrain-0.1.0.dist-info/METADATA

@@ -0,0 +1,107 @@
+Metadata-Version: 2.4
+Name: wzrdbrain
+Version: 0.1.0
+Summary: Basic APIs to generate tricks for wizard skating.
+Project-URL: Homepage, https://github.com/nazroll/wzrdbrain
+Project-URL: Documentation, https://github.com/nazroll/wzrdbrain#readme
+Project-URL: Repository, https://github.com/nazroll/wzrdbrain
+Project-URL: Issues, https://github.com/nazroll/wzrdbrain/issues
+Author: nazroll
+License: MIT License
+        
+        Copyright (c) 2025 Nazrul Kamaruddin
+        
+        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.
+License-File: LICENSE
+Keywords: generator,inline skating,random,tricks,wizard skating
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+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 :: Games/Entertainment
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Provides-Extra: dev
+Requires-Dist: black>=24.3; extra == 'dev'
+Requires-Dist: build>=1.2; extra == 'dev'
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: ruff>=0.5; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# wzrdbrain
+
+Basic APIs to generate tricks for wizard skating.
+
+## Installation
+
+```bash
+pip install wzrdbrain
+```
+
+## Usage
+
+```python
+from wzrdbrain import generate_trick, generate_tricks
+
+# Single trick (random)
+print(generate_trick())  # e.g., "Front Open Lion"
+
+# Multiple tricks
+print(generate_combo(5))  # Maximum of 5 tricks in a combo (duplicates allowed)
+```
+
+## Development
+
+```bash
+# clone your repo
+python -m venv .venv
+source .venv/bin/activate  # on Windows: .venv\Scripts\activate
+pip install -e ".[dev]"
+
+# lint + format
+ruff check .
+black .
+
+# type-check
+mypy .
+
+# tests
+pytest
+```
+
+## Release
+
+1. Update version in `pyproject.toml` and `src/wzrdbrain/__init__.py`.
+2. Create a Git tag and GitHub Release, e.g. `v0.1.0`.
+3. The release workflow will build and publish to PyPI via Trusted Publishing.
+
+## Notes
+
+- Reproducibility: Set `seed` to get the same result across runs.
+- Categories: Use `categories()` to see available groups and restrict generation.
+- Typing: This library ships `py.typed` for type checkers.

wzrdbrain-0.1.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+wzrdbrain/__init__.py,sha256=trIv6PSyva-qbi3Qjyzu7PAvkZoFT33709p47wHFXFg,196
+wzrdbrain/wzrdbrain.py,sha256=VeVdgaGD62kRz8qv3vFlpNMKd87X6di4oWXVAJxujP4,2067
+wzrdbrain-0.1.0.dist-info/METADATA,sha256=nrpSLlJHxEuaVHAe-AfMOaBZG6JNahsZz_NR9HQdAeU,3708
+wzrdbrain-0.1.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+wzrdbrain-0.1.0.dist-info/licenses/LICENSE,sha256=Hy5x7SjmbSRYLupIQI0bKAlfdZadCRV6Ka3XCXQrbAo,1073
+wzrdbrain-0.1.0.dist-info/RECORD,,

wzrdbrain-0.1.0.dist-info/WHEEL

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

wzrdbrain-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Nazrul Kamaruddin
+
+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.