This post details the development of a Python microservice named “MarkItLikeItsHot,” designed to streamline content conversion into Markdown within Willow CMS. This microservice uses a FastAPI wrapper around Microsoft’s powerful MarkItDown library, enabling seamless conversion of files, URLs, and raw text into clean, formatted Markdown. We’ll explore the underlying technologies, get into the code structure, and highlight key aspects like Docker deployment, testing, and configuration.

This comprehensive guide details how PHPUnit testing is implemented in Willow CMS, both locally and through GitHub Actions. The testing infrastructure includes 116 tests and 414 assertions, providing robust quality assurance. The setup revolves around five key components: a PHPUnit configuration file, GitHub Actions for continuous integration, shared test case code for DRY principles, controller tests for critical functionality, and code coverage reporting. The system uses random test execution to ensure independence and includes both admin and non-admin testing scenarios. The GitHub Actions workflow is particularly noteworthy, running tests across multiple PHP versions and incorporating various quality checks including PHPStan and PHP CodeSniffer.