Skip to content

AdhamAwadhi/client-api-demo

Repository files navigation

API Client boilerplate template

💡 🏗️ A boilerplate API client template for .NET API client wrappers


About

This is a template repository that sets the basic code and infrastructure for a repository/solution in .NET C# 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 SolutionName.sln to your solution/project name.
  • Change project name (SolutionName.csproj, SolutionName.Tests.csproj, SolutionName.IntegrationTests.csproj) and namespace inside directories Src and Tests.
  • Change the package name in the SolutionName.csproj.
  • Change the main project reference in the tests project in files Tests/SolutionName.Tests.csproj and Tests/SolutionName.IntegrationTests.csproj
  • 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 be also the LICENSE of your API client wrapper / SDK, but you are free to change it for another that suits your needs.

About

No description, website, or topics provided.

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published