msts 1.0.0__tar.gz

msts-1.0.0/CHANGELOG.md

@@ -0,0 +1,40 @@
+# Lịch sử phiên bản
+
+## 1.0.0 — 2026-11-12
+
+Bản phát hành đầu tiên.
+
+### Tính toán chính xác
+
+- Số học bằng **phân số** chính xác tuyệt đối: `0.1 + 0.2` → `3/10` (không bao giờ có sai số số thực)
+- **Căn thức** giữ dạng chính xác và tự rút gọn: `√8` → `2√2`, `//2 * //8` → `4`
+- Tự **phân tích trong căn / lũy thừa phân số**: `8^(2/3)` → `4`, `2^0.5` → `√2`
+- **π** (công thức Machin) và **e** (chuỗi hội tụ) tính bằng số nguyên lớn với độ chính xác tuỳ ý
+- **Phân số thập phân** nhận diện số tuần hoàn: `1/3` → `0.(3)`, kiểu SGK: `0,(3)`
+- Làm tròn nửa xa 0, làm tròn số thập phân lớn (`round(2.675, 2)` = `67/25`)
+
+### Trình bày từng bước giải
+
+- `steps()` xuất từng bước biến đổi như bài làm SGK, chọn mức `chi_tiet="short"` / `"full"`
+- Song ngữ Việt / Anh: `ngon_ngu="vi"` / `"en"`
+- Giải **phương trình bậc 1, bậc 2** (trình bày Δ, nghiệm kép, vô nghiệm, vô số nghiệm)
+- Giải **bất phương trình** bậc 1, bậc 2 (tập nghiệm theo dấu Δ)
+- So sánh hai vế (Đúng / Sai) và rút gọn biểu thức chứa ẩn
+
+### Kí hiệu SGK
+
+- `pretty()` / `xem_truc_tuyen()`: `2^10 + 8//3 + pi/2 <= 5` → `2¹⁰ + ∛8 + π/2 ≤ 5`
+- Đọc được kí hiệu **Unicode khi nhập**: `√`, `∛`, `∜`, `π`, `≤`, `≥`, `×`, `÷`, `²`, `³`, `½`, `−`...
+- `chuan_hoa()` xuất lại biểu thức ở dạng ASCII tường minh: `√16 + π` → `can(16, 2) + pi`
+
+### Hàm bổ trợ
+
+- Lượng giác `sin`, `cos`, `tan`, `cot`, `asin`, `acos`, `atan` — bảng giá trị chính xác, theo độ hoặc radian
+- `ln`, `log`, `log2`, `log10`, `exp`, `sqrt`, `can(a[,b])`, `abs`, `floor`, `ceil`, `round`, `gcd`, `lcm`, `min`, `max`, `mod`, giai thừa `n!`, phần trăm `n%`
+
+### GUI (tuỳ chọn — `pip install msts[gui]`)
+
+- `msts.MathLabel` — nhãn hiển thị toán học, tự chọn font đẹp nhất trên máy
+- `msts.StepsBox` — khung hiển thị các bước giải
+- `msts.chon_font_toan`, `msts.gan_xem_truc_tiep` — tiện ích font và xem trước trực tiếp
+- App demo máy tính hoàn chỉnh trong `examples/demo_may_tinh.py`

msts-1.0.0/HUONG_DAN_PYPI.md

