Metadata-Version: 2.1
Name: incipyt
Version: 0.4.0
Summary: incipyt is a command-line tool that bootstraps a python project.
Author-email: Not at Name <julien@drlazor.be>
Maintainer-email: Not at Name <julien@drlazor.be>
Requires-Python: >=3.8, <4.0
Description-Content-Type: text/markdown
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Software Development
Requires-Dist: click
Requires-Dist: signalslot
Requires-Dist: tomli_w
Requires-Dist: tomli; python_version<'3.11'
Requires-Dist: flit==3.9.0 ; extra == "dev"
Requires-Dist: pre-commit==3.3.2 ; extra == "dev"
Requires-Dist: m2r2==0.3.2 ; extra == "doc"
Requires-Dist: sphinxcontrib-apidoc==0.3.0 ; extra == "doc"
Requires-Dist: sphinx_rtd_theme==1.2.1 ; extra == "doc"
Requires-Dist: pytest-cov==4.1.0 ; extra == "test"
Requires-Dist: pytest-subprocess==1.5.0 ; extra == "test"
Project-URL: documentation, https://github.com/NotANameServer/incipyt/wiki
Project-URL: homepage, https://pypi.org/incipyt
Project-URL: repository, https://github.com/NotANameServer/incipyt
Provides-Extra: dev
Provides-Extra: doc
Provides-Extra: test

# incipyt

*It begins...*

incipyt \[ˈɪŋkɪpɪt̪\] is a command-line tool that bootstraps a Python project.

	$ pip install incipyt

## Usage

incipyt is *not* opinated, by default it setups the tools recommanded in the
[PyPA/packaging-projects] tutorial: [pyproject.toml] and [setuptools] in
addition to [git] and [sphinx] which are de-facto standard.

	$ python -m incipyt mynewproject
	Project Name [mynewproject]:
	Author [John Doe]:
	Author email [john.doe@users.noreply.github.com]: john.doe@example.com
	$ tree mynewproject
	mynewproject/
	├── .git/
	├── docs/
	│   ├── _build/
	│   ├── _static/
	│   ├── _templates/
	│   ├── conf.py
	│   ├── index.rst
	│   ├── make.bat
	│   └── Makefile
	├── mynewproject/
	│   └── __init__.py
	├── tests/
	├── .gitignore
	├── LICENSE
	├── pyproject.toml
	├── README.md
	├── setup.cfg
	└── setup.py

incipyt provides a rich command line interface so you can choose various build
systems, version control system, virtual environments, documentation software,
linters, formatters, etc.

    $ python -m incipyt --help

## Contribute

incipyt is released under the MIT license and is open to contributions

The complete setup instruction are found on the [dev-instructions]. Below is
the minimum to get started:

    $ git clone https://github.com/NotANameServer/incipyt
    $ cd incipyt
    $ git config commit.template .gitmessage
    $ python -m venv --upgrade-deps .env
    $ source .env/bin/activate
    $ python -m pip install --upgrade flit
    $ python -m flit install --pth-file --deps develop
    $ python -m pytest -vv tests
    $ pre-commit & pre-commit install

[PyPA/packaging-projects]: https://packaging.python.org/tutorials/packaging-projects/
[pyproject.toml]: https://www.python.org/dev/peps/pep-0518/
[setuptools]: https://pypi.org/project/setuptools/
[git]: https://git-scm.com/
[sphinx]: https://www.sphinx-doc.org/en/master/
[dev-instructions]: https://github.com/NotANameServer/incipyt/wiki/Developper-instructions

