Appcircle MCP Server

chính thức

Máy chủ MCP chính thức của Appcircle

GitHub

Bạn có thể làm gì với Appcircle MCP?

  • Liệt kê và tìm kiếm hồ sơ build — Truy xuất hồ sơ build có phân trang và lọc theo tên bằng get_build_profiles.
  • Kiểm tra cấu hình build và quy trình làm việc — Lấy thông tin chi tiết cho một hồ sơ build cụ thể, các cấu hình và quy trình làm việc của nó bằng cách sử dụng get_build_profile_details, get_build_configuration_details và get_workflow_detail.
  • Xem lại danh tính ký — Liệt kê chứng chỉ, kho khóa, hồ sơ cấp phép và mã định danh gói thông qua get_certificates, get_keystores, get_provisioning_profiles và get_bundle_identifiers.
  • Kiểm tra trạng thái phân phối thử nghiệm và doanh nghiệp — Lấy hồ sơ phân phối và phiên bản ứng dụng của chúng bằng get_distribution_profiles và get_distribution_profile_details, hoặc kiểm tra hồ sơ cửa hàng doanh nghiệp qua get_store_profiles.
  • Tạo báo cáo sức khỏe CI/CD và lịch sử build — Sử dụng get_build_insights_report để phân tích xu hướng tổng hợp và nguyên nhân gốc rễ, hoặc get_build_history_report để lấy bản ghi build thô.

Tài liệu

Appcircle MCP Server

Máy chủ MCP cho Appcircle: cung cấp các công cụ Build, Signing Identities, Testing Distribution, Enterprise App Store, Publish to Stores và Reporting cho bất kỳ máy khách nào hỗ trợ MCP (Claude Desktop, Cursor, VS Code, v.v.). Appcircle MCP Server đóng vai trò là cầu nối giữa các công cụ AI và Appcircle; nhờ đó, các tác nhân AI, trợ lý và chatbot có thể truy cập và tương tác an toàn với các tài nguyên Appcircle thông qua các công cụ có cấu trúc, được quản lý và ở cấp độ tác vụ.

Trường hợp sử dụng

  • Thông minh về CI/CD và Quy trình làm việc: Giám sát các lần chạy pipeline, theo dõi trạng thái phát hành và nhận thông tin chi tiết về quy trình CI/CD di động của bạn.
  • Thông tin chi tiết về Cấu hình và Môi trường: Truy vấn cấu hình build và thiết lập ký để hiểu cách một dự án được cấu hình và nơi các vấn đề có thể phát sinh.
  • Thông tin chi tiết về Báo cáo và Vận hành: Tạo các bản tóm tắt về độ ổn định CI, các vấn đề tái diễn, hiệu suất pipeline và tình trạng tổng thể của CI/CD.

Chế độ chạy

Bạn có thể sử dụng máy chủ MCP theo bốn cách:

Chế độTóm tắt
1. Máy chủ từ xaKết nối tới https://mcp.appcircle.io. Không cần cài đặt cục bộ; máy khách của bạn gửi token Appcircle (ví dụ: Authorization: Bearer <token>) trong mỗi yêu cầu.
2. Cục bộ (stdio)Chạy máy chủ từ mã nguồn: sao chép kho lưu trữ, tùy chọn sử dụng venv, sau đó chạy appcircle-mcp (phương thức truyền tải mặc định là stdio). Yêu cầu Python và pip. Đặt APPCIRCLE_ACCESS_TOKEN trong môi trường. Máy khách MCP của bạn chạy máy chủ như một tiến trình con.
3. Cục bộ (streamable-http)Chạy máy chủ cục bộ qua HTTP: sử dụng --transport streamable-http và tùy chọn --host / --port (ví dụ: appcircle-mcp --transport streamable-http --host 127.0.0.1 --port 8000). Máy khách kết nối tới URL đó và gửi token của họ trong yêu cầu.
4. Cục bộ (Docker)Chạy image Docker chính thức trên máy của bạn. Yêu cầu Docker. Sử dụng cổng mặc định của image hoặc ghi đè bằng --port; xem tài liệu image để biết cách sử dụng chính xác.

Cấu hình máy khách chi tiết (Cursor, Claude, v.v.) nằm trong hướng dẫn cài đặt chuyên dụng; phần này chỉ là tóm tắt cấp cao.

Cài đặt

Hướng dẫn thiết lập cho từng máy khách cụ thể:

Cấu hình (Biến môi trường)

BiếnBắt buộcMô tả
APPCIRCLE_ACCESS_TOKENCó (chỉ stdio)Token truy cập API Appcircle. Bắt buộc khi sử dụng phương thức truyền tải stdio. Đối với streamable-http, mỗi máy khách gửi token riêng của mình. Xem Lấy token để biết cách lấy.
APPCIRCLE_API_URLKhôngURL cơ sở API (mặc định: https://api.appcircle.io có thể khác đối với người dùng tự lưu trữ).
APPCIRCLE_MCP_ALLOWED_HOSTKhông (chỉ streamable-http)Tên máy chủ công khai cho máy chủ MCP (ví dụ: mcp.appcircle.io). Đặt biến này khi triển khai phía sau proxy ngược để máy chủ chấp nhận tiêu đề Host từ máy khách. Bỏ qua đối với localhost.
APPCIRCLE_MCP_PORTKhông (chỉ streamable-http)Cổng liên kết cho máy chủ HTTP (mặc định: 8000). Bị ghi đè bởi --port nếu được cung cấp. Hữu ích cho on-prem hoặc Docker khi cần một cổng cụ thể.
LOG_LEVELKhôngMức ghi nhật ký, ví dụ: DEBUG, INFO (mặc định: INFO).
APPCIRCLE_EXCLUDED_TOOLSETSKhôngDanh sách các bộ công cụ cần loại trừ, phân tách bằng dấu phẩy (ví dụ: build_module,report). Xem Bộ công cụ bên dưới.

Đặt các biến này trong shell của bạn hoặc trong cấu hình máy khách MCP.

Bộ công cụ

Bộ công cụ khả dụng

Các bộ công cụ sau đây có sẵn:

Bộ công cụMô tả
build_moduleHồ sơ build, cấu hình, quy trình làm việc, commit và hoạt động pipeline
signing_identitiesDanh tính ký và mã định danh gói
testing_distributionHồ sơ phân phối thử nghiệm và chi tiết phân phối
publish_to_storesHồ sơ xuất bản và hoạt động xuất bản lên cửa hàng
enterprise_app_storeHồ sơ cửa hàng ứng dụng doanh nghiệp và chi tiết cửa hàng
reportBáo cáo: lịch sử build, phân phối, ký, trạng thái xuất bản và các báo cáo liên quan

Bạn có thể loại trừ một hoặc nhiều bộ công cụ để các công cụ của chúng không được đăng ký. Việc loại trừ có thể được đặt qua đối số CLI hoặc biến môi trường APPCIRCLE_EXCLUDED_TOOLSETS; cả hai được hợp nhất (phép hợp).

  • CLI: --exclude toolset1 toolset2 hoặc --exclude-toolsets toolset1,toolset2
  • Môi trường: APPCIRCLE_EXCLUDED_TOOLSETS=build_module,report

Ví dụ cấu hình MCP (Cursor / Claude Desktop) với loại trừ:

{
  "mcpServers": {
    "appcircle": {
      "command": "appcircle-mcp",
      "args": ["--exclude", "report"]
    }
  }
}

Công cụ

Các công cụ được hiển thị qua MCP tools/list. Tham chiếu bên dưới liệt kê tất cả công cụ theo bộ công cụ; để biết hình dạng phản hồi và ví dụ, xem docs/tool_contract.md.

Build

  • get_build_profiles - Lấy hồ sơ build cho tổ chức hiện tại (phân trang). Tùy chọn lọc theo tên hồ sơ.

    • Cấp độ truy cập: đọc
    • page: Số trang (bắt đầu từ 1). Mặc định: 1. (số, tùy chọn)
    • size: Kích thước trang (1-100). Mặc định: 25. Giá trị trên 100 bị giới hạn ở 100. (số, tùy chọn)
    • search: Thuật ngữ tìm kiếm tùy chọn để lọc hồ sơ theo tên (khớp một phần không phân biệt chữ hoa chữ thường). (chuỗi, tùy chọn)

  • get_build_profile_details - Lấy một hồ sơ build duy nhất theo ID, tùy chọn bao gồm các cấu hình build của nó.

    • Cấp độ truy cập: đọc
    • profile_id: ID hồ sơ build (ví dụ: UUID). (chuỗi, bắt buộc)
    • configurations: Nếu true, cũng tìm nạp các cấu hình build của hồ sơ. Mặc định: false. (boolean, tùy chọn)

  • get_build_configuration_details - Lấy một cấu hình build duy nhất theo ID hồ sơ và ID cấu hình.

    • Cấp độ truy cập: đọc
    • profile_id: ID hồ sơ build (ví dụ: UUID). (chuỗi, bắt buộc)
    • configuration_id: ID cấu hình build (ví dụ: UUID). (chuỗi, bắt buộc)

  • get_build_profile_workflows - Lấy quy trình làm việc cho một hồ sơ build theo ID hồ sơ.

    • Cấp độ truy cập: đọc
    • profile_id: ID hồ sơ build (ví dụ: UUID). (chuỗi, bắt buộc)

  • get_workflow_detail - Lấy một quy trình làm việc duy nhất theo ID hồ sơ build và ID quy trình làm việc.

    • Cấp độ truy cập: đọc
    • profile_id: ID hồ sơ build (ví dụ: UUID). (chuỗi, bắt buộc)
    • workflow_id: ID quy trình làm việc (ví dụ: UUID). (chuỗi, bắt buộc)

  • get_commits_by_branch - Lấy commit cho một nhánh build (phân trang).

    • Cấp độ truy cập: đọc
    • branch_id: ID nhánh (ví dụ: UUID). (chuỗi, bắt buộc)
    • page: Số trang (bắt đầu từ 1). Nếu được cung cấp cùng với kích thước, kích hoạt phân trang. Mặc định: 1. (số, tùy chọn)
    • size: Kích thước trang. Nếu được cung cấp cùng với trang, kích hoạt phân trang. Mặc định: 25, tối đa 100. (số, tùy chọn)

  • get_commit_details - Lấy một commit duy nhất theo ID commit (UUID) hoặc theo hash commit (git SHA). Cung cấp commit_id hoặc commit_hash, không phải cả hai.

    • Cấp độ truy cập: đọc
    • commit_id: ID commit (UUID). (chuỗi, tùy chọn)
    • commit_hash: Hash commit (git SHA). (chuỗi, tùy chọn)
Danh tính ký

  • get_bundle_identifiers - Lấy tất cả mã định danh gói cho tổ chức (ID gói ứng dụng iOS/macOS).

    • Cấp độ truy cập: đọc
    • Không có tham số.

  • get_certificates - Lấy tất cả chứng chỉ ký cho tổ chức. Các trường nhạy cảm (p12Password, p12Binary, metaData, thumbprint) bị bỏ qua.

    • Cấp độ truy cập: đọc
    • Không có tham số.

  • get_keystores - Lấy tất cả kho khóa cho tổ chức (ví dụ: kho khóa ký Android). Các trường nhạy cảm (password, aliasPassword, binary, checkSum, sha256FingerPrint) bị bỏ qua.

    • Cấp độ truy cập: đọc
    • Không có tham số.

  • get_provisioning_profiles - Lấy hồ sơ cấp phép cho tổ chức (ví dụ: iOS/macOS). Các trường nhạy cảm/lớn (binary, metaData, certificateThumbPrints, provisionedDevices, connectApiKeyId) bị bỏ qua. Tùy chọn lọc theo ID ứng dụng (gói).

    • Cấp độ truy cập: đọc
    • app_id: ID ứng dụng (gói) tùy chọn để lọc hồ sơ cấp phép (ví dụ: com.example.app). (chuỗi, tùy chọn)
Phân phối thử nghiệm

  • get_distribution_profiles - Lấy hồ sơ phân phối thử nghiệm cho tổ chức hiện tại (phân trang). Tùy chọn lọc theo tên hồ sơ.

    • Cấp độ truy cập: đọc
    • page: Số trang (bắt đầu từ 1). Mặc định: 1. (số, tùy chọn)
    • size: Kích thước trang (1-100). Mặc định: 25, tối đa 100. (số, tùy chọn)
    • search: Thuật ngữ tìm kiếm tùy chọn để lọc hồ sơ theo tên. (chuỗi, tùy chọn)

  • get_distribution_profile_details - Lấy một hồ sơ phân phối thử nghiệm duy nhất theo ID (với phân trang phiên bản ứng dụng tùy chọn).

    • Cấp độ truy cập: đọc
    • profile_id: ID hồ sơ phân phối (ví dụ: UUID). (chuỗi, bắt buộc)
    • page: Số trang cho phiên bản ứng dụng (bắt đầu từ 1). Mặc định: 1. (số, tùy chọn)
    • size: Kích thước trang cho phiên bản ứng dụng (1-100). Mặc định: 25, tối đa 100. (số, tùy chọn)
Xuất bản lên Cửa hàng

  • get_publish_profiles - Lấy hồ sơ xuất bản cho tổ chức hiện tại cho một loại nền tảng nhất định (phân trang). Tùy chọn lọc theo trạng thái luồng.

    • Cấp độ truy cập: đọc
    • platform_type: Loại nền tảng của hồ sơ xuất bản ("ios" hoặc "android"). (chuỗi, bắt buộc)
    • page: Số trang (bắt đầu từ 1). Mặc định: 1. (số, tùy chọn)
    • size: Kích thước trang (1-100). Mặc định: 25, tối đa 100. (số, tùy chọn)
    • flow_status: Mã trạng thái luồng tùy chọn để lọc (ví dụ: 0=Thành công, 1=Thất bại, 91=Đang chạy). (số, tùy chọn)

  • get_publish_profile_details - Lấy một hồ sơ xuất bản duy nhất theo loại nền tảng và ID (với phân trang phiên bản ứng dụng tùy chọn).

    • Cấp độ truy cập: đọc
    • platform_type: Loại nền tảng ("ios" hoặc "android"). (chuỗi, bắt buộc)
    • profile_id: ID hồ sơ xuất bản (ví dụ: UUID). (chuỗi, bắt buộc)
    • page: Số trang cho phiên bản ứng dụng (bắt đầu từ 1). Mặc định: 1. (số, tùy chọn)
    • size: Kích thước trang cho phiên bản ứng dụng (1-100). Mặc định: 25, tối đa 100. (số, tùy chọn)
Cửa hàng ứng dụng doanh nghiệp

  • get_store_profiles - Lấy hồ sơ cửa hàng ứng dụng doanh nghiệp cho tổ chức hiện tại (phân trang).

    • Cấp độ truy cập: đọc
    • page: Số trang (bắt đầu từ 1). Mặc định: 1. (số, tùy chọn)
    • size: Kích thước trang (1-100). Mặc định: 25, tối đa 100. (số, tùy chọn)

  • get_store_profile_details - Lấy một hồ sơ cửa hàng ứng dụng doanh nghiệp duy nhất theo ID (với phân trang phiên bản ứng dụng tùy chọn).

    • Cấp độ truy cập: đọc
    • profile_id: ID hồ sơ cửa hàng ứng dụng doanh nghiệp (ví dụ: UUID). (chuỗi, bắt buộc)
    • page: Số trang cho phiên bản ứng dụng (bắt đầu từ 1). Mặc định: 1. (số, tùy chọn)
    • size: Kích thước trang cho phiên bản ứng dụng (1-100). Mặc định: 25, tối đa 100. (số, tùy chọn)
Báo cáo - **get_build_history_report** - Lấy báo cáo lịch sử build, có thể lọc theo khoảng ngày, hồ sơ build và tổ chức. Có phân trang. - **Cấp độ truy cập:** read - `start_date`: Ngày bắt đầu tùy chọn (YYYY-MM-DD). (chuỗi, tùy chọn) - `end_date`: Ngày kết thúc tùy chọn (YYYY-MM-DD). (chuỗi, tùy chọn) - `page`: Số trang (mặc định: 1). (số, tùy chọn) - `size`: Số mục mỗi trang (1-100, mặc định: 50). (số, tùy chọn) - `build_profile_name`: Lọc theo tên hồ sơ build. (chuỗi, tùy chọn) - `organization_id`: Lọc theo UUID tổ chức. (chuỗi, tùy chọn)

  • get_build_insights_report - Lấy Báo cáo Thông tin chi tiết Build được tính toán (Ảnh chụp Sức khỏe + Xu hướng, Nguyên nhân Gốc rễ, Sức khỏe Artifact, Chất lượng Quy trình, Thời gian Chờ và phân tích Đánh giá Mức độ Trưởng thành) trên lịch sử build, được tổng hợp phía máy chủ. Không giống get_build_history_report, công cụ này tự động tìm nạp mọi trang nội bộ và trả về các kết quả đã được tổng hợp sẵn nhỏ gọn thay vì các bản ghi thô.

    • Cấp độ truy cập: read
    • start_date: Ngày bắt đầu tùy chọn (YYYY-MM-DD) cho giai đoạn hiện tại. Mặc định: 30 ngày qua. (chuỗi, tùy chọn)
    • end_date: Ngày kết thúc tùy chọn (YYYY-MM-DD) cho giai đoạn hiện tại. (chuỗi, tùy chọn)
    • sections: Danh sách tùy chọn các phần cần tính toán: health_snapshot, root_cause, artifact_health, workflow_quality, queue_time, maturity_assessment. Mặc định: cả sáu. (mảng chuỗi, tùy chọn)
    • include_sub_orgs: Nếu true, giữ lại các bản ghi build liên tổ chức trong các chỉ số lấy từ lịch sử thay vì lọc theo tổ chức của token. Mặc định: false. (boolean, tùy chọn)

  • get_distribution_app_version_report - Lấy báo cáo sử dụng hàng ngày cho các phiên bản ứng dụng đã phân phối. Có phân trang; hỗ trợ lọc theo hồ sơ, hệ điều hành, tổ chức.

    • Cấp độ truy cập: read
    • start_date: Ngày bắt đầu tùy chọn (YYYY-MM-DD). (chuỗi, tùy chọn)
    • end_date: Ngày kết thúc tùy chọn (YYYY-MM-DD). (chuỗi, tùy chọn)
    • page: Số trang (mặc định: 1). (số, tùy chọn)
    • size: Số mục mỗi trang (1-100, mặc định: 50). (số, tùy chọn)
    • profile_name: Lọc theo tên hồ sơ phân phối. (chuỗi, tùy chọn)
    • os: Lọc theo hệ điều hành ("ios" hoặc "android"). (chuỗi, tùy chọn)
    • organization_id: Lọc theo UUID tổ chức. (chuỗi, tùy chọn)

  • get_distribution_sent_report - Lấy báo cáo sử dụng hàng ngày cho việc chia sẻ ứng dụng đã phân phối. Có phân trang; hỗ trợ lọc theo hồ sơ, hệ điều hành, tổ chức.

    • Cấp độ truy cập: read
    • start_date: Ngày bắt đầu tùy chọn (YYYY-MM-DD). (chuỗi, tùy chọn)
    • end_date: Ngày kết thúc tùy chọn (YYYY-MM-DD). (chuỗi, tùy chọn)
    • page: Số trang (mặc định: 1). (số, tùy chọn)
    • size: Số mục mỗi trang (1-100, mặc định: 50). (số, tùy chọn)
    • profile_name: Lọc theo tên hồ sơ phân phối. (chuỗi, tùy chọn)
    • os: Lọc theo hệ điều hành ("ios" hoặc "android"). (chuỗi, tùy chọn)
    • organization_id: Lọc theo UUID tổ chức. (chuỗi, tùy chọn)

  • get_enterprise_app_store_app_usage_report - Lấy báo cáo sử dụng ứng dụng cho cửa hàng ứng dụng doanh nghiệp. start_date và end_date là bắt buộc. Có phân trang.

    • Cấp độ truy cập: read
    • start_date: Ngày bắt đầu (YYYY-MM-DD). (chuỗi, bắt buộc)
    • end_date: Ngày kết thúc (YYYY-MM-DD). (chuỗi, bắt buộc)
    • page: Số trang (mặc định: 1). (số, tùy chọn)
    • size: Số mục mỗi trang (1-100, mặc định: 50). (số, tùy chọn)
    • organization_id: Lọc tùy chọn theo UUID tổ chức. (chuỗi, tùy chọn)

  • get_publish_resign_report - Lấy báo cáo ký lại phát hành, có thể lọc theo khoảng ngày, tên ứng dụng, tổ chức và trạng thái. Có phân trang.

    • Cấp độ truy cập: read
    • start_date: Ngày bắt đầu tùy chọn (YYYY-MM-DD). (chuỗi, tùy chọn)
    • end_date: Ngày kết thúc tùy chọn (YYYY-MM-DD). (chuỗi, tùy chọn)
    • page: Số trang (mặc định: 1). (số, tùy chọn)
    • size: Số mục mỗi trang (1-100, mặc định: 50). (số, tùy chọn)
    • app_name: Lọc theo tên ứng dụng. (chuỗi, tùy chọn)
    • organization_id: Lọc theo UUID tổ chức. (chuỗi, tùy chọn)
    • status: Lọc theo trạng thái ký lại (0=đang chờ, 1=đang xử lý, 2=thành công, 3=thất bại, 4=đã hủy, 5=hết thời gian). (số, tùy chọn)

  • get_publish_status_report - Lấy báo cáo trạng thái phát hành, có thể lọc theo khoảng ngày, tên ứng dụng, tổ chức và trạng thái. Có phân trang.

    • Cấp độ truy cập: read
    • start_date: Ngày bắt đầu tùy chọn (YYYY-MM-DD). (chuỗi, tùy chọn)
    • end_date: Ngày kết thúc tùy chọn (YYYY-MM-DD). (chuỗi, tùy chọn)
    • page: Số trang (mặc định: 1). (số, tùy chọn)
    • size: Số mục mỗi trang (1-100, mặc định: 50). (số, tùy chọn)
    • app_name: Lọc theo tên ứng dụng. (chuỗi, tùy chọn)
    • organization_id: Lọc theo UUID tổ chức. (chuỗi, tùy chọn)
    • status: Lọc theo trạng thái phát hành (ví dụ: 0=Thành công, 1=Thất bại, 91=Đang chạy). (số, tùy chọn)

  • get_signing_report - Lấy báo cáo ký, có thể lọc theo khoảng ngày, tổ chức, hệ điều hành và trạng thái build. Có phân trang.

    • Cấp độ truy cập: read
    • start_date: Ngày bắt đầu tùy chọn (YYYY-MM-DD). (chuỗi, tùy chọn)
    • end_date: Ngày kết thúc tùy chọn (YYYY-MM-DD). (chuỗi, tùy chọn)
    • page: Số trang (mặc định: 1). (số, tùy chọn)
    • size: Số mục mỗi trang (1-100, mặc định: 50). (số, tùy chọn)
    • organization_id: Lọc theo UUID tổ chức. (chuỗi, tùy chọn)
    • os: Lọc theo hệ điều hành ("ios" hoặc "android"). (chuỗi, tùy chọn)
    • build_status: Lọc theo trạng thái build (ví dụ: 0=Thành công, 1=Thất bại, 91=Đang chạy). (số, tùy chọn)

Chạy máy chủ

Từ thư mục gốc của repo:

python -m src.server

Hoặc sau pip install -e .:

appcircle-mcp

Máy chủ chạy qua stdio (hoặc SSE/HTTP tùy thuộc vào cách máy khách của bạn khởi động nó).

Định dạng phản hồi

Mọi công cụ đều trả về một lớp vỏ bọc tiêu chuẩn:

  • Thành công: { "success": true, "data": <payload>, "meta": { ... } }
    data là kết quả của công cụ; meta là tùy chọn (ví dụ: count, page, filters).
  • Lỗi: { "success": false, "error": { "tool", "type", "message", "details" } }
    Cùng một hình dạng cho tất cả các công cụ để máy khách có thể phân tích lỗi một cách nhất quán.

Đặc tả đầy đủ: docs/tool_contract.md.

Kiểm thử

Cài đặt với các phụ thuộc phát triển:

pip install -e ".[dev]"

Kiểm thử đơn vị (mặc định)

Sử dụng API giả lập; không cần APPCIRCLE_ACCESS_TOKEN. pytest mặc định chỉ chạy những kiểm thử này (xem testpaths trong pyproject.toml):

pytest test/unit/ -v
  • Tệp đơn: pytest test/unit/tools/build_module/test_get_build_profiles.py -v
  • Với coverage: pytest test/unit/ --cov=src --cov-report=term-missing

Kiểm thử tích hợp

Gọi API Appcircle thực. Đặt APPCIRCLE_ACCESS_TOKEN trong môi trường, sau đó chạy:

pytest test/integration/ -v
  • Tất cả kiểm thử tích hợp: pytest test/integration/ -v
  • Theo công cụ: pytest test/integration/build_module/ -v, pytest test/integration/report/ -v, v.v.
  • Theo marker: pytest -m integration -v (khi chạy từ thư mục gốc của repo; chỉ bao gồm kiểm thử tích hợp nếu cả kiểm thử đơn vị và tích hợp đều được thu thập)

Nếu APPCIRCLE_ACCESS_TOKEN không được đặt, kiểm thử tích hợp sẽ bị bỏ qua (không báo lỗi).

Biến môi trường tùy chọn cho kiểm thử tích hợp (khi khám phá thất bại hoặc kiểm thử cần ID thực; bỏ qua để bỏ qua các kiểm thử đó):

BiếnMô tả
APPCIRCLE_TEST_ORGANIZATION_IDUUID tổ chức. Được sử dụng bởi test_with_organization_id (báo cáo sử dụng ứng dụng cửa hàng doanh nghiệp).
APPCIRCLE_TEST_BRANCH_IDUUID nhánh. Được sử dụng bởi get_commits_by_branch và các kiểm thử liên quan khi không thể khám phá nhánh nào từ API.
APPCIRCLE_TEST_COMMIT_IDUUID commit. Được sử dụng bởi kiểm thử get_commit_details khi không thể khám phá commit nào từ API.

Bảo mật

Dự án này phụ thuộc vào các gói mã nguồn mở của bên thứ ba được liệt kê trong pyproject.toml. Mặc dù chúng tôi ghim phạm vi phiên bản phụ thuộc và cung cấp tệp khóa (uv.lock) với các hàm băm mật mã, các gói này được duy trì độc lập và cung cấp "nguyên trạng." Appcircle không đưa ra đảm bảo nào về tính bảo mật hoặc độ tin cậy của các phụ thuộc bên thứ ba.

Chúng tôi khuyên bạn nên kiểm tra các gói đã cài đặt trước khi sử dụng:

uv run pip-audit