Skip to content

ftkit init

Dựng mới một service Fountain từ bộ layout dự án có sẵn.

Cách dùng

bash
ftkit init <service-name> <module-path>

Ví dụ (lấy từ phần help của chính lệnh):

bash
ftkit init my-service gitlab.soludian.com/soludian/my-service

Lệnh cũng có alias là i.

Lệnh làm gì

init tạo một thư mục mới đặt tên theo <service-name> và đổ vào đó bộ layout chuẩn của Fountain. Cụ thể, lệnh:

  1. Yêu cầu phải có biến GOPATH — nếu trống, lệnh sẽ dừng với lỗi.
  2. Không ghi đè lên thư mục đã tồn tại: nếu đã có thư mục trùng <service-name>, lệnh sẽ dừng với lỗi.
  3. Tính các biến thể tên từ tên service (CamelCase chuẩn hóa, snake_case) và suy ra metadata bản quyền / Java package từ module path.
  4. Sao chép bộ layout nền (cây template data/layout) cùng một package client vào thư mục mới, rồi render mọi template với dữ liệu đã tính.
  5. Chạy go mod tidy cho module mới trong lúc render, và cuối cùng cố mở dự án bằng VS Code (code <service-name>).

Sau khi hoàn tất, bạn có một service Fountain sẵn sàng build tại ./<service-name>.

Tham số

init nhận đúng hai tham số vị trí:

Vị tríTham sốMô tả
1<service-name>Tên service; cũng được dùng làm tên thư mục cho dự án mới.
2<module-path>Module path Go của service, ví dụ gitlab.soludian.com/soludian/my-service.

Module path còn được dùng để suy ra tên Java package (các đoạn host được đảo ngược) cho những artifact được sinh ra cần đến nó.

WARNING

init sẽ dừng với lỗi nếu chưa đặt GOPATH hoặc thư mục đích đã tồn tại. Lệnh này không có cờ (flag) nào.