MyFAP API CLI

Giới thiệu

Đây là cli tương tác giống hoàn toàn với APP MYFAP trên điện thoại. Bạn có thể xem lịch học, lịch thi, điểm số (sự thất vọng của gia đình), thông tin cá nhân, v.v. 1 cách thuận tiện, không bị gò bó trong giao diện app.

• Lưu ý: repo này được thực hiện cùng với sự hỗ trợ của AI.

Tính năng chính

• Hỗ trợ đa nền tảng.
• Login thông qua FEID hoặc Google OAuth.
• Xem lịch học (từng tuần hoặc cả Kỳ).
• Xem điểm (từng môn hoặc cả Kỳ).
• Check điểm danh (từng môn hoặc cả Kỳ).
• Check tình trạng đơn từ.
• Xem thông báo của trường.
• Check Info của sinh viên hoặc phòng dvsv.
• Convert lịch học Kỳ sang ICS, dễ dàng import lịch học vào Google Calendar hoặc các dịch vụ tương tự.
• Và nhiều hơn nữa ...

Cách sử dụng

Bạn có thể cài ứng dụng bằng pip theo hướng dẫn bên dưới. Để phát triển từ mã nguồn, xem mục dùng uv.

• Cài đặt ứng dụng.

  pip install myfap
  

• Lấy danh sách cơ sở.

  myfap campuses
  

• Login vào feid (chỉ cần làm 1 lần, mặc định chọn cơ sở Hola).

  myfap login
  

  Sau khi hoàn thành login, phiên đăng nhập sẽ dc lưu ở ~/.myfap-api-cli/session.json
  

• Login cho cơ sở Xavalo.

  myfap login -c HCM
  

• Lấy Lịch học (tự động lấy kỳ mới nhất).

  myfap schedule
  

Phát triển với uv

Bạn cần cài uv trước khi bắt đầu. Repo dùng Python 3.11 cho môi trường dev, được chọn trong .python-version; package vẫn hỗ trợ Python từ 3.9. Cả .python-version và uv.lock được commit để các máy dùng cùng cấu hình và phiên bản dependency.

Clone repo và cài môi trường theo lockfile:

git clone https://github.com/WindowScary321/myfap-api-cli.git
cd myfap-api-cli
uv sync --locked

uv sync tạo .venv và cài package ở chế độ editable, nên thay đổi mã nguồn có hiệu lực khi chạy CLI. Bạn dùng uv run để chạy trong môi trường này, không cần activate thủ công hay chạy uv init trong repo đã có cấu hình.

uv run myfap --help
uv run myfap version
uv run python -m unittest discover -s tests -v
uv build

Trình duyệt cho đăng nhập

Đăng nhập mở cửa sổ trình duyệt và ưu tiên Chrome đã cài trên máy, sau đó thử Edge. Nếu có Chrome hoặc Edge chạy được, bạn không cần cài thêm trình duyệt. Để dùng Firefox làm phương án dự phòng, cài trình duyệt của Playwright bằng lệnh sau:

uv run playwright install firefox

Bước cài Firefox là tùy chọn; việc build package không cần trình duyệt.

Cập nhật dependency

Bạn dùng uv add <tên-package> hoặc uv remove <tên-package> để cập nhật dependency trong pyproject.toml và uv.lock. Nếu sửa dependency trực tiếp trong pyproject.toml, chạy uv lock rồi uv sync --locked. Sau khi kiểm tra, commit cả thay đổi cấu hình và lockfile cùng nhau. Không commit thư mục .venv.

Các Options

Các ví dụ sử dụng