API Clients: Publishing packages for multiple languages

View original Gist on GitHub

Tags: #publish #package #ruby #php #python #go #js #javascript #rust #api #clients

Publishing packages for multiple languages.md

Manual release process

The following steps describe the manual steps to take so you can publish a specific Fastly API client.

fastly-go

• Clone https://github.com/fastly/fastly-go
• Run tag="v1.0.0-beta.0" && git tag -s $tag -m $tag && git push origin $tag
• Create a new ‘release’ https://github.com/fastly/fastly-go/releases
• Check https://pkg.go.dev/github.com/fastly/fastly-go for latest release

fastly-js

• Clone https://github.com/fastly/fastly-js
• Run tag="v3.0.0" && git tag -s $tag -m $tag && git push origin $tag
• Run npm login and follow instructions
• Run npm publish --dry-run and check there are no errors
• Run npm publish to publish the module to https://www.npmjs.com/package/fastly

Reference: https://docs.npmjs.com/cli/v9/commands/npm-publish

fastly-perl

…

fastly-php

• Clone https://github.com/fastly/fastly-php
• Run tag="v1.0.0" && git tag -s $tag -m $tag && git push origin $tag
• Create a new ‘release’ https://github.com/fastly/fastly-php/releases
• Check https://packagist.org/packages/fastly/fastly for latest release

fastly-py

• Clone https://github.com/fastly/fastly-py
• Run tag="v1.0.0" && git tag -s $tag -m $tag && git push origin $tag
• Run python3 -m pip install --upgrade build && python3 -m build to build the package
• Run python3 -m pip install --upgrade twine && python3 -m twine upload --repository pypi dist/* to publish the package to https://pypi.org/project/fastly/

Reference: https://packaging.python.org/en/latest/tutorials/packaging-projects/

fastly-ruby

• Clone https://github.com/fastly/fastly-ruby
• Run tag="v4.0.0" && git tag -s $tag -m $tag && git push origin $tag
• Create a new ‘release’ https://github.com/fastly/fastly-ruby/releases
• Run gem build fastly.gemspec
• Run gem push fastly-4.0.0.gem

fastly-rust

• Clone https://github.com/fastly/fastly-rust
• Run cargo login and following instructions
• Run cargo publish --dry-run and check there are no errors
• Run cargo publish to publish the crate to https://crates.io/crates/fastly-api

Reference: https://doc.rust-lang.org/cargo/reference/publishing.html