pyquickstart 1.1.0

Create Python projects easily using well-defined templates.

pyquickstart

Create Python projects easily using well-defined templates.

Features

• Intuitive Python project creation
• Well-defined standard template

Standard template

We use this template for our own projects following modern best practices:

• Linting with flake8
• Testing automation with pytest and tox for current Python releases
• Measuring code coverage using coverage
• Continuous integration on Gitlab
• Packaging as wheel
• Deployment on PyPI using twine

Technical requirements

Below is the list of currently supported Python releases:

#	Python
1	3.6
2	3.7
3	3.8

Code and contribution

The code is open source and released under the MIT License (MIT). It is available on Gitlab and follows the guidelines about Semantic Versioning for transparency within the release cycle and backward compatibility whenever possible.

All contributions are welcome, whether bug reports, reviews, documentation or feature requests.

If you're a developer and have time and ideas for code contributions, fork the repo and prepare a merge request:

# Prepare your environment the first time
mkvirtualenv --python=python3.6 pyquickstart-py36
pip install -e .[development]

# Running the tests while development
pytest

# Individual Python release tests and code quality checks
tox -e py36
tox -e coverage
tox -e flake8

# Ensure code quality running the entire test suite,
# this requires all supported Python releases to be installed
tox

Installation

Install pyquickstart using pip:

pip install pyquickstart

Usage

Create a new Python project from the standard template in your current working directory by running pyquickstart:

pyquickstart

Then answer a few simple questions, default values in square brackets:

project [shinyprojectname]: 
author [John Doe]: 
author_email [[e-mail]]: 
repository_url [https://gitlab.com/johndoe/shinyprojectname]: 
year [2020]: