like mime, but simpler - a simple, human-readable file format Simple I/O to flat text files with a header (composed of fields) and a body (arbitrary bytes). Ideal for no-hassle storage of some metadata and some large data that doesn't fit nicely into things like JSON (which becomes really hard to edit in a text editor if there's a 2 MB blob of numbers somewhere in it).
Readme
like mime, but simpler - a simple, human-readable file format
Simple I/O to flat text files with a header (composed of fields) and a body (arbitrary bytes). Ideal for no-hassle storage of some metadata and some large data that doesn't fit nicely into things like JSON (which becomes really hard to edit in a text editor if there's a 2 MB blob of numbers somewhere in it).
While the general format is the same as MIME/"internet messages" and most if not all "internet messages" can be parsed by this module there are a few distinctions. For starters the header is always UTF-8 encoded (which doesn't clash with the 7-bit-ASCII-padded-to-bytes used by internet messages). Field names are mangled to Python identifiers by stripping surrounding whitespace and dashes, turning them all lower case, replacing dashes (-) with underscores (_) and appending another underscore if the result is a reserved Python keyword. If the result of this is not a valid Python identifier, the field name is invalid.
When writing files from objects this translation is reversed (underscores replaced with dashes, surrounding dashes are removed and the result is title-cased).
Values are simple strings.
The optional body of a file is, in contrast to the header, not UTF-8, but rather treated as a byte string. If the body is text-like usage of UTF-8 is strongly advised.
Line endings in the header can be UNIX style (\n, preferred) or Windows style (\r\n). Windows style endings are always converted to UNIX style endings when reading, and only UNIX style endings are written.
Primary APIs are dump, dumps, load and loads.
FAQs
like mime, but simpler - a simple, human-readable file format Simple I/O to flat text files with a header (composed of fields) and a body (arbitrary bytes). Ideal for no-hassle storage of some metadata and some large data that doesn't fit nicely into things like JSON (which becomes really hard to edit in a text editor if there's a 2 MB blob of numbers somewhere in it).
We found that limbs demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Git dependencies in open source packages can introduce significant risks, including lack of version control, stability issues, dependency drift, and difficulty in auditing, making them potential targets for supply chain attacks.
Security News
Node.js has added experimental support for TypeScript, a move that highlights the growing importance of TypeScript in modern development.
Product
Check out what's new at Socket with our Product Changelog. It tracks all public-facing updates, improvements, and fixes so you can take full advantage of our features.
