Add autometa keyword to the setuptools.setup function which automatically fills version
Project description
To use it, pass the module (without .py), or the package name as the autometa keyword argument for setup():
#! /usr/bin/env python from setuptools import setup setup( autometa='test', name='Test', packages=['test'], ... )
Setuptools-Autometa will parse the specified module or package’s __init__.py and set version to its __version__ attribute, description to the first line of its docstring, and long_description to the rest of the docstring. Additionally build_sphinx command’s version and release options will be set.
For example following package’s __init__.py:
"""First line of docstring. Many more lines of docstring. """ __version__ = '1.2.3.dev0' # alternatively: (1, 2, 3, 'dev0')
Is equivalent to writing:
setup( version='1.2.3.dev0', description='First line of docstring', long_description='Many\nmore\nlines\nof\ndocstring.' ... )
NOTE: Please note, that the version is parsed by running ast.literal_eval on the right side of the assignment to __version__, so keep in mind that it can only be a string literal, or a list/tuple of string/integer literals.
NOTE: Setuptools-Autometa assumes a PEP 0257 compliant docstring, that is its first line has to end with a period and be separated from the description by a blank line.
Additionally you can whitelist which fields are to be parsed by using the autometa_fields keyword argument and setting it to an iterable of field names (‘description’, ‘long_description’, ‘version’).
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
Hashes for Setuptools-Autometa-0.1.1.post1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1522a2370a4f7592e4d909e847f4e914e3e91ffa083b5e302ed3441f3a9ea072 |
|
MD5 | db7d37b7dfcf237ede56a07d08a5d565 |
|
BLAKE2b-256 | cfb2bb615912843866105ccc4067032346c730d795e0441aad9d224442c1629c |
Hashes for Setuptools_Autometa-0.1.1.post1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3eea600e68bcebe25f843c2c03e1524b2a5442a41bfd21f1b2969419ccddc041 |
|
MD5 | cfa88cf54b7e26f824e1632a362caf81 |
|
BLAKE2b-256 | cf7d589cbb659ff87b525bf493b92f9927dae22a4ab83f2df253d69be5a44ff0 |
Hashes for Setuptools_Autometa-0.1.1.post1-py2-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | dbae7e1a85eae66241dc5f340b1de06d1e5aeffdffe804b36297f24f1a0b7883 |
|
MD5 | 42578ba23e160f16eab8f1d8b8a142d6 |
|
BLAKE2b-256 | 2e926d74fa47e31410aca0b0e20e9249e4d45fa56de25dbe229753272dbda433 |