pytomlpp 1.0.4

A python wrapper for toml++

pytomlpp

This is an python wrapper for toml++ (https://marzer.github.io/tomlplusplus/).

Some points you may want to know before use:

• Using toml++ means that this module is fully compatible with TOML v1.0.0.
• We convert toml structure to native python data structures (dict/list etc.) when parsing, this is more inline with what json module does.
• The binding is using pybind11.
• The project is tested using toml-test and pytest.

Example

In [1]: import pytomlpp                                                                                                                                                                                                                                                                            

In [2]: toml_string = 'hello = "世界"'                                                                                                                                                                                                                                                             

In [3]: pytomlpp.loads(toml_string)                                                                                                                                                                                                                                                                
Out[3]: {'hello': '世界'}

In [4]: type(_)                                                                                                                                                                                                                                                                                    
Out[4]: dict

In [6]: pytomlpp.dumps({"你好": "world"})                                                                                                                 
Out[6]: '"你好" = "world"'

Why bother?

There are some existing python TOML parsers on the market but from my experience they are implemented purely in python which is a bit slow.

Parsing data.toml 5000 times:
  pytomlpp:    0.846 s
     tomli:    3.317 s (3.9x slower)
      toml:    5.697 s (6.7x slower)
     qtoml:    8.473 s (10.0x slower)
   tomlkit:   43.250 s (51.0x slower)

Test it for yourself using the benchmark script.

Installing

We recommand you to use pip to install this package:

pip install pytomlpp

You can also use conda to install this package, Note we only support linux 64 python 3.8 for now, I would love to provide this package on more python versions and platforms via conda but I have not found a way yet to automate this in the CI, if you know how to do this please contribute!

conda install -c dorafmon pytomlpp

You can also install from source:

git clone [e-mail]:bobfang1992/pytomlpp.git --recurse-submodules=third_party/tomlplusplus --shallow-submodules
cd pytomlpp
pip install .