Skip to content

mahdi/pokespeare

Repository files navigation

Pokespeare API v1.0

Docker Cloud Automated build Docker Cloud Build Status

This is a simple REST API written in .NET 5 / ASP.NET WebAPI. It translates a Pokemon description (by getting its name) into its Shakespearean description!

Build

You need to have Docker installed on your machine to build and run the container.

Build the image first:

docker build -t pokespeare .

Run

And, run it:

docker run --rm -p 5000:80 --name pokespeare pokespeare

Now the application is running at http://localhost:5000; to call the API method send a GET request to http://localhost:5000/pokemon/charizard

API Documentation

Swagger API docs are available at https://localhost:5001/swagger if you run the app without docker over HTTPS (docker run); I skipped explanations for HTTPs over docker as it's different on Windows and Linux and depends on various factors that are out of scope of purpose of this challenge.

Tests

Unit tests are available under tests\Pokespeare.Api.Tests; to run the tests using .NET CLI:

dotnet restore
dotnet build
dotnet test

Known Issues

  • Automatic image builds in Docker Hub is not working
  • Automatic "Open Issues" listing here is not working in GitHub Actions.
  • CodeQL code analysis is not working in GitHub Actions.
  • HTTPS over Docker.

About

This is a simple REST API written in .NET 5 / ASP.NET WebAPI. It translates a Pokemon description (by getting its name) into its Shakespearean description!

Resources

License

Stars

Watchers

Forks

Packages

No packages published