Sail-On Client and Protocols

Client and Protocols for DARPA sail-on

Protocols present in the repository

OND
CONDDA

Requirements

Installation

Install Poetry following the instructions available in the installation page
Clone the repositories associated with different components in a working directory
```
  git clone https://github.com/darpa-sail-on/sail-on-client.git
```
This would create sail-on-client directories in your working directory
Install the different components in a virtual environment
```
 cd sail-on-client
 poetry install
 poetry shell
```

Running Client and Server with Different Algorithms

Note: If you are using the server setup by PAR, update the url to http://3.32.8.161:5000 in sail_on_client/protocol/configuration.json and skip step 1 of running the server.

Publishing on PYPI

sail-on-client uses github actions to publish packages on pypi. The action is triggered when a semver tag is pushed to the repository.

We support the following version format .. and ..-alpha. for tags. To publish a package on pypi, the tag must match with the version maintained in pyproject.toml. This is implemented as a mandatory check in the workflow. Poetry provides support for both querying and bumping version via cli. Please refer to version for more details.

Thus to publish sail-on-client on pypi use the following commands

Bump the version in pyproject.toml using poetry version <version_rule>.
Use poetry version --short to determine the version that would be used in the tag.

Generate and push the tag using

 git tag <package-version>
 git push origin --tags

Acknowledgement of Support and Disclaimer

This material is based upon work supported by the Defense Advanced Research Projects Agency (DARPA) under Contract No. HR001120C0055. Any opinions, findings and conclusions or recommendations expressed in this material are those of the author(s) and do not necessarily reflect the views of the DARPA.

darpa-sail-on / sail-on-client