You can read more in the following blog posts:

• Introducing BlackSlope: A DotNet Core Reference Architecture from Slalom Build
• BlackSlope: A Deeper Look at the Components of our DotNet Reference Architecture
• BlackSlope in Action: A Guide to Using our DotNet Reference Architecture

Install the latest verison of .NET Core for Windows/Linux or Mac.

• https://dotnet.microsoft.com/download

dotnet build src/BlackSlope.NET.sln

1. Install SQL Server Developer 2019

   https://www.microsoft.com/en-us/sql-server/sql-server-downloads

2. Update connection string server name and credentials in appsettings.json

   MoviesConnectionString
   

3. Create a SQL Database for "movies" either manually through a GUI of your choice or CLI tool
   • SSMS
   • mssql-cli
4. Open PowerShell and install the dotnet-ef tool using:

   dotnet tool install --global dotnet-ef
   

5. Navigate Powershell to your repository root directory and run the following command:

   dotnet ef database update --project=.\src\BlackSlope.Api\BlackSlope.Api.csproj
   

6. If successful, the result of the above command will be similar to the following example:

   Build started...
   Build succeeded.
   Applying migration '20190814225754_initialized'.
   Applying migration '20190814225910_seeded'.
   Done.
   

dotnet run --project src/BlackSlope.Api/BlackSlope.Api.csproj

1. Install Docker Desktop
2. Build the application under the /src directory
3. Build the docker image in the CLI under the /src directory:

   docker build -t blackslope.api -f Dockerfile .
   

4. Verify the new blackslope.api image exists in local docker repo with

   docker images
   

5. Create a container for the blackslope.api image

   docker create --name blackslope-container blackslope.api
   

6. Spin the container for the blackslope image up

   docker start blackslope-container
   

7. Visual inspection of the Docker Desktop app should show your image running in the container locally

dotnet test ./src/

NOTE: Per 6.x, these projects have been removed from the Solution until SpecFlow adds support for the latest version of .NET 6 Intended for use by Quality Engineers (QE), Blackslope provides two SpecFlow driven Integration Test projects for consumption:

• BlackSlope.Api.Tests.IntegrationTests
  • using a System.Net.Http.HttpClient implementation
• BlackSlope.Api.Tests.RestSharpIntegrationTests
  • using a RestSharp HttpClient implementation

These can be executed in Test Explorer much like regular Unit Tests, and it is up to your team to choose which implementation best suits your project.

To Setup:

1. Ensure you've successfully run the Build DB and Build Application steps above.
2. Update the appsettings.test.json file in your Integration Test project with the proper DB connection string and Host URL for the BlackSlope API
   • NOTE: The Blackslope API can be run on a localhost configuration if desired, but needs to be done so in a separate instance of your IDE to allow tests to run
3. Download the appropriate SpecFlow plugins for your IDE

Open your browser and navigate to http://localhost:51385/swagger to view the API documentation

BlackSlope.Api supports configuring Polly policies for outgoing HTTP requests. An example of this configuration can be seen in the sample FakeApiRepository

See the following articles for implementation details:

• Using HttpClientFactory to Implement Resilient HTTP Requests
• Polly and HttpClientFactory

Blackslope makes use of two different analyzers to keep the codebase clean and formatted.

1. StyleCop - for style formatting and code cleanliness
   • Consumes stylecop.json files at the project level
   • May be set as part of .editorconfig, but documentation is sparse and not recommended at this time
2. Microsoft.CodeAnalysis.NetAnalyzers - Nuget package for the IDE level; covers style formatting and code analysis issues.
   • Consumes .editorconfig files set at the solution or project level

NOTE: SA and CA rules are globally suppressed at BlackSlope.Api.Common.GlobalSuppressions

• CodeAnalysis FAQ
• When to Use NetAnalyzers?
• .editorconfig Configuration
• stylecop.json Configuration

StyleCop
The following rules are currently ignored:

CodeAnalysis
The following rules are currently ignored: