Nếu bạn thường xuyên làm việc trong terminal nhưng thấy cú pháp của curl rắc rối và đầu ra thô của nó khó đọc, thì curlie rất đáng để bạn biết đến. Đây là một công cụ client HTTP dòng lệnh nhỏ gọn bao bọc curl và học hỏi cú pháp thân thiện cùng với đầu ra có màu của HTTPie, giúp bạn nhận được các phản hồi dễ đọc mà không phải từ bỏ sức mạnh của curl. Hướng dẫn này giải thích curlie là gì, cách cài đặt và sử dụng nó, mối quan hệ của nó với curl và HTTPie, và khi nào nên chuyển từ các lệnh terminal tức thời sang một quy trình làm việc được lưu trữ và có thể lặp lại.
curlie thực sự là gì
curlie là một giao diện người dùng cho curl. Nó không tái hiện lại HTTP. Nó phân tích một lệnh đơn giản hơn, theo phong cách HTTPie, xây dựng lời gọi curl tương đương, và chuyển yêu cầu thực tế cho tệp nhị phân curl trên máy của bạn. Kết quả trả về có tô màu cú pháp và JSON được định dạng đẹp mắt.
Lựa chọn thiết kế đó rất quan trọng. Bởi vì curl thực hiện việc kết nối mạng, curlie thừa hưởng khả năng hỗ trợ giao thức, xử lý TLS, hành vi proxy và các cờ lệnh mà bạn đã biết của curl. Bạn có thể truyền bất kỳ cờ lệnh curl gốc nào trực tiếp. curlie chỉ đơn giản là làm cho trường hợp phổ biến, gửi yêu cầu và đọc phản hồi, trở nên ít khó khăn hơn nhiều.
Dự án được phân phối dưới dạng một tệp nhị phân Go duy nhất được duy trì trên GitHub. Không cần cài đặt môi trường chạy, không có môi trường Python, không có plugin. Bạn chỉ cần đặt tệp nhị phân vào PATH của mình là xong.
Nói một cách đơn giản: curlie là một công cụ client HTTP tương tác, tức thời dành cho terminal. Bạn sử dụng nó khi muốn kiểm tra một endpoint, xem xét phản hồi và tiếp tục công việc. Nó không phải là một công cụ chạy thử nghiệm, và nó cũng không cố gắng trở thành một công cụ như vậy.
Tại sao mọi người sử dụng nó
curl có mặt ở khắp mọi nơi, nhưng đầu ra của nó đổ các byte thô ra màn hình của bạn. JSON xuất hiện dưới dạng một dòng duy nhất không được định dạng. Header và body hòa lẫn vào nhau trừ khi bạn thêm cờ lệnh. HTTPie đã khắc phục vấn đề về khả năng đọc bằng cú pháp sạch và đầu ra có màu, nhưng nó là một công cụ Python riêng biệt với hành vi và các phụ thuộc riêng.
curlie nằm giữa hai công cụ này. Bạn nhận được sự tiện lợi của HTTPie với công cụ curl bên dưới. Dưới đây là một vài lý do các nhà phát triển thích nó:
- Dễ đọc theo mặc định. Các phản hồi trả về có màu, với JSON được định dạng đẹp mắt và các header được tách biệt rõ ràng.
- Cú pháp quen thuộc. Thiết lập header, tham số truy vấn và các trường JSON sử dụng kiểu HTTPie nhỏ gọn thay vì các cờ
-Hvà-dchồng chất. - Có curl bên dưới. Bất kỳ cờ lệnh curl nào cũng hoạt động. Nếu bạn biết curl, bạn đã biết hầu hết curlie.
- Không phụ thuộc. Một tệp nhị phân tĩnh duy nhất. Không có gì phải cập nhật ngoại trừ chính tệp nhị phân đó.
- Chế độ chi tiết hiển thị lệnh curl. Chạy với
-vvà bạn có thể thấy các header và yêu cầu cơ bản, điều này cũng làm cho nó trở thành một công cụ học tập tốt.
Cài đặt curlie
curlie được phân phối dưới dạng tệp nhị phân đã biên dịch sẵn và thông qua các trình quản lý gói phổ biến. Các lệnh chính xác có thể thay đổi theo thời gian, vì vậy hãy kiểm tra trang phát hành trên GitHub để biết phương pháp hiện tại, nhưng các cách thông thường trông như thế này.
Trên macOS với Homebrew:
brew install curlie
Với Go đã được cài đặt:
go install github.com/rs/curlie@latest
Hoặc tải tệp nhị phân phù hợp với nền tảng của bạn từ trang phát hành và di chuyển nó vào PATH của bạn:
# ví dụ: đặt tệp nhị phân đã tải xuống vào một vị trí nào đó trong PATH
mv curlie /usr/local/bin/
curlie --version
Bạn cần có curl trên hệ thống, vì curlie gọi nó. Trên macOS và hầu hết các bản phân phối Linux, curl đã có sẵn.
Cách sử dụng cơ bản
Cú pháp sẽ quen thuộc nếu bạn đã từng sử dụng HTTPie. Một yêu cầu GET có thể ngắn gọn chỉ bằng URL:
curlie httpbin.org/get
curlie mặc định là GET khi bạn không chỉ định phương thức, và nó sẽ tự động điền http:// nếu bạn bỏ qua giao thức. Phản hồi được in ra với các header có màu và JSON được định dạng.
Để gửi JSON, hãy sử dụng các cặp key=value. curlie sẽ tự động đặt header Content-Type: application/json và xây dựng phần thân yêu cầu cho bạn:
curlie POST httpbin.org/post name=apidog role=platform
Lệnh đó gửi {"name": "apidog", "role": "platform"} làm phần thân yêu cầu. Thêm một header với dạng Header:value và một tham số truy vấn với param==value:
curlie GET httpbin.org/get \
Authorization:"Bearer token123" \
search==apidog
Vì curl chạy bên dưới, bạn có thể kết hợp các cờ lệnh gốc bất cứ khi nào cú pháp ngắn gọn không đủ:
curlie -v --max-time 5 httpbin.org/get
Cờ lệnh -v rất đáng để trở thành một thói quen. Nó in ra các header của yêu cầu và phản hồi, giúp bạn xác nhận chính xác những gì đã được gửi đi. Nếu bạn muốn tìm hiểu sâu hơn về công cụ cơ bản, hướng dẫn API REST của curl bao gồm các cờ lệnh thô mà curlie đang bao bọc.
curlie so với curl so với HTTPie
Cả ba công cụ này đều gửi các yêu cầu HTTP từ terminal. Sự khác biệt nằm ở cú pháp, đầu ra và những gì đang chạy bên dưới.
| Khía cạnh | curl | HTTPie | curlie |
|---|---|---|---|
| Công cụ | libcurl | Python (kiểu requests) | curl (bao bọc nó) |
| Cú pháp | Nhiều cờ lệnh (-X, -H, -d) |
Gọn nhẹ (key=value) |
Gọn nhẹ, kiểu HTTPie |
| Đầu ra | Thô, không định dạng | Có màu, JSON đẹp mắt | Có màu, JSON đẹp mắt |
| Cài đặt | Được cài đặt sẵn ở hầu hết mọi nơi | Gói Python | Tệp nhị phân Go duy nhất |
| Cờ lệnh curl gốc | Có | Không | Có (truyền thẳng) |
| Phụ thuộc | Không có | Môi trường chạy Python | Tệp nhị phân curl |
| Được xây dựng cho | Tập lệnh và các lệnh tức thời | Các lệnh tức thời thân thiện | Các lệnh tức thời thân thiện |
Tóm tắt chân thực: HTTPie và curlie giải quyết cùng một vấn đề về khả năng đọc và tiện lợi theo những cách khác nhau. HTTPie là một công cụ được tái hiện đầy đủ bằng Python với bộ tính năng riêng. curlie là một trình bao bọc mỏng giúp bạn sử dụng curl. Nếu nhóm của bạn chuẩn hóa các cờ lệnh curl hoặc bạn muốn truy cập trực tiếp vào mọi tùy chọn của curl, curlie sẽ rất phù hợp. Nếu bạn thích bề mặt tính năng rộng hơn của HTTPie và không bận tâm đến phụ thuộc Python, HTTPie là một lựa chọn tốt. Hướng dẫn HTTPie của chúng tôi đi sâu vào công cụ đó, và nếu bạn đang cân nhắc giữa hai công cụ, bài so sánh curl-to-HTTPie sẽ đối chiếu cú pháp của cả hai.
Để có cái nhìn rộng hơn về các lựa chọn terminal và GUI ngoài ba công cụ này, hãy xem tổng hợp các lựa chọn thay thế curl để kiểm thử REST API của chúng tôi.
Khi nào curlie là công cụ phù hợp, và khi nào không
curlie phát huy tác dụng tốt nhất cho các công việc nhanh chóng, tương tác:
- Kiểm tra xem một endpoint có hoạt động và trả về định dạng mà bạn mong đợi hay không.
- Kiểm tra nhanh một phản hồi JSON mà không cần pipe qua
jqđể đọc. - Gỡ lỗi header và xác thực trong quá trình phát triển.
- Dạy hoặc trình diễn HTTP, vì cờ
-vhiển thị yêu cầu thực sự.
Nó không còn hữu ích trong bất kỳ trường hợp nào cần được lặp lại, chia sẻ hoặc xác minh tự động. curlie không có khái niệm về các yêu cầu đã lưu. Không có môi trường để chuyển đổi giữa staging và production. Không có xác nhận để kiểm tra xem mã trạng thái là 200 hay một trường bằng một giá trị mong đợi. Không có báo cáo khi có điều gì đó hỏng hóc lúc 3 giờ sáng trong pipeline của bạn.
Điều đó không phải là chê bai curlie. Nó là một công cụ tức thời làm tốt công việc tức thời. Nhưng ngay khi bạn thấy mình dán cùng một lệnh curlie vào tài liệu, hoặc sao chép nó vào một tập lệnh shell với các kiểm tra grep viết tay, bạn đã vượt quá giới hạn của một công cụ client tương tác.
Lộ trình nâng cấp: từ các lệnh một lần sang một quy trình làm việc được lưu, có thể lặp lại
Đây là lúc quy trình làm việc tự nhiên phân tách. Tiếp tục sử dụng curlie để khám phá. Khi một yêu cầu cần được lưu trữ, tái sử dụng hoặc chạy trong CI, hãy chuyển nó vào một nền tảng được xây dựng cho mục đích đó.
Apidog là lớp lưu trữ và cộng tác chính xác cho quá trình chuyển đổi này. Nó không phải là một công cụ thay thế trực tiếp cho curlie trong terminal; nó là bước tiếp theo sau terminal. Với Apidog, bạn có thể:
- Lưu các yêu cầu vào các bộ sưu tập có tổ chức thay vì phải gõ lại hoặc tìm kiếm trong lịch sử shell.
- Quản lý môi trường để cùng một yêu cầu chạy trên môi trường local, staging và production bằng cách chuyển đổi một biến.
- Thêm các xác nhận để kiểm tra mã trạng thái, các trường phản hồi và schema, biến một kiểm tra thủ công thành một kiểm tra tự động.
- Chạy các bài kiểm thử trong CI với
apidog run, công cụ chạy dòng lệnh thực thi các kịch bản kiểm thử đã lưu của bạn trong một pipeline và báo cáo kết quả thành công hay thất bại. - Chia sẻ với nhóm của bạn thông qua một không gian làm việc cộng tác, để một yêu cầu mà bạn đã gỡ lỗi một lần có thể được mọi người tái sử dụng.
Một mô hình thực tế: khám phá một endpoint với curlie cho đến khi bạn hiểu nó, sau đó tạo lại nó thành một yêu cầu đã lưu trong Apidog với các xác nhận đính kèm. Việc khám phá vẫn nhanh chóng và dùng một lần. Việc xác minh trở nên bền vững và tự động. Nếu bạn đang chính thức hóa cách nhóm của bạn xác thực các endpoint, hướng dẫn kiểm thử API bao gồm các khái niệm đằng sau các xác nhận và kịch bản kiểm thử.
Các câu hỏi thường gặp
curlie có phải là công cụ thay thế cho curl không?
Không hẳn vậy. curlie chạy trên nền tảng của curl, vì vậy nó giống như một giao diện thân thiện hơn là một công cụ thay thế. Nó chuyển đổi cú pháp gọn nhẹ thành các lệnh gọi curl và định dạng đầu ra. Bản thân curl vẫn là công cụ chính, và mọi cờ lệnh curl gốc vẫn hoạt động thông qua curlie.
curlie có hoạt động trong các pipeline CI/CD không?
Bạn có thể gọi curlie trong một script, nhưng nó không được xây dựng cho kiểm thử tự động. Nó không có xác nhận, không có kịch bản kiểm thử đã lưu và không có báo cáo có cấu trúc. Đối với công việc pipeline, bạn cần một công cụ chạy kiểm tra phản hồi và làm thất bại bản dựng khi có lỗi. Lệnh apidog run của Apidog đáp ứng vai trò đó, và danh sách các client kiểm thử API hàng đầu của chúng tôi bao gồm các tùy chọn khác cho kiểm thử lặp lại, thân thiện với CI.
curlie khác gì so với HTTPie?
Chúng có cảm giác tương tự vì curlie sao chép cú pháp và đầu ra có màu của HTTPie. Sự khác biệt nằm ở công cụ chính. HTTPie là một công cụ Python độc lập với cách triển khai riêng. curlie là một trình bao bọc Go mỏng xung quanh curl, vì vậy nó thừa hưởng hành vi của curl và chấp nhận trực tiếp các cờ lệnh curl. Chọn curlie nếu bạn muốn tiếp tục sử dụng curl; chọn HTTPie nếu bạn thích bộ tính năng độc lập của nó.
Tôi có thể xem lệnh curl thực tế mà curlie chạy không?
Có. Chạy curlie với cờ -v (verbose) và nó sẽ in ra các header yêu cầu và phản hồi cùng với chi tiết yêu cầu cơ bản. Đây là một cách tiện lợi để học các cờ lệnh curl hoặc để xác nhận chính xác những gì đã được gửi đi.
Kết luận
curlie là một công cụ nhỏ thông minh: cú pháp dễ đọc và đầu ra có màu của HTTPie, với curl thực hiện công việc thực tế bên dưới. Để kiểm tra các endpoint, đọc phản hồi JSON và gỡ lỗi xác thực trong terminal, nó là một nâng cấp chất lượng cuộc sống thực sự so với việc sử dụng curl thô. Chỉ cần nhớ nó là gì. Nó là một client tương tác, không phải là một công cụ chạy thử nghiệm.
Khi các yêu cầu của bạn cần được lưu, chia sẻ, xác nhận và chạy trong CI, đó là tín hiệu để bạn chuyển lên một tầng cao hơn. Tải xuống Apidog để biến các endpoint bạn khám phá trong terminal thành các yêu cầu đã lưu, môi trường và các bài kiểm thử tự động mà toàn bộ nhóm của bạn có thể tin cậy. Hãy giữ curlie cho những công việc nhanh chóng, và để Apidog xử lý những công việc cần lặp lại.