Skip to main content

token-utils

Installation: pip install token-utils.

The purpose of token-utils is to simplify manipulations of tokens normally obtaind from Python's tokenize module. One of token-utils' features is that, unlike Python's version, the following is always guaranteed:

from token_utils import tokenize, untokenize

source = "Arbitrary Python code here"

assert source == untokenize(tokenize(source))

To get an idea of the simplicity of using token-utils, consider this example from Python's standard library which substitute Decimals for floats in a string of statements:

from tokenize import tokenize, untokenize, NUMBER, STRING, NAME, OP
from io import BytesIO

def decistmt(s):
    result = []
    g = tokenize(BytesIO(s.encode('utf-8')).readline)  # tokenize the string
    for toknum, tokval, _, _, _ in g:
        if toknum == NUMBER and '.' in tokval:  # replace NUMBER tokens
            result.extend([
                (NAME, 'Decimal'),
                (OP, '('),
                (STRING, repr(tokval)),
                (OP, ')')
            ])
        else:
            result.append((toknum, tokval))
    return untokenize(result).decode('utf-8')

Here's how you could achieve the same result with token-utils:

from token_utils import tokenize, untokenize

def decistmt(source):
    tokens = tokenize(source)
    for token in tokens:
        if token.is_float():
            token.string = f"Decimal('{token.string}')"
    return untokenize(tokens)

See the documentation for more information.

Metadata

Release files for token-utils 0.3.1

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

Source distribution (sdist)

Source distribution for token-utils 0.3.1
File Size Uploaded
token_utils-0.3.1.tar.gz 7.8 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for token-utils 0.3.1
File Interpreter ABI Platform
token_utils-0.3.1-py3-none-any.whl Python 3 none any Details

Total release size: 7.8 MB

Release files / token_utils-0.3.1.tar.gz

Download URL token_utils-0.3.1.tar.gz
Size 7.8 MB
Tags Source
SHA-256 checksum
How to use checksums
4040e443b3622f9768fa59a34168392856ebb21b1669da5b57becd22718663ed
BLAKE2b-256 checksum
How to use checksums
a99ea753381dcf2aab7333b8b994352762a91a266e990e23a8ec733d58e50b8a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.10.11

Release files / token_utils-0.3.1-py3-none-any.whl

Download URL token_utils-0.3.1-py3-none-any.whl
Size 19.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
73e89f24818e17f726f5e898c8d508187be4bb1728f70131a1f432cbcba71090
BLAKE2b-256 checksum
How to use checksums
b388beece75e7a9b55f338a3e053844d2983584c15dcce5fcda7f74d21cd2a8f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.10.11

Release history Release notifications | RSS feed

This release

0.3.1 This release

2 release files

0.3.0

2 release files

0.2.4

2 release files

0.2.3

2 release files

0.2.2

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.8

2 release files

0.1.7

2 release files

0.1.6

2 release files

0.1.5

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

0.0.9

2 release files

0.0.8

2 release files

0.0.7

2 release files

0.0.6

2 release files

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