Skip to main content
Release file added late

1 file was added to this release more than 14 days after its initial publication. Inspect the release files before installing.

bases: a Python library for general Base-N encodings.

Generic badge PyPI version shields.io PyPI status Checked with Mypy Python package standard-readme compliant

Table of Contents

Install

You can install this package with pip:

pip install bases

Usage

The core functionality of the library is performed by the encode and decode methods of base encodings, instances of BaseEncoding (or, more precisely, of its concrete subclasses).

Common encodings are associated to pre-defined constants:

>>> from bases import base32
>>> base32
FixcharBaseEncoding(
    StringAlphabet('ABCDEFGHIJKLMNOPQRSTUVWXYZ234567',
                   case_sensitive=False),
    pad_char='=', padding='include')

The encode method can be used to encode bytestrings into strings:

>>> b = bytes([70, 98, 190, 187, 66, 224, 178])
>>> base32.encode(b)
'IZRL5O2C4CZA===='

The decode method can be used to decode strings into bytestrings:

>>> s = 'IZRL5O2C4CZA===='
>>> base32.decode(s)
b'Fb\xbe\xbbB\xe0\xb2'
>>> list(base32.decode(s))
[70, 98, 190, 187, 66, 224, 178]

The get(name), has(name), make(...) and table(prefix="") functions provide an interface for the programmatic management of encodings. The get(name) function can be used to obtain an existing encoding by name:

>>> import bases
>>> bases.get("base32")
FixcharBaseEncoding(
    StringAlphabet('ABCDEFGHIJKLMNOPQRSTUVWXYZ234567',
                   case_sensitive=False),
    pad_char='=', padding='include')

The make(...) function can be used to create a new encoding from a given alphabet, encoding kind and options:

>>> bases.make("0123", kind="zeropad-enc", block_nchars=4, name="base4")
ZeropadBaseEncoding(StringAlphabet('0123'), block_nchars=4)

The optional keyword argument name can be used to register with the library for future retrieval. The has(name) function can be used to check whether an encoding exists by a given name:

>>> bases.has("base4")
True

The table(prefix="") function can be used to iterate through the existing encoding, optionally filtering by name prefix:

>>> dict(bases.table(prefix="base32"))
{'base32':      FixcharBaseEncoding(
                    StringAlphabet('ABCDEFGHIJKLMNOPQRSTUVWXYZ234567',
                                   case_sensitive=False),
                    pad_char='=', padding='include'),
 'base32hex':   FixcharBaseEncoding(
                    StringAlphabet('0123456789ABCDEFGHIJKLMNOPQRSTUV',
                                   case_sensitive=False),
                    pad_char='=', padding='include'),
 'base32z':     FixcharBaseEncoding(
                    StringAlphabet('ybndrfg8ejkmcpqxot1uwisza345h769',
                                   case_sensitive=False))
}

For further information, please refer to the API documentation.

API

The API documentation for this package is automatically generated by pdoc.

Contributing

Please see the contributing file.

License

MIT © Hashberg Ltd.

Metadata

Release files for bases 0.1.0.post2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

File added late

1 file was uploaded more than 14 days after the first file in this release.

While project maintainers occasionally add legitimate files to an existing release, late additions can also indicate a security compromise.

We recommend inspecting the release files before installing.

Source distribution (sdist)

Source distribution for bases 0.1.0.post2
File Size Uploaded Provenance Actions
bases-0.1.0.post2.tar.gz 31.1 kB File added late: Without provenance Details for bases-0.1.0.post2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for bases 0.1.0.post2
File Interpreter ABI Platform Actions
bases-0.1.0.post2-py3-none-any.whl Python 3 none any Details for bases-0.1.0.post2-py3-none-any.whl

Total release size: 64.6 kB

Release files / bases-0.1.0.post2.tar.gz

File added late

This file was uploaded more than 14 days after the first file in this release.

While project maintainers occasionally add legitimate files to an existing release, late additions can also indicate a security compromise.

We recommend inspecting the release file before installing.

Download URL bases-0.1.0.post2.tar.gz
Size 31.1 kB
Tags Source
SHA-256 checksum
How to use checksums
2494144dabcf97e1525ff329776c9cb22b3ccd5b565b4973fbfa7beff94e3424
BLAKE2b-256 checksum
How to use checksums
4f0dfe56fc98fca83262829802dd1891bdc022a6a80b8b062ed7071a206533ee
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.4.1 importlib_metadata/4.6.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.58.0 CPython/3.9.7

Release files / bases-0.1.0.post2-py3-none-any.whl

Download URL bases-0.1.0.post2-py3-none-any.whl
Size 33.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f4ec6a67dd10d1e4f6ffefa47b7e4f89f5abfcb3032bd3363204d8bbb47b4c68
BLAKE2b-256 checksum
How to use checksums
0dd1162b35d13b4e96ee5ff3200f076425f15e84cd8802abb2e3f3ed1c946d94
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.4.1 importlib_metadata/4.6.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.58.0 CPython/3.9.7

Security for bases 0.1.0.post2

Upload timing

Release file added late

1 file was uploaded more than 14 days after the first file in this release.

While project maintainers occasionally add legitimate files to an existing release, late additions can also indicate a security compromise.


Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page