Skip to main content

TinyScript Tweet

Make a CLI tool with very few lines of code.

PyPi Read The Docs Build Status Coverage Status Python Versions Known Vulnerabilities License

This library is aimed to provide useful features and helpers in order to shorten the number of required lines of code for writing simple and nice-looking command-line interface tools. It is based on argparse and is considered a development kit, on the contrary of popular frameworks like cement, click or docopt, as it is not aimed to reinvent the wheel in yet another paradigm.

pip install tinyscript

Philosophy

This library is built with the DRY (Don't Repeat Yourself) and KISS (Keep It Stupid Simple) philosophies in mind ; the whole machinery of Tinyscript holds in its star import (from tinyscript import *) and its initialization (with the initialize function).

It is aimed to shorten required code by setting a few things while loaded:

  • a proxy parser (coming from the star import) collects arguments definitions and formats help at initialization, preventing from rewriting the whole bunch of code needed to declare an ArgumentParser (and define its epilog, and so forth)
  • a main (colored) logger is preconfigured and can be tuned through two constants so that we don't care for writing a bunch of code needed to configure logging
  • preimports (while a bit anti-Pythonic, we confess) of common libraries also reduces the quantity of code required
  • among these, some modules are enhanced with new functions and classes that are not natively foreseen

Leveraging this allows to create very short scripts with only the real code that matters, reducing the code to be rewritten to create efficient, nice-looking and sophisticated CLI tools.

Note that, while star imports should be avoided according to Python's style guide (see PEP8), it is deliberately extensively used and covering a huge scope in order to shorten code length. This "anti-pattern" pays off after creating a few tools, when we can realize it shortens parts of the code that are often repeated from a tool to another (e.g. for shaping tool's help message).

Usage

It is designed to be as simple and straightforward to use as possible. In order to learn and use it, you only need your browser (for consulting the documentation), a text editor and a good Python Interpreter (e.g. IDLE) for using auto-completion or an IDE like PyCharm to get helpers suggested.

The point is that you will use:

  • features, enabled by setting flags in the "master" function called ìnitialize
  • helpers, grouped under the "master" submodule called ts
  • reporting objects from the global scope

Please see the example tools herebelow for examples of usage of features, helpers and reporting.

Quick Start

Create from template

Edit source

Run your tool

Example tools

Security

Utils

Metadata

Release files for tinyscript 1.31.3

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

Source distribution (sdist)

Source distribution for tinyscript 1.31.3
File Size Uploaded
tinyscript-1.31.3.tar.gz 1.3 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for tinyscript 1.31.3
File Interpreter ABI Platform
tinyscript-1.31.3-py3-none-any.whl Python 3 none any Details

Total release size: 1.5 MB

Release files / tinyscript-1.31.3.tar.gz

Download URL tinyscript-1.31.3.tar.gz
Size 1.3 MB
Tags Source
SHA-256 checksum
How to use checksums
70d925d1b9de3d181f79ea421a6a684669644041482ce1839cbe4a94f833b400
BLAKE2b-256 checksum
How to use checksums
059e5d55fb7862a7860b2d630e71d57c4c4e3ff566db19b9db4bc50d96519f18
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 9, 2026.

Transparency log

Release files / tinyscript-1.31.3-py3-none-any.whl

Download URL tinyscript-1.31.3-py3-none-any.whl
Size 175.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
23498a30e3f71ddc934b3781a36e27692405316ce377f78863c24eca9f53cf90
BLAKE2b-256 checksum
How to use checksums
f36cd93dae20938fdfd8443992b791ac8d629cdecfda4cade7311ce923b257b0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 9, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

1.31.3 This release

2 release files

1.31.2

2 release files

1.31.1

2 release files

1.29.5

2 release files

1.28.6

2 release files

1.27.5

2 release files

1.26.13

1 release file

1.26.12

1 release file

1.26.10

1 release file

1.26.5

1 release file

1.26.0

1 release file

1.25.4

1 release file

1.23.24

1 release file

1.23.23

1 release file

1.23.22

1 release file

1.23.19

1 release file

1.23.17

1 release file

1.23.14

1 release file

1.23.13

1 release file

1.23.12

1 release file

1.23.11

1 release file

1.23.10

1 release file

1.23.9

1 release file

1.23.7

1 release file

1.23.6

1 release file

1.23.5

1 release file

1.23.4

1 release file

1.23.2

1 release file

1.23.0

1 release file

1.22.12

1 release file

1.22.9

1 release file

1.22.8

1 release file

1.22.7

1 release file

1.22.6

1 release file

1.22.5

1 release file

1.22.4

1 release file

1.22.3

1 release file

1.22.1

1 release file

1.21.8

1 release file

1.21.7

1 release file

1.21.3

1 release file

1.21.2

1 release file

1.21.1

1 release file

1.21.0

1 release file

1.20.1

1 release file

1.20.0

1 release file

1.18.0

1 release file

1.17.6

1 release file

1.17.5

1 release file

1.17.4

1 release file

1.17.3

1 release file

1.17.2

1 release file

1.17.1

1 release file

1.16.11

1 release file

1.16.10

1 release file

1.16.7

1 release file

1.16.6

1 release file

1.16.3

1 release file

1.16.2

1 release file

1.15.14

1 release file

1.15.13

1 release file

1.15.7

1 release file

1.14.5

1 release file

1.13.0

1 release file

1.12.3

1 release file

1.11.0

1 release file

1.9.5

1 release file

1.8.1

1 release file

1.7.2

1 release file

1.6.5

1 release file

1.5.3

1 release file

1.4.0

1 release file

1.3.0

1 release file

1.2.1

1 release file

1.1.7

1 release file

1.1.4

1 release file

1.0.0

1 release file

0.3.20

1 release file

0.3.14

1 release file

0.3.11

1 release file

0.3.9

1 release file

0.3.7

1 release file

0.3.6

1 release file

0.3.3

1 release file

0.3.0

1 release file

0.2.5

1 release file

0.2.3

1 release file

0.1

1 release file

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