TCSystem — C# Utility Libraries

TCSystemCS is a collection of reusable .NET libraries for logging, image metadata, GPS data, SQLite metadata storage, threading, and general utilities. The repository also contains two command-line tools and NUnit test projects.

Projects

Libraries

Package	Purpose	NuGet
TCSystem.Util	General extension methods and equality/math helpers
TCSystem.Logging	Serilog-based logging facade
TCSystem.MetaData	Immutable image metadata models and JSON serialization
TCSystem.MetaDataDB	SQLite persistence for image metadata
TCSystem.Gps	Google Takeout location-history reader and lookup helpers
TCSystem.Thread	Worker-thread, semaphore, and async update helpers

Library projects target netstandard2.1, net8.0, and net10.0.

Tools

Project	Purpose	Target
TCSystem.Tools.DBConverter	Convert and validate a metadata database	net10.0
TCSystem.Tools.TakeoutReader	Import missing GPS coordinates from Google Takeout	net10.0

Unit Tests

Test project	Project under test
TCSystem.Gps.Tests	TCSystem.Gps
TCSystem.MetaData.Tests	TCSystem.MetaData
TCSystem.MetaDataDB.Tests	TCSystem.MetaDataDB
TCSystem.Thread.Tests	TCSystem.Thread
TCSystem.Util.Tests	TCSystem.Util

All test projects target both net8.0 and net10.0. There is currently no dedicated TCSystem.Logging.Tests project.

Dependency Overview

• TCSystem.Util has no external dependencies.
• TCSystem.Logging wraps Serilog and its configured sinks/enrichers.
• TCSystem.MetaData depends on TCSystem.Util and Newtonsoft.Json.
• TCSystem.Thread depends on TCSystem.Logging.
• TCSystem.Gps depends on TCSystem.MetaData and System.Text.Json.
• TCSystem.MetaDataDB depends on TCSystem.Logging, TCSystem.MetaData, TCSystem.Thread, Microsoft.Data.Sqlite, and the native SQLite bundle.
• The tools compose these libraries through project references.

Build from Source

All commands below are intended to run from the repository root.

Prerequisites

• .NET 10 SDK for C# 14, net10.0, and .slnx support.
• .NET 8 runtime as well as the .NET 10 runtime to execute the complete two-framework unit-test matrix.
• No additional workloads or external database server are required. SQLite is supplied through NuGet.

The repository does not pin an SDK with global.json. Confirm the selected SDK and installed runtimes with:

dotnet --version
dotnet --list-runtimes

Restore and Build the Complete Solution

dotnet restore TCSystem.slnx
dotnet build TCSystem.slnx --configuration Release --no-restore

The build compiles libraries for all three target frameworks, tools for net10.0, and tests for net8.0 and net10.0. Warnings are treated as errors. Compiled output is written below each project's bin/Release directory.

For an ordinary development build, omit --configuration Release (the default configuration is Debug):

dotnet build TCSystem.slnx

Run Unit Tests

Complete Test Matrix

After the Release build above:

dotnet test TCSystem.slnx --configuration Release --no-build --no-restore

This runs every test project for both net8.0 and net10.0. To let dotnet test restore and build automatically, use the shorter command:

dotnet test TCSystem.slnx --configuration Release

One Target Framework

Use this when validating one runtime or when the .NET 8 runtime is not installed:

dotnet test TCSystem.slnx --configuration Release --framework net10.0

The SonarCloud analysis workflow uses the equivalent net8.0 test run.

One Test Project

dotnet test Gps/Tests/TCSystem.Gps.Tests.csproj --configuration Release
dotnet test MetaData/Tests/TCSystem.MetaData.Tests.csproj --configuration Release
dotnet test MetaDataDB/Tests/TCSystem.MetaDataDB.Tests.csproj --configuration Release
dotnet test Thread/Tests/TCSystem.Thread.Tests.csproj --configuration Release
dotnet test Util/Tests/TCSystem.Util.Tests.csproj --configuration Release

See the linked test-project READMEs for single-framework and coverage examples. Some MetaDataDB converter tests are reported as skipped when optional legacy database fixtures are not present; the regular database tests create temporary SQLite databases and require no setup.

Code Coverage

Coverlet MSBuild is referenced by every test project. To reproduce the CI coverage format for net8.0, first build Release and then run:

dotnet test TCSystem.slnx --configuration Release --no-build --no-restore --framework net8.0 -p:CollectCoverage=true -p:CoverletOutputFormat=opencover

The generated, ignored reports are named coverage.net8.0.opencover.xml in the test project directories.

Run the Tools

Each tool README documents its arguments and data-safety considerations:

• Run DBConverter
• Run TakeoutReader

Maintenance

Dependency Vulnerability Audit

After restore, with the .NET 10 SDK:

dotnet package list --project TCSystem.slnx --vulnerable --include-transitive --no-restore

See SECURITY.md for the security policy.

Clean Generated Build Output

dotnet clean TCSystem.slnx --configuration Release

If a local SonarScanner run was interrupted and later builds reference missing analyzer files, delete the ignored .sonarqube directory before rebuilding.

Coding and Contribution Guidance

• CodingStyle.md defines the C# style and analyzer expectations.
• AGENTS.md defines repository instructions for coding agents.
• .github/copilot-instructions.md summarizes project patterns.

NuGet Packaging

Library projects import Packaging.props for NuGet metadata, symbol-package settings, and publish targets. Test and tool projects import NoPackaging.props so ordinary builds do not generate or publish packages. Package versioning is defined in Version.props; IsCiBuild defaults to true and adds a timestamped -ci.* suffix. The manual nuget_deploy.yml workflow explicitly invokes the Pack and NugetPush targets and can select a stable or CI version. Do not invoke NugetPush for an ordinary local build.

CI/CD

Workflow	Trigger	Purpose
analyze.yml	Push to develop or main; manual	Release build, net8.0 tests with OpenCover output, and SonarCloud analysis
dotnet.yml	Manual	Release restore and build validation
nuget_deploy.yml	Manual	Release build, full test matrix, package, and NuGet publish

CI runs on windows-latest with the .NET 10 SDK. Dependabot checks NuGet packages and GitHub Actions weekly and targets develop.

License

MIT — Copyright © 2003–2026 Thomas Gößler