tatools01 2.0

Thư viện hữu ích của Tuấn Anh.

Giới thiệu

tattools01 là 1 thư viện dùng để ghi tham số vào ổ cứng

Tinh năng

1. Mục đích chính

Tạo một base class TactParameters để quản lý parameters cho các module khác nhau, lưu trữ vào file YAML chung .

2. Cách hoạt động

Lần chạy đầu tiên (file YAML chưa tồn tại):

• Lấy giá trị default từ code
• Tạo file YAML với các giá trị default

Các lần chạy sau (file YAML đã tồn tại):

• Đọc giá trị từ file YAML
• Giá trị trong file YAML là ưu tiên cao nhất (user có thể sửa trực tiếp)
• Nếu user xóa một key trong file → lấy giá trị default từ code
• Nếu code thêm key mới → bổ sung vào file với giá trị default
• Save lại file để đồng bộ

3. Các kiểu dữ liệu cần hỗ trợ

Kiểu	Ví dụ	Cách access
Scalar	self.test1 = "123"	obj.test1
List	self.myList = [1, 2, 3]	obj.myList[0]
Dict thường	self.myDict = {"key": "value"}	obj.myDict["key"]
Nested class	self.Minio = clsMinio()	obj.Minio.IP

4. Quy tắc merge (QUAN TRỌNG)

┌─────────────────────────────────────────────────────────────┐
│  Code default    +    File YAML    =    Kết quả cuối       │
├─────────────────────────────────────────────────────────────┤
│  có giá trị           có giá trị       → Dùng FILE         │
│  có giá trị           không có key     → Dùng DEFAULT      │
│  không có             có giá trị       → Dùng FILE         │
└─────────────────────────────────────────────────────────────┘

Deep merge cho nested object:

# Code default:
Minio:
  IP: "192.168.3.42:9000"
  access_key: "admin"
  secret_key: "Proton@2025"

# File YAML (user chỉ sửa IP, xóa secret_key):
Minio:
  IP: "10.0.0.1:9000"
  access_key: "admin"

# Kết quả:
Minio:
  IP: "10.0.0.1:9000"      ← từ file (user sửa)
  access_key: "admin"       ← từ file (giữ nguyên)
  secret_key: "Proton@2025" ← từ default (user xóa → khôi phục)

5. Giữ nguyên TYPE sau khi load

# Trước khi load:
self.myDict = {"key": "value"}      # dict
self.Minio = clsMinio()              # nested class

# Sau khi load từ file:
self.myDict["key"]                   # vẫn access bằng []
self.Minio.IP                        # vẫn access bằng .

6. Nhiều module dùng chung 1 file

# My_Project_Name.yml
Module 01:
    test1: "123"
    myDict: {key1: value1}

Module 02:
    test1: "456"
    test2: "New param"

chatbotAPI:
    Minio:
        IP: "192.168.3.42:9000"

.