@@ -0,0 +1,90 @@
+# Hướng dẫn phát hành (upload) msts lên PyPI
+
+Sau khi làm theo các bước dưới đây, người dùng chỉ cần:
+
+```bash
+pip install msts
+python -c "import msts; print(msts.solve('x^2 - 5x + 6 = 0'))"
+```
+
+> Tên `msts` trên PyPI **còn trống** lúc kiểm tra ngày 2026-11-12.
+> PyPI cấp tên theo thứ tự ai đăng trước thì được — nên hoàn thiện và đăng sớm.
+
+## 0. Chuẩn bị (chỉ làm một lần)
+
+1. Đăng kí tài khoản tại <https://pypi.org/account/register/> và bật xác thực 2 bước.
+2. Tạo API token tại <https://pypi.org/manage/account/token/> (scope: *Entire account*),
+   sao chép chuỗi token (dạng `pypi-...`).
+3. **Sửa thông tin tác giả** trong `pyproject.toml` cho đúng bạn (bắt buộc trước khi đăng):
+
+   ```toml
+   authors = [
+       { name = "Tên của bạn", email = "ban@email.com" },
+   ]
+   ```
+
+   (Có thể thêm mục `[project.urls]` với `Homepage` / `Repository` trỏ về repo GitHub/GitLab của bạn.)
+
+## 1. Build gói
+
+```bash
+cd msts                        # thư mục chứa pyproject.toml
+python -m pip install --upgrade build
+python -m build
+```
+
+Kết quả: `dist/msts-1.0.0.tar.gz` (sdist) và `dist/msts-1.0.0-py3-none-any.whl` (wheel).
+
+## 2. Kiểm tra gói trước khi đăng
+
+```bash
+python -m pip install --upgrade twine
+twine check dist/*
+```
+
+Phải nhận được `PASSED` cho cả hai file. Nên tự thử nghiệm thêm:
+
+```bash
+python -m venv /tmp/thu_nghiem
+/tmp/thu_nghiem/bin/pip install dist/msts-1.0.0-py3-none-any.whl
+/tmp/thu_nghiem/bin/python -m msts            # demo console
+/tmp/thu_nghiem/bin/python tests/test_msts.py # bộ test logic
+```
+
+## 3. Tập dượt trên TestPyPI (khuyến nghị lần đầu)
+
+```bash
+twine upload --repository testpypi dist/*
+```
+
+(Tài khoản TestPyPI riêng tại <https://test.pypi.org/>; nếu dùng token thì tạo token trên TestPyPI.)
+
+Kiểm tra trang dự án tại `https://test.pypi.org/project/msts/` rồi thử cài:
+
+```bash
+pip install --index-url https://test.pypi.org/simple/ msts
+```
+
+## 4. Đăng lên PyPI chính thức
+
+```bash
+twine upload dist/*
+```
+
+- Twine sẽ hỏi username: nhập `__token__`, password: dán chuỗi token `pypi-...`
+  (hoặc lưu sẵn trong file `~/.pypirc` để không phải gõ lại mỗi lần).
+
+Sau khi đăng thành công, trang dự án nằm tại: `https://pypi.org/project/msts/`
+
+## 5. Phát hành bản mới sau này
+
+1. Tăng `version` trong `pyproject.toml` (ví dụ `1.0.1`, `1.1.0`...) — PyPI **không cho phép đè** lên version đã đăng.
+2. Ghi bổ sung vào `CHANGELOG.md`.
+3. Xoá thư mục `dist/` cũ, chạy lại `python -m build`, rồi `twine upload dist/*`.
+
+## Ghi chú thêm
+
+- **Phần lõi không có bất kì dependency nào** — chỉ cần Python chuẩn; người dùng cài
+  `pip install msts[gui]` nếu muốn dùng widget customtkinter.
+- File `dist/` và `*.egg-info/` đã có trong `.gitignore` — đừng commit lên git.
+- Nếu twine báo lỗi `File already exists` nghĩa là version đó đã đăng rồi — tăng version rồi build lại.

msts-1.0.0/LICENSE

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

msts-1.0.0/MANIFEST.in

@@ -0,0 +1,6 @@
+include LICENSE
+include README.md
+include CHANGELOG.md
+include HUONG_DAN_PYPI.md
+recursive-include tests *.py
+recursive-include examples *.py

msts-1.0.0/PKG-INFO

@@ -0,0 +1,171 @@
+Metadata-Version: 2.4
+Name: msts
+Version: 1.0.0
+Summary: Máy Tính Toán Học Thông Minh — tính chính xác bằng phân số, trình bày từng bước giải, kí hiệu SGK (√, ∛, π, ≤), giải phương trình / bất đẳng thức, widget customtkinter
+Author: VVT
+License-Expression: MIT
+Keywords: math,calculator,exact-arithmetic,fraction,sqrt,radical,step-by-step,equation,inequality,quadratic,sgk,vietnam,education,textbook
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Education
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: OS Independent
+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
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: gui
+Requires-Dist: customtkinter>=5.2; extra == "gui"
+Dynamic: license-file
+
+# msts — Máy Tính Toán Học Thông Minh
+
+Thư viện Python **thuần chuẩn** (không cần cài thêm bất kì thư viện nào) dành cho bài tập toán kiểu sách giáo khoa Việt Nam:
+
+- **Tính chính xác tuyệt đối** bằng phân số — không bao giờ gặp `0.1 + 0.2 = 0.30000000000000004`
+- **Trình bày từng bước giải** như bài làm trên bảng, song ngữ Việt / Anh
+- **Biến kí hiệu nhập sang dạng SGK**: `2^10` → `2¹⁰`, `8//3` → `∛8`, `pi/2` → `π/2`, `<=` → `≤`
+- **Giải phương trình / bất phương trình** bậc 1, bậc 2 (có trình bày Δ, tập nghiệm...)
+- Căn thức, π, e giữ **dạng chính xác** và tự rút gọn: `√8` → `2√2`, `1/(√2+1)` → `√2 − 1`
+- Số thập phân vô tỉ tuần hoàn nhận diện được: `1/3` → `0.(3)` (kiểu SGK: `0,(3)`)
+- Widget **customtkinter** để làm app máy tính thông minh (tuỳ chọn)
+
+## Cài đặt
+
+```bash
+pip install msts            # phần lõi — chỉ cần Python chuẩn
+pip install "msts[gui]"     # kèm widget customtkinter cho phần GUI
+```
+
+Yêu cầu Python 3.9 trở lên. Chạy thử nhanh sau khi cài: gõ lệnh `msts` (demo console).
+
+## Bắt đầu nhanh
+
+```python
+>>> import msts
+
+>>> msts.solve("0.1 + 0.2").text          # chính xác tuyệt đối, không sai số
+'3/10'
+>>> msts.solve("(1/2 + 1/3) : (1/6)").text
+'5'
+>>> msts.solve("//2 * //8").text           # √2 · √8 = √16
+'4'
+>>> msts.solve("2pi + pi").text            # π giữ dạng kí hiệu
+'3π'
+>>> msts.solve("1/3").thap_phan()          # dạng thập phân (12 chữ số mặc định)
+'0.333333333333…'
+>>> msts.solve("2x + 3 = 7").text          # phương trình bậc 1
+'x = 2'
+>>> msts.solve("x^2 - 5x + 6 = 0").text    # phương trình bậc 2
+'x = 2 hoặc x = 3'
+>>> msts.solve("2x - 1 >= 3").text         # bất phương trình
+'x ≥ 2'
+```
+
+Trình bày từng bước giải:
+
+```python
+>>> print(msts.steps("2 + 3*(4-1)").text)
+2 + 3·(4 − 1)
+Bước 1: Tính hiệu: 4 − 1 = 3
+= 2 + 3·3
+Bước 2: Tính tích: 3 · 3 = 9
+= 2 + 9
+Bước 3: Tính tổng: 2 + 9 = 11
+= 11
+Vậy 2 + 3·(4 − 1) = 11
+```
+
+Biến kí hiệu nhập sang dạng SGK:
+
+```python
+>>> msts.pretty("2^10 + 8//3 + pi/2 <= 5")
+'2¹⁰ + ∛8 + π/2 ≤ 5'
+```
+
+Xem thêm file `examples/vi_du_su_dung.py` trong kho mã nguồn để có ví dụ cho toàn bộ API.
+
+## Bảng kí hiệu khi nhập
+
+| Khi nhập | Nghĩa | Ví dụ |
+| --- | --- | --- |
+| `a//b` | căn bậc b của a | `8//3` = ∛8 = 2 |
+| `//a` | căn bậc hai | `//16` = 4 |
+| `a^b`, `a^b^c` | lũy thừa (kết hợp phải) | `2^3^2` = 512 |
+| `pi`, `e` | số π, số e | `2pi + pi` = 3π |
+| `(a/b)` | phân số | `(1/2) + (1/3)` = 5/6 |
+| `/` hoặc `:` | chia | `5 : 2` = 5/2 |
+| `<` `<=` `>` `>=` `!=` | so sánh | `2^3 >= 7` → Đúng |
+| `=` | lập phương trình / BPT | `2x + 3 = 7` |
+| `5!` | giai thừa | `5!` = 120 |
+| `50%` | phần trăm | `50%` = 1/2 |
+| `sin(30)`... | lượng giác (mặc định theo độ) | `sin(30)` = 1/2 |
+| `ln`, `log`, `log2`, `log10`, `exp`, `sqrt`, `can(a[,b])`, `abs`, `floor`, `ceil`, `round`, `gcd`, `lcm`, `min`, `max`, `mod` | hàm bổ trợ | `log2(8)` = 3 |
+
+Module cũng **đọc được** kí hiệu Unicode khi nhập: `√16`, `∛8`, `π`, `≤`, `×`, `÷`, `²`, `½`, `−5`...
+
+## Cấu hình
+
+```python
+msts.cau_hinh(kieu_sgk=True)     # xuất số kiểu SGK: 0,5 và 0,(3)
+msts.cau_hinh(so_chu_so=15)      # số chữ số thập phân (mặc định 12)
+msts.cau_hinh(don_vi="rad")      # lượng giác theo radian
+msts.cau_hinh(ngon_ngu="en")     # chú thích bước giải tiếng Anh
+msts.cau_hinh(chi_tiet="short")  # rút gọn lời giải
+```
+
+## Làm app máy tính với customtkinter
+
+```python
+import msts
+import customtkinter as ctk
+
+app = ctk.CTk()
+
+nhan = msts.MathLabel(app, co_chu=26)
+nhan.pack()
+nhan.dat_toan("2^10 + 8//3")              # hiển thị '2¹⁰ + ∛8'
+
+khung = msts.StepsBox(app, co_chu=17)
+khung.pack()
+khung.hien(msts.steps("x^2 - 5x + 6 = 0"))  # hiển thị từng bước giải
+
+app.mainloop()
+```
+
+Các widget có sẵn: `MathLabel`, `StepsBox`, `chon_font_toan`, `gan_xem_truc_tiep` (đổi kí hiệu sang dạng SGK ngay khi gõ). Xem app hoàn chỉnh trong `examples/demo_may_tinh.py`.
+
+## English summary
+
+`msts` (Máy Tính Toán Học Thông Minh — Smart Math Calculator) is a pure-standard-library Python package for school-style mathematics:
+
+- **Exact arithmetic** with fractions — radicals, π and e stay exact (`0.1 + 0.2` → `3/10`, `√8` → `2√2`, `1/(√2+1)` → `√2 − 1`)
+- **Step-by-step solutions** (bilingual Vietnamese / English) for expressions, linear and quadratic equations, and inequalities
+- **Pretty-printing** input into textbook notation: `2^10 + 8//3 + pi/2 <= 5` → `2¹⁰ + ∛8 + π/2 ≤ 5`
+- Extra math functions: trigonometry (degrees/radians), `ln`/`log`/`log2`/`log10`, `exp`, `sqrt`, `gcd`, `lcm`, factorial, percent...
+- Optional **customtkinter** widgets (`MathLabel`, `StepsBox`) for building calculator apps
+
+```python
+>>> import msts
+>>> msts.solve("x^2 - 5x + 6 = 0").text
+'x = 2 hoặc x = 3'
+>>> msts.steps("2 + 3*(4-1)", ngon_ngu="en").danh_sach[0]
+'Bước 1: Tính hiệu: 4 − 1 = 3'
+```
+
+## Chạy test
+
+```bash
+python tests/test_msts.py    # 191 test logic (không cần GUI)
+xvfb-run -a python tests/test_gui.py   # 17 smoke test GUI (cần customtkinter + Xvfb trên Linux)
+```
+
+## Giấy phép
+
+MIT — xem file [LICENSE](LICENSE).

msts-1.0.0/README.md

@@ -0,0 +1,145 @@
+# msts — Máy Tính Toán Học Thông Minh
+
+Thư viện Python **thuần chuẩn** (không cần cài thêm bất kì thư viện nào) dành cho bài tập toán kiểu sách giáo khoa Việt Nam:
+
+- **Tính chính xác tuyệt đối** bằng phân số — không bao giờ gặp `0.1 + 0.2 = 0.30000000000000004`
+- **Trình bày từng bước giải** như bài làm trên bảng, song ngữ Việt / Anh
+- **Biến kí hiệu nhập sang dạng SGK**: `2^10` → `2¹⁰`, `8//3` → `∛8`, `pi/2` → `π/2`, `<=` → `≤`
+- **Giải phương trình / bất phương trình** bậc 1, bậc 2 (có trình bày Δ, tập nghiệm...)
+- Căn thức, π, e giữ **dạng chính xác** và tự rút gọn: `√8` → `2√2`, `1/(√2+1)` → `√2 − 1`
+- Số thập phân vô tỉ tuần hoàn nhận diện được: `1/3` → `0.(3)` (kiểu SGK: `0,(3)`)
+- Widget **customtkinter** để làm app máy tính thông minh (tuỳ chọn)
+
+## Cài đặt
+
+```bash
+pip install msts            # phần lõi — chỉ cần Python chuẩn
+pip install "msts[gui]"     # kèm widget customtkinter cho phần GUI
+```
+
+Yêu cầu Python 3.9 trở lên. Chạy thử nhanh sau khi cài: gõ lệnh `msts` (demo console).
+
+## Bắt đầu nhanh
+
+```python
+>>> import msts
+
+>>> msts.solve("0.1 + 0.2").text          # chính xác tuyệt đối, không sai số
+'3/10'
+>>> msts.solve("(1/2 + 1/3) : (1/6)").text
+'5'
+>>> msts.solve("//2 * //8").text           # √2 · √8 = √16
+'4'
+>>> msts.solve("2pi + pi").text            # π giữ dạng kí hiệu
+'3π'
+>>> msts.solve("1/3").thap_phan()          # dạng thập phân (12 chữ số mặc định)
+'0.333333333333…'
+>>> msts.solve("2x + 3 = 7").text          # phương trình bậc 1
+'x = 2'
+>>> msts.solve("x^2 - 5x + 6 = 0").text    # phương trình bậc 2
+'x = 2 hoặc x = 3'
+>>> msts.solve("2x - 1 >= 3").text         # bất phương trình
+'x ≥ 2'
+```
+
+Trình bày từng bước giải:
+
+```python
+>>> print(msts.steps("2 + 3*(4-1)").text)
+2 + 3·(4 − 1)
+Bước 1: Tính hiệu: 4 − 1 = 3
+= 2 + 3·3
+Bước 2: Tính tích: 3 · 3 = 9
+= 2 + 9
+Bước 3: Tính tổng: 2 + 9 = 11
+= 11
+Vậy 2 + 3·(4 − 1) = 11
+```
+
+Biến kí hiệu nhập sang dạng SGK:
+
+```python
+>>> msts.pretty("2^10 + 8//3 + pi/2 <= 5")
+'2¹⁰ + ∛8 + π/2 ≤ 5'
+```
+
+Xem thêm file `examples/vi_du_su_dung.py` trong kho mã nguồn để có ví dụ cho toàn bộ API.
+
+## Bảng kí hiệu khi nhập
+
+| Khi nhập | Nghĩa | Ví dụ |
+| --- | --- | --- |
+| `a//b` | căn bậc b của a | `8//3` = ∛8 = 2 |
+| `//a` | căn bậc hai | `//16` = 4 |
+| `a^b`, `a^b^c` | lũy thừa (kết hợp phải) | `2^3^2` = 512 |
+| `pi`, `e` | số π, số e | `2pi + pi` = 3π |
+| `(a/b)` | phân số | `(1/2) + (1/3)` = 5/6 |
+| `/` hoặc `:` | chia | `5 : 2` = 5/2 |
+| `<` `<=` `>` `>=` `!=` | so sánh | `2^3 >= 7` → Đúng |
+| `=` | lập phương trình / BPT | `2x + 3 = 7` |
+| `5!` | giai thừa | `5!` = 120 |
+| `50%` | phần trăm | `50%` = 1/2 |
+| `sin(30)`... | lượng giác (mặc định theo độ) | `sin(30)` = 1/2 |
+| `ln`, `log`, `log2`, `log10`, `exp`, `sqrt`, `can(a[,b])`, `abs`, `floor`, `ceil`, `round`, `gcd`, `lcm`, `min`, `max`, `mod` | hàm bổ trợ | `log2(8)` = 3 |
+
+Module cũng **đọc được** kí hiệu Unicode khi nhập: `√16`, `∛8`, `π`, `≤`, `×`, `÷`, `²`, `½`, `−5`...
+
+## Cấu hình
+
+```python
+msts.cau_hinh(kieu_sgk=True)     # xuất số kiểu SGK: 0,5 và 0,(3)
+msts.cau_hinh(so_chu_so=15)      # số chữ số thập phân (mặc định 12)
+msts.cau_hinh(don_vi="rad")      # lượng giác theo radian
+msts.cau_hinh(ngon_ngu="en")     # chú thích bước giải tiếng Anh
+msts.cau_hinh(chi_tiet="short")  # rút gọn lời giải
+```
+
+## Làm app máy tính với customtkinter
+
+```python
+import msts
+import customtkinter as ctk
+
+app = ctk.CTk()
+
+nhan = msts.MathLabel(app, co_chu=26)
+nhan.pack()
+nhan.dat_toan("2^10 + 8//3")              # hiển thị '2¹⁰ + ∛8'
+
+khung = msts.StepsBox(app, co_chu=17)
+khung.pack()
+khung.hien(msts.steps("x^2 - 5x + 6 = 0"))  # hiển thị từng bước giải
+
+app.mainloop()
+```
+
+Các widget có sẵn: `MathLabel`, `StepsBox`, `chon_font_toan`, `gan_xem_truc_tiep` (đổi kí hiệu sang dạng SGK ngay khi gõ). Xem app hoàn chỉnh trong `examples/demo_may_tinh.py`.
+
+## English summary
+
+`msts` (Máy Tính Toán Học Thông Minh — Smart Math Calculator) is a pure-standard-library Python package for school-style mathematics:
+
+- **Exact arithmetic** with fractions — radicals, π and e stay exact (`0.1 + 0.2` → `3/10`, `√8` → `2√2`, `1/(√2+1)` → `√2 − 1`)
+- **Step-by-step solutions** (bilingual Vietnamese / English) for expressions, linear and quadratic equations, and inequalities
+- **Pretty-printing** input into textbook notation: `2^10 + 8//3 + pi/2 <= 5` → `2¹⁰ + ∛8 + π/2 ≤ 5`
+- Extra math functions: trigonometry (degrees/radians), `ln`/`log`/`log2`/`log10`, `exp`, `sqrt`, `gcd`, `lcm`, factorial, percent...
+- Optional **customtkinter** widgets (`MathLabel`, `StepsBox`) for building calculator apps
+
+```python
+>>> import msts
+>>> msts.solve("x^2 - 5x + 6 = 0").text
+'x = 2 hoặc x = 3'
+>>> msts.steps("2 + 3*(4-1)", ngon_ngu="en").danh_sach[0]
+'Bước 1: Tính hiệu: 4 − 1 = 3'
+```
+
+## Chạy test
+
+```bash
+python tests/test_msts.py    # 191 test logic (không cần GUI)
+xvfb-run -a python tests/test_gui.py   # 17 smoke test GUI (cần customtkinter + Xvfb trên Linux)
+```
+
+## Giấy phép
+
+MIT — xem file [LICENSE](LICENSE).