Name | flit JSON |
Version |
3.9.0
JSON |
| download |
home_page | None |
Summary | A simple packaging tool for simple packages. |
upload_time | 2023-05-14 14:49:09 |
maintainer | None |
docs_url | None |
author | None |
requires_python | >=3.6 |
license | None |
keywords |
|
VCS |
|
bugtrack_url |
|
requirements |
No requirements were recorded.
|
Travis-CI |
No Travis.
|
coveralls test coverage |
|
**Flit** is a simple way to put Python packages and modules on PyPI.
It tries to require less thought about packaging and help you avoid common
mistakes.
See `Why use Flit? <https://flit.readthedocs.io/en/latest/rationale.html>`_ for
more about how it compares to other Python packaging tools.
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__``:
.. code-block:: python
"""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`` in the directory containing the module to create a
``pyproject.toml`` file. It will look something like this:
.. code-block:: ini
[build-system]
requires = ["flit_core >=3.2,<4"]
build-backend = "flit_core.buildapi"
[project]
name = "foobar"
authors = [{name = "Sir Robin", email = "robin@camelot.uk"}]
dynamic = ["version", "description"]
[project.urls]
Home = "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 <https://flit.readthedocs.io/en/latest/pyproject_toml.html#scripts-section>`_
of the documentation.
If you have already got a ``flit.ini`` file to use with older versions of
Flit, convert it to ``pyproject.toml`` by running ``python3 -m flit.tomlify``.
4. Run this command to upload your code to PyPI::
flit publish
Once your package is published, people can install it using *pip* just like
any other package. In most cases, pip will download a 'wheel' package, a
standard format it knows how to install. If you specifically ask pip to install
an 'sdist' package, it will install and use Flit in a temporary environment.
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.
Raw data
{
"_id": null,
"home_page": null,
"name": "flit",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": null,
"keywords": null,
"author": null,
"author_email": "Thomas Kluyver <thomas@kluyver.me.uk>",
"download_url": "https://files.pythonhosted.org/packages/b1/a6/e9227cbb501aee4fa4a52517d3868214036a7b085d96bd1e4bbfc67ad6c6/flit-3.9.0.tar.gz",
"platform": null,
"description": "**Flit** is a simple way to put Python packages and modules on PyPI.\nIt tries to require less thought about packaging and help you avoid common\nmistakes.\nSee `Why use Flit? <https://flit.readthedocs.io/en/latest/rationale.html>`_ for\nmore about how it compares to other Python packaging tools.\n\nInstall\n-------\n\n::\n\n $ python3 -m pip install flit\n\nFlit requires Python 3 and therefore needs to be installed using the Python 3\nversion of pip.\n\nPython 2 modules can be distributed using Flit, but need to be importable on\nPython 3 without errors.\n\nUsage\n-----\n\nSay you're writing a module ``foobar`` \u2014 either as a single file ``foobar.py``,\nor as a directory \u2014 and you want to distribute it.\n\n1. Make sure that foobar's docstring starts with a one-line summary of what\n the module is, and that it has a ``__version__``:\n\n .. code-block:: python\n\n \"\"\"An amazing sample package!\"\"\"\n\n __version__ = \"0.1\"\n\n2. Install flit if you don't already have it::\n\n python3 -m pip install flit\n\n3. Run ``flit init`` in the directory containing the module to create a\n ``pyproject.toml`` file. It will look something like this:\n\n .. code-block:: ini\n\n [build-system]\n requires = [\"flit_core >=3.2,<4\"]\n build-backend = \"flit_core.buildapi\"\n\n [project]\n name = \"foobar\"\n authors = [{name = \"Sir Robin\", email = \"robin@camelot.uk\"}]\n dynamic = [\"version\", \"description\"]\n\n [project.urls]\n Home = \"https://github.com/sirrobin/foobar\"\n\n You can edit this file to add other metadata, for example to set up\n command line scripts. See the\n `pyproject.toml page <https://flit.readthedocs.io/en/latest/pyproject_toml.html#scripts-section>`_\n of the documentation.\n\n If you have already got a ``flit.ini`` file to use with older versions of\n Flit, convert it to ``pyproject.toml`` by running ``python3 -m flit.tomlify``.\n\n4. Run this command to upload your code to PyPI::\n\n flit publish\n\nOnce your package is published, people can install it using *pip* just like\nany other package. In most cases, pip will download a 'wheel' package, a\nstandard format it knows how to install. If you specifically ask pip to install\nan 'sdist' package, it will install and use Flit in a temporary environment.\n\n\nTo install a package locally for development, run::\n\n flit install [--symlink] [--python path/to/python]\n\nFlit packages a single importable module or package at a time, using the import\nname as the name on PyPI. All subpackages and data files within a package are\nincluded automatically.\n",
"bugtrack_url": null,
"license": null,
"summary": "A simple packaging tool for simple packages.",
"version": "3.9.0",
"project_urls": {
"Changelog": "https://flit.pypa.io/en/stable/history.html",
"Documentation": "https://flit.pypa.io",
"Source": "https://github.com/pypa/flit"
},
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "680eb1d1a1201215bf54adea518e79d0f0e84e376bec896c3a6ed437e5201471",
"md5": "600abd32e68eccf1415dc63066357ad3",
"sha256": "076c3aaba5ac24cf0ad3251f910900d95a08218e6bcb26f21fef1036cc4679ca"
},
"downloads": -1,
"filename": "flit-3.9.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "600abd32e68eccf1415dc63066357ad3",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 49856,
"upload_time": "2023-05-14T14:49:06",
"upload_time_iso_8601": "2023-05-14T14:49:06.202806Z",
"url": "https://files.pythonhosted.org/packages/68/0e/b1d1a1201215bf54adea518e79d0f0e84e376bec896c3a6ed437e5201471/flit-3.9.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "b1a6e9227cbb501aee4fa4a52517d3868214036a7b085d96bd1e4bbfc67ad6c6",
"md5": "f18a36cfbbc28dabc7c32d8849327ae9",
"sha256": "d75edf5eb324da20d53570a6a6f87f51e606eee8384925cd66a90611140844c7"
},
"downloads": -1,
"filename": "flit-3.9.0.tar.gz",
"has_sig": false,
"md5_digest": "f18a36cfbbc28dabc7c32d8849327ae9",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 141104,
"upload_time": "2023-05-14T14:49:09",
"upload_time_iso_8601": "2023-05-14T14:49:09.476089Z",
"url": "https://files.pythonhosted.org/packages/b1/a6/e9227cbb501aee4fa4a52517d3868214036a7b085d96bd1e4bbfc67ad6c6/flit-3.9.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-05-14 14:49:09",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "pypa",
"github_project": "flit",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"tox": true,
"lcname": "flit"
}