TplQueue.Adapter contains the integration packages that complement TplQueue.Core.
It provides the top-level API facade and the concrete modules for retry policies, observers, cache implementations, serialization, and Microsoft dependency injection.
The repository publishes several packages. The main facade package is:
dotnet add package Fmacias.TplQueue --version 0.1.0-preview.1For ASP.NET Core or generic-host microsoft DI integration, install:
dotnet add package Fmacias.TplQueue.Microsoft.DependencyInjection --version 0.1.0-preview.1- Fmacias.TplQueue
- Fmacias.TplQueue.Cache.Abstract
- Fmacias.TplQueue.Cache.MemCache
- Fmacias.TplQueue.Microsoft.DependencyInjection
- Fmacias.TplQueue.Observers
- Fmacias.TplQueue.RetryPolicies
- Fmacias.TplQueue.Serialization.SystemTextJson
- Fmacias.TplQueue.Serialization.Xml
Repository-level documentation now lives under the multilingual source-of-truth tree:
- English landing page
- German landing page
- English getting started
- English core concepts
- English queues
- English architecture
- English development
- English operations
- English reference hub
- English license section
TplQueue.Adapter/docs/<lang>/ is the only documentation tree imported into fmacias.github.io for the public TplQueue site. Those pages may still link to other public repositories and may include small focused code blocks from public sources such as TplQueue.Abstractions and TplQueue.Usage when that improves the documentation.
docs/Agents.md is the repository-local instruction file for rebuilding those documentation trees. It is not part of the published documentation and must not be mirrored into fmacias.github.io.
If you want to rebuild or refresh the repository documentation with an agent, use docs/Agents.md as the instruction file and start from this prompt:
Rebuild the TplQueue.Adapter documentation under docs/en/ and docs/de/ according to docs/Agents.md. Treat README.md as the concise repository and package entry point, keep docs/en/ and docs/de/ structurally aligned, use docs/en/getting-started/index.md as the main entry for onboarding, keep docs/en/reference/index.md as a compact reference hub, keep `TplQueue.Adapter/docs/<lang>/` as the only public-site source tree, and ground every API example in the current TplQueue.Adapter source code plus small focused public snippets or runnable sample links from TplQueue.Abstractions and TplQueue.Usage where they improve the docs.
Run the repository test surface:
dotnet test .\TplQueue.Adapter.slnRun repository coverage:
.\coverage.ps1
.\coverage.ps1 -EnforceBaselineBuild local preview packages:
.\pack-local.ps1For signed official packaging and the public publish flow, use the coordinated workspace scripts documented in docs/en/operations/index.md.
For package-based samples, public integration tests, and observer-facing validation, see TplQueue.Usage.
TplQueue.Adapter is distributed under the MIT license.
TplQueue.Core, which the adapter complements, is distributed separately under its own package-specific license terms. The published Core binaries are publicly consumable, but the Core source repository, private unit tests, and private integration tests remain outside the public repositories and require separate approval.