Ravenports generated: 13 Oct 2023 04:56
[ravenports.git] / bucket_B4 / python-toml
1 # Buildsheet autogenerated by ravenadm tool -- Do not edit.
2
3 NAMEBASE=               python-toml
4 VERSION=                0.10.2
5 KEYWORDS=               python
6 VARIANTS=               v11 v12
7 SDESC[v11]=             Tom's Obvious, Minimal Language (3.11)
8 SDESC[v12]=             Tom's Obvious, Minimal Language (3.12)
9 HOMEPAGE=               https://github.com/uiri/toml
10 CONTACT=                Python_Automaton[python@ironwolf.systems]
11
12 DOWNLOAD_GROUPS=        main
13 SITES[main]=            PYPIWHL/44/6f/7120676b6d73228c96e17f1f794d8ab046fc910d781c8d151120c3f1569e
14 DISTFILE[1]=            toml-0.10.2-py2.py3-none-any.whl:main
15 DF_INDEX=               1
16 SPKGS[v11]=             single
17 SPKGS[v12]=             single
18
19 OPTIONS_AVAILABLE=      PY311 PY312
20 OPTIONS_STANDARD=       none
21 VOPTS[v11]=             PY311=ON PY312=OFF
22 VOPTS[v12]=             PY311=OFF PY312=ON
23
24 DISTNAME=               toml-0.10.2.dist-info
25
26 GENERATED=              yes
27
28 [PY311].USES_ON=                        python:v11,wheel
29
30 [PY312].USES_ON=                        python:v12,wheel
31
32 [FILE:1993:descriptions/desc.single]
33 ****
34 TOML
35 ****
36
37 A Python library for parsing and creating [TOML].
38
39 The module passes [the TOML test suite].
40
41 See also:
42
43 * [The TOML Standard]
44 * [The currently supported TOML specification]
45
46 Installation
47 ============
48
49 To install the latest release on [PyPI],
50 simply run:
51
52 ::
53
54   pip install toml
55
56 Or to install the latest development version, run:
57
58 ::
59
60   git clone https://github.com/uiri/toml.git
61   cd toml
62   python setup.py install
63
64 Quick Tutorial
65 ==============
66
67 *toml.loads* takes in a string containing standard TOML-formatted data and
68 returns a dictionary containing the parsed data.
69
70 .. code:: pycon
71
72   >>> import toml
73   >>> toml_string = """
74   ... # This is a TOML document.
75   ...
76   ... title = "TOML Example"
77   ...
78   ... [owner]
79   ... name = "Tom Preston-Werner"
80   ... dob = 1979-05-27T07:32:00-08:00 # First class dates
81   ...
82   ... [database]
83   ... server = "192.168.1.1"
84   ... ports = [ 8001, 8001, 8002]
85   ... connection_max = 5000
86   ... enabled = true
87   ...
88   ... [servers]
89   ...
90   ...   # Indentation (tabs and/or spaces) is allowed but not required
91   ...   [servers.alpha]
92   ...   ip = "10.0.0.1"
93   ...   dc = "eqdc10"
94   ...
95   ...   [servers.beta]
96   ...   ip = "10.0.0.2"
97   ...   dc = "eqdc10"
98   ...
99   ... [clients]
100   ... data = [ ["gamma", "delta"], [1, 2]]
101   ...
102   ... # Line breaks are OK when inside arrays
103   ... hosts = [
104   ...   "alpha",
105   ...   "omega"
106   ...]
107   ... """
108   >>> parsed_toml = toml.loads(toml_string)
109
110 *toml.dumps* takes a dictionary and returns a string containing the
111 corresponding TOML-formatted data.
112
113 .. code:: pycon
114
115   >>> new_toml_string = toml.dumps(parsed_toml)
116   >>> print(new_toml_string)
117   title = "TOML Example"
118   [owner]
119   name = "Tom Preston-Werner"
120   dob = 1979-05-27T07:32:00Z
121   [database]
122   server = "192.168.1.1"
123   ports = [ 8001, 8001, 8002,]
124   connection_max = 5000
125   enabled = true
126   [clients]
127   data = [ [ "gamma", "delta",], [ 1, 2,],]
128   hosts = [ "alpha", "omega",]
129   [servers.alpha]
130   ip = "10.0.0.1"
131   dc = "eqdc10"
132   [servers.beta]
133
134
135 [FILE:111:distinfo]
136 806143ae5bfb6a3c6e736a764057db0e6a0e05e338b5630894a5f779cabb4f9b        16588 toml-0.10.2-py2.py3-none-any.whl
137