README.md

netcore-ext

.NET core extensions

• API Documentation
• Sources Changelog

---

• Quickstart
• Unit tests
• How this project was built
• Documentation (github pages)
  • Build and view locally
  • Build and commit into docs branch

---

Quickstart

dotnet new console --use-program-main -n test
cd test
dotnet add package netcore-ext
dotnet run

• copy usings.ext.cs global usings to the source folder

• extension methods

using SearchAThing.Ext;

• toolkit methods

using static SearchAThing.Ext.Toolkit;

Unit tests

dotnet test

• to debug from vscode just run debug test from code lens balloon

How this project was built

mkdir netcore-ext
cd netcore-ext

mkdir -p examples src/ext

cd src

dotnet new classlib -n netcore-ext -f netstandard2.1 --langVersion 11
mv netcore-ext ext
cd ..

dotnet new xunit -n test
cd test
dotnet add reference ../ext/netcore-ext.csproj
# enable test coverage collectorx
# to view in vscode ( "Coverage Gutters" ext ) run `./test-coverage` then `C-S-p` Coverage Gutters: Watch
dotnet add package coverlet.collector
dotnet add package coverlet.msbuild
cd ..

cd ..
dotnet new sln
dotnet sln add src/ext src/test examples/example01
dotnet build
dotnet test

Documentation (github pages)

Configured through Settings/Pages on Branch docs ( path /docs ).

• while main branch exclude "docs" with .gitignore the docs branch doesn't

Build and view locally

./doc build
./doc serve
./doc view

Build and commit into docs branch

./doc commit