Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Components for scripts in python 3.6+

Project Description

If you’re going to import antigravity, you’d better make sure the hatch is closed.

The airtight package is written for Python 3.6+. It provides idiosyncratic code that somewhat simplifies the creation and debugging of command-line python scripts.

simpler than a template

Instead of copying some 50-line template for your python script and then writing a bunch of calls to argparse and logging just build some lists describing the arguments and logging level you want and invoke artight.cli.configure_commandline():

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
Example script template using the airtight module

from airtight.cli import configure_commandline
import logging

    # each argument is a list: short option, long option, default value,
    # help string, required?
    ['-l', '--loglevel', 'NOTSET',
        'desired logging level (' +
        'case-insensitive string: DEBUG, INFO, WARNING, or ERROR',
    ['-v', '--verbose', False, 'verbose output (logging level == INFO)',
    ['-w', '--veryverbose', False,
        'very verbose output (logging level == DEBUG)', False],
    ['-x', '--custom', 7, 'your custom argument', False]
    # each argument is a list with 3 elements: name, type, help
    ['foovar', str, 'some input value that you want']

def main(**kwargs):
    """Main function of your script.

    kwargs -- keyword arguments as parsed from the command line
    # your additional code here

if __name__ == "__main__":

make debug logging just a wee bit easier

The airtight.logging module provides two methods: configure_logging(), which is used by airtight.cli.configure_commandline(), and flog(), which reduces typing when you want to log a variable’s name and value.

So, you can write:

> from airtight.logging import flog
> fish = 'salmon'
> flog(fish)
DEBUG:foo_script: fish: 'salmon'

flog() logs to DEBUG by default, but an optional keyword argument level may be used to specify another standard level, e.g.:

> from airtight.logging import flog
> import logging
> fish = 'salmon'
> flog(fish, level=logging.WARNING)
WARNING:foo_script: fish: 'salmon'

Another optional keyword argument (comment) may be specified. A string value supplied via this argument will be postfixed to the logged variable name and value, thus:

> from airtight.logging import flog
> fish = 'salmon'
> flog(fish, comment='I like this fish!')
DEBUG:foo_script: fish: 'salmon' I like this fish!


Bug reports and feature requests are welcome, but really I’d prefer pull requests.


  • docstrings

Release History

This version
History Node


History Node


History Node


History Node


History Node


Download Files

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

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(16.9 kB) Copy SHA256 Hash SHA256
Source None Oct 8, 2017

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers