Tài liệu này giải thích cách sử dụng CLI của dự án Book Reading Tracker, giúp bạn quản lý sách, tác giả và danh mục sách.
Để sử dụng ứng dụng CLI này, bạn cần cài đặt các gem với phiên bản chính xác mà dự án yêu cầu. Làm theo các bước dưới đây để cài đặt:
Tạo tệp Gemfile
trong thư mục gốc của dự án và thêm vào các dòng sau:
# frozen_string_literal: true
source 'https://rubygems.org'
gemspec
gem 'activerecord', '7.1.0'
gem 'activesupport', '7.1.0'
gem 'awesome_print', '1.8'
gem 'benchmark', '0.4.0'
gem 'dotenv', '2.8'
gem 'fileutils', '0.7.2'
gem 'irb', '1.15'
gem 'logger', '1.6'
gem 'ostruct', '0.1.0'
gem 'pastel', '0.8'
gem 'pg', '1.5'
gem 'pry', '0.14.1'
gem 'rake', '13.0'
gem 'rspec', '3.12'
gem 'thor', '1.3'
gem 'tty-prompt', '0.23'
gem 'tty-table', '0.12.0'
book_reading_tracker_gem add_book "Tên Sách" --author AUTHOR_ID1 AUTHOR_ID2 ... --pages 300 [--description "..."] [--isbn "..."] [--published_year 2023]
Mô tả:
- Thêm một cuốn sách mới vào danh sách.
- Bắt buộc:
--author
,--pages
- Tùy chọn:
--description
,--isbn
,--published_year
Ví dụ: 📗 Thêm sách với 1 tác giả:
book_reading_tracker_gem add_book "Lập trình Ruby" --author 1 --pages 300 --description "Học Ruby" --isbn "978-1234567890" --published_year 2023
📘 Thêm sách với nhiều tác giả:
book_reading_tracker_gem add_book "Clean Ruby Code" --author 1 2 3 --pages 280 --description "Viết Ruby sạch và hiệu quả" --isbn "978-9876543210" --published_year 2024
book_reading_tracker_gem remove_book ID
Mô tả:
- Xóa sách bằng ID duy nhất.
Ví dụ:
book_reading_tracker_gem remove_book 1
book_reading_tracker_gem progress_book ID --page PAGE
Mô tả:
- Cập nhật tiến độ đọc bằng cách chỉ định trang cuối đã đọc.
Ví dụ:
book_reading_tracker_gem progress_book 2 --page 150
book_reading_tracker_gem list_books
Mô tả:
- Hiển thị danh sách tất cả các sách.
book_reading_tracker_gem show_progress ID
Mô tả:
- Hiển thị tiến độ đọc của một cuốn sách cụ thể.
Ví dụ:
book_reading_tracker_gem show_progress 2
book_reading_tracker_gem add_author "Tên Tác Giả" [--biography "Tiểu sử"]
Mô tả:
- Thêm một tác giả mới vào hệ thống.
- Tùy chọn:
--biography
Ví dụ:
book_reading_tracker_gem add_author "J.K. Rowling" --biography "Tác giả của Harry Potter"
book_reading_tracker_gem list_authors
Mô tả:
- Hiển thị danh sách tất cả các tác giả.
book_reading_tracker_gem add_category "Tên Danh Mục"
Mô tả:
- Thêm một danh mục mới vào hệ thống.
Ví dụ:
book_reading_tracker_gem add_category "Tiểu thuyết"
book_reading_tracker_gem list_categories
Mô tả:
- Hiển thị danh sách tất cả các danh mục.
book_reading_tracker_gem stats
Mô tả:
- Hiển thị thống kê tổng quan như tổng số sách, số trang đã đọc và tỷ lệ hoàn thành.