package conan

  1. Overview
  2. Docs
On This Page
  1. recognition.
Identify type of your file (such as the MIME type)

Install

dune-project
 Dependency

Authors

Maintainers

Sources

conan-0.0.7.tbz
sha256=e196f218b9cf44899143cbceef58be8e5116601fc524249e958eee06e1f87415
sha512=38024e10308a92e8487ace257e18a968e1cc7ea1991e6150c10ae3232af4812fe96583ea36f54cc6e42cf91a2f04eec1dae323dfda64268469db7769d38ef2cc

doc/conan.string/Conan_string/index.html

Module Conan_stringSource

recognition.

Conan_string is a system-free implementation of the file recognition. This implementation does not uses any syscalls - and it can be safely used into a MirageOS example.

So Conan_string does not have an access to a database. The user must rebuild a Conan.Tree.t by himself/herself via tree_of_string for example. Then, from this tree, the user is able to recognize a payload as a simple string with run:

  let v =
    {file|0       byte    0x66
  >1      byte    0x6f
  >>1     byte    0x6f    foo header
  |file}

  let tree =
    match Conan_string.tree_of_string v with
    | Ok tree -> tree
    | Error (`Msg err) -> failwith err

  let database = Conan.Tree.database ~tree

  let m =
    match Conan_string.run ~database contents with
    | Ok m -> m
    | Error (`Msg err) -> failwith err
Sourceval tree_of_string : string -> (Conan.Tree.t, [> `Msg of string ]) result

tree_of_string str tries to parse the given str as a decision tree according to the libmagic format.

Sourceval run : database:Conan.Process.database -> string -> (Conan.Metadata.t, [> `Msg of string ]) result

run ~database contents tries to recognize the given contents with the help of database. The databse can be made via Conan.Process.database. Indeed, a Conan.Tree.t can have some indirect decision paths so we must pre-process the tree to agglomerate such indirections.