Hangman
A Hangman (the old classic guess-the-word game) gaming API written in C#
with ASP.NET core
framework. This project comes with the following extra features (besides the game itself) that are important for production-ready scenarios:
Serilog
logging configuration for sending logs to ElasticsearchElasticsearch
instance to receive log messagesSonarqube
configuration which contains anMSBuild
xml configuration for sonarqube along with the tools required to collect test coverage such ascoverlet.collector
Nuget package and arunsettings.xml
file to setup coverage file formats.
API demo: winning (guessing) the word without being hanged
API demo: losing a game (not guessing the word) by being hanged
Hangman architecture
This application's architecture uses layered-design that can roughly be divided into:
Controller layer
Application layer (use cases)
Business layer
Infra layer
This model is much simpler than other famous modelings approaches, such as Domain Driven Design, but that's not a problem! It's actually just a different architectural approach that is definitely effective for domains that are not so complex but, at the same time, require more than bare CRUD logic.
Hangman modeling (entities)
The presented entities were used to model the Hangman game problem.
Running the project
As this project contains a dockerized
application, it can be executed in development mode in two environments:
- locally via the
dotnet
command line tool; - inside docker containers via
docker-compose
;
1. Locally via dotnet command line tool
Running locally has the huge advantage of being ultra easy to invoke the application and its tests with debug. Due to the easy-to-debug feature , this it the recommended option.
Run the following commands on a terminal:
# the database and other services must be running and bound to the localhost's port
docker-compose up -d db
# start project on localhost
dotnet run --project ./Hangman/Hangman.csproj
2. In a docker container via docker-compose
Running with docker-compose
allows one to run without having dotnet SDK
or anything else installed on his machine.
The project is started with the watch option which rebuilds/reloads the container upon code changes. However, bear in mind that, as of now, debugging is not yet supported.
Run the following commands on a terminal:
docker-compose up app # brings up the app and its required services
Running tests
Again, this can be done in two environments:
- locally via the
dotnet
command line tool; - inside docker containers via
docker-compose
;
1. Locally via dotnet command line tool
Locally, they can be run with:
docker-compose up -d db
dotnet test
2. In a docker container via docker-compose
With a docker-compose
:
docker-compose -f docker-compose-tests.yml up
Project structure creation (so far)
# solution creation
dotnet new sln -n Hangman
dotnet sln list # shows no projects in the solution
# projects creation
dotnet new webapi -n Hangman
dotnet new xunit -n Tests
# projects wrapping inside the solution
dotnet sln add ./Hangman/Hangman.csproj # adds project to the solution
dotnet sln add ./Tests/Tests.csproj # adds project to the solution
Adding migrations
dotnet ef migrations add MigrationName --project ./Hangman/Hangman.csproj --context HangmanDbContext -v
Removing a migration (non-applied)
dotnet ef migrations remove # removes last applied migration
Applying migrations manually (done at runtime in this project)
dotnet ef database update --project ./Hangman/Hangman.csproj
Rolling back (reverting) to a specific migration (applied)
dotnet ef database update MigrationName --project ./Hangman/Hangman.csproj