Skip to main content

a treatment for PANDAS

Project description


NamedTuple / dataclasses <-> delimited text

"The best treatment for acute episodes of PANDAS is to treat the strep infection causing the symptoms, if it is still present, with antibiotics."
-- National Institute of Mental Health

antibiotics is a minimalist type-driven serialization/deserialization library inspired by Serde and cassava.

It uses type annotations to automatically read and write NamedTuple or @dataclass objects to or from delimited text files.

Out of the box, it only knows about Python scalar types and typing.Unions of them (including typing.Optional), but an extension mechanism for arbitrary type-directed serialization and deserialization is provided through the type_serde_ext argument to the Delimited constructor - see examples/

For Union types, serialization is driven by the runtime type, and deserialization is attempted in the order of declaration of the Union arguments - except that NoneType is tried first if present, to preserve the expected behavior when deserializing null/missing values of types whose deserializers do not throw when receiving '' as an argument.

Basic example

from antibiotics import Delimited
from dataclasses import dataclass
from typing import NamedTuple, Optional

class SampleDC():
    w: Optional[float]
    x: int
    y: bool
    z: str

class SampleNT(NamedTuple):
    w: Optional[float]
    x: int
    y: bool
    z: str

if __name__ == '__main__':
    dcs = list()
    nts = list()
    for i in range(10):
        even = i % 2 == 0
            i * 3.5 if even else None,
            not even,
            i * 3.5 if even else None,
            not even,

    csv = Delimited()
    with open('dcs.csv', 'w') as f:
        csv.write(SampleDC, dcs, f)

    tsv = Delimited(sep='\t', escape='\\')
    with open('nts.tsv', 'w') as f:
        tsv.write(SampleNT, dcs, f, header=False)

    with open('dcs.csv', 'r') as f:
        for r in, f):

    with open('nts.tsv', 'r') as f:
        for r in, f, header=False):

View the full pdoc3-generated API documentation.

Install with:

pip install --index-url antibiotics

Or download directly from Test PyPI.

(c) 2020 dwt | terminus data science, LLC

available under the Apache License 2.0

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

antibiotics-0.2.tar.gz (6.2 kB view hashes)

Uploaded Source

Built Distribution

antibiotics-0.2-py3-none-any.whl (10.3 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page