README.rst
1===================
2about python-creole
3===================
4
5python-creole is a OpenSource (GPL) Python lib for converting markups.
6python-creole is pure python. No external libs needed.
7
8Compatible Python Versions (see `tox.ini <https://github.com/jedie/python-creole/blob/master/tox.ini>`_ or `.travis.yml <https://github.com/jedie/python-creole/blob/master/.travis.yml>`_):
9
10* 3.9, 3.8, 3.7, 3.6
11
12* PyPy3
13
14Existing converters:
15
16* creole -> html
17
18* html -> creole markup
19
20* reSt -> html (for clean html code)
21
22* html -> reStructuredText markup (only a subset of reSt supported)
23
24* html -> textile markup (not completed yet)
25
26The creole2html part based on the creole markup parser and emitter from the MoinMoin project by Radomir Dopieralski and Thomas Waldmann.
27
28+-----------------------------------+
29| |Build Status on github| |
30+-----------------------------------+
31| |Build Status on travis-ci.org| |
32+-----------------------------------+
33| |Coverage Status on coveralls.io| |
34+-----------------------------------+
35| |Status on landscape.io| |
36+-----------------------------------+
37| |PyPi version| |
38+-----------------------------------+
39
40.. |Build Status on github| image:: https://github.com/jedie/python-creole/workflows/test/badge.svg?branch=master
41.. |Build Status on travis-ci.org| image:: https://travis-ci.org/jedie/python-creole.svg
42.. _travis-ci.org/jedie/python-creole: https://travis-ci.org/jedie/python-creole/
43.. |Coverage Status on coveralls.io| image:: https://coveralls.io/repos/jedie/python-creole/badge.svg
44.. _coveralls.io/r/jedie/python-creole: https://coveralls.io/r/jedie/python-creole
45.. |Status on landscape.io| image:: https://landscape.io/github/jedie/python-creole/master/landscape.svg
46.. _landscape.io/github/jedie/python-creole/master: https://landscape.io/github/jedie/python-creole/master
47.. |PyPi version| image:: https://badge.fury.io/py/python-creole.svg
48.. _pypi.org/project/python-creole/: https://pypi.org/project/python-creole/
49
50=======
51install
52=======
53
54Python packages available on: `http://pypi.python.org/pypi/python-creole/ <http://pypi.python.org/pypi/python-creole/>`_
55
56::
57
58 ~$ pip install python-creole
59
60To setup a virtualenv via Poetry, see ``unittests`` section below.
61
62------------
63dependencies
64------------
65
66For the most parts (``creole2html`` and ``html2creole``) no external libraries are needed.
67
68For all functionality (and running the unittests) these modules are needed:
69
70* `docutils <http://pypi.python.org/pypi/docutils/>`_ (for the ReStructuredText stuff)
71
72* `textile <http://pypi.python.org/pypi/textile/>`_ (for html2textile tests)
73
74=======
75example
76=======
77
78-----------
79creole2html
80-----------
81
82Convert creole markup to html code:
83
84::
85
86 >>> from creole import creole2html
87 >>> creole2html("This is **creole //markup//**")
88 u'<p>This is <strong>creole <i>markup</i></strong></p>\n'
89
90-----------
91html2creole
92-----------
93
94Convert html code back into creole markup:
95
96::
97
98 >>> from creole import html2creole
99 >>> html2creole(u'<p>This is <strong>creole <i>markup</i></strong></p>\n')
100 u'This is **creole //markup//**'
101
102---------
103rest2html
104---------
105
106Convert ReStructuredText into clean html code (needs `docutils`_):
107
108::
109
110 >>> from creole.rest2html.clean_writer import rest2html
111 >>> rest2html(u"A ReSt link to `PyLucid CMS <http://www.pylucid.org>`_ :)")
112 u'<p>A ReSt link to <a href="http://www.pylucid.org">PyLucid CMS</a> :)</p>\\n'
113
114(more information: `rest2html wiki page <https://github.com/jedie/python-creole/wiki/rest2html>`_)
115
116---------
117html2rest
118---------
119
120Convert html code into ReStructuredText markup:
121
122::
123
124 >>> from creole import html2rest
125 >>> html2rest(u'<p>This is <strong>ReStructuredText</strong> <em>markup</em>!</p>')
126 u'This is **ReStructuredText** *markup*!'
127
128------------
129html2textile
130------------
131
132Convert html code into textile markup
133
134::
135
136 >>> from creole import html2textile
137 >>> html2textile(u'<p>This is <strong>textile <i>markup</i></strong>!</p>')
138 u'This is *textile __markup__*!'
139
140See also: `http://github.com/jedie/python-creole/blob/master/demo.py <http://github.com/jedie/python-creole/blob/master/demo.py>`_
141
142=====================
143Image size additional
144=====================
145
146You can pass image width/height in image tags, e.g.:
147
148::
149
150 >>> from creole import creole2html
151 >>> creole_markup="""{{foobar.jpg|image title|90x160}}"""
152 >>> creole2html(creole_markup)
153 '<p><img src="foobar.jpg" title="image title" alt="image title" width="90" height="160" /></p>'
154
155The third part (``90x160``) is not in creole standard, you can force a *strict* mode, e.g.:
156
157::
158
159 >>> creole2html(creole_markup, strict=True)
160 '<p><img src="foobar.jpg" title="image title|90x160" alt="image title|90x160" /></p>'
161
162================================
163Source code highlighting support
164================================
165
166You can find a example macro which highlight source code thanks to the pygments
167library. It is located here: `/creole/shared/example_macros.py <https://github.com/jedie/python-creole/blob/master/creole/shared/example_macros.py>`_.
168Here is how to use it:
169
170::
171
172 >>> from creole import creole2html
173 >>> from creole.shared.example_macros import code
174 >>> creole_markup="""<<code ext=".py">>#some code\nprint('coucou')\n<</code>>"""
175 >>> creole2html(creole_markup, macros={'code': code})
176
177=====================
178commandline interface
179=====================
180
181If you have python-creole installed, you will get these simple CLI scripts:
182
183* creole2html
184
185* html2creole
186
187* html2rest
188
189* html2textile
190
191Here the ``--help`` output from ``html2creole``:
192
193::
194
195 $ html2creole --help
196 usage: html2creole [-h] [-v] [--encoding ENCODING] sourcefile destination
197
198 python-creole is an open-source (GPL) markup converter in pure Python for:
199 creole2html, html2creole, html2ReSt, html2textile
200
201 positional arguments:
202 sourcefile source file to convert
203 destination Output filename
204
205 optional arguments:
206 -h, --help show this help message and exit
207 -v, --version show program's version number and exit
208 --encoding ENCODING Codec for read/write file (default encoding: utf-8)
209
210Example to convert a html file into a creole file:
211
212::
213
214 $ html2creole foobar.html foobar.creole
215
216=============
217documentation
218=============
219
220We store documentation/examples into the project wiki:
221
222* `https://github.com/jedie/python-creole/wiki <https://github.com/jedie/python-creole/wiki>`_
223
224How to handle unknown html tags in html2creole:
225
226* `https://github.com/jedie/python-creole/wiki/Unknown-Html-Tags <https://github.com/jedie/python-creole/wiki/Unknown-Html-Tags>`_
227
228Contributers should take a look at this page:
229
230* `https://github.com/jedie/python-creole/wiki/Developer-Info <https://github.com/jedie/python-creole/wiki/Developer-Info>`_
231
232Creole Markup Cheat Sheet can be found here: `http://www.wikicreole.org/wiki/CheatSheet <http://www.wikicreole.org/wiki/CheatSheet>`_
233
234|Creole Markup Cheat Sheet|
235
236.. |Creole Markup Cheat Sheet| image:: http://www.wikicreole.org/imageServlet?page=CheatSheet%2Fcreole_cheat_sheet.png&width=340
237
238---------
239unittests
240---------
241
242::
243
244 # clone repository (or use your fork):
245 ~$ git clone https://github.com/jedie/python-creole.git
246 ~$ cd python-creole
247
248 # install or update poetry:
249 ~/python-creole$ make install-poetry
250
251 # install python-creole via poetry:
252 ~/python-creole$ make install
253
254 # Run pytest:
255 ~/python-creole$ make pytest
256
257 # Run pytest via tox with all environments:
258 ~/python-creole$ make tox
259
260 # Run pytest via tox with one Python version:
261 ~/python-creole$ make tox-py38
262 ~/python-creole$ make tox-py37
263 ~/python-creole$ make tox-py36
264
265------------
266make targets
267------------
268
269To see all make targets, just call ``make``:
270
271::
272
273 ~/python-creole$ make
274 help List all commands
275 install-poetry install or update poetry
276 install install python-creole via poetry
277 lint Run code formatters and linter
278 fix-code-style Fix code formatting
279 tox-listenvs List all tox test environments
280 tox Run pytest via tox with all environments
281 tox-py36 Run pytest via tox with *python v3.6*
282 tox-py37 Run pytest via tox with *python v3.7*
283 tox-py38 Run pytest via tox with *python v3.8*
284 tox-py39 Run pytest via tox with *python v3.9*
285 pytest Run pytest
286 update-rst-readme update README.rst from README.creole
287 publish Release new version to PyPi
288
289--------------------
290Use creole in README
291--------------------
292
293With python-creole you can convert a README on-the-fly from creole into ReStructuredText in setup.py
294How to do this, read: `https://github.com/jedie/python-creole/wiki/Use-In-Setup <https://github.com/jedie/python-creole/wiki/Use-In-Setup>`_
295
296Note: In this case you must install **docutils**! See above.
297
298=======
299history
300=======
301
302* *dev* - `compare v1.4.9...master <https://github.com/jedie/python-creole/compare/v1.4.9...master>`_
303
304 * TBC
305
306* v1.4.9 - 2020-11-4 - `compare v1.4.8...v1.4.9 <https://github.com/jedie/python-creole/compare/v1.4.8...v1.4.9>`_
307
308 * Add missing classifier for Python 3.9 (`Contributed by jugmac00 <https://github.com/jedie/python-creole/pull/55>`_)
309
310 * Update readme test
311
312* v1.4.8 - 2020-10-17 - `compare v1.4.7...v1.4.8 <https://github.com/jedie/python-creole/compare/v1.4.7...v1.4.8>`_
313
314 * Validate generated ``README.rst`` with `readme-renderer <https://pypi.org/project/readme-renderer/>`_
315
316* v1.4.7 - 2020-10-17 - `compare v1.4.6...v1.4.7 <https://github.com/jedie/python-creole/compare/v1.4.6...v1.4.7>`_
317
318 * ``update_rst_readme()`` will touch ``README.rst`` if there are not change (timestamp will not changed in file)
319
320 * Run tests with Python 3.9, too.
321
322 * Some meta updates to project setup
323
324* v1.4.6 - 2020-02-13 - `compare v1.4.5...v1.4.6 <https://github.com/jedie/python-creole/compare/v1.4.5...v1.4.6>`_
325
326 * less restricted dependency specification
327
328* v1.4.5 - 2020-02-13 - `compare v1.4.4...v1.4.5 <https://github.com/jedie/python-creole/compare/v1.4.4...v1.4.5>`_
329
330 * new: ``creole.setup_utils.assert_rst_readme`` for project setup tests
331
332 * use `https://github.com/ymyzk/tox-gh-actions <https://github.com/ymyzk/tox-gh-actions>`_ on gitlab CI
333
334* v1.4.4 - 2020-02-07 - `compare v1.4.3...v1.4.4 <https://github.com/jedie/python-creole/compare/v1.4.3...v1.4.4>`_
335
336 * Fix #44: Move ``poetry-publish`` to ``dev-dependencies`` and lower ``docutils`` requirement to |^0.15|
337
338 * some code style updated
339
340 * Always update README.rst before publish
341
342* v1.4.3 - 2020-02-01 - `compare v1.4.2...v1.4.3 <https://github.com/jedie/python-creole/compare/v1.4.2...v1.4.3>`_
343
344 * Use new `poetry-publish <https://pypi.org/project/poetry-publish/>`_ for ``make publish``
345
346* v1.4.2 - 2020-02-01 - `compare v1.4.1...v1.4.2 <https://github.com/jedie/python-creole/compare/v1.4.1...v1.4.2>`_
347
348 * Update CI configs on github and travis
349
350 * Update ``Makefile``: add ``make publish`` and ``make update-rst-readme``
351
352 * Add generated ``README.rst`` in repository to fix install problems about missing readme
353
354* v1.4.1 - 2020-01-19 - `compare v1.4.0...v1.4.1 <https://github.com/jedie/python-creole/compare/v1.4.0...v1.4.1>`_
355
356 * Remove Python v2 support code
357
358 * `Fix "Undefined substitution referenced" error <https://github.com/jedie/python-creole/issues/26>`_ contributed by dforsi
359
360 * `Fix regression in tests for setup_utils <https://github.com/jedie/python-creole/pull/37>`_ contributed by jugmac00
361
362 * Fix code style with: autopep8
363
364 * sort imports with isort
365
366 * change old ``%-formatted`` and ``.format(...)`` strings into Python 3.6+'s ``f-strings`` with flynt
367
368 * Activate linting in CI pipeline
369
370* v1.4.0 - 2020-01-19 - `compare v1.3.2...v1.4.0 <https://github.com/jedie/python-creole/compare/v1.3.2...v1.4.0>`_
371
372 * modernize project:
373
374 * use poetry
375
376 * Add a ``Makefile``
377
378 * use pytest and tox
379
380 * remove Python v2 support
381
382 * Test with Python v3.6, v3.7 and v3.8
383
384* v1.3.2 - 2018-02-27 - `compare v1.3.1...v1.3.2 <https://github.com/jedie/python-creole/compare/v1.3.1...v1.3.2>`_
385
386 * Adding optional img size to creole2html and html2creole contributed by `John Dupuy <https://github.com/JohnAD>`_
387
388 * run tests also with python 3.5 and 3.6
389
390* v1.3.1 - 2015-08-15 - `compare v1.3.0...v1.3.1 <https://github.com/jedie/python-creole/compare/v1.3.0...v1.3.1>`_
391
392 * Bugfix for "Failed building wheel for python-creole"
393
394* v1.3.0 - 2015-06-02 - `compare v1.2.2...v1.3.0 <https://github.com/jedie/python-creole/compare/v1.2.2...v1.3.0>`_
395
396 * Refactory internal file structure
397
398 * run unittests and doctests with nose
399
400 * Refactor CLI tests
401
402 * skip official support for Python 2.6
403
404 * small code cleanups and fixes.
405
406 * use **json.dumps()** instead of **repr()** in some cases
407
408* v1.2.2 - 2015-04-05 - `compare v1.2.1...v1.2.2 <https://github.com/jedie/python-creole/compare/v1.2.1...v1.2.2>`_
409
410 * Bugfix textile unittests if url scheme is unknown
411
412 * migrate google-code Wiki to github and remove google-code links
413
414* v1.2.1 - 2014-09-14 - `compare v1.2.0...v1.2.1 <https://github.com/jedie/python-creole/compare/v1.2.0...v1.2.1>`_
415
416 * Use origin PyPi code to check generated reStructuredText in setup.py
417
418 * Update unitest for textile v2.1.8
419
420* v1.2.0 - 2014-05-15 - `compare v1.1.1...v1.2.0 <https://github.com/jedie/python-creole/compare/v1.1.1...v1.2.0>`_
421
422 * NEW: Add ``<<code>>`` example macro (Source code highlighting with pygments) - implemented by Julien Enselme
423
424 * NEW: Add ``<<toc>>`` macro to create a table of contents list
425
426 * Bugfix for: AttributeError: 'CreoleParser' object has no attribute '_escaped_char_repl'
427
428 * Bugfix for: AttributeError: 'CreoleParser' object has no attribute '_escaped_url_repl'
429
430 * API Change: Callable macros will raise a TypeError instead of create a DeprecationWarning (Was removed in v0.5)
431
432* v1.1.1 - 2013-11-08
433
434 * Bugfix: Setup script exited with error: can't copy 'README.creole': doesn't exist or not a regular file
435
436* v1.1.0 - 2013-10-28
437
438 * NEW: Simple commandline interface added.
439
440* v1.0.7 - 2013-08-07
441
442 * Bugfix in 'clean reStructuredText html writer' if docutils => v0.11 used.
443
444 * Bugfix for PyPy 2.1 usage
445
446* v1.0.6 - 2012-10-15
447
448 * Security fix in rest2html: Disable "file_insertion_enabled" and "raw_enabled" as default.
449
450* v1.0.5 - 2012-09-03
451
452 * made automatic protocol links more strict: Only whitespace before and at the end are allowed.
453
454 * Bugfix: Don't allow ``ftp:/broken`` (Only one slash) to be a link.
455
456* v1.0.4 - 2012-06-11
457
458 * html2rest: Handle double link/image substitution and raise better error messages
459
460 * Bugfix in unittests (include test README file in python package). Thanks to Wen Heping for reporting this.
461
462* v1.0.3 - 2012-06-11
463
464 * Bugfix: ``AttributeError: 'module' object has no attribute 'interesting_cdata'`` from HTMLParser patch. Thanks to Wen Heping for reporting this.
465
466 * Fix a bug in get_long_description() ReSt test for Py3k and his unittests.
467
468 * Use Travis CI, too.
469
470* v1.0.2 - 2012-04-04
471
472 * Fix "`AttributeError: 'NoneType' object has no attribute 'parent' <https://github.com/jedie/python-creole/issues/6>`_" in html2creole.
473
474* v1.0.1 - 2011-11-16
475
476 * Fix "`TypeError: expected string or buffer <https://github.com/jedie/python-creole/issues/5>`_" in rest2html.
477
478 * `Bugfix in exception handling. <https://github.com/jedie/python-creole/commit/e8422f944709a5f8c2c6a8c8a58a84a92620f035>`_
479
480* v1.0.0 - 2011-10-20
481
482 * Change API: Replace 'parser_kwargs' and 'emitter_kwargs' with separate arguments. (More information on `API Wiki Page <https://github.com/jedie/python-creole/wiki/API>`_)
483
484* v0.9.2
485
486 * Turn zip_safe in setup.py on and change unittests API.
487
488* v0.9.1
489
490 * Many Bugfixes, tested with CPython 2.6, 2.7, 3.2 and PyPy v1.6
491
492* v0.9.0
493
494 * Add Python v3 support (like `http://python3porting.com/noconv.html <http://python3porting.com/noconv.html>`_ strategy)
495
496 * move unittests into creole/tests/
497
498 * Tested with Python 2.7.1, 3.2 and PyPy v1.6.1 15798ab8cf48 jit
499
500* v0.8.5
501
502 * Bugfix in html2creole: ignore links without href
503
504* v0.8.4
505
506 * Bugfix in html parser if list tag has attributes: `https://code.google.com/p/python-creole/issues/detail?id=19#c4 <https://code.google.com/p/python-creole/issues/detail?id=19#c4>`_
507
508* v0.8.3
509
510 * Better error message if given string is not unicode: `https://code.google.com/p/python-creole/issues/detail?id=19 <https://code.google.com/p/python-creole/issues/detail?id=19>`_
511
512* v0.8.2
513
514 * Bugfix in get_long_description() error handling (*local variable 'long_description_origin' referenced before assignment*)
515
516* v0.8.1
517
518 * Bugfix for installation under python 2.5
519
520 * Note: `setup helper <https://github.com/jedie/python-creole/wiki/Use-In-Setup>`_ changed: rename ``GetLongDescription(...)`` to ``get_long_description(...)``
521
522* v0.8
523
524 * New GetLongDescription() helper for setup.py, see: `https://github.com/jedie/python-creole/wiki/Use-In-Setup`_
525
526* v0.7.3
527
528 * Bugfix in html2rest:
529
530 * table without ``<th>`` header
531
532 * new line after table
533
534 * create reference hyperlinks in table cells intead of embedded urls.
535
536 * Don't always use raise_unknown_node()
537
538 * Add child content to raise_unknown_node()
539
540* v0.7.2
541
542 * Activate ``----`` to ``<hr>`` in html2rest
543
544 * Update demo.py
545
546* v0.7.1
547
548 * Bugfix if docutils are not installed
549
550 * API change: rest2html is now here: ``from creole.rest2html.clean_writer import rest2html``
551
552* v0.7.0
553
554 * **NEW**: Add a html2reStructuredText converter (only a subset of reSt supported)
555
556* v0.6.1
557
558 * Bugfix: separate lines with one space in "wiki style line breaks" mode
559
560* v0.6
561
562 * **NEW**: html2textile converter
563
564 * some **API changed**!
565
566* v0.5
567
568 * **API changed**:
569
570 * Html2CreoleEmitter optional argument 'unknown_emit' takes now a callable for handle unknown html tags.
571
572 * No macros used as default in creole2html converting.
573
574 * We remove the support for callable macros. Only dict and modules are allowed.
575
576 * remove unknown html tags is default behaviour in html2creole converting.
577
578 * restructure and cleanup sourcecode files.
579
580* v0.4
581
582 * only emit children of empty tags like div and span (contributed by Eric O'Connell)
583
584 * remove inter wiki links and doesn't check the protocol
585
586* v0.3.3
587
588 * Use <tt> when {{{ ... }}} is inline and not <pre>, see: `PyLucid Forum Thread <http://forum.pylucid.org/viewtopic.php?f=3&t=320>`_
589
590 * Bugfix in html2creole: insert newline before new list. TODO: apply to all block tags: `issues 16 <http://code.google.com/p/python-creole/issues/detail?id=16#c5>`_
591
592* v0.3.2
593
594 * Bugfix for spaces after Headline: `issues 15 <https://code.google.com/p/python-creole/issues/detail?id=15>`_
595
596* v0.3.1
597
598 * Make argument 'block_rules' in Parser() optional
599
600* v0.3.0
601
602 * creole2html() has the optional parameter 'blog_line_breaks' to switch from default blog to wiki line breaks
603
604* v0.2.8
605
606 * bugfix in setup.py
607
608* v0.2.7
609
610 * handle obsolete non-closed <br> tag
611
612* v0.2.6
613
614 * bugfix in setup.py
615
616 * Cleanup DocStrings
617
618 * add unittests
619
620* v0.2.5
621
622 * creole2html: Bugfix if "--", "//" etc. stands alone, see also: `issues 12 <http://code.google.com/p/python-creole/issues/detail?id=12>`_
623
624 * Note: bold, italic etc. can't cross line any more.
625
626* v0.2.4
627
628 * creole2html: ignore file extensions in image tag
629
630 * see also: `issues 7 <http://code.google.com/p/python-creole/issues/detail?id=7>`_
631
632* v0.2.3
633
634 * html2creole bugfix/enhanced: convert image tag without alt attribute:
635
636 * see also: `issues 6 <http://code.google.com/p/python-creole/issues/detail?id=6>`_
637
638 * Thanks Betz Stefan alias 'encbladexp'
639
640* v0.2.2
641
642 * html2creole bugfix: convert ``<a href="/url/">Search & Destroy</a>``
643
644* v0.2.1
645
646 * html2creole bugfixes in:
647
648 * converting tables: ignore tbody tag and better handling p and a tags in td
649
650 * converting named entity
651
652* v0.2
653
654 * remove all django template tag stuff: `issues 3 <http://code.google.com/p/python-creole/issues/detail?id=3>`_
655
656 * html code always escaped
657
658* v0.1.1
659
660 * improve macros stuff, patch by Vitja Makarov: `issues 2 <http://code.google.com/p/python-creole/issues/detail?id=2>`_
661
662* v0.1.0
663
664 * first version cut out from `PyLucid CMS <http://www.pylucid.org>`_
665
666.. |^0.15| image:: ^0.15
667
668first source code was written 27.11.2008: `Forum thread (de) <http://www.python-forum.de/viewtopic.php?f=3&t=16742>`_
669
670-------------
671Project links
672-------------
673
674+--------+------------------------------------------------+
675| GitHub | `https://github.com/jedie/python-creole`_ |
676+--------+------------------------------------------------+
677| Wiki | `https://github.com/jedie/python-creole/wiki`_ |
678+--------+------------------------------------------------+
679| PyPi | `https://pypi.org/project/python-creole/`_ |
680+--------+------------------------------------------------+
681
682.. _https://github.com/jedie/python-creole: https://github.com/jedie/python-creole
683.. _https://pypi.org/project/python-creole/: https://pypi.org/project/python-creole/
684
685--------
686donation
687--------
688
689* `paypal.me/JensDiemer <https://www.paypal.me/JensDiemer>`_
690
691* `Flattr This! <https://flattr.com/submit/auto?uid=jedie&url=https%3A%2F%2Fgithub.com%2Fjedie%2Fpython-creole%2F>`_
692
693* Send `Bitcoins <http://www.bitcoin.org/>`_ to `1823RZ5Md1Q2X5aSXRC5LRPcYdveCiVX6F <https://blockexplorer.com/address/1823RZ5Md1Q2X5aSXRC5LRPcYdveCiVX6F>`_
694
695------------
696
697``Note: this file is generated from README.creole 2020-11-04 08:46:39 with "python-creole"``
