magicada 1.0, libmagic external (#926)

2023-11-27 16:26:25 +01:00
parent 0cae39b728
commit a8589243b8
2 changed files with 82 additions and 0 deletions
@@ -0,0 +1,11 @@
+description = "Recognize the type of data in a file using 'magic' numbers"
+name = "libmagic"
+
+maintainers = ["Stephane Carrez <Stephane.Carrez@gmail.com>"]
+maintainers-logins = ["stcarrez"]
+
+[[external]]
+kind = "system"
+
+[external.origin."case(distribution)"]
+"debian|ubuntu" = ["libmagic-dev"]
@@ -0,0 +1,71 @@
+name = "magicada"
+description = "Magic Number Recognition Library Ada binding"
+version = "1.0.0"
+long-description = """
+
+Small Ada binding library to the [libmagic (3)](https://linux.die.net/man/3/libmagic)
+library which is used by the implementation of the
+[file (1)](https://linux.die.net/man/1/file) command.
+
+To simplify and help in the use of the magic Ada library, the
+`Magic.Manager` package encapsulates the management of the libmagic library
+and provides high level simple operations to hide the details of interacting
+with the C library.  The package defines the `Magic_Manager` tagged record
+that takes care of the C library interaction and cleaning of the libmagic
+library once the manager is no longer required.  To use it, declare the
+instance and initialize it with the `Initialize` procedure:
+
+```Ada
+ with Magic.Manager;
+ ...
+    Mgr : Magic.Manager.Magic_Manager;
+    ...
+       Mgr.Initialize (Magic.MAGIC_MIME, Magic.DEFAULT_PATH);
+```
+
+The first parameter defines a set of flags represented by the `Magic.Flags`
+type to control various options of the libmagic library.   The second
+parameter indicates the default path to the magic file
+(see [magic (5)](https://linux.die.net/man/5/magic)).
+Once configured, the `Identify` functions can be used to identify a content.
+For the first form, a path of the file is given:
+
+```Ada
+ Mime : constant String := Mgr.Identify ("file.ads");
+```
+
+With the second form, a `Stream_Element_Array` with the content to identify
+is given to the function.
+
+## Example
+
+- [examples.adb](https://gitlab.com/stcarrez/ada-libmagic/-/blob/main/examples/src/examples.adb?ref_type=heads)
+
+"""
+
+authors = ["Stephane.Carrez@gmail.com"]
+maintainers = ["Stephane.Carrez@gmail.com"]
+maintainers-logins = ["stcarrez"]
+licenses = "Apache-2.0"
+website = "https://gitlab.com/stcarrez/ada-libmagic"
+tags = ["magic", "file", "bindings"]
+
+[gpr-externals]
+MAGICADA_BUILD = ["distrib", "debug", "optimize", "profile", "coverage"]
+MAGICADA_LIBRARY_TYPE = ["relocatable", "static", "static-pic"]
+
+[available.'case(os)']
+linux = true
+freebsd = true
+'...' = false
+
+[[depends-on]]
+libmagic = "*"
+
+[configuration]
+disabled = true
+
+[origin]
+commit = "8a67ea102940bb05ea8eae783f04eb6e8cb33b56"
+url = "git+https://gitlab.com/stcarrez/ada-libmagic.git"
+