{"id":25776209,"url":"https://github.com/citrusframework/citrus","last_synced_at":"2026-01-16T20:01:27.510Z","repository":{"id":799904,"uuid":"500806","full_name":"citrusframework/citrus","owner":"citrusframework","description":"Framework for automated integration tests with focus on message-based applications","archived":false,"fork":false,"pushed_at":"2026-01-13T18:08:34.000Z","size":103786,"stargazers_count":474,"open_issues_count":177,"forks_count":145,"subscribers_count":39,"default_branch":"main","last_synced_at":"2026-01-14T05:36:28.407Z","etag":null,"topics":["apache-camel","http","integration-testing","jms","kafka","knative","kubernetes","messaging","microservices","quarkus","rest-api","spring-boot","testing"],"latest_commit_sha":null,"homepage":"https://citrusframework.org","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/citrusframework.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE","maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2010-02-03T15:32:30.000Z","updated_at":"2026-01-13T18:08:38.000Z","dependencies_parsed_at":"2023-07-09T11:17:01.934Z","dependency_job_id":"c675ccd4-c518-4ed5-bac1-9306385f0eb4","html_url":"https://github.com/citrusframework/citrus","commit_stats":{"total_commits":4428,"total_committers":74,"mean_commits":59.83783783783784,"dds":"0.34462511291779585","last_synced_commit":"40e7de216913cdac1d8109529ea20ecfa4101e85"},"previous_names":["christophd/citrus"],"tags_count":66,"template":false,"template_full_name":null,"purl":"pkg:github/citrusframework/citrus","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/citrusframework%2Fcitrus","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/citrusframework%2Fcitrus/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/citrusframework%2Fcitrus/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/citrusframework%2Fcitrus/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/citrusframework","download_url":"https://codeload.github.com/citrusframework/citrus/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/citrusframework%2Fcitrus/sbom","scorecard":{"id":280978,"data":{"date":"2025-08-11","repo":{"name":"github.com/citrusframework/citrus","commit":"7852e0f9d9971144e71554dbf42a3e4ef1333d08"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":5.3,"checks":[{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Code-Review","score":5,"reason":"Found 2/4 approved changesets -- score normalized to 5","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Maintained","score":10,"reason":"30 commit(s) and 14 issue activity found in the last 90 days -- score normalized to 10","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: no topLevel permission defined: .github/workflows/build.yml:1","Warn: no topLevel permission defined: .github/workflows/lts.yml:1","Warn: no topLevel permission defined: .github/workflows/nightly.yml:1","Warn: no topLevel permission defined: .github/workflows/release.yml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: Apache License 2.0: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Branch-Protection","score":-1,"reason":"internal error: error during branchesHandler.setup: internal error: githubv4.Query: Resource not accessible by integration","details":null,"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build.yml:42: update your workflow using https://app.stepsecurity.io/secureworkflow/citrusframework/citrus/build.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build.yml:47: update your workflow using https://app.stepsecurity.io/secureworkflow/citrusframework/citrus/build.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build.yml:49: update your workflow using https://app.stepsecurity.io/secureworkflow/citrusframework/citrus/build.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/lts.yml:34: update your workflow using https://app.stepsecurity.io/secureworkflow/citrusframework/citrus/lts.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/lts.yml:39: update your workflow using https://app.stepsecurity.io/secureworkflow/citrusframework/citrus/lts.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/lts.yml:41: update your workflow using https://app.stepsecurity.io/secureworkflow/citrusframework/citrus/lts.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/nightly.yml:29: update your workflow using https://app.stepsecurity.io/secureworkflow/citrusframework/citrus/nightly.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/nightly.yml:34: update your workflow using https://app.stepsecurity.io/secureworkflow/citrusframework/citrus/nightly.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/nightly.yml:36: update your workflow using https://app.stepsecurity.io/secureworkflow/citrusframework/citrus/nightly.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release.yml:33: update your workflow using https://app.stepsecurity.io/secureworkflow/citrusframework/citrus/release.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/release.yml:36: update your workflow using https://app.stepsecurity.io/secureworkflow/citrusframework/citrus/release.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release.yml:48: update your workflow using https://app.stepsecurity.io/secureworkflow/citrusframework/citrus/release.yml/main?enable=pin","Warn: downloadThenRun not pinned by hash: .github/workflows/build.yml:62","Warn: downloadThenRun not pinned by hash: .github/workflows/lts.yml:54","Info:   0 out of  11 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of   1 third-party GitHubAction dependencies pinned","Info:   0 out of   2 downloadThenRun dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 30 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-17T15:51:57.818Z","repository_id":799904,"created_at":"2025-08-17T15:51:57.818Z","updated_at":"2025-08-17T15:51:57.818Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28482217,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-16T11:59:17.896Z","status":"ssl_error","status_checked_at":"2026-01-16T11:55:55.838Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["apache-camel","http","integration-testing","jms","kafka","knative","kubernetes","messaging","microservices","quarkus","rest-api","spring-boot","testing"],"created_at":"2025-02-27T06:01:19.288Z","updated_at":"2026-01-16T20:01:27.470Z","avatar_url":"https://github.com/citrusframework.png","language":"Java","readme":"Citrus Integration Testing ![Logo][1]\n==============\n\n[![Maven Central](https://maven-badges.herokuapp.com/maven-central/org.citrusframework/citrus/badge.svg?style=flat-square)](https://central.sonatype.com/search?q=g%253Aorg.citrusframework)\n[![build](https://github.com/citrusframework/citrus/workflows/build/badge.svg?branch=main)](https://github.com/citrusframework/citrus/actions) \n[![Javadocs](http://javadoc.io/badge/org.citrusframework/citrus-core.svg)](http://javadoc.io/doc/org.citrusframework/citrus-core)\n[![Licensed under Apache License version 2.0](https://img.shields.io/github/license/openshift/origin.svg?maxAge=2592000)](https://www.apache.org/licenses/LICENSE-2.0\")\n[![Chat on Zulip](https://img.shields.io/badge/zulip-join_chat-brightgreen.svg)](https://citrusframework.zulipchat.com)\n\nWelcome to Citrus\n---------\n\nCitrus is a test framework written in Java that provides a complete test automation tool for integration testing of message-based enterprise applications. \n\nThe framework supports a huge set of different message transports and protocols like Http REST, Kafka, JMS, TCP/IP, FTP, SOAP Web Services.\n\nIn addition to that Citrus integrates with many technologies and libraries such as Apache Camel, Spring, Quarkus, Testcontainers, Kubernetes, Knative, Selenium and many more.\n\nFor validation purpose Citrus is able to verify many different message data formats and protocols such as XML, Json, YAML, CSV, Plaintext, SQL ResultSet and more.\n\nVisit the official website at 'https://citrusframework.org'\nfor more information and a detailed documentation.\n \nQuickstart\n---------\n\nLearn how to create and run Citrus integration tests in just a few minutes. You can choose from a set of supported runtimes (JUnit, TestNG, Quarkus, SpringBoot, JBang) and domain specific languages (Java, XML, YAML, Groovy, Cucumber).\n\nFor a full guide how to get started with Citrus please visit the [quickstart section](https://citrusframework.org/quickstart/) on the official website.\n\nThe easiest way to create and run a Citrus test without a project setup is to use the Citrus JBang support.\n\nYou can just call this command to create a new test.\n\n```shell\njbang citrus@citrusframework/citrus init MyTest.java\n```\n\nThe `init` command creates a new file that represents a Citrus test. The file extension used defines the test source language. You can choose one of the supported test source languages `.java`, `.xml`, `.yaml`, `.groovy`, `.feature`.\n\nThe result looks like this:\n\n```java\nimport org.citrusframework.TestActionSupport;\nimport org.citrusframework.TestCaseRunner;\nimport org.citrusframework.annotations.CitrusResource;\n\npublic class MyTest implements Runnable, TestActionSupport {\n\n    @CitrusResource\n    TestCaseRunner t;\n\n    @Override\n    public void run() {\n        t.given(\n            createVariables().variable(\"message\", \"Citrus rocks!\")\n        );\n\n        t.then(\n            echo().message(\"${message}\")\n        );\n    }\n}\n```\n\nYou can now just run the test without any project setup using the Citrus JBang run command:\n\n```shell\njbang citrus@citrusframework/citrus run MyTest.java\n```\n\nYou may also install the Citrus JBang app to simplify the command line tooling:\n\n```shell\njbang trust add https://github.com/citrusframework/citrus/\njbang app install citrus@citrusframework/citrus\n```\n\nNow you can just call:\n\n```shell\ncitrus init my-test.yaml\ncitrus run my-test.yaml\n```\n\nA more complex Citrus integration test typically uses messaging endpoints to send and receive messages with different messaging transports. \n\nA typical Citrus Java JUnit Jupiter test may look like this:\n\n```java\nimport org.citrusframework.TestCaseRunner;\nimport org.citrusframework.TestActionSupport;\nimport org.citrusframework.annotations.CitrusResource;\nimport org.citrusframework.annotations.CitrusTest;\nimport org.citrusframework.junit.jupiter.CitrusSupport;\nimport org.junit.jupiter.api.Test;\n\n@CitrusSupport\npublic class HelloServiceIT implements TestActionSupport {\n\n    @CitrusResource\n    private TestCaseRunner t;\n\n    @Test\n    @CitrusTest\n    public void shouldSayHello() {\n        t.when(\n            http().client(\"http://localhost:8080/test\")\n                    .send()\n                    .post()\n                    .contentType(\"text/plain\")\n                    .body(\"Hello from Citrus!\")\n        );\n\n        t.then(\n            receive().endpoint(\"kafka:my-topic\")\n                    .message()\n                    .body(\"Hello from Citrus!\")\n        );\n\n        t.and(\n            http().client(\"http://localhost:8080/test\")\n                    .receive()\n                    .response(HttpStatus.OK));\n    }\n}\n```\n\nAs you can see the test leverages several Citrus features like sending/receiving messages with different message transports. Receiving a message always comes with an expected message content, so Citrus performs a powerful message validation on body and header content. Citrus is able to handle different message types such as XML, Json, Plaintext, YAML, CSV and more.\n\nYou can easily integrate the test into your project with Maven, or you can just run the test without any project setup with JBang.\n\n```shell\ncitrus run HelloServiceIT.java\n```\n\nDeveloping\n---------\n\nThe following software is recommended in order to code with the\nCitrus framework:\n\n* Java 17+\n  Installed JDK plus JAVA_HOME environment variable set\n  up and pointing to your Java installation directory. Used to compile and build the Citrus code.\n\n* Maven 3.9.8+\n  Citrus projects will fit best with [Maven](https://maven.apache.org).\n  However, it is not required to use Maven. You can also run tests using [Gradle](https://gradle.org/) for instance.\n\n* Java IDE (optional)\n  A Java IDE will help you to manage your Citrus project (e.g. creating\n  and executing test cases). You can use the Java IDE that you like best like Eclipse or IntelliJ IDEA.\n\n* [JBang](https://jbang.dev) (optional)\n  For fast prototyping you can use the Citrus JBang app as a command line tooling. It allows you to create and run Citrus tests without a project setup. Dependencies and Java runtime setup is automatically managed by JBang. \n\nSamples\n---------\n\nOur sample section is still growing. \nYou can find several sample projects in the separate repository [citrusframework/citrus-samples](https://github.com/citrusframework/citrus-samples). \n\nSupport\n---------\n\nIn case you need help and support for Citrus have a look at\n[https://citrusframework.org/help](https://citrusframework.org/help).\nContact `citrus-dev@googlegroups.com` directly for any request or questions.\n\nIssues\n---------\n\nPlease report any bugs and/or feature requests directly to\n[citrusframework/citrus/issues](https://github.com/citrusframework/citrus/issues)\n\nResources\n---------\n\n* Clone the code repository [https://github.com/citrusframework/citrus.git](https://github.com/citrusframework/citrus.git) with Git to run the Maven build on your machine to get a fresh copy of the latest bits.\n\n* Find our [blog and news articles](https://citrusframework.org/news) about Citrus and checkout the various post categories for selecting a specific topic.\n\n* The official website [https://citrusframework.org](https://citrusframework.org) offers tutorials and more information about Citrus.\n\n* Review the individual [release notes](https://citrusframework.org/docs/history/) to learn about the changes for a release. For detailed description of changed packages and classes do also consult the GitHub commit history.\n\nLicense\n---------\n\nCopyright 2006-2025 the original author or authors.\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n  http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n\nInformation\n---------\n\nFor more information on Citrus see [citrusframework.org][2], including\na complete [reference manual][3].\n\n [1]: https://citrusframework.org/img/brand-logo.png \"Citrus\"\n [2]: https://citrusframework.org\n [3]: https://citrusframework.org/citrus/reference/html/index.html\n","funding_links":[],"categories":["测试"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcitrusframework%2Fcitrus","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcitrusframework%2Fcitrus","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcitrusframework%2Fcitrus/lists"}