masts 0.1.0__tar.gz

masts-0.1.0/LICENSE

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

masts-0.1.0/PKG-INFO

@@ -0,0 +1,111 @@
+Metadata-Version: 2.4
+Name: masts
+Version: 0.1.0
+Summary: Step-by-step solutions for math expressions and equations (1 + 2 x 3 -> ['1 + 6', '7']), plus text-to-symbol helpers (6^6 -> 6⁶).
+Author: PipoAndDodo
+License-Expression: MIT
+Keywords: math,steps,solver,equation,calculator,superscript,education
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Education
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+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 :: Education
+Classifier: Topic :: Scientific/Engineering :: Mathematics
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# math-step-to-step
+
+Giải biểu thức / phương trình **từng bước** và trả về danh sách các bước.
+Không phụ thuộc thư viện ngoài, dùng phân số chính xác (`fractions.Fraction`) nên không bị sai số.
+
+*Step-by-step solver for math expressions and equations. Pure Python, zero dependencies, exact arithmetic.*
+
+```bash
+pip install math-step-to-step
+```
+
+## Dùng nhanh
+
+```python
+from math_step_to_step import steps, solve, evaluate, prettify
+
+steps("1 + 2 x 3")              # ['1 + 6', '7']
+steps("(1 + 2) x 3 + 4 x 5")    # ['3 × 3 + 4 × 5', '9 + 20', '29']
+steps("2 + 3 x (4 - 1)^2")      # ['2 + 3 × 3²', '2 + 3 × 9', '2 + 27', '29']
+steps("1/2 + 1/3")              # ['1/2 + 1/3', '5/6']
+
+# tìm x
+steps("2x + 3 = 7")             # ['2x = 7 - 3', '2x = 4', 'x = 4 ÷ 2', 'x = 2']
+steps("2(x + 3) = 10")          # ['2x + 6 = 10', '2x = 10 - 6', '2x = 4', 'x = 4 ÷ 2', 'x = 2']
+steps("x^2 - 3x + 2 = 0")       # a, b, c -> Δ -> x₁, x₂ (từng bước)
+
+# kết quả có cấu trúc
+sol = solve("x^2 - 3x + 2 = 0")
+sol.kind, sol.values            # ('roots', (2, 1))
+
+evaluate("2 + 3 x 4")           # 14   (nhanh, không tạo chuỗi bước)
+
+# đổi chuỗi thành ký hiệu
+prettify("6^6")                 # '6⁶'
+prettify("x^2 + y^(n+1) <= sqrt(2)*pi")   # 'x² + yⁿ⁺¹ ≤ √2×π'
+```
+
+## Cú pháp nhập
+
+| Viết | Ý nghĩa |
+|---|---|
+| `+ - * x × · / ÷ :` | cộng, trừ, nhân, chia |
+| `x` giữa hai toán hạng, vd `2 x 3` | **phép nhân**; còn `2x`, `x + 1`, `x²` thì `x` là **biến** |
+| `^`, `**`, `²` `³` | lũy thừa (số mũ nguyên) |
+| `sqrt(…)`, `√9` | căn bậc hai |
+| `( )`, `[ ]`, `{ }` | ngoặc |
+| `2x`, `3(x+1)`, `(a)(b)` | nhân ngầm |
+| `1,5` hoặc `1.5` | số thập phân |
+| `=` | phương trình (1 biến, bậc 1 hoặc 2) |
+
+## Tùy chọn của `steps()` / `solve()`
+
+| Tham số | Mặc định | Ý nghĩa |
+|---|---|---|
+| `include_original` | `False` | thêm biểu thức gốc làm bước đầu |
+| `detailed` | `False` | mỗi bước chỉ làm 1 phép (`1+2+3` → `3 + 3` → `6`) thay vì gộp |
+| `pretty` | `True` | dùng `× ÷ ² √`; `False` ra ASCII (`* / ^ sqrt()`), có thể đưa lại vào thư viện |
+| `style` | `"auto"` | `"fraction"`, `"decimal"` hoặc `"auto"` (thập phân nếu đầu vào có số thập phân) |
+| `lang` | `"vi"` | ngôn ngữ thông báo: `"vi"` / `"en"` |
+
+Cách chọn bước: ngoặc trước → lũy thừa/căn → nhân chia → cộng trừ; các phép độc lập được làm **cùng một bước**
+và chuỗi cộng/nhân liên tiếp được gộp để lời giải ngắn nhất. Với phương trình: rút gọn → chuyển vế → chia hệ số;
+bậc 2 dùng Δ.
+
+## Ký hiệu
+
+```python
+from math_step_to_step import superscript, subscript, prettify
+superscript("123")        # '¹²³'
+subscript("12")           # '₁₂'
+prettify("H_2O, 6^6, x^(n+1), 1/2, a<=b, a!=b, +-3, alpha")
+# 'H₂O, 6⁶, xⁿ⁺¹, ½, a≤b, a≠b, ±3, α'
+```
+
+## Giới hạn (cố ý, để ít lỗi)
+Một biến; phương trình bậc ≤ 2; số mũ nguyên; không có số phức; không rút gọn căn phức tạp
+(căn không chính phương được rút gọn dạng `2 × √3` và cho giá trị gần đúng). Đầu vào sai/không hỗ trợ
+luôn ném `MathStepError` (kế thừa `ValueError`) với thông báo rõ ràng.
+
+## Dòng lệnh
+
+```bash
+math-step-to-step "(1 + 2) x 3 + 4 x 5"
+python -m math_step_to_step "2x + 3 = 7" --en
+```
+
+MIT License.

