[](https://dhall-lang.org/)
[](https://GitHub.com/s-zeng/dhall-python/graphs/commit-activity)
[](https://github.com/s-zeng/dhall-python/actions)
[](https://pypi.python.org/pypi/dhall/)
[](https://pypistats.org/packages/dhall)
Dhall is a programmable configuration language optimized for
maintainability.
You can think of Dhall as: JSON + functions + types + imports
Note that while Dhall is programmable, Dhall is not Turing-complete. Many
of Dhall's features take advantage of this restriction to provide stronger
safety guarantees and more powerful tooling.
You can try the language live in your browser by visiting the official website:
* [https://dhall-lang.org](http://dhall-lang.org/)
# `dhall-python`
`dhall-python` contains [Dhall][dhall-lang] bindings for Python using the
[rust][dhall-rust] implementation. It is meant to be used to integrate Dhall
into your python applications.
If you only want to convert Dhall to/from JSON or YAML, you should use the
official tooling instead; instructions can be found
[here](https://docs.dhall-lang.org/tutorials/Getting-started_Generate-JSON-or-YAML.html).
## Usage
Install using pip:
```shell
pip install dhall
```
Supports the following:
- Operating Systems
- Windows
- Mac OS
- Linux (manylinux_2_24_x86_64)
- Python versions
- 3.7
- 3.8
- 3.9
- 3.10
- 3.11
Python 3.5 and 3.6 support is available in older versions of dhall-python.
dhall-python implements a similar API to Python's [json
module](https://docs.python.org/3/library/json.html):
```python
>>> import dhall
>>> dhall.dumps({"keyA": 81, "keyB": True, "keyC": "value"})
'{ keyA = 81, keyB = True, keyC = "value" }'
>>> dhall.loads("""{ keyA = 81, keyB = True, keyC = "value" }""")
{'keyA': 81, 'keyB': True, 'keyC': 'value'}
```
# License
dhall-python is licensed under either of
- Apache License, Version 2.0, (LICENSE-APACHE or
http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
# Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in python-dhall by you, as defined in the Apache-2.0 license, shall
be dual licensed as above, without any additional terms or conditions.
All contributions are welcome! If you spot any bugs, or have any requests,
issues and PRs are always welcome.
# Developer guide
This project uses [poetry](https://python-poetry.org/docs/) for managing the development environment. If you don't have it installed, run
```
curl -sSL https://raw.githubusercontent.com/python-poetry/poetry/master/get-poetry.py | python
export PATH="$HOME/.poetry/bin:$PATH"
```
The project requires the latest `stable` version of Rust.
Install it via `rustup`:
```
rustup install stable
```
If you have already installed the `stable` version, make sure it is up-to-date:
```
rustup update stable
```
After that, you can compile the current version of dhall-python and execute all tests and benchmarks with the following commands:
```
make install
make test
```
🤫 Pssst!... run `make help` to learn more.
[dhall-rust]: https://github.com/Nadrieril/dhall-rust
[dhall-lang]: https://dhall-lang.org
Raw data
{
"_id": null,
"home_page": "https://github.com/s-zeng/dhall-python",
"name": "dhall",
"maintainer": null,
"docs_url": null,
"requires_python": "",
"maintainer_email": null,
"keywords": "dhall,python",
"author": "Simon Zeng <contact@simonzeng.com>, Tristan Cacqueray <tdecacqu@redhat.com>, Matthias Endler <matthias-endler@gmx.net>",
"author_email": "Simon Zeng <contact@simonzeng.com>, Tristan Cacqueray <tdecacqu@redhat.com>, Matthias Endler <matthias-endler@gmx.net>",
"download_url": null,
"platform": null,
"description": "[](https://dhall-lang.org/)\n\n[](https://GitHub.com/s-zeng/dhall-python/graphs/commit-activity)\n[](https://github.com/s-zeng/dhall-python/actions)\n[](https://pypi.python.org/pypi/dhall/)\n[](https://pypistats.org/packages/dhall)\n\nDhall is a programmable configuration language optimized for\nmaintainability.\n\nYou can think of Dhall as: JSON + functions + types + imports\n\nNote that while Dhall is programmable, Dhall is not Turing-complete. Many\nof Dhall's features take advantage of this restriction to provide stronger\nsafety guarantees and more powerful tooling.\n\nYou can try the language live in your browser by visiting the official website:\n\n* [https://dhall-lang.org](http://dhall-lang.org/)\n\n# `dhall-python`\n\n`dhall-python` contains [Dhall][dhall-lang] bindings for Python using the \n[rust][dhall-rust] implementation. It is meant to be used to integrate Dhall \ninto your python applications.\n\nIf you only want to convert Dhall to/from JSON or YAML, you should use the\nofficial tooling instead; instructions can be found\n[here](https://docs.dhall-lang.org/tutorials/Getting-started_Generate-JSON-or-YAML.html).\n\n## Usage\n\nInstall using pip:\n\n```shell\npip install dhall\n```\n\nSupports the following:\n\n- Operating Systems\n - Windows\n - Mac OS\n - Linux (manylinux_2_24_x86_64)\n- Python versions\n - 3.7\n - 3.8\n - 3.9\n - 3.10\n - 3.11\n\nPython 3.5 and 3.6 support is available in older versions of dhall-python.\n\ndhall-python implements a similar API to Python's [json\nmodule](https://docs.python.org/3/library/json.html):\n\n```python\n>>> import dhall\n>>> dhall.dumps({\"keyA\": 81, \"keyB\": True, \"keyC\": \"value\"})\n'{ keyA = 81, keyB = True, keyC = \"value\" }'\n>>> dhall.loads(\"\"\"{ keyA = 81, keyB = True, keyC = \"value\" }\"\"\")\n{'keyA': 81, 'keyB': True, 'keyC': 'value'}\n```\n\n# License\n\ndhall-python is licensed under either of\n\n- Apache License, Version 2.0, (LICENSE-APACHE or\n http://www.apache.org/licenses/LICENSE-2.0)\n- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)\n\nat your option.\n\n# Contribution\n\nUnless you explicitly state otherwise, any contribution intentionally submitted\nfor inclusion in python-dhall by you, as defined in the Apache-2.0 license, shall\nbe dual licensed as above, without any additional terms or conditions.\n\nAll contributions are welcome! If you spot any bugs, or have any requests, \nissues and PRs are always welcome.\n\n# Developer guide\n\nThis project uses [poetry](https://python-poetry.org/docs/) for managing the development environment. If you don't have it installed, run\n\n```\ncurl -sSL https://raw.githubusercontent.com/python-poetry/poetry/master/get-poetry.py | python\nexport PATH=\"$HOME/.poetry/bin:$PATH\"\n```\n\nThe project requires the latest `stable` version of Rust.\n\nInstall it via `rustup`:\n\n```\nrustup install stable\n```\n\nIf you have already installed the `stable` version, make sure it is up-to-date:\n\n```\nrustup update stable\n```\n\nAfter that, you can compile the current version of dhall-python and execute all tests and benchmarks with the following commands:\n\n```\nmake install\nmake test\n```\n\n\ud83e\udd2b Pssst!... run `make help` to learn more.\n\n\n[dhall-rust]: https://github.com/Nadrieril/dhall-rust\n[dhall-lang]: https://dhall-lang.org\n\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "Python bindings for dhall, a functional configuration language",
"version": "0.1.15",
"project_urls": {
"Homepage": "https://github.com/s-zeng/dhall-python",
"Source Code": "https://github.com/s-zeng/dhall-python"
},
"split_keywords": [
"dhall",
"python"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "cbe006495fef2be382ea32631d1ecd21468f8165e107854cbf76996ad77ef677",
"md5": "dcd1459adc35df9e29bef7dc8ca7786d",
"sha256": "21f6e38578fc7c475ccad92c0a1dcb1e20772095006c0790f0a3f32fe77cf2d5"
},
"downloads": -1,
"filename": "dhall-0.1.15-cp310-cp310-macosx_10_7_x86_64.whl",
"has_sig": false,
"md5_digest": "dcd1459adc35df9e29bef7dc8ca7786d",
"packagetype": "bdist_wheel",
"python_version": "cp310",
"requires_python": null,
"size": 2177846,
"upload_time": "2023-06-18T03:01:57",
"upload_time_iso_8601": "2023-06-18T03:01:57.225315Z",
"url": "https://files.pythonhosted.org/packages/cb/e0/06495fef2be382ea32631d1ecd21468f8165e107854cbf76996ad77ef677/dhall-0.1.15-cp310-cp310-macosx_10_7_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "dfd6322d27c17b957dc2b12aa61af42f0b4db05fb02e85053c7fb42ed6de0864",
"md5": "3b0a15271dd1e54b16b0382657f31f2a",
"sha256": "697548fff78902504c02a0f97a1261048f1c591f4de83effa1dbfee852606ba2"
},
"downloads": -1,
"filename": "dhall-0.1.15-cp310-cp310-manylinux_2_24_x86_64.whl",
"has_sig": false,
"md5_digest": "3b0a15271dd1e54b16b0382657f31f2a",
"packagetype": "bdist_wheel",
"python_version": "cp310",
"requires_python": null,
"size": 3361193,
"upload_time": "2023-06-18T02:57:30",
"upload_time_iso_8601": "2023-06-18T02:57:30.979919Z",
"url": "https://files.pythonhosted.org/packages/df/d6/322d27c17b957dc2b12aa61af42f0b4db05fb02e85053c7fb42ed6de0864/dhall-0.1.15-cp310-cp310-manylinux_2_24_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "c56ca8c529735dfad61a818a0c8e09f10b8063d66b4f11f6e9ce8e7496171fea",
"md5": "bf9fae5bbd3be0c85af7d4e650b306be",
"sha256": "80199b062eb0350f1ff6aacf84a74b6e4c20e1c87d5878071ee2e43889df5fc5"
},
"downloads": -1,
"filename": "dhall-0.1.15-cp311-cp311-macosx_10_7_x86_64.whl",
"has_sig": false,
"md5_digest": "bf9fae5bbd3be0c85af7d4e650b306be",
"packagetype": "bdist_wheel",
"python_version": "cp311",
"requires_python": null,
"size": 2177711,
"upload_time": "2023-06-18T03:01:05",
"upload_time_iso_8601": "2023-06-18T03:01:05.210111Z",
"url": "https://files.pythonhosted.org/packages/c5/6c/a8c529735dfad61a818a0c8e09f10b8063d66b4f11f6e9ce8e7496171fea/dhall-0.1.15-cp311-cp311-macosx_10_7_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "7ee1ae8ac000534a06a6f004343ac87fa727e0edf376fce7fec0f6b00cbda2a1",
"md5": "89067fd5fdebec91a270462546f72c9c",
"sha256": "ceaade029a846fbace28d69e89ef18bf7c80ffddd3f8ab6b4755cfd86f4f7c18"
},
"downloads": -1,
"filename": "dhall-0.1.15-cp311-cp311-manylinux_2_24_x86_64.whl",
"has_sig": false,
"md5_digest": "89067fd5fdebec91a270462546f72c9c",
"packagetype": "bdist_wheel",
"python_version": "cp311",
"requires_python": null,
"size": 3361258,
"upload_time": "2023-06-18T02:57:29",
"upload_time_iso_8601": "2023-06-18T02:57:29.345361Z",
"url": "https://files.pythonhosted.org/packages/7e/e1/ae8ac000534a06a6f004343ac87fa727e0edf376fce7fec0f6b00cbda2a1/dhall-0.1.15-cp311-cp311-manylinux_2_24_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "6d4d843e39ed22826907a48ee4da524d4265f20251c6364f89933065429963c1",
"md5": "a928710701f6e6d6e244c49fd6520114",
"sha256": "eb0044aad1599b21cd8dcd94a056fb9572fb956a8467bc9f48297c61b97e0a66"
},
"downloads": -1,
"filename": "dhall-0.1.15-cp37-cp37m-macosx_10_7_x86_64.whl",
"has_sig": false,
"md5_digest": "a928710701f6e6d6e244c49fd6520114",
"packagetype": "bdist_wheel",
"python_version": "cp37",
"requires_python": null,
"size": 2176935,
"upload_time": "2023-06-18T03:04:36",
"upload_time_iso_8601": "2023-06-18T03:04:36.306965Z",
"url": "https://files.pythonhosted.org/packages/6d/4d/843e39ed22826907a48ee4da524d4265f20251c6364f89933065429963c1/dhall-0.1.15-cp37-cp37m-macosx_10_7_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "2d39f0f45f9af81617183ed1d90c7d7b32223b02e35ad249011f6c2e6fddc79e",
"md5": "a8dfc9d14dba9dc7fd94906d09bfd8ae",
"sha256": "a465d136d61453aa3c2a71cf0029acd694bc1ded372d2cc5495a99b3f750ea5c"
},
"downloads": -1,
"filename": "dhall-0.1.15-cp37-cp37m-manylinux_2_24_x86_64.whl",
"has_sig": false,
"md5_digest": "a8dfc9d14dba9dc7fd94906d09bfd8ae",
"packagetype": "bdist_wheel",
"python_version": "cp37",
"requires_python": null,
"size": 3360986,
"upload_time": "2023-06-18T02:58:22",
"upload_time_iso_8601": "2023-06-18T02:58:22.410375Z",
"url": "https://files.pythonhosted.org/packages/2d/39/f0f45f9af81617183ed1d90c7d7b32223b02e35ad249011f6c2e6fddc79e/dhall-0.1.15-cp37-cp37m-manylinux_2_24_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "0e1fe3ef2ec2cb7b61eed390ae68ece24cb39d53cbf8d20c9b9a75239c74a67b",
"md5": "d7b44e745e25f01d9006b8302a5487ff",
"sha256": "bdc8c52d5f4a8bee2fe0ee78322e5b629f0474a716dcf0a7119ce27d0c8f515d"
},
"downloads": -1,
"filename": "dhall-0.1.15-cp38-cp38-macosx_10_7_x86_64.whl",
"has_sig": false,
"md5_digest": "d7b44e745e25f01d9006b8302a5487ff",
"packagetype": "bdist_wheel",
"python_version": "cp38",
"requires_python": null,
"size": 2177197,
"upload_time": "2023-06-18T03:01:24",
"upload_time_iso_8601": "2023-06-18T03:01:24.739035Z",
"url": "https://files.pythonhosted.org/packages/0e/1f/e3ef2ec2cb7b61eed390ae68ece24cb39d53cbf8d20c9b9a75239c74a67b/dhall-0.1.15-cp38-cp38-macosx_10_7_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "a698cba9a6449b19303a824817ed59d30d51b9c972b7545d2d1b65c89dc59603",
"md5": "f2ad690a5ca3be9a64374ac5ef1b1796",
"sha256": "aea9453b1bf56b9e154ade3526d52c0450cc905dbbf3384d28e540f229c11d45"
},
"downloads": -1,
"filename": "dhall-0.1.15-cp38-cp38-manylinux_2_24_x86_64.whl",
"has_sig": false,
"md5_digest": "f2ad690a5ca3be9a64374ac5ef1b1796",
"packagetype": "bdist_wheel",
"python_version": "cp38",
"requires_python": null,
"size": 3360918,
"upload_time": "2023-06-18T02:57:35",
"upload_time_iso_8601": "2023-06-18T02:57:35.512362Z",
"url": "https://files.pythonhosted.org/packages/a6/98/cba9a6449b19303a824817ed59d30d51b9c972b7545d2d1b65c89dc59603/dhall-0.1.15-cp38-cp38-manylinux_2_24_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "ad5a8ab4def9159e81db690cf77cd15107ebfaebac28c7a746e9f637d97ab5da",
"md5": "5f01a79769e46cfb2cf4f6230057a046",
"sha256": "aac14b4f595fcb356ad5063a42794943d8be2493cbad0fb991c21df2f4c2d2bf"
},
"downloads": -1,
"filename": "dhall-0.1.15-cp39-cp39-macosx_10_7_x86_64.whl",
"has_sig": false,
"md5_digest": "5f01a79769e46cfb2cf4f6230057a046",
"packagetype": "bdist_wheel",
"python_version": "cp39",
"requires_python": null,
"size": 2177885,
"upload_time": "2023-06-18T03:00:48",
"upload_time_iso_8601": "2023-06-18T03:00:48.497003Z",
"url": "https://files.pythonhosted.org/packages/ad/5a/8ab4def9159e81db690cf77cd15107ebfaebac28c7a746e9f637d97ab5da/dhall-0.1.15-cp39-cp39-macosx_10_7_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "dd407310157fbb12182b8ce7ee633410415a1ca561c3d62b495b155b59a2f740",
"md5": "d6ff8e3d225bd6012ebcaff984c31977",
"sha256": "6c23c955cfc11dd05579fbc76bea04848ff51a4fac406b0c5bf47c4cd1108d15"
},
"downloads": -1,
"filename": "dhall-0.1.15-cp39-cp39-manylinux_2_24_x86_64.whl",
"has_sig": false,
"md5_digest": "d6ff8e3d225bd6012ebcaff984c31977",
"packagetype": "bdist_wheel",
"python_version": "cp39",
"requires_python": null,
"size": 3361274,
"upload_time": "2023-06-18T02:58:44",
"upload_time_iso_8601": "2023-06-18T02:58:44.073921Z",
"url": "https://files.pythonhosted.org/packages/dd/40/7310157fbb12182b8ce7ee633410415a1ca561c3d62b495b155b59a2f740/dhall-0.1.15-cp39-cp39-manylinux_2_24_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "2f0f2bef02ad38897aa432f473bef3d140313a8d2d3af37a3885558194bcb8b1",
"md5": "14bc591d1b3e719ac786712626a765c7",
"sha256": "7c51f81b876ccf98a69a93d7dd4e707654835d5f6075036f24576ce037735a08"
},
"downloads": -1,
"filename": "dhall-0.1.15-cp39-none-win_amd64.whl",
"has_sig": false,
"md5_digest": "14bc591d1b3e719ac786712626a765c7",
"packagetype": "bdist_wheel",
"python_version": "cp39",
"requires_python": null,
"size": 2160136,
"upload_time": "2023-06-18T03:06:18",
"upload_time_iso_8601": "2023-06-18T03:06:18.809348Z",
"url": "https://files.pythonhosted.org/packages/2f/0f/2bef02ad38897aa432f473bef3d140313a8d2d3af37a3885558194bcb8b1/dhall-0.1.15-cp39-none-win_amd64.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-06-18 03:01:57",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "s-zeng",
"github_project": "dhall-python",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "dhall"
}
JSON
