diff --git a/DEVELOPMENT.md b/DEVELOPMENT.md index f62d095..b355ed4 100644 --- a/DEVELOPMENT.md +++ b/DEVELOPMENT.md @@ -1,6 +1,6 @@ # Python Project Bootstrapper -This page contains information associated with the content generated by `PythonProjectBootstrapper`. Please see [README.md](https://github.com/gt-sse-center/PythonProjectBootstrapper) for information about `PythonProjectBootstrapper` itself. +This page contains information associated with the content generated by `PythonProjectBootstrapper`. Please see [README.md](https://github.com/gt-sse-center/PythonProjectBootstrapper/blob/main/README.md) for information about `PythonProjectBootstrapper` itself. ## Generated Content @@ -22,6 +22,8 @@ Automated tests that exercise functionality defined within your package. There s Script that prepares your repository for development within the local environment. This script installs python (if necessary), creates a virtual python environment, and installs the python dependencies defined in `pyproject.toml`. In addition, it creates the files `Activate.sh` / `Activate.cmd` and `Deactivate.sh` / `Deactivate.cmd`. +Visit [PythonBootstrapper](https://github.com/davidbrownell/PythonBootstrapper) for more information about these files. + ### `Build.py` The entry point for local development activities for your repository. Run `python Build.py --help` for more information about this script. diff --git a/README.md b/README.md index 0261df2..e43043f 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,3 @@ -# PythonProjectBootstrapper - [](https://github.com/gt-sse-center/PythonProjectBootstrapper/actions/workflows/standard.yaml) [](https://github.com/gt-sse-center/PythonProjectBootstrapper/actions) [](https://github.com/gt-sse-center/PythonProjectBootstrapper/blob/master/LICENSE.txt) @@ -9,9 +7,7 @@ [](https://pypistats.org/packages/pythonprojectbootstrapper) -# PythonProjectBootstrapper - -Tools that help in the creation of python projects. +Tool that helps in the creation of python projects. ### Quick Start @@ -24,7 +20,7 @@ Tools that help in the creation of python projects. #### Functionality Provided in Generated Projects -- Simple local development through `Build.py` (see [Local Development](#local-development)) +- Simple local development through `Build.py` (see [Local Development](#local-development) for more information) - Python bootstrapping via [PythonBootstrapper](https://github.com/davidbrownell/PythonBootstrapper) - Source code formatting via [black](https://github.com/psf/black) - Static source analysis via [pylint](https://github.com/pylint-dev/pylint) @@ -39,7 +35,7 @@ Tools that help in the creation of python projects. #### Project Content Customization -Please see [DEVELOPMENT.md](https://github.com/gt-sse-center/PythonProjectBootstrapper/DEVELOPMENT.md) for information on the generated content and how to make common modifications to that content. +Please see [DEVELOPMENT.md](https://github.com/gt-sse-center/PythonProjectBootstrapper/blob/main/DEVELOPMENT.md) for information on the generated content and how to make common modifications to that content. ### How to use PythonProjectBootstrapper @@ -58,19 +54,19 @@ From a terminal window, run one of the commands below. You will be asked a serie
PythonProjectBootstrapper package <output_dir>- ┌──────────────────────────────────────────────────────────────────────────────── Python Package ─────────────────────────────────────────────────────────────────────────────────┐ - │ │ - │ This project creates a Python package hosted on GitHub that uploads a Python wheel to PyPi. It also includes opt-in functionality to create docker images that ensure the exact │ - │ reproducibility of all commits (which is especially useful for scientific software). │ - │ │ - │ If you continue, you will be asked a series of questions about your project and given step-by-step instructions on how to set up your project so that it works with 3rd party │ - │ solutions (GitHub, PyPi, etc.). │ - │ │ - │ The entire process should take about 20 minutes to complete. │ - │ │ - └─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ +┌──────────────────────────────────────────────────────────────────────────────── Python Package ─────────────────────────────────────────────────────────────────────────────────┐ +│ │ +│ This project creates a Python package hosted on GitHub that uploads a Python wheel to PyPi. It also includes opt-in functionality to create docker images that ensure the exact │ +│ reproducibility of all commits (which is especially useful for scientific software). │ +│ │ +│ If you continue, you will be asked a series of questions about your project and given step-by-step instructions on how to set up your project so that it works with 3rd party │ +│ solutions (GitHub, PyPi, etc.). │ +│ │ +│ The entire process should take about 20 minutes to complete. │ +│ │ +└─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ - Enter 'yes' to continue or 'no' to exit: +Enter 'yes' to continue or 'no' to exit: