{"id":24370077,"url":"https://github.com/unikraft/app-testing","last_synced_at":"2025-07-07T13:35:50.396Z","repository":{"id":196394053,"uuid":"696006626","full_name":"unikraft/app-testing","owner":"unikraft","description":"Add tests of various applications and libraries running on top of Unikraft","archived":false,"fork":false,"pushed_at":"2023-10-21T14:12:58.000Z","size":9,"stargazers_count":0,"open_issues_count":4,"forks_count":7,"subscribers_count":5,"default_branch":"staging","last_synced_at":"2025-06-03T14:51:47.960Z","etag":null,"topics":["application","integration-testing","testing","unikraft-application"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/unikraft.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2023-09-24T21:26:22.000Z","updated_at":"2023-10-02T11:51:33.000Z","dependencies_parsed_at":"2024-02-02T09:03:36.207Z","dependency_job_id":"98639e33-5ae9-4792-836f-370b39d66781","html_url":"https://github.com/unikraft/app-testing","commit_stats":null,"previous_names":["unikraft/app-testing"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/unikraft/app-testing","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unikraft%2Fapp-testing","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unikraft%2Fapp-testing/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unikraft%2Fapp-testing/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unikraft%2Fapp-testing/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/unikraft","download_url":"https://codeload.github.com/unikraft/app-testing/tar.gz/refs/heads/staging","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unikraft%2Fapp-testing/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264086665,"owners_count":23555375,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["application","integration-testing","testing","unikraft-application"],"created_at":"2025-01-19T04:12:29.289Z","updated_at":"2025-07-07T13:35:50.326Z","avatar_url":"https://github.com/unikraft.png","language":"Python","readme":"# Unikraft Application Tests\n\nAdd tests of various applications and libraries running on top of Unikraft.\n\n## Use an Application Test\n\nEnter the application directory and then run the `scripts/setup.sh` script.\nFor example, for C helloworld, run the commands:\n\n```console\ncd lang/c/helloworld/\n../../../scripts/setup.sh\n```\n\nThe setup script clones required repositories and generates the `Makefile` file.\n\nConfigure the application:\n\n```console\nmake menuconfig\n```\n\nBuild the application:\n\n```console\nmake prepare\nmake -j $(nproc)\n```\n\nRun the application using the corresponding command, depending on your hypervisor and VMM (i.e. `qemu-system-x86_64`, `firecracker`).\n\n## Add a New Application Test\n\nNew application tests will get their own directories, similar to the [helloworld C](https://github.com/unikraft/app-testing/tree/master/lang/c/helloworld) or [helloworld C++](https://github.com/unikraft/app-testing/tree/master/lang/cpp/helloworld) applications.\n\nSteps to be done are:\n\n1. Create the new application directory.\n\n1. Inside the new application directory, add source code files and the `Makefile.uk` file that uses the source code files for the build.\n\n1. Fill the `libs.txt` with the [depending Unikraft libraries](https://github.com/unikraft/TODO).\n   Add one library per-line, **without** the `lib-` prefix for the repository name.\n   That is, for the [`lib-libcxx` repository](https://github.com/unikraft/lib-libcxx), add `libcxx`;\n   for the [`lib-musl` repository](https://github.com/unikraft/lib-musl) add `musl`;\n   for the [`lib-openssl` repository](https://github.com/unikraft/lib-openssl) add `openssl`.\n\nThis is it, you can now commit your changes to the [`app-testing` repository](https://github.com/unikraft/app-testing).\n\nNow, to test it, follow the steps also mentioned above:\n\n1. Inside the app directory, run the `scripts/setup.sh` script.\n   Be sure to provide the proper path to the script;\n   depending on your app directory, this may be something like `../../../scripts/setup.sh` or `../../scripts/setup.sh` or `../scripts/setup.sh`.\n\n   The `scripts/setup.sh` script will create the `workdir/` directory with all the repository clones (the [`unikraft` repository](https://github.com/unikraft/unikraft) and [required library repositories](https://github.com/unikraft/)).\n   It will also create the `Makefile` file used for configuring and building the application.\n\n1. Configure the application with `make menuconfig`.\n\n1. Build the application with `make prepare` and `make -j $(nproc)`.\n\n1. Run the application with the corresponding run command.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Funikraft%2Fapp-testing","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Funikraft%2Fapp-testing","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Funikraft%2Fapp-testing/lists"}