# DOCS

- [maci](https://docs.macilib.org/docs/maci.md): maci language, api functions, and information
- [language](https://docs.macilib.org/docs/maci/language.md): learn the language syntax and version features
- [v1.0.0](https://docs.macilib.org/docs/maci/language/v1.0.0.md): language syntax & features for v1.0.0
- [functions](https://docs.macilib.org/docs/maci/functions.md): api functions for maci
- [maci.build](https://docs.macilib.org/docs/maci/functions/maci.build.md): builds a maci data object
- [maci.load](https://docs.macilib.org/docs/maci/functions/maci.load.md): loads maci data from a file
- [maci.loadstr](https://docs.macilib.org/docs/maci/functions/maci.loadstr.md): loads maci data from a string
- [maci.loadattrs](https://docs.macilib.org/docs/maci/functions/maci.loadattrs.md): loads maci data from a file into any class/object
- [maci.loadraw](https://docs.macilib.org/docs/maci/functions/maci.loadraw.md): loads raw data from a file
- [maci.loaddict](https://docs.macilib.org/docs/maci/functions/maci.loaddict.md): loads maci data from a file as dict
- [maci.loadstrdict](https://docs.macilib.org/docs/maci/functions/maci.loadstrdict.md): loads maci data from a string as dict
- [maci.dump](https://docs.macilib.org/docs/maci/functions/maci.dump.md): dumps maci, dict, or object data to a file
- [maci.dumpstr](https://docs.macilib.org/docs/maci/functions/maci.dumpstr.md): dumps maci, dict, or object data to a string
- [maci.dumpraw](https://docs.macilib.org/docs/maci/functions/maci.dumpraw.md): dumps raw data to a file
- [object](https://docs.macilib.org/docs/maci/object.md): maci data object
- [methods](https://docs.macilib.org/docs/maci/object/methods.md): api methods for MaciDataObj
- [lock\_attr](https://docs.macilib.org/docs/maci/object/methods/lock_attr.md): lock an attribute name
- [unlock\_attr](https://docs.macilib.org/docs/maci/object/methods/unlock_attr.md): unlock an attribute name
- [hard\_lock\_attr](https://docs.macilib.org/docs/maci/object/methods/hard_lock_attr.md): hard lock an attribute name
- [map\_attr](https://docs.macilib.org/docs/maci/object/methods/map_attr.md): map attribute name to another
- [unmap\_attr](https://docs.macilib.org/docs/maci/object/methods/unmap_attr.md): unmap an attribute name
- [load\_attrs](https://docs.macilib.org/docs/maci/object/methods/load_attrs.md): load attribute names and data
- [get\_attrs](https://docs.macilib.org/docs/maci/object/methods/get_attrs.md): get dict of attribute names and values
- [get\_locked\_list](https://docs.macilib.org/docs/maci/object/methods/get_locked_list.md): get list of locked attribute names
- [get\_hard\_locked\_list](https://docs.macilib.org/docs/maci/object/methods/get_hard_locked_list.md): get list of hard locked attribute names
- [get\_all\_maps](https://docs.macilib.org/docs/maci/object/methods/get_all_maps.md): get dict of all parent and child maps
- [get\_parent\_maps](https://docs.macilib.org/docs/maci/object/methods/get_parent_maps.md): get dict of all parent maps
- [get\_child\_maps](https://docs.macilib.org/docs/maci/object/methods/get_child_maps.md): get dict of all child maps
- [get\_parent\_map\_chains](https://docs.macilib.org/docs/maci/object/methods/get_parent_map_chains.md): get dict of parent maps with chain of their children as list
- [is\_parent\_map](https://docs.macilib.org/docs/maci/object/methods/is_parent_map.md): check if attribute name is a parent
- [is\_child\_map](https://docs.macilib.org/docs/maci/object/methods/is_child_map.md): check if attribute name is a child
- [errors](https://docs.macilib.org/docs/maci/errors.md): all errors and exceptions
- [hints](https://docs.macilib.org/docs/maci/hints.md): all type hints
- [json](https://docs.macilib.org/docs/json.md): thin wrapper functions and information for json
- [functions](https://docs.macilib.org/docs/json/functions.md): api functions for maci.json\*
- [maci.jsonload](https://docs.macilib.org/docs/json/functions/maci.jsonload.md): loads json data from a file
- [maci.jsonloadstr](https://docs.macilib.org/docs/json/functions/maci.jsonloadstr.md): loads json data from a string
- [maci.jsondump](https://docs.macilib.org/docs/json/functions/maci.jsondump.md): dumps data to a file as json
- [maci.jsondumpstr](https://docs.macilib.org/docs/json/functions/maci.jsondumpstr.md): dumps data to a string as json
- [yaml](https://docs.macilib.org/docs/yaml.md): thin wrapper functions and information for yaml
- [functions](https://docs.macilib.org/docs/yaml/functions.md): api functions for maci.yaml\*
- [maci.yamlload](https://docs.macilib.org/docs/yaml/functions/maci.yamlload.md): loads yaml data from a file
- [maci.yamlloadstr](https://docs.macilib.org/docs/yaml/functions/maci.yamlloadstr.md): loads yaml data from a string
- [maci.yamlloadall](https://docs.macilib.org/docs/yaml/functions/maci.yamlloadall.md): loads multiple yaml docs from a file
- [maci.yamldump](https://docs.macilib.org/docs/yaml/functions/maci.yamldump.md): dumps data to a file as yaml
- [maci.yamldumpstr](https://docs.macilib.org/docs/yaml/functions/maci.yamldumpstr.md): dumps data to a string as yaml
- [maci.yamldumpall](https://docs.macilib.org/docs/yaml/functions/maci.yamldumpall.md): dumps multiple yaml docs to a file
- [toml](https://docs.macilib.org/docs/toml.md): thin wrapper functions and information for toml
- [functions](https://docs.macilib.org/docs/toml/functions.md): api functions for maci.toml\*
- [maci.tomlload](https://docs.macilib.org/docs/toml/functions/maci.tomlload.md): loads toml data from a file
- [maci.tomlloadstr](https://docs.macilib.org/docs/toml/functions/maci.tomlloadstr.md): loads toml data from a string
- [maci.tomldump](https://docs.macilib.org/docs/toml/functions/maci.tomldump.md): dumps data to a file as toml
- [maci.tomldumpstr](https://docs.macilib.org/docs/toml/functions/maci.tomldumpstr.md): dumps data to a string as toml
- [ini](https://docs.macilib.org/docs/ini.md): thin wrapper functions and information for ini
- [functions](https://docs.macilib.org/docs/ini/functions.md): api functions for maci.ini\*
- [maci.iniload](https://docs.macilib.org/docs/ini/functions/maci.iniload.md): loads ini data from a file
- [maci.inidump](https://docs.macilib.org/docs/ini/functions/maci.inidump.md): dumps data to a file as ini
- [maci.inibuildauto](https://docs.macilib.org/docs/ini/functions/maci.inibuildauto.md): auto builds a configparser object from dict
- [maci.inibuildmanual](https://docs.macilib.org/docs/ini/functions/maci.inibuildmanual.md): gets a configparser object to build from
- [xml](https://docs.macilib.org/docs/xml.md): thin wrapper functions and information for xml
- [functions](https://docs.macilib.org/docs/xml/functions.md): api functions for maci.xml\*
- [maci.xmlload](https://docs.macilib.org/docs/xml/functions/maci.xmlload.md): loads xml data to element or elementtree from a file
- [maci.xmlloadstr](https://docs.macilib.org/docs/xml/functions/maci.xmlloadstr.md): loads xml data to element from a string
- [maci.xmlloaddict](https://docs.macilib.org/docs/xml/functions/maci.xmlloaddict.md): loads xml data to dict from a file
- [maci.xmlloadstrdict](https://docs.macilib.org/docs/xml/functions/maci.xmlloadstrdict.md): loads xml data to dict from a string
- [maci.xmldump](https://docs.macilib.org/docs/xml/functions/maci.xmldump.md): dumps element or elementtree data to a file as xml
- [maci.xmldumpstr](https://docs.macilib.org/docs/xml/functions/maci.xmldumpstr.md): dumps element data to a string as xml
- [maci.xmldumpdict](https://docs.macilib.org/docs/xml/functions/maci.xmldumpdict.md): dumps dict data to a file as xml
- [maci.xmldumpstrdict](https://docs.macilib.org/docs/xml/functions/maci.xmldumpstrdict.md): dumps dict data to a string as xml
- [maci.xmlbuildmanual](https://docs.macilib.org/docs/xml/functions/maci.xmlbuildmanual.md): gets the elementtree module object to build elements
- [maci.\_defuse\_xml\_stdlib](https://docs.macilib.org/docs/xml/functions/maci._defuse_xml_stdlib.md): enable defusedxml feature
- [pickle](https://docs.macilib.org/docs/pickle.md): thin wrapper functions and information for pickle data
- [functions](https://docs.macilib.org/docs/pickle/functions.md): api functions for maci.pickle\*
- [maci.pickleloadbytes](https://docs.macilib.org/docs/pickle/functions/maci.pickleloadbytes.md): load pickled bytes
- [maci.pickledumpbytes](https://docs.macilib.org/docs/pickle/functions/maci.pickledumpbytes.md): dump data to pickled bytes
- [tools](https://docs.macilib.org/docs/tools.md): extra tooling for convenience
- [hash functions](https://docs.macilib.org/docs/tools/hash-functions.md): api functions for hash tools
- [maci.createhash](https://docs.macilib.org/docs/tools/hash-functions/maci.createhash.md): create hash of data
- [maci.createfilehash](https://docs.macilib.org/docs/tools/hash-functions/maci.createfilehash.md): hash a file and store hash to file
- [maci.comparefilehash](https://docs.macilib.org/docs/tools/hash-functions/maci.comparefilehash.md): compare hash of file to stored hash
- [format functions](https://docs.macilib.org/docs/tools/format-functions.md): api functions for format tools
- [maci.cleanformat](https://docs.macilib.org/docs/tools/format-functions/maci.cleanformat.md): formats data to a cleaner structured output


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.macilib.org/docs.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.