LDIF.Sigil (LDIF v0.1.1)

View Source

LDIF.Sigil allows compile-time conversion of LDIF text into structs.

The ~L sigil will convert one or more LDIF records into structs. Modifiers allow the output to be adjusted.

Sigils can be convenient when testing and demonstrating software but in most cases it will be more practical to load a separate LDIF file and process it with LDIF.decode_entries!/2

Use require LDIF.Sigil to enable this in a module or function.

Summary

Functions

sigil_L(string, modifiers)

The ~L sigil will convert one or more LDIF records into structs, defaulting to normal entry records.

Functions

sigil_L(string, modifiers)

(macro)

The ~L sigil will convert one or more LDIF records into structs, defaulting to normal entry records. 


 require LDIF.Sigil

 ~L"""
 dn:cn=Barbara Jensen, ou=Product Development, dc=airius, dc=com
 objectclass:top
 objectclass:person
 objectclass:organizationalPerson
 cn:Barbara Jensen
 cn:Barbara J Jensen
 cn:Babs Jensen
 sn:Jensen
 uid:bjensen
 telephonenumber:+1 408 555 1212
 description:Babs is a big sailing fan, and travels extensively in sea
   rch of perfect sailing conditions.
 title:Product Manager, Rod and Reel Division
 """
 |> List.first()
 |> LDIF.Entry.attribute("cn")
 #=> ["Barbara Jensen", "Barbara J Jensen", "Babs Jensen"]

You can adjust the output with modifiers:

  • X - allows external HTTP/HTTPS resources to be embedded at compile time
  • m - merges language-tagged attributes into a single untagged attribute
  • n - normalize each entry's DN (does not change DNs used in attributes)
  • e - specified that all records are normal entries (the default)
  • c - specifies that all records are special change entries

 require LDIF.Sigil

 ~L"""
 dn: ou=Product Development, dc=airius, dc=com
ou: Product Development
objectClass: top
objectClass: organizationalUnit
 """n
 |> List.first()
 |> LDIF.Entry.dn()
 #=> "ou=product development,dc=airius,dc=com"