bolt_compute 0.0.3__tar.gz

bolt_compute-0.0.3/.github/workflows/release.yml

@@ -0,0 +1,60 @@
+name: Make a release
+on:
+  workflow_dispatch:
+    inputs:
+      version_bump:
+        description: 'Overide the automatic version bump (default: automatic)'
+        required: true
+        default: 'minor'
+        type: choice
+        options:
+        - patch
+        - minor
+        - major
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      id-token: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+        with:
+          fetch-depth: 0
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.14'
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          enable-cache: true
+      - name: Install dependencies
+        run: uv sync --group dev --all-extras
+      - name: Release
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          VERSION_BUMP: ${{ github.event.inputs.version_bump }}
+        run: |
+          uv run pytest -vvv
+          git config --global user.name "github-actions"
+          git config --global user.email "action@github.com"
+
+          uv version --bump $VERSION_BUMP
+          uv build
+
+          git add pyproject.toml
+          git add uv.lock
+          git commit -m "$(uv version --short)"
+          git tag -a $(uv version --short) -m "$(uv version --short)"
+          git push origin $(uv version --short)
+          git push origin main
+
+          uv publish
+
+          
+          
+          
+          

bolt_compute-0.0.3/.gitignore

@@ -0,0 +1,10 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv

bolt_compute-0.0.3/.vscode/launch.json

@@ -0,0 +1,15 @@
+{
+    // Use IntelliSense to learn about possible attributes.
+    // Hover to view descriptions of existing attributes.
+    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+    "version": "0.2.0",
+    "configurations": [
+    
+        {
+            "name": "Python Debugger: Module",
+            "type": "debugpy",
+            "request": "launch",
+            "module": "beet"
+        }
+    ]
+}

bolt_compute-0.0.3/PKG-INFO

@@ -0,0 +1,100 @@
+Metadata-Version: 2.5
+Name: bolt_compute
+Version: 0.0.3
+Summary: Add your description here
+Requires-Python: >=3.14
+Requires-Dist: beet>=0.116.0
+Requires-Dist: bolt>=0.50.1
+Description-Content-Type: text/markdown
+
+# Bolt Compute
+
+A [beet](https://github.com/mcbeet/beet) plugin that allows to use expressions instead of inline [number providers](https://minecraft.wiki/w/Number_provider).
+
+
+## Installation
+
+In a beet project, use `uv add bolt_compute` and add the module in the require phase in your beet config:
+
+```yaml
+require:
+  - bolt
+  - bolt_compute # <-- Add this line
+pipeline:
+  - mecha
+```
+
+## Usage
+
+Any place where the `compute` command/subcommand is used, you can use the `bolt` subcommand to use an expression instead of a number provider. For example, instead of:
+
+```mcfunction 
+compute default {type:"minecraft:sum",operands:[1,1]}
+data modify storage namespace:path path set compute default {type:"minecraft:sum",operands:[1,1]}
+```
+You can use:
+
+```mcfunction
+compute bolt (1 + 1)
+data modify storage namespace:path path set compute bolt (1 + 1)
+```
+
+### Literals values
+
+Bolt compute supports the following literal values:
+```mcfunction
+compute bolt (storage namespace:path path) # compute default {type:"minecraft:storage",storage:"namespace:path",path:"path"}
+
+x = 1 # bolt variable assignment
+compute bolt (x + 1) # compute default {type:"minecraft:sum",operands:[1,1]}
+
+y = "namespace:path_to_number_provider"
+compute bolt (y * y) # compute default {type:"minecraft:product",operands:["namespace:path_to_number_provider","namespace:path_to_number_provider"]}
+
+```
+
+### Operators
+
+`+`, `-`, `*`, are supported, as well as parentheses for grouping.
+
+### Functions
+
+Built-in functions are supported, such as : 
+- `average` expect a list using square brackets, e.g. `average([1,2,3])`
+- `binomial` expect N and P, can be expressions, e.g. `binomial(10, 0.5)`
+- `conditional` currently not implemented
+- `maximum` expect a list using square brackets, e.g. `maximum([1,2,3])`
+- `minimum` expect a list using square brackets, e.g. `minimum([1,2,3])`
+- `uniform` expect two number providers, can be expressions, e.g. `uniform(1, 10)`
+- `sum` expect a list using square brackets, e.g. `sum([1,2,3])`
+- `product` expect a list using square brackets, e.g. `product([1,2,3])`
+
+### Multiline expressions
+
+Expressions can be multiline, for example:
+
+```mcfunction
+x = 1
+y = 2
+compute bolt (
+    x + y
+)
+```
+
+### Full example
+
+```mcfunction
+
+x = "namespace:path_to_number_provider"
+y = 256*256
+
+data modify storage example:main result_bolt set compute bolt (
+    (storage example:main prod1)*(storage example:main prod2)*(storage example:main prod3)*2
+    *
+    2485*52+
+    maximum([0,1,(storage example:main prod2),1])+(143)-
+    (y*x) + x
+)
+```
+
+More examples can be found in the [examples](examples) folder.

bolt_compute-0.0.3/README.md

@@ -0,0 +1,91 @@
+# Bolt Compute
+
+A [beet](https://github.com/mcbeet/beet) plugin that allows to use expressions instead of inline [number providers](https://minecraft.wiki/w/Number_provider).
+
+
+## Installation
+
+In a beet project, use `uv add bolt_compute` and add the module in the require phase in your beet config:
+
+```yaml
+require:
+  - bolt
+  - bolt_compute # <-- Add this line
+pipeline:
+  - mecha
+```
+
+## Usage
+
+Any place where the `compute` command/subcommand is used, you can use the `bolt` subcommand to use an expression instead of a number provider. For example, instead of:
+
+```mcfunction 
+compute default {type:"minecraft:sum",operands:[1,1]}
+data modify storage namespace:path path set compute default {type:"minecraft:sum",operands:[1,1]}
+```
+You can use:
+
+```mcfunction
+compute bolt (1 + 1)
+data modify storage namespace:path path set compute bolt (1 + 1)
+```
+
+### Literals values
+
+Bolt compute supports the following literal values:
+```mcfunction
+compute bolt (storage namespace:path path) # compute default {type:"minecraft:storage",storage:"namespace:path",path:"path"}
+
+x = 1 # bolt variable assignment
+compute bolt (x + 1) # compute default {type:"minecraft:sum",operands:[1,1]}
+
+y = "namespace:path_to_number_provider"
+compute bolt (y * y) # compute default {type:"minecraft:product",operands:["namespace:path_to_number_provider","namespace:path_to_number_provider"]}
+
+```
+
+### Operators
+
+`+`, `-`, `*`, are supported, as well as parentheses for grouping.
+
+### Functions
+
+Built-in functions are supported, such as : 
+- `average` expect a list using square brackets, e.g. `average([1,2,3])`
+- `binomial` expect N and P, can be expressions, e.g. `binomial(10, 0.5)`
+- `conditional` currently not implemented
+- `maximum` expect a list using square brackets, e.g. `maximum([1,2,3])`
+- `minimum` expect a list using square brackets, e.g. `minimum([1,2,3])`
+- `uniform` expect two number providers, can be expressions, e.g. `uniform(1, 10)`
+- `sum` expect a list using square brackets, e.g. `sum([1,2,3])`
+- `product` expect a list using square brackets, e.g. `product([1,2,3])`
+
+### Multiline expressions
+
+Expressions can be multiline, for example:
+
+```mcfunction
+x = 1
+y = 2
+compute bolt (
+    x + y
+)
+```
+
+### Full example
+
+```mcfunction
+
+x = "namespace:path_to_number_provider"
+y = 256*256
+
+data modify storage example:main result_bolt set compute bolt (
+    (storage example:main prod1)*(storage example:main prod2)*(storage example:main prod3)*2
+    *
+    2485*52+
+    maximum([0,1,(storage example:main prod2),1])+(143)-
+    (y*x) + x
+)
+```
+
+More examples can be found in the [examples](examples) folder.