Skip to content

GuilhermeStracini/apiclient-boilerplate-rs

Repository files navigation

API Client boilerplate template

💡 🏗️ A boilerplate API client template for Rust API client wrappers


About

This is a template repository that sets the basic code and infrastructure for a repository/solution in Rust to create an API client wrapper (sometimes known as SDK).


Instructions

Warning

The automated process listed below only works in a Windows environment. A Linux/MAC setup is on the way but currently is not supported, so it should be done manually

Automated process

  • Click on the green button USE THIS TEMPLATE
  • Give a name to your new project/repository
  • Clone your newly created repository to your machine
  • Execute/run the file initial-setup.bat or initial-setup.ps1 and follow the instructions on the prompt/terminal.

Manual process

  • Click on the green button USE THIS TEMPLATE
  • Give a name to your new project/repository
  • Clone your newly created repository to your machine
  • Delete this file (README.md) and rename README.template.md to README.md
  • Change the appveyor.yml with your tokens (use secure tokens) or use your preferred CI tool (Circle CI, GitHub Actions, Jenkins, Team City, Azure DevOps)
  • Change the package name in the Cargo.toml`.
  • Fix in the README.md the path of the badges. (change all {username}/{repo} tokens with your own data).
  • Add to README.md usage instructions of your client/SDK.
  • Update _config.yml with project details (github.io docs website)

License

Licensed under: MIT license (LICENSE or http://opensource.org/licenses/MIT).

This will also be your project's LICENSE, but you can change it to another one that suits your needs.