cube-python 0.4.0__tar.gz

cube_python-0.4.0/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2026 coshz
+
+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.

cube_python-0.4.0/PKG-INFO

@@ -0,0 +1,88 @@
+Metadata-Version: 2.4
+Name: cube-python
+Version: 0.4.0
+Summary: Python binding for Cube C++ library
+Author-email: coshz <fsinhx@gmail.com>
+License: MIT
+Project-URL: Documentation, https://github.com/coshz/cube/tree/master/bindings/python#readme
+Project-URL: Source, https://github.com/coshz/cube
+Project-URL: Bug Tracker, https://github.com/coshz/cube/issues
+Keywords: game,rubiks-cube,bindings
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: C++
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# cube-python
+
+[![PyPI version](https://img.shields.io/pypi/v/cube-python.svg)](https://pypi.org/project/cube-python/)
+[![License](https://img.shields.io/github/license/yourusername/cube)](https://github.com/yourusername/cube/blob/main/LICENSE)
+[![GitHub](https://img.shields.io/badge/github-coshz%2Fcube-blue?logo=github)](https://github.com/coshz/cube/tree/master/bindings/python)
+
+
+High-performance Rubik's Cube solver Python bindings powered by C/C++ FFI.
+
+---
+
+## Installation
+
+```bash
+pip install cube-python
+```
+
+## Quickstart
+
+```python
+iimport pycube
+from pycube import SolveError
+
+# Default solved cube string representation
+print(f"Target State: {pycube.CUBE_ID}")
+
+# Validate state solvability
+scrambled = pycube.facecube("U F U' L2 R L' D2 B")
+
+if pycube.solvable(scrambled):
+    try:
+        # Find solution sequence
+        solution = pycube.solve(scrambled, step=30, best=True)
+        print(f"Solution: {solution}")
+
+        # Apply solution to verify end state
+        end_state = pycube.facecube(solution, scrambled)
+        assert end_state == pycube.CUBE_ID
+
+    except SolveError as e:
+        print(f"Failed to solve cube: {e}")
+```
+
+## 📖 API Reference
+
+```python
+import pycube
+from pycube import SolveError, CUBE_ID
+```
+
+### Functions
+
+| Function | Description |
+| :--- | :--- |
+| `solve(src, tgt=CUBE_ID, step=30, best=False)` | Solves the cube state string `src`. Returns solution string or raises `SolveError`. |
+| `facecube(maneuver, cube=CUBE_ID)` | Applies move sequence (e.g., `"U F U' L2"`) to a cube state and returns the new state. |
+| `solvable(cube)` | Returns `True` if the 54-character state string is physically solvable. |
+| `permutation(ms, fmt=2)` | Returns a permutation representation for a move sequence or state. |
+
+### Constants & Exceptions
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `CUBE_ID` | `str` | Constant representing the standard solved state (`"UUUUUUUUURRRRRRRRRFFFFFFFFFDDDDDDDDDLLLLLLLLLBBBBBBBBB"`). |
+| `SolveError` | `Exception` | Raised when the state is invalid, unsolvable, or exceeds search step limits. |
+
+## 📄 License
+
+[MIT](LICENSE) © coshz

cube_python-0.4.0/README.md

@@ -0,0 +1,69 @@
+# cube-python
+
+[![PyPI version](https://img.shields.io/pypi/v/cube-python.svg)](https://pypi.org/project/cube-python/)
+[![License](https://img.shields.io/github/license/yourusername/cube)](https://github.com/yourusername/cube/blob/main/LICENSE)
+[![GitHub](https://img.shields.io/badge/github-coshz%2Fcube-blue?logo=github)](https://github.com/coshz/cube/tree/master/bindings/python)
+
+
+High-performance Rubik's Cube solver Python bindings powered by C/C++ FFI.
+
+---
+
+## Installation
+
+```bash
+pip install cube-python
+```
+
+## Quickstart
+
+```python
+iimport pycube
+from pycube import SolveError
+
+# Default solved cube string representation
+print(f"Target State: {pycube.CUBE_ID}")
+
+# Validate state solvability
+scrambled = pycube.facecube("U F U' L2 R L' D2 B")
+
+if pycube.solvable(scrambled):
+    try:
+        # Find solution sequence
+        solution = pycube.solve(scrambled, step=30, best=True)
+        print(f"Solution: {solution}")
+
+        # Apply solution to verify end state
+        end_state = pycube.facecube(solution, scrambled)
+        assert end_state == pycube.CUBE_ID
+
+    except SolveError as e:
+        print(f"Failed to solve cube: {e}")
+```
+
+## 📖 API Reference
+
+```python
+import pycube
+from pycube import SolveError, CUBE_ID
+```
+
+### Functions
+
+| Function | Description |
+| :--- | :--- |
+| `solve(src, tgt=CUBE_ID, step=30, best=False)` | Solves the cube state string `src`. Returns solution string or raises `SolveError`. |
+| `facecube(maneuver, cube=CUBE_ID)` | Applies move sequence (e.g., `"U F U' L2"`) to a cube state and returns the new state. |
+| `solvable(cube)` | Returns `True` if the 54-character state string is physically solvable. |
+| `permutation(ms, fmt=2)` | Returns a permutation representation for a move sequence or state. |
+
+### Constants & Exceptions
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `CUBE_ID` | `str` | Constant representing the standard solved state (`"UUUUUUUUURRRRRRRRRFFFFFFFFFDDDDDDDDDLLLLLLLLLBBBBBBBBB"`). |
+| `SolveError` | `Exception` | Raised when the state is invalid, unsolvable, or exceeds search step limits. |
+
+## 📄 License
+
+[MIT](LICENSE) © coshz

cube_python-0.4.0/cube_python.egg-info/PKG-INFO

@@ -0,0 +1,88 @@
+Metadata-Version: 2.4
+Name: cube-python
+Version: 0.4.0
+Summary: Python binding for Cube C++ library
+Author-email: coshz <fsinhx@gmail.com>
+License: MIT
+Project-URL: Documentation, https://github.com/coshz/cube/tree/master/bindings/python#readme
+Project-URL: Source, https://github.com/coshz/cube
+Project-URL: Bug Tracker, https://github.com/coshz/cube/issues
+Keywords: game,rubiks-cube,bindings
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: C++
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# cube-python
+
+[![PyPI version](https://img.shields.io/pypi/v/cube-python.svg)](https://pypi.org/project/cube-python/)
+[![License](https://img.shields.io/github/license/yourusername/cube)](https://github.com/yourusername/cube/blob/main/LICENSE)
+[![GitHub](https://img.shields.io/badge/github-coshz%2Fcube-blue?logo=github)](https://github.com/coshz/cube/tree/master/bindings/python)
+
+
+High-performance Rubik's Cube solver Python bindings powered by C/C++ FFI.
+
+---
+
+## Installation
+
+```bash
+pip install cube-python
+```
+
+## Quickstart
+
+```python
+iimport pycube
+from pycube import SolveError
+
+# Default solved cube string representation
+print(f"Target State: {pycube.CUBE_ID}")
+
+# Validate state solvability
+scrambled = pycube.facecube("U F U' L2 R L' D2 B")
+
+if pycube.solvable(scrambled):
+    try:
+        # Find solution sequence
+        solution = pycube.solve(scrambled, step=30, best=True)
+        print(f"Solution: {solution}")
+
+        # Apply solution to verify end state
+        end_state = pycube.facecube(solution, scrambled)
+        assert end_state == pycube.CUBE_ID
+
+    except SolveError as e:
+        print(f"Failed to solve cube: {e}")
+```
+
+## 📖 API Reference
+
+```python
+import pycube
+from pycube import SolveError, CUBE_ID
+```
+
+### Functions
+
+| Function | Description |
+| :--- | :--- |
+| `solve(src, tgt=CUBE_ID, step=30, best=False)` | Solves the cube state string `src`. Returns solution string or raises `SolveError`. |
+| `facecube(maneuver, cube=CUBE_ID)` | Applies move sequence (e.g., `"U F U' L2"`) to a cube state and returns the new state. |
+| `solvable(cube)` | Returns `True` if the 54-character state string is physically solvable. |
+| `permutation(ms, fmt=2)` | Returns a permutation representation for a move sequence or state. |
+
+### Constants & Exceptions
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `CUBE_ID` | `str` | Constant representing the standard solved state (`"UUUUUUUUURRRRRRRRRFFFFFFFFFDDDDDDDDDLLLLLLLLLBBBBBBBBB"`). |
+| `SolveError` | `Exception` | Raised when the state is invalid, unsolvable, or exceeds search step limits. |
+
+## 📄 License
+
+[MIT](LICENSE) © coshz

cube_python-0.4.0/cube_python.egg-info/SOURCES.txt

@@ -0,0 +1,14 @@
+LICENSE
+README.md
+pyproject.toml
+setup.py
+cube_python.egg-info/PKG-INFO
+cube_python.egg-info/SOURCES.txt
+cube_python.egg-info/dependency_links.txt
+cube_python.egg-info/top_level.txt
+cxx/cube_amalg.min.cpp
+pycube/__init__.py
+pycube/_exceptions.py
+pycube/_ffi.py
+test/test.2.py
+test/test_cube.py

cube_python-0.4.0/cube_python.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

cube_python-0.4.0/cube_python.egg-info/top_level.txt

@@ -0,0 +1 @@
+pycube