ACF Advanced Configuration Format
Merging configuration files and programming languages so you don't have to create an interpreter for every project.
Get ACF syntax hightlighting for VS Code here.
Installation
Install with pip install acfile
Usage with Python
Read an ACF file
from acfile import read_file
config = read_file("<FILE_PATH>.acf")
Read values
To read values, get the section name and then the value name from the acf object.
print(config.SECTION_NAME.VALUE_NAME)
ACF documentation
The file extension for an acf file is .acf
.
Sections
ACF has a section-based structure where the header is preceded by an @
symbol. Example: @header
. Each section contains key-value pairs.
Values
A value contains a name and a value seperated by an equals symbol. Text values must be enclosed with speech marks.
Example:
text = "this is text"
number = 42
Referencing other values
As long as the value is in the same section, you can refernce them to perform math operations on. Order of operations is supported
Examples:
a = 12
b = 2 + 3 * a
The value b
will have the value of 38
.
a = "hello"
b = 3 * a
The value b
will be "hellohellohello" as operators on strings have the same behaviour as in Python.
Comments
Inline comments begin with a semicolon ;
.