Repository files navigation

All SDKs provided in this repository are generated using openapi-generator.

To publish the SDK Builder Docker Image, create a new GitHub release with thedesired version.

You may also manually build and publish this image using:

docker build -t oryd/sdk:latest.docker tag oryd/sdk:latest oryd/sdk:v0.0.34docker push oryd/sdk:v0.0.34

If you wish to debug some generators or build steps, you can run the image locally:

$ docker run --mount type=bind,source="$(pwd)",target=/sdk --name sdk -it oryd/sdk:v0.0.42 /bin/sh$cd sdk$ ./scripts/generate.sh$ ...

Place the spec inspec/<project>/<version>.json (e.g.spec/hydra/v0.0.0-alpha.1.json) and create a commit that references both theproject and the versiongit commit -a -m "Add spec for <project>:<version>"(e.g.git commit -a -m "Add spec for hydra:v0.0.0-alpha.1").

Do not create multiple commits adding several specs in one PR, as only thelatest commit will be checked when it lands on master.

Because this is an automated process, it is highly recommended to add, commit,and push the spec file directly to master in one go!

You can create a PR if you're making changes to the build chain.

Upgrading OpenAPI Generator versions requires careful upgrading of the Javapom.xml. The file might contain new versions for dependencies, but ifoverwritten, will not work with the release pipeline.

Therefore, the pom.xml file is being always overwritten from the contrib/pomsdirectory for each project. To update any dependencies, the changes must thus bemade there. We recommend running the openapi generator manually on the localmachine and diffing the changes with contents in contrib/poms.

Install PHP andcomposer. Then, run the install commandto initialize everything:

export PROJECT=hydracd clients/${PROJECT}/phpcomposer install

Then, push the directory to a git remote of your choosing and also publish thetag you want to release the package as. You can take a look at./scripts/publish.sh to understand how to accomplishthat.

First, install all the necessary tools and python3:

python3 -m pip install --user --upgrade setuptools wheel twine

Next, create a PyPi account andAPI Tokenand set the env vars to:

export TWINE_USERNAME=__token__export TWINE_PASSWORD=<token>

Then, publish the project (and set the project name):

export PROJECT=hydracd clients/${PROJECT}/pythonpython3 setup.py sdist bdist_wheelpython3 -m twine upload dist/*

YOu need to setGEM_HOST_API_KEY

Due to abug in openapi-generatorthat appears in Java11+, please disable javadoc generation:

mvn<cmd> -Dmaven.javadoc.skip=true

You will also need a PGP keypair that is associated with one of the owners ofthesh.ory group and that is published on one of the public key servers. Formore details, see:https://dzone.com/articles/publish-your-artifacts-to-maven-central

mvn clean# THESE VALUES ARE EXAMPLES - PLEASE PICK THE APPROPRIATE `tag`, etcmvn -Dtag=client-0.0.1-alpha.1 release:update-version \  -DreleaseVersion=0.0.1-alpha.1 -DdevelopmentVersion=0.0.1-alpha.1-SNAPSHOT \  -Darguments="-Dmaven.javadoc.skip=true" -Dresume=falsemvn release:perform -Darguments="-Dmaven.javadoc.skip=true" -Dresume=false