Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

A simple packaging tool for simple packages.

Project description

Flit is a simple way to put Python packages and modules on PyPI.

Install

$ python3 -m pip install flit

Flit requires Python 3 and therefore needs to be installed using the Python 3 version of pip.

Python 2 modules can be distributed using Flit, but need to be importable on Python 3 without errors.

Usage

Say you’re writing a module foobar — either as a single file foobar.py, or as a directory — and you want to distribute it.

  1. Make sure that foobar’s docstring starts with a one-line summary of what the module is, and that it has a __version__:

    """An amazing sample package!"""
    
    __version__ = '0.1'
    
  2. Install flit if you don’t already have it:

    python3 -m pip install flit
    
  3. Run flit init to create a pyproject.toml file. It will look something like this:

    [build-system]
    requires = ["flit"]
    build-backend = "flit.buildapi"
    
    [tool.flit.metadata]
    module = "foobar"
    author = "Sir Robin"
    author-email = "robin@camelot.uk"
    home-page = "https://github.com/sirrobin/foobar"
    

    You can edit this file to add other metadata, for example to set up command line scripts. See the pyproject.toml page of the documentation.

    If you have already got a flit.ini file to use with older versions of Flit, it will still work for now, but you should convert it to pyproject.toml when convenient.

  4. Run this command to upload your code to PyPI:

    flit publish
    

To install a package locally for development, run:

flit install [--symlink] [--python path/to/python]

Flit packages a single importable module or package at a time, using the import name as the name on PyPI. All subpackages and data files within a package are included automatically.

Documentation

See Flit’s documentation for more information.

Project details


Release history Release notifications

This version
History Node

1.0

History Node

0.13

History Node

0.12.3

History Node

0.12.2

History Node

0.12.1

History Node

0.12

History Node

0.11.4

History Node

0.11.3

History Node

0.11.2

History Node

0.11.1

History Node

0.11

History Node

0.10

History Node

0.9

History Node

0.8.1

History Node

0.8

History Node

0.7.2

History Node

0.7.1

History Node

0.7

History Node

0.6

History Node

0.5.1

History Node

0.5

History Node

0.4

History Node

0.3

History Node

0.2

History Node

0.1

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
flit-1.0-py3-none-any.whl (157.0 kB) Copy SHA256 hash SHA256 Wheel py3 Apr 7, 2018
flit-1.0.tar.gz (87.7 kB) Copy SHA256 hash SHA256 Source None Apr 7, 2018

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page