{"id":18349140,"url":"https://github.com/fonoster/seet","last_synced_at":"2025-04-06T09:31:58.045Z","repository":{"id":61629797,"uuid":"192129554","full_name":"fonoster/seet","owner":"fonoster","description":"SEET: Orchestrating multiple user-agents for complex SIP testing scenarios.","archived":false,"fork":false,"pushed_at":"2024-09-12T00:56:53.000Z","size":3083,"stargazers_count":21,"open_issues_count":2,"forks_count":0,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-03-21T21:22:35.658Z","etag":null,"topics":["sip","testing","voip"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/fonoster.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2019-06-15T22:37:38.000Z","updated_at":"2025-02-20T01:38:36.000Z","dependencies_parsed_at":"2023-07-18T16:02:23.642Z","dependency_job_id":null,"html_url":"https://github.com/fonoster/seet","commit_stats":{"total_commits":196,"total_committers":4,"mean_commits":49.0,"dds":"0.36734693877551017","last_synced_commit":"2ffb9d2129567ca87bce5e7af95971f0201609d2"},"previous_names":["psanders/seet"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fonoster%2Fseet","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fonoster%2Fseet/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fonoster%2Fseet/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fonoster%2Fseet/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fonoster","download_url":"https://codeload.github.com/fonoster/seet/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247463745,"owners_count":20942935,"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":["sip","testing","voip"],"created_at":"2024-11-05T21:20:45.255Z","updated_at":"2025-04-06T09:31:57.668Z","avatar_url":"https://github.com/fonoster.png","language":"TypeScript","funding_links":[],"categories":["Testing"],"sub_categories":["GPS, Time"],"readme":"# SIP End-to-End Testing\n\n[![publish to docker hub](https://github.com/fonoster/seet/actions/workflows/gh-docker.yml/badge.svg)](https://github.com/fonoster/seet/actions/workflows/gh-docker.yml)\n\n\u003cimg src=\"test_example.png\" /\u003e\n\nSEET is a suite for end-to-end testing of SIP deployments. We aim to add useful artifacts to help test and troubleshoot any SIP device or software. SEET is inspired in [pysipp](https://github.com/SIPp/pysipp).\n\nIt lets you run complex scenarios involving multiple UASs and UACs. With SEET, you create your SIPp XML scenarios as usual and the suite creates the necesary User Agents and ensure the scenarios run in the correct sequence.\n\n## Scenario configuration\n\n| Property                                | Description                                                       | Required |\n| --------------------------------------- | ----------------------------------------------------------------- | -------- |\n| name                                    | The name of the scenario                                          | Yes      |\n| description                             | The description of the scenario                                   | No       |\n| target                                  | System under test                                                 | No       |\n| transportMode                           | SIPp transport mode. Check [here](https://github.com/SIPp/sipp/blob/v3.6.1/docs/transport.rst) for possible values               | Yes      |\n| domain                                  | Needed for registration. Defaults to `target`                     | No       |\n| enabled                                 | Enables scenario. Defauls to `true`                               | No       |\n| only                                    | Exclude all other scenarios. Defauls to `false`                   | No       |\n| userAgents.[*].mode                     | User Agent mode. Possible values are `uac` and `uas`              | Yes      |\n| userAgents.[*].port                     | Port to bind the User Agent                                       | No       |\n| userAgents.[*].scenarioFile             | Path to the SIPp XML scenario                                     | Yes      |\n| userAgents.[*].authentication           | Username and password for SIP authentication                      | No       |\n| userAgents.[*].sendRegister             | Used for User Agent registration                                  | No       |\n| userAgents.[*].sessionCount             | Optional Session Count sent during registration. Defaults to `0`  | No       |\n| userAgents.[*].expires                  | Expiration in seconds use in for `sendRegister`. Defaults to `30` | No       |\n| userAgents.[*].timeout                  | Maximum duration in seconds for the scenario                      | No       |\n| userAgents.[*].variables                | Key-value array for SIPp XML scenario                             | No       |\n| userAgents.[*].maxIterations            | Maximum number of iterations for the scenario (Experimental)      | No       |\n| userAgents.[*].maxRate                  | Maximun rate of calls per second for the scenario (Experimental)  | No       |\n| userAgents.[*].callLimit                | Maximum simultaneous calls for the scenario (Experimental)        | No       |\n\n**Example of scenario file**\n\n```json\n[\n  {\n    \"name\": \"Simple SIP Message\",\n    \"description\": \"UAC sends a simple MESSAGE to UAS and waits for an OK response\",\n    \"target\": \"192.168.1.3\",\n    \"transportMode\": \"u1\",\n    \"domain\": \"sip.local\",\n    \"userAgents\": [\n      {\n        \"mode\": \"uas\",\n        \"scenarioFile\": \"scenarios/ims_uas.xml\",\n        \"authentication\": {\n          \"username\": \"1001\",\n          \"secret\": \"1234\"\n        },\n        \"sendRegister\": true,\n        \"expires\": 30\n      },\n      {\n        \"mode\": \"uac\",\n        \"scenarioFile\": \"scenarios/ims_uac.xml\",\n        \"authentication\": {\n          \"username\": \"1002\",\n          \"secret\": \"1234\"\n        },\n        \"variables\": [\n          {\n            \"name\": \"requestURI\",\n            \"value\": \"1001@sip.local\"\n          },\n          {\n            \"name\": \"from\",\n            \"value\": \"1002@sip.local\"\n          },\n          {\n            \"name\": \"to\",\n            \"value\": \"1001@sip.local\"\n          }\n        ]\n      }\n    ],\n    \"enabled\": true\n  }\n]\n```\n\n## Available Versions\n\nYou can see all images available to pull from Docker Hub via the [Tags](https://hub.docker.com/repository/docker/fonoster/seet) page. Docker tag names that begin with a \"change type\" word, such as task, bug, or feature, are available for testing and may be removed at any time.\n\n## Installation\n\nYou can clone this repository and manually build it.\n\n```\ngit clone https://github.com/fonoster/seet\ncd seet\ndocker build -t fonoster/seet:%%VERSION%% .\n```\n\nOtherwise, you can pull this image from the docker index.\n\n```\ndocker pull fonoster/seet:%%VERSION%%\n```\n\n## Usage Example\n\nThe following is a basic example of using this image. Be sure to add the port of every User Agent Server. If you use an udp mode in your scenario (e.g. `u1`), you must also bind the port in docker with the corresponding notation.\n\n```\ndocker run \\\n  -v $(pwd)/seet.json:/seet.json \\\n  -v $(pwd)/scenarios:/scenarios \\\n  -p 7060:7060/udp \\\n  -t fonoster/seet \n```\n\nor with NodeJS\n\n```\n# Requires of sipp 3.6.0-r2 installed in the host\nnpm i -g @fonoster/seet\nSCENARIOS=$(pwd)/seet_example.json seet\n```\n\n## Environment Variables\n\nEnvironment variables are used in the entry point script to render configuration templates. You can specify the values of these variables during `docker run`, `docker-compose up`, or in Kubernetes manifests in the `env` array.\n\n- `SCENARIOS` - Changes the default path to the scenario file.\n\n## Exposed ports\n\nNone\n\n## Volumes\n\n- `/scenarios` - Location for your SIPp `XML` files\n- `/seet.json` - Default location for your scenarios file\n\n## Contributing\n\nPlease read [CONTRIBUTING.md](https://github.com/fonoster/fonoster/blob/master/CONTRIBUTING.md) for details on our code of conduct and the process for submitting pull requests to us.\n\n## Authors\n\n- [Pedro Sanders](https://github.com/psanders)\n\nSee this project's list of contributors who [participated](https://github.com/fonoster/seet/contributors).\n\n## License\n\nCopyright (C) 2023 by Fonoster Inc. MIT License (see [LICENSE](https://github.com/fonoster/fonoster/blob/master/LICENSE) for details).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffonoster%2Fseet","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffonoster%2Fseet","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffonoster%2Fseet/lists"}