{"id":19362719,"url":"https://github.com/smartdevicelink/sdl_atf_test_scripts","last_synced_at":"2025-04-23T12:33:13.693Z","repository":{"id":38075106,"uuid":"53459525","full_name":"smartdevicelink/sdl_atf_test_scripts","owner":"smartdevicelink","description":"Test scripts for sdl_atf","archived":false,"fork":false,"pushed_at":"2022-10-31T18:47:55.000Z","size":36344,"stargazers_count":2,"open_issues_count":18,"forks_count":60,"subscribers_count":17,"default_branch":"master","last_synced_at":"2025-04-02T15:21:19.319Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Lua","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/smartdevicelink.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-03-09T01:53:02.000Z","updated_at":"2021-11-06T08:04:19.000Z","dependencies_parsed_at":"2023-01-19T14:01:25.881Z","dependency_job_id":null,"html_url":"https://github.com/smartdevicelink/sdl_atf_test_scripts","commit_stats":null,"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smartdevicelink%2Fsdl_atf_test_scripts","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smartdevicelink%2Fsdl_atf_test_scripts/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smartdevicelink%2Fsdl_atf_test_scripts/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smartdevicelink%2Fsdl_atf_test_scripts/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/smartdevicelink","download_url":"https://codeload.github.com/smartdevicelink/sdl_atf_test_scripts/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250435279,"owners_count":21430252,"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":[],"created_at":"2024-11-10T07:30:03.190Z","updated_at":"2025-04-23T12:33:08.680Z","avatar_url":"https://github.com/smartdevicelink.png","language":"Lua","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Build Status](https://travis-ci.org/smartdevicelink/sdl_atf_test_scripts.svg?branch=master)](https://travis-ci.org/smartdevicelink/sdl_atf_test_scripts)\n\n# Automated Test Framework (ATF) scripts\nThis repository contains ATF scripts and data to run it.\n\n## Coverage\n|Functionality    |Status    |Notes    |\n|:---|:---|:---|\n|Smoke Test    | 100%   | Common mobile APIs check   |\n|Mobile API Protocol    | 95%   |    |\n|HMI API    |  5% |    |\n|App Resumption    | 10%   |    |\n|SDL 4.0    | 100%   |    |\n|UTF-8 Check    | 100%   |    |\n|Safety feature active    | 100%   |    |\n|Audio/Video Streaming    | 20%   | Planned   |\n|Policies    | Not Covered   | Planned   |\n|Heartbeat    | Not Covered   | Needs new ATF functionality   |\n|SecurityService    | Not Covered   | Needs new ATF functionality   |\n|Start/End Service    |  Not Covered  | Planned   |\n|Transport    | Not Covered   |    |\n\n## Manual usage:\n\n* [Setup SDL](https://github.com/smartdevicelink/sdl_core).\n  * Later the SDL sources destination directory is referenced as `\u003csdl_core\u003e`\n* [Setup ATF](https://github.com/smartdevicelink/sdl_atf).\n  * Later the ATF sources destination directory is referenced as `\u003csdl_atf\u003e`\n  * Later the ATF build destination directory is referenced as `\u003catf_build\u003e`\n* Clone [sdl_atf_test_scripts](https://github.com/smartdevicelink/sdl_atf)\n  * Later the atf test scripts destination directory is referenced as `\u003csdl_atf_test_scripts\u003e`\n\n  ```bash\n  git clone https://github.com/smartdevicelink/sdl_atf_test_scripts \u003csdl_atf_test_scripts\u003e\n  ```\n\n* Create symlinks in the build `bin` directory to certain directories in `\u003csdl_atf_test_scripts\u003e`:\n\n  ```bash\n  cd \u003catf_build\u003e/bin\n  ln -s \u003csdl_atf_test_scripts\u003e/files\n  ln -s \u003csdl_atf_test_scripts\u003e/test_sets\n  ln -s \u003csdl_atf_test_scripts\u003e/test_scripts\n  ln -s \u003csdl_atf_test_scripts\u003e/user_modules\n  ```\n\n* In your `\u003csdl_atf\u003e/modules/configuration/base_config.lua`\n  * Include the path to your local SDL Core binary (ex. `\u003csdl_build\u003e/bin/`):\n  ```lua\n  --- Define path to SDL binary\n  -- Example: \"/home/user/sdl_build/bin\"\n  config.pathToSDL = \"/home/user/sdl_build/bin\"\n  ```\n\n  * Include the path to your local SDL Core Source directory (ex. `\u003csdl_core\u003e/`):\n  ```lua\n  --- Define path to SDL source\n  -- Example: \"/home/user/sdl_core\"\n  config.pathToSDLSource = \"\u003csdl_core\u003e\"\n  ```\n  ATF will use the provided path to derive the location of the MOBILE_API.xml and HMI_API.xml files within the directory.\n\n  * Instead of including the path to your local SDL Core Source directory, you can alternatively include the paths to your local directories containing the HMI_API and MOBILE_API files:\n\n  ```lua\n  --- Define path to SDL MOBILE interface\n  -- Example: \"/home/user/sdl_core/tools/rpc_spec\"\n  config.pathToSDLMobileInterface = \"/home/user/sdl_core/tools/rpc_spec\"\n  --- Define path to SDL HMI interface\n  -- Example: \"/home/user/sdl_core/src/components/interfaces\"\n  config.pathToSDLHMIInterface = \"/home/user/sdl_core/src/components/interfaces\"\n  ```\n  **NOTE:** If both `pathToSDLSource` and `pathToSDLMobileInterface`/`pathToSDLHMIInterface` are defined in the config file, the paths provided in `pathToSDLMobileInterface`/`pathToSDLHMIInterface` will override the paths derived from `pathToSDLSource`.\n\n\n* Run ATF.\n\n _Mandatory options:_\n  * Pass path to test script as first command line parameter\n  ```\n  cd \u003catf_build\u003e/bin\n  ./start.sh ./test_scripts/Smoke/API/021_Speak_PositiveCase_SUCCESS.lua\n  ```\n\nYou can get additional help of usage ATF:\n```\n./start.sh --help\n```\n\n#### Known Issues\n- Some test cases are failed due to known SDL issues. List of failed test cases available in KnownIssues.md\n- For testing different application types (NAVI, MEDIA, etc...) you need to modify your ```\u003csdl_atf\u003e/modules/config.lua``` after *prepare* step \n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsmartdevicelink%2Fsdl_atf_test_scripts","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsmartdevicelink%2Fsdl_atf_test_scripts","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsmartdevicelink%2Fsdl_atf_test_scripts/lists"}