Fossil Media by Fossil Logic

Fossil Media is a lightweight, portable data parsing and processing library written in pure C with zero external dependencies. Designed for maximum portability and flexibility, Fossil Media provides robust parsers and utilities to handle a variety of common and complex data formats including JSON, CSV, XML, and more. Its minimal footprint and clean, audit-friendly codebase make it ideal for embedded, cross-platform, and security-sensitive applications that require reliable data ingestion and transformation.

Key Features

• Wide Format Support
  Parse and process popular data formats such as JSON, CSV, XML, and extendable to custom formats.

• Cross-Platform Compatibility
  Runs effortlessly on Windows, macOS, Linux, and embedded systems without modification.

• Zero External Dependencies
  Written entirely in clean, portable C to simplify integration and enable thorough code audits.

• Efficient and Lightweight
  Optimized for minimal memory and CPU usage, making it perfect for resource-constrained environments.

• Modular and Extensible
  Easily customizable to support new data formats or tailor parsing behavior to your project’s needs.

• Robust Data Handling
  Supports streaming parsing, validation, and conversion utilities for flexible data workflows.

Getting Started

Prerequisites

To get started, ensure you have the following installed:

• Meson Build System: If you don’t have Meson 1.8.0 or newer installed, follow the installation instructions on the official Meson website.
• Conan Package Manager: If you prefer using Conan, ensure it is installed by following the instructions on the official Conan website.

Adding Dependency

Adding via Meson Git Wrap

To add a git-wrap, place a .wrap file in subprojects with the Git repo URL and revision, then use dependency('fossil-media') in meson.build so Meson can fetch and build it automatically.

Adding via Conan GitHub repository

packages directly from a GitHub repository if it contains a valid conanfile.py.

conan install git+https://github.com/fossillogic/fossil-media.git#v0.1.1 --name fossil_media --build=missing

Integrate the Dependency:

Add the fossil-media.wrap file in your subprojects directory and include the following content:

[wrap-git]
url = https://github.com/fossillogic/fossil-media.git
revision = v0.1.1

[provide]
dependency_names = fossil-media

Note: For the best experience, always use the latest releases. Visit the releases page for the latest versions.

Build Configuration Options

Customize your build with the following Meson options: • Enable Tests To run the built-in test suite, configure Meson with:

meson setup builddir -Dwith_test=enabled

Tests Double as Samples

The project is designed so that test cases serve two purposes:

• ✅ Unit Tests – validate the framework’s correctness.
• 📖 Usage Samples – demonstrate how to use these libraries through test cases.

This approach keeps the codebase compact and avoids redundant “hello world” style examples.
Instead, the same code that proves correctness also teaches usage.

This mirrors the Meson build system itself, which tests its own functionality by using Meson to test Meson.
In the same way, Fossil Logic validates itself by demonstrating real-world usage in its own tests via Fossil Test.

meson test -C builddir -v

Running the test suite gives you both verification and practical examples you can learn from.

Contributing and Support

For those interested in contributing, reporting issues, or seeking support, please open an issue on the project repository or visit the Fossil Logic Docs for more information. Your feedback and contributions are always welcome.