$ show Sicos1977/ChromiumHtmlToPdf
ChromiumHtmlToPdf is a .NET library and CLI tool that converts HTML to PDF (and PNG) using headless Google Chrome or Microsoft Edge via the Chrome DevTools Protocol (CDP). The core library (ChromiumHtmlToPdfLib) provides a managed C# API with synchronous and asynchronous methods for conversion, supporting extensive configuration of page settings, headers/footers, margins, paper size, JavaScript execution, and file caching. The console application (ChromiumHtmlToPdfConsole) wraps this library into a command-line tool with over 50 options, enabling batch conversions, multi-threading, and integration into scripts or CI/CD pipelines. The architecture is a two-project solution: a netstandard2.0/2.1 library and a .NET 8 console app packaged as a dotnet tool. Key entry points include the Converter class (ConvertToPdf/ConvertToImage methods) and the console's Program.cs. External dependencies are limited to a Chromium-based browser (Chrome/Edge) installed on the system, plus NuGet packages for JSON serialization, logging abstractions, and image processing (AngleSharp, Magick.NET). The codebase demonstrates solid engineering with reusable components like a file-backed cache, CDP protocol models, and pluggable loggers, but suffers from minor technical debt such as deprecated BinaryFormatter usage, disabled certificate validation in HTTP helpers, and version drift between projects. No automated tests exist, increasing regression risk for a process-heavy library.
The LLM identified 3 files worth highlighting for reuse:
A self-contained, file-backed ObjectCache implementation supporting serializable objects, filenames, and raw bytes. It includes region support, expiration policies, max-size enforcement with LRU-style shrinking, semaphore-file locking for cross-process safety, and cleaning/shrinking methods. This component is fully reusable in any .NET project needing a disk cache with minimal dependencies.
A lightweight logger implementation that wraps any System.IO.Stream, implementing Microsoft.Extensions.Logging.ILogger. It provides configurable log levels and formatted output, and can be easily extracted and reused in other .NET applications for stream-based logging without external dependencies.
Base class for Chrome DevTools Protocol messages, providing JSON serialization/deserialization with an Id property for request-response correlation. It is part of a clean protocol model hierarchy that can be reused or extended for any CDP-based automation project, demonstrating a well-structured approach to typed protocol handling.