TCSystem.Thread 5.0.0-ci.202605071830

TCSystem — C# Utility Libraries

A collection of reusable .NET libraries for logging, image metadata management, GPS data processing, threading utilities, and more. All libraries are published as NuGet packages and target netstandard2.1, net8.0, and net10.0.

Libraries

TCSystem.Logging

Wraps Serilog behind an abstract Logger class where debug logging is not compiled into your code when building in Release mode (using [Conditional("DEBUG")]).

The recommended pattern is to add a Log.cs file in each folder/namespace so that each log output can be filtered by its namespace.

Init Logging

Factory.InitLogging(Factory.LoggingOptions.Console | Factory.LoggingOptions.File,
                    "Output.txt", 1, 10 * 1024);

Log.cs example

namespace Hello.World
{
    internal static class Log
    {
        public static Logger Instance { get; } = Factory.GetLogger(typeof(Log));
    }
}

Usage in your code

Log.Instance.Info("Hello World");

TCSystem.MetaData

Classes for handling and storing image metadata (date/time, GPS location, face/person tags). Supports JSON serialization via Newtonsoft.Json.

TCSystem.MetaDataDB

SQLite database abstraction (via Microsoft.Data.Sqlite) for storing, querying, and filtering image metadata. Provides thread-safe access through an instance-pooling pattern.

TCSystem.Gps

Reader for GPS data from Google Takeout location history files (records.json). Uses System.Text.Json with async streaming.

TCSystem.Thread

Thread helper classes including a worker thread that queues commands and executes them in order. Supports async Task-based APIs and cancellation tokens.

TCSystem.Util

Lightweight extension methods for containers, enumerables, and common patterns such as null-safe equality comparisons.

Tools

Both tools are .NET 8.0 console applications and are not published as NuGet packages.

Project Dependencies

TCSystem.Util
  └─► TCSystem.MetaData ─► Newtonsoft.Json
        ├─► TCSystem.Gps ─► System.Text.Json
        └─► TCSystem.MetaDataDB ─► Microsoft.Data.Sqlite
              ├─► TCSystem.Logging ─► Serilog
              └─► TCSystem.Thread
                    └─► TCSystem.Logging

Getting Started

Prerequisites

• .NET 8.0 SDK or later (net10.0 also supported)

Build

dotnet restore
dotnet build -c Release

Test

dotnet test

Tests use NUnit with code coverage via Coverlet.

NuGet Packages

All library projects produce NuGet packages on build. Packages are published to nuget.org via the nuget_deploy GitHub Actions workflow.

CI / CD

Dependency updates are managed by Dependabot (weekly, targeting the develop branch).

License

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