sm-blueprint-lib 0.0.7__py3-none-any.whl → 0.0.8__py3-none-any.whl

sm_blueprint_lib-0.0.8.dist-info/METADATA

@@ -0,0 +1,99 @@
+Metadata-Version: 2.4
+Name: sm_blueprint_lib
+Version: 0.0.8
+Summary: Scrap Mechanic Library for Blueprint manipulation.
+Project-URL: Homepage, https://github.com/MauriceTZ/sm_blueprint_lib
+Project-URL: Issues, https://github.com/MauriceTZ/sm_blueprint_lib/issues
+Author-email: Maurice <mauriciotorrez00@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.8
+Requires-Dist: numpy
+Description-Content-Type: text/markdown
+
+# sm_blueprint_lib
+ Scrap Mechanic Library for Blueprint manipulation.
+
+## Instalation
+```sh
+pip install sm_blueprint_lib
+```
+## Usage
+```python
+import numpy as np
+
+import sm_blueprint_lib as sm
+
+# Create a Blueprint object to store your parts
+bp = sm.Blueprint()
+
+# Define your stuff as you like, ID's are generated automatically or u can create them manually
+# The controller argument is converted to the needed LogicGateController class
+# 0: and, 1: or, 2: xor, 3: nand, 4: nor, 5: xnor
+single_and = sm.LogicGate(pos=(0, 0, 0), color="1122ff", controller=0)
+single_or = sm.LogicGate(sm.Pos(0, 2, 0), "3322ff", 1)
+single_self_wired_xor = sm.LogicGate(
+    pos=sm.Pos(0, 4, 0),
+    color="5522ff",
+    # Or define it explicitly
+    controller=sm.LogicGateController(mode=2, id=9999999, controllers=[sm.ID(9999999)])
+)
+
+# Create multiple gates at the same time
+row_0 = [sm.LogicGate((x, 6, 0), "ffffff", 0) for x in range(10)]
+row_1 = [sm.LogicGate((-1, 6, z + 1), "ffffff", 0) for z in range(10)]
+# Define matrices using numpy
+matrix = np.ndarray((10, 10), dtype=sm.LogicGate)
+for x in range(10):
+    for z in range(10):
+        # Define custom rotation (xaxis, zaxis)
+        matrix[x, z] = sm.LogicGate(
+            (x, 8, z + 1), "000000", 5, xaxis=1, zaxis=2)
+
+single_nor = sm.LogicGate(sm.Pos(0, 11, 0), "ee22ff", 4)
+
+row_2 = [sm.LogicGate((x, 13, 0), "ffffff", 0) for x in range(10)]
+row_3 = [sm.LogicGate((-1, 13, z + 1), "ffffff", 0) for z in range(10)]
+
+# Simple Timer loop
+loop = [sm.LogicGate((4, 0, 0), "987654"),
+        # TimerController can be passed as (seconds, ticks)
+        sm.Timer((5, 0, 0), "3210ff", (1, 0)),
+        sm.LogicGate((6, 0, 0), "eeddcc", 3)]
+
+# Connect stuff
+# 1 to 1
+sm.connect(single_and, single_or)
+sm.connect(single_or, single_self_wired_xor)
+sm.connect(row_0, row_1)    # With parallel=True (ie row to row)
+# 1 to many
+sm.connect(single_self_wired_xor, row_0)
+sm.connect(row_0, matrix)
+# Many to 1
+sm.connect(matrix, single_nor)
+# Many to many
+# With parallel=False (ie everything connects to everything)
+sm.connect(row_2, row_3, parallel=False)
+# You can also chain single gate connections
+loop[0].connect(loop[1]).connect(loop[2]).connect(loop[0])
+
+# Put all parts into the blueprint
+# Note that it doesn't care if it's a single gate or arrays
+bp.add(single_and, single_or, single_self_wired_xor,
+       row_0, row_1, matrix, single_nor, row_2, row_3, loop)
+
+# Finally, save the blueprint into a file or dump it as a string
+print(sm.dump_string_from_blueprint(bp))
+path = "path/to/your/blueprint/folder/blueprint.json"
+sm.save_blueprint(bp, path)
+```
+
+### Results
+#### 1 to 1 and loop
+![1 to 1 and loop](1to1andloop.png)
+#### Row to row and 1 to many
+![row to row and 1 to many](rowtorowand1tomany.png)
+#### Many to 1 and many to many
+![many to 1 and many to many](manytooneandmanytomany.png)

{sm_blueprint_lib-0.0.7.dist-info → sm_blueprint_lib-0.0.8.dist-info}/RECORD

@@ -34,7 +34,7 @@ sm_blueprint_lib/prebuilds/register.py,sha256=MAiplmiA2L_VJaxCX2E8QuancnoqvyLY-v
 sm_blueprint_lib/prebuilds/rom.py,sha256=4dxAaNxRX60kDW17NKew-TJkPB7EMfHuK_zVIm6N-jo,3700
 sm_blueprint_lib/prebuilds/timer_ram_cached.py,sha256=PG53hDKYS00fur5vazh7iOs2Gm4G_URJLX7d9xWJOe4,19057
 sm_blueprint_lib/prebuilds/timer_ram_multiclient.py,sha256=NlQeJB6ilEGJDrIOfkFmPWd7afDR_0CUZH7RQpjyA4s,4200
-sm_blueprint_lib-0.0.7.dist-info/METADATA,sha256=QBI7t4D3xRFccTybjqgAnnACBTcg0oQMJX4MuzDD9-0,611
-sm_blueprint_lib-0.0.7.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-sm_blueprint_lib-0.0.7.dist-info/licenses/LICENSE,sha256=DWhaodryTSEv07KdWbanCMaEujOXYxnj-IEhmgTkOq0,1084
-sm_blueprint_lib-0.0.7.dist-info/RECORD,,
+sm_blueprint_lib-0.0.8.dist-info/METADATA,sha256=a8b9VUFkqtRqzOTuWkomOeOb6y6r7VerAgp7ZNuOGs0,3378
+sm_blueprint_lib-0.0.8.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+sm_blueprint_lib-0.0.8.dist-info/licenses/LICENSE,sha256=DWhaodryTSEv07KdWbanCMaEujOXYxnj-IEhmgTkOq0,1084
+sm_blueprint_lib-0.0.8.dist-info/RECORD,,

sm_blueprint_lib-0.0.7.dist-info/METADATA

@@ -1,17 +0,0 @@
-Metadata-Version: 2.4
-Name: sm_blueprint_lib
-Version: 0.0.7
-Summary: Scrap Mechanic Library for Blueprint manipulation.
-Project-URL: Homepage, https://github.com/MauriceTZ/sm_blueprint_lib
-Project-URL: Issues, https://github.com/MauriceTZ/sm_blueprint_lib/issues
-Author-email: Maurice <mauriciotorrez00@gmail.com>
-License-Expression: MIT
-License-File: LICENSE
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
-Requires-Python: >=3.8
-Requires-Dist: numpy
-Description-Content-Type: text/markdown
-
-# sm_blueprint_lib
- Scrap Mechanic Library for Blueprint manipulation.