package crunch

  1. Overview
  2. Docs
Convert a filesystem into a static OCaml module

Install

Dune Dependency

Authors

Maintainers

Sources

crunch-3.3.1.tbz
sha256=2c5ba0d4110bcbb7731cba4eafb6c44a7487c3f88c1ad47401271b69ffa8ed6a
sha512=5aaa1b67456dd2f5e3ab450ea547e62fba2b0341a49f3b24669162dce91b6ea1158c1594d60c6df3e416e719484411c50ae61017c40b2f75ee90401aa543bd08

Description

ocaml-crunch takes a directory of files and compiles them into a standalone OCaml module which serves the contents directly from memory. This can be convenient for libraries that need a few embedded files (such as a web server) and do not want to deal with all the trouble of file configuration.

Tags

org:mirage org:xapi-project

Published: 05 Aug 2022

README

ocaml-crunch — convert a filesystem into a static OCaml module

ocaml-crunch takes a directory of files and compiles them into a standalone OCaml module which serves the contents directly from memory. This can be convenient for libraries that need a few embedded files (such as a web server) and do not want to deal with all the trouble of file configuration.

Run ocaml-crunch --help for more information:

NAME
       ocaml-crunch - Convert a directory structure into a standalone OCaml
       module that can serve the file contents without requiring an external
       filesystem to be present.

SYNOPSIS
       ocaml-crunch [--ext=VALID EXTENSION] [--mode=MODE] [--output=OUTPUT]
       [OPTION]… DIRECTORIES…

ARGUMENTS
       DIRECTORIES (required)
           Directories to recursively walk and crunch.

OPTIONS
       -e VALID EXTENSION, --ext=VALID EXTENSION
           If specified, only these extensions will be included in the
           crunched output. If not specified, then all files will be crunched
           into the output module.

       -m MODE, --mode=MODE (absent=lwt)
           Interface access mode: either lwt or plain. lwt is the default.

       -o OUTPUT, --output=OUTPUT
           Output file for the OCaml module.

       -s, --silent
           Silent mode.

COMMON OPTIONS
       --help[=FMT] (default=auto)
           Show this help in format FMT. The value FMT must be one of auto,
           pager, groff or plain. With auto, the format is pager or plain
           whenever the TERM env var is dumb or undefined.

       --version
           Show version information.

EXIT STATUS
       ocaml-crunch exits with the following status:

       0   on success.

       123 on indiscriminate errors reported on standard error.

       124 on command line parsing errors.

       125 on unexpected internal errors (bugs).

ENVIRONMENT
       These environment variables affect the execution of ocaml-crunch:

       SOURCE_DATE_EPOCH
           Specifies the last modification of crunched files for reproducible
           output.

BUGS
       Email bug reports to <mirage-devel@lists.xenproject.org>.

Dependencies (4)

  1. dune >= "2.5"
  2. ptime
  3. cmdliner >= "1.1"
  4. ocaml >= "4.08.0"

Dev Dependencies (4)

  1. fmt with-test
  2. mirage-kv-mem with-test & >= "3.0.0"
  3. mirage-kv with-test & >= "3.0.0"
  4. lwt with-test

Conflicts (1)

  1. mirage-kv < "3.0.0"