masts-0.1.0/README.md

@@ -0,0 +1,87 @@
+# math-step-to-step
+
+Giải biểu thức / phương trình **từng bước** và trả về danh sách các bước.
+Không phụ thuộc thư viện ngoài, dùng phân số chính xác (`fractions.Fraction`) nên không bị sai số.
+
+*Step-by-step solver for math expressions and equations. Pure Python, zero dependencies, exact arithmetic.*
+
+```bash
+pip install math-step-to-step
+```
+
+## Dùng nhanh
+
+```python
+from math_step_to_step import steps, solve, evaluate, prettify
+
+steps("1 + 2 x 3")              # ['1 + 6', '7']
+steps("(1 + 2) x 3 + 4 x 5")    # ['3 × 3 + 4 × 5', '9 + 20', '29']
+steps("2 + 3 x (4 - 1)^2")      # ['2 + 3 × 3²', '2 + 3 × 9', '2 + 27', '29']
+steps("1/2 + 1/3")              # ['1/2 + 1/3', '5/6']
+
+# tìm x
+steps("2x + 3 = 7")             # ['2x = 7 - 3', '2x = 4', 'x = 4 ÷ 2', 'x = 2']
+steps("2(x + 3) = 10")          # ['2x + 6 = 10', '2x = 10 - 6', '2x = 4', 'x = 4 ÷ 2', 'x = 2']
+steps("x^2 - 3x + 2 = 0")       # a, b, c -> Δ -> x₁, x₂ (từng bước)
+
+# kết quả có cấu trúc
+sol = solve("x^2 - 3x + 2 = 0")
+sol.kind, sol.values            # ('roots', (2, 1))
+
+evaluate("2 + 3 x 4")           # 14   (nhanh, không tạo chuỗi bước)
+
+# đổi chuỗi thành ký hiệu
+prettify("6^6")                 # '6⁶'
+prettify("x^2 + y^(n+1) <= sqrt(2)*pi")   # 'x² + yⁿ⁺¹ ≤ √2×π'
+```
+
+## Cú pháp nhập
+
+| Viết | Ý nghĩa |
+|---|---|
+| `+ - * x × · / ÷ :` | cộng, trừ, nhân, chia |
+| `x` giữa hai toán hạng, vd `2 x 3` | **phép nhân**; còn `2x`, `x + 1`, `x²` thì `x` là **biến** |
+| `^`, `**`, `²` `³` | lũy thừa (số mũ nguyên) |
+| `sqrt(…)`, `√9` | căn bậc hai |
+| `( )`, `[ ]`, `{ }` | ngoặc |
+| `2x`, `3(x+1)`, `(a)(b)` | nhân ngầm |
+| `1,5` hoặc `1.5` | số thập phân |
+| `=` | phương trình (1 biến, bậc 1 hoặc 2) |
+
+## Tùy chọn của `steps()` / `solve()`
+
+| Tham số | Mặc định | Ý nghĩa |
+|---|---|---|
+| `include_original` | `False` | thêm biểu thức gốc làm bước đầu |
+| `detailed` | `False` | mỗi bước chỉ làm 1 phép (`1+2+3` → `3 + 3` → `6`) thay vì gộp |
+| `pretty` | `True` | dùng `× ÷ ² √`; `False` ra ASCII (`* / ^ sqrt()`), có thể đưa lại vào thư viện |
+| `style` | `"auto"` | `"fraction"`, `"decimal"` hoặc `"auto"` (thập phân nếu đầu vào có số thập phân) |
+| `lang` | `"vi"` | ngôn ngữ thông báo: `"vi"` / `"en"` |
+
+Cách chọn bước: ngoặc trước → lũy thừa/căn → nhân chia → cộng trừ; các phép độc lập được làm **cùng một bước**
+và chuỗi cộng/nhân liên tiếp được gộp để lời giải ngắn nhất. Với phương trình: rút gọn → chuyển vế → chia hệ số;
+bậc 2 dùng Δ.
+
+## Ký hiệu
+
+```python
+from math_step_to_step import superscript, subscript, prettify
+superscript("123")        # '¹²³'
+subscript("12")           # '₁₂'
+prettify("H_2O, 6^6, x^(n+1), 1/2, a<=b, a!=b, +-3, alpha")
+# 'H₂O, 6⁶, xⁿ⁺¹, ½, a≤b, a≠b, ±3, α'
+```
+
+## Giới hạn (cố ý, để ít lỗi)
+Một biến; phương trình bậc ≤ 2; số mũ nguyên; không có số phức; không rút gọn căn phức tạp
+(căn không chính phương được rút gọn dạng `2 × √3` và cho giá trị gần đúng). Đầu vào sai/không hỗ trợ
+luôn ném `MathStepError` (kế thừa `ValueError`) với thông báo rõ ràng.
+
+## Dòng lệnh
+
+```bash
+math-step-to-step "(1 + 2) x 3 + 4 x 5"
+python -m math_step_to_step "2x + 3 = 7" --en
+```
+
+MIT License.

masts-0.1.0/pyproject.toml

@@ -0,0 +1,42 @@
+[build-system]
+requires = ["setuptools>=77", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "masts"
+version = "0.1.0"
+description = "Step-by-step solutions for math expressions and equations (1 + 2 x 3 -> ['1 + 6', '7']), plus text-to-symbol helpers (6^6 -> 6⁶)."
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "PipoAndDodo" }]
+keywords = ["math", "steps", "solver", "equation", "calculator", "superscript", "education"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Education",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Education",
+    "Topic :: Scientific/Engineering :: Mathematics",
+    "Typing :: Typed",
+]
+dependencies = []
+
+[project.scripts]
+math-step-to-step = "math_step_to_step.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+math_step_to_step = ["py.typed"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]

masts-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

masts-0.1.0/src/masts.egg-info/PKG-INFO

@@ -0,0 +1,111 @@
+Metadata-Version: 2.4
+Name: masts
+Version: 0.1.0
+Summary: Step-by-step solutions for math expressions and equations (1 + 2 x 3 -> ['1 + 6', '7']), plus text-to-symbol helpers (6^6 -> 6⁶).
+Author: PipoAndDodo
+License-Expression: MIT
+Keywords: math,steps,solver,equation,calculator,superscript,education
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Education
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+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 :: Education
+Classifier: Topic :: Scientific/Engineering :: Mathematics
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# math-step-to-step
+
+Giải biểu thức / phương trình **từng bước** và trả về danh sách các bước.
+Không phụ thuộc thư viện ngoài, dùng phân số chính xác (`fractions.Fraction`) nên không bị sai số.
+
+*Step-by-step solver for math expressions and equations. Pure Python, zero dependencies, exact arithmetic.*
+
+```bash
+pip install math-step-to-step
+```
+
+## Dùng nhanh
+
+```python
+from math_step_to_step import steps, solve, evaluate, prettify
+
+steps("1 + 2 x 3")              # ['1 + 6', '7']
+steps("(1 + 2) x 3 + 4 x 5")    # ['3 × 3 + 4 × 5', '9 + 20', '29']
+steps("2 + 3 x (4 - 1)^2")      # ['2 + 3 × 3²', '2 + 3 × 9', '2 + 27', '29']
+steps("1/2 + 1/3")              # ['1/2 + 1/3', '5/6']
+
+# tìm x
+steps("2x + 3 = 7")             # ['2x = 7 - 3', '2x = 4', 'x = 4 ÷ 2', 'x = 2']
+steps("2(x + 3) = 10")          # ['2x + 6 = 10', '2x = 10 - 6', '2x = 4', 'x = 4 ÷ 2', 'x = 2']
+steps("x^2 - 3x + 2 = 0")       # a, b, c -> Δ -> x₁, x₂ (từng bước)
+
+# kết quả có cấu trúc
+sol = solve("x^2 - 3x + 2 = 0")
+sol.kind, sol.values            # ('roots', (2, 1))
+
+evaluate("2 + 3 x 4")           # 14   (nhanh, không tạo chuỗi bước)
+
+# đổi chuỗi thành ký hiệu
+prettify("6^6")                 # '6⁶'
+prettify("x^2 + y^(n+1) <= sqrt(2)*pi")   # 'x² + yⁿ⁺¹ ≤ √2×π'
+```
+
+## Cú pháp nhập
+
+| Viết | Ý nghĩa |
+|---|---|
+| `+ - * x × · / ÷ :` | cộng, trừ, nhân, chia |
+| `x` giữa hai toán hạng, vd `2 x 3` | **phép nhân**; còn `2x`, `x + 1`, `x²` thì `x` là **biến** |
+| `^`, `**`, `²` `³` | lũy thừa (số mũ nguyên) |
+| `sqrt(…)`, `√9` | căn bậc hai |
+| `( )`, `[ ]`, `{ }` | ngoặc |
+| `2x`, `3(x+1)`, `(a)(b)` | nhân ngầm |
+| `1,5` hoặc `1.5` | số thập phân |
+| `=` | phương trình (1 biến, bậc 1 hoặc 2) |
+
+## Tùy chọn của `steps()` / `solve()`
+
+| Tham số | Mặc định | Ý nghĩa |
+|---|---|---|
+| `include_original` | `False` | thêm biểu thức gốc làm bước đầu |
+| `detailed` | `False` | mỗi bước chỉ làm 1 phép (`1+2+3` → `3 + 3` → `6`) thay vì gộp |
+| `pretty` | `True` | dùng `× ÷ ² √`; `False` ra ASCII (`* / ^ sqrt()`), có thể đưa lại vào thư viện |
+| `style` | `"auto"` | `"fraction"`, `"decimal"` hoặc `"auto"` (thập phân nếu đầu vào có số thập phân) |
+| `lang` | `"vi"` | ngôn ngữ thông báo: `"vi"` / `"en"` |
+
+Cách chọn bước: ngoặc trước → lũy thừa/căn → nhân chia → cộng trừ; các phép độc lập được làm **cùng một bước**
+và chuỗi cộng/nhân liên tiếp được gộp để lời giải ngắn nhất. Với phương trình: rút gọn → chuyển vế → chia hệ số;
+bậc 2 dùng Δ.
+
+## Ký hiệu
+
+```python
+from math_step_to_step import superscript, subscript, prettify
+superscript("123")        # '¹²³'
+subscript("12")           # '₁₂'
+prettify("H_2O, 6^6, x^(n+1), 1/2, a<=b, a!=b, +-3, alpha")
+# 'H₂O, 6⁶, xⁿ⁺¹, ½, a≤b, a≠b, ±3, α'
+```
+
+## Giới hạn (cố ý, để ít lỗi)
+Một biến; phương trình bậc ≤ 2; số mũ nguyên; không có số phức; không rút gọn căn phức tạp
+(căn không chính phương được rút gọn dạng `2 × √3` và cho giá trị gần đúng). Đầu vào sai/không hỗ trợ
+luôn ném `MathStepError` (kế thừa `ValueError`) với thông báo rõ ràng.
+
+## Dòng lệnh
+
+```bash
+math-step-to-step "(1 + 2) x 3 + 4 x 5"
+python -m math_step_to_step "2x + 3 = 7" --en
+```
+
+MIT License.

masts-0.1.0/src/masts.egg-info/SOURCES.txt

@@ -0,0 +1,23 @@
+LICENSE
+README.md
+pyproject.toml
+src/masts.egg-info/PKG-INFO
+src/masts.egg-info/SOURCES.txt
+src/masts.egg-info/dependency_links.txt
+src/masts.egg-info/entry_points.txt
+src/masts.egg-info/top_level.txt
+src/math_step_to_step/__init__.py
+src/math_step_to_step/__main__.py
+src/math_step_to_step/cli.py
+src/math_step_to_step/context.py
+src/math_step_to_step/engine.py
+src/math_step_to_step/errors.py
+src/math_step_to_step/fmt.py
+src/math_step_to_step/nodes.py
+src/math_step_to_step/parser.py
+src/math_step_to_step/poly.py
+src/math_step_to_step/py.typed
+src/math_step_to_step/solver.py
+src/math_step_to_step/symbols.py
+tests/test_fuzz.py
+tests/test_steps.py

masts-0.1.0/src/masts.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

masts-0.1.0/src/masts.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+math-step-to-step = math_step_to_step.cli:main

masts-0.1.0/src/masts.egg-info/top_level.txt

@@ -0,0 +1 @@
+math_step_to_step

masts-0.1.0/src/math_step_to_step/__init__.py

@@ -0,0 +1,10 @@
+"""math-step-to-step: step-by-step solutions for math expressions and equations."""
+from .errors import MathStepError
+from .solver import Solution, evaluate, solve, steps
+from .symbols import prettify, subscript, superscript
+
+__version__ = "0.1.0"
+__all__ = [
+    "steps", "solve", "evaluate", "Solution", "MathStepError",
+    "superscript", "subscript", "prettify", "__version__",
+]

masts-0.1.0/src/math_step_to_step/__main__.py

@@ -0,0 +1,3 @@
+from .cli import main
+
+raise SystemExit(main())

masts-0.1.0/src/math_step_to_step/cli.py

@@ -0,0 +1,41 @@
+"""Command line: math-step-to-step "1 + 2 x 3"."""
+from __future__ import annotations
+
+import argparse
+import sys
+
+from . import __version__
+from .errors import MathStepError
+from .solver import solve
+
+
+def main(argv=None):
+    ap = argparse.ArgumentParser(prog="math-step-to-step", description=__doc__)
+    ap.add_argument("expression", nargs="*", help="expression; omit to read lines from stdin")
+    ap.add_argument("-d", "--detailed", action="store_true", help="one operation per step")
+    ap.add_argument("--ascii", action="store_true", help="plain ASCII output")
+    ap.add_argument("--en", action="store_true", help="English messages")
+    ap.add_argument("--style", choices=["auto", "fraction", "decimal"], default="auto")
+    ap.add_argument("-V", "--version", action="version", version=__version__)
+    a = ap.parse_args(argv)
+
+    lines = [" ".join(a.expression)] if a.expression else (l.strip() for l in sys.stdin)
+    code = 0
+    for line in lines:
+        if not line:
+            continue
+        try:
+            sol = solve(line, include_original=True, detailed=a.detailed,
+                        pretty=not a.ascii, style=a.style, lang="en" if a.en else "vi")
+        except MathStepError as e:
+            print(f"Error: {e}", file=sys.stderr)
+            code = 1
+            continue
+        print(sol.steps[0])
+        for s in sol.steps[1:]:
+            print("  →", s)
+    return code
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

masts-0.1.0/src/math_step_to_step/context.py

@@ -0,0 +1,23 @@
+"""Options shared by the parser, engine and formatter."""
+from __future__ import annotations
+
+from .errors import LANGS
+
+MAX_LEN = 10_000   # max characters of input
+MAX_BITS = 14_000  # max size of any intermediate number (~4200 digits)
+MAX_DEG = 60       # max polynomial degree
+
+
+class Ctx:
+    __slots__ = ("pretty", "detailed", "lang", "style", "decimal")
+
+    def __init__(self, pretty=True, detailed=False, lang="vi", style="auto"):
+        if lang not in LANGS:
+            raise ValueError(f"lang must be one of {LANGS}")
+        if style not in ("auto", "fraction", "decimal"):
+            raise ValueError("style must be 'auto', 'fraction' or 'decimal'")
+        self.pretty = bool(pretty)
+        self.detailed = bool(detailed)
+        self.lang = lang
+        self.style = style
+        self.decimal = style == "decimal"