pyhcl
Implements a parser for HCL (HashiCorp Configuration Language) in Python. This implementation aims to be compatible with the original golang version of the parser.
The grammar and many of the tests/fixtures were copied/ported from the golang parser into pyhcl. All releases are tested with Python 2.7, 3.2, 3.3, and 3.4.
Installation
pip install pyhcl
Usage
This module is intended to be used in mostly the same way that one would use the json module in python, and load/loads/dumps are implemented.
import hcl
with open('file.hcl', r) as fp:
obj = hcl.load(fp)
Currently the dumps function outputs JSON, and not HCL.
Convert HCL to JSON
pyhcl comes with a script that you can use to easily convert HCL to JSON, similar to the json.tool that comes with python:
hcltool INFILE [OUTFILE]
Structure Validation
Similar to JSON, the output of parsing HCL is a python dictionary with no defined structure. The golang library for HCL implements support for parsing HCL according to defined objects, but this implementation does not currently support such constructs.
Instead, I recommend that you use tools designed to validate JSON, such as the schematics <https://pypi.python.org/pypi/schematics> library.
Syntax
Single line comments start with # or //
Multi-line comments are wrapped in /* and */
Values are assigned with the syntax key = value (whitespace doesn’t matter). The value can be any primitive: a string, number, boolean, object, or list.
Strings are double-quoted and can contain any UTF-8 characters. Example: "Hello, World"
Numbers are assumed to be base 10. If you prefix a number with 0x, it is treated as a hexadecimal. If it is prefixed with 0, it is treated as an octal. Numbers can be in scientific notation: “1e10”.
Boolean values: true, false, on, off, yes, no.
Arrays can be made by wrapping it in []. Example: ["foo", "bar", 42]. Arrays can contain primitives and other arrays, but cannot contain objects. Objects must use the block syntax shown below.
Objects and nested objects are created using the structure shown below:
variable "ami" {
description = "the AMI to use"
}
Testing
To run the tests:
pip install -r testing-requirements.txt tests/run_tests.sh
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file pyhcl-0.1.4.tar.gz.
File metadata
- Download URL: pyhcl-0.1.4.tar.gz
- Upload date:
- Size: 18.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c0c541c80c18a33bca376652ab305a9509286deaf03a8e18f7ac4b4c2dd9a184
|
|
| MD5 |
16f4a1ea935c358232e799fc453f3aa8
|
|
| BLAKE2b-256 |
30f2008282f21d4dac7739c0f40ce652d22d5e3d4f519ff04f4ae217429a265a
|
