Lossy python to markdown serializer
Project description
markpickle
Lossy serialization of markdown to simple python data types and back. It will create predictable markdown from a python object, but can't turn all markdown files into sensible python objects (for that use a markdown library that creates an AST). I created this because I wanted a way to turn json into Markdown.
For example this
- 1
- 2
becomes the python list [1, 2]
Installation
pip install markpickle
Capabilities
This is a lossy serialization. Markdown is missing too many concepts to make a high fidelity representation of a python data structure. If you want an object model that faithfully represents each object in a Markdown document, use the AST of mistune or one of the other markdown parsers.
Supported types
- Scalar values
- Lists of scalar values
- Dictionaries with scalar values
- Lists of dictionaries of scalar values
- Dictionaries with list values
- Partial support for blanks/string with leading/trailing whitespace
Not supported
- Things not ordinarily serializable
- Markdown that uses more than headers, lists, tables
Serializing
Almost all markdown libraries use it as intended, as a way to generate HTML fragments from untrusted sources for insertion into some other HTML template.
Deserializing
Markdown is deserialized by parsing the document to an abstract syntax tree. This is done by mistune
. If the markdown file has the same structure that markpickle uses, then it will create a sensible object. Deserializing a random README.md file is not expected to always work. For that you should use mistune's AST.
Round Tripping
Some but not all data structures will be round-trippable. The goal is that the sort of dicts you get from loading JSON will be round-trippable, provided everything is a string.
Prior Art
People normally want to convert json to markdown. Json looks like python dict, so if you can do that you can probably do both.
Serializing to Markdown
json2md, a node package, will turn json that looks like the HTML document object model into markdown, e.g.
{"h1": "Some Header",
"p": "Some Text"}
tomark will turn dict into a markdown table. Unmaintained.
pytablewriter also, dict to table, but supports many tabular formats.
Deserializing to Python
I don't know of any libraries that turn markdown into basic python types. At the moment, they all turn markdown into document object model.
mistune will turn markdown into an Abstract Syntax Tree. The AST is faithful representation of the Markdown, including concepts that have no semantic equivalent to python datatypes.
beautifulsoup will let you navigate the HTML DOM. So you can turn the markdown into HTML, then parse with Beautiful Soup.
Documentation
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for markpickle-1.0.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 20ae0cb2fa449e6231824de463f5e3c161d72820f75eeb652b66c3c655539ee7 |
|
MD5 | 5b9aa1e9cf7a57f781be7b31cd77b717 |
|
BLAKE2b-256 | 851ce4b825d9b65245c617e55011746fa992997af95e8d9d9e65aecb4da60339 |