Skip to main content

PyHatch initializes files and directory structure for new python projects.

Project description

https://img.shields.io/travis/sonofeft/PyHatch.svg https://img.shields.io/pypi/v/PyHatch.svg https://img.shields.io/pypi/pyversions/PyHatch.svg https://img.shields.io/pypi/l/PyHatch.svg

PyHatch

Pyhatch Initializes Files And Directory Structures For New Python Projects.

See the Code at: https://github.com/sonofeft/PyHatch

See the Docs at: http://pyhatch.readthedocs.org/en/latest/

See PyPI page at:https://pypi.python.org/pypi/pyhatch

PyHatch is intended to help technical programmers focus their python programming efforts on their science and engineering problems by easing the many source code organizational issues required to build and maintain a quality code base. PyHatch will initialize the basic file structure for project files, documentation, unit testing and licensing.

Each time a new project is started, the user fills in a few simple forms and selects a directory location for the project layout. The layout used by PyHatch is shown below.:

MyProject/
    myproject/
        __init__.py
        mycode.py
        examples/
            example_1.py
        tests/
            __init__.py
            test_mycode.py
    docs/
        conf.py
        index.rst
    .travis.yml
    HISTORY.rst
    history_from_github_api.py
    LICENSE.txt
    MANIFEST.in
    README.rst
    requirements.txt
    setup.cfg
    setup.py
    tox.ini

One goal of PyHatch is to encourage unit testing. To do that, a “tests” directory is created and initialized. Of the three common locations of the test scripts shown below, PyHatch uses the third option. The user is free to modify this layout, but encouraged to maintain test scripts in one of the following layouts.

Put test scripts:
  1. Mixed into the same directory as mycode.py /MyProject/myproject/

  2. At the same level as the code directory /MyProject/tests/

  3. One level under the code directory /MyProject/myproject/tests/

A tox.ini file is also created in order to simplify running the unit tests with a number of different python versions. Tox will need to be installed separately, however, the new project simply needs to execute tox locally to use it.

The docs/ subdirectory contains the layout required to run sphinx and create documentation for the project. It is set up to automatically read the project *.py files and include code documentation on the fly. Note that Sphinx will need to be installed separately.

Run make html in the docs/ subdirectory (with sphinx installed) to generate HTML documentation for the project. The file index.html is the main page of the documentation in the directory docs/_build/html.

The examples/ subdirectory contains any example files that use the project.

The hope for PyHatch is that better code will result from early organization and test driven development.

Notice that a configuration file (PyHatch.cfg) is created in the users home directory. That configuration file holds project and personal data that will help autofill the PyHatch GUI the second time that PyHatch is used.

See the Code at: https://github.com/sonofeft/PyHatch

See the Docs at: http://pyhatch.readthedocs.org/en/latest/

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

PyHatch-0.0.19.tar.gz (98.7 kB view details)

Uploaded Source

Built Distribution

PyHatch-0.0.19-py2.py3-none-any.whl (104.5 kB view details)

Uploaded Python 2Python 3

File details

Details for the file PyHatch-0.0.19.tar.gz.

File metadata

  • Download URL: PyHatch-0.0.19.tar.gz
  • Upload date:
  • Size: 98.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.4.2 requests/2.21.0 setuptools/40.6.3 requests-toolbelt/0.9.1 tqdm/4.28.1 CPython/2.7.15

File hashes

Hashes for PyHatch-0.0.19.tar.gz
Algorithm Hash digest
SHA256 10c3e942f8b56e362424c9b2ee4e3dacea1ce77e750286ed8dd57e8028bc0186
MD5 c97b86fbbca63d86bc991b6caeee0f6b
BLAKE2b-256 ca49dc60f20fb20a58e543b7269c863ffd4110a72c504323c6d624e212eac46b

See more details on using hashes here.

File details

Details for the file PyHatch-0.0.19-py2.py3-none-any.whl.

File metadata

  • Download URL: PyHatch-0.0.19-py2.py3-none-any.whl
  • Upload date:
  • Size: 104.5 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.4.2 requests/2.21.0 setuptools/40.6.3 requests-toolbelt/0.9.1 tqdm/4.28.1 CPython/2.7.15

File hashes

Hashes for PyHatch-0.0.19-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 21aff4fe3dc72012d24f703b98be01440edee9f5d3349d6f21b7f82c5ac115a9
MD5 670474d9ef1cf64cdd0651975cb429d6
BLAKE2b-256 d9277a2887b9eac105cc5f735655fad55239a16f037c1ed48603d6fabd440daf

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page