Skip to content
/ b64uuid Public

A small Python library and command-line tool to encode/decode UUID to/from a 22 characters shorter URL safe base64 string.

License

Notifications You must be signed in to change notification settings

tanbro/b64uuid

Repository files navigation

b64uuid


pytest PyPI Documentation Status


A small Python library and command-line tool to encode/decode UUID to/from a 22 characters shorter URL safe base64 string.

We can use it to make UUID string a little shorter.

Installation

  • Installing from PyPI:

    pip install b64uuid
  • Installing from a local src tree:

    pip install .

    or

    python setup.py install

Check https://packaging.python.org/tutorials/installing-packages for more details.

Command Line Usages

  • Make a random short ID

    $ b64uuid
    bxntPh4PSA6-OMDfBXMLhQ
  • Short ID from UUID

    $ b64uuid -u 2863a16d-b6ae-45a2-9d74-98d20377d56a
    KGOhbbauRaKddJjSA3fVag
  • Short ID to UUID

    $ b64uuid -s KGOhbbauRaKddJjSA3fVag
    2863a16d-b6ae-45a2-9d74-98d20377d56a

Library Usages

  • Make a random short ID

    >>> from b64uuid import B64UUID
    >>>
    >>> B64UUID().string
    'Ft018l4aTwalxqDHMQoqTQ'
  • Short ID from UUID

    >>> from uuid import uuid1
    >>> from b64uuid import B64UUID
    >>>
    >>> uid = uuid1()
    >>> str(uid)
    'cb6e319c-d793-11ea-9619-1cb72cde3f7f'
    >>> bid = B64UUID(uid)
    >>> str(bid)
    'y24xnNeTEeqWGRy3LN4_fw'
  • Short ID to UUID

    >>> from uuid import uuid1
    >>> from b64uuid import B64UUID
    >>>
    >>> uid = uuid1()
    >>> uid.hex
    '95327416d79411ea96191cb72cde3f7f'
    >>> short_id = B64UUID(uid).string
    >>> short_id
    'lTJ0FteUEeqWGRy3LN4_fw'
    >>> B64UUID(short_id).uuid.hex
    '95327416d79411ea96191cb72cde3f7f'

About

A small Python library and command-line tool to encode/decode UUID to/from a 22 characters shorter URL safe base64 string.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages