simple_foundation_api

Overview

simple_foundation_api is a unified facade that bundles essential foundation libraries for any Eiffel project. Instead of managing multiple library dependencies, use a single FOUNDATION class that provides access to:

• Base64 encoding/decoding
• Cryptographic hashing (SHA-256, SHA-1, MD5, HMAC)
• UUID generation and validation
• JSON parsing and building
• CSV parsing and generation
• Markdown to HTML conversion
• XML parsing and building
• Data validation with fluent API
• Regular expressions with fluent builder
• Date/time manipulation and formatting
• Structured logging with JSON output
• HTMX component generation
• Process execution
• Random data generation

Features

Installation

Add simple_foundation_api to your ECF configuration file:

<library name="simple_foundation_api"
        location="$SIMPLE_FOUNDATION_API\simple_foundation_api.ecf"/>

Environment Variables

Set the following environment variables:

SIMPLE_FOUNDATION_API=path/to/simple_foundation_api
SIMPLE_BASE64=path/to/simple_base64
SIMPLE_CSV=path/to/simple_csv
SIMPLE_DATETIME=path/to/simple_datetime
SIMPLE_HASH=path/to/simple_hash
SIMPLE_HTMX=path/to/simple_htmx
SIMPLE_JSON=path/to/simple_json
SIMPLE_LOGGER=path/to/simple_logger
SIMPLE_MARKDOWN=path/to/simple_markdown
SIMPLE_PROCESS=path/to/simple_process
SIMPLE_RANDOMIZER=path/to/simple_randomizer
SIMPLE_REGEX=path/to/simple_regex
SIMPLE_UUID=path/to/simple_uuid
SIMPLE_VALIDATION=path/to/simple_validation
SIMPLE_XML=path/to/simple_xml

Quick Start

local
    foundation: FOUNDATION
do
    create foundation.make

    -- Base64 encoding
    foundation.base64_encode ("Hello")  -- "SGVsbG8="

    -- SHA-256 hashing
    foundation.sha256 ("data")

    -- UUID generation
    foundation.new_uuid  -- "550e8400-e29b-41d4-a716-446655440000"

    -- JSON parsing
    if attached foundation.parse_json ("{%"name%": %"test%"}") as json then
        ...
    end

    -- Markdown conversion
    foundation.markdown_to_html ("# Hello World")

    -- Validation
    if foundation.is_valid_email ("test@example.com") then
        ...
    end

    -- Random generation
    foundation.random_integer_in_range (1, 100)
end

API Reference

Dependencies

simple_foundation_api bundles the following libraries: