Skip to content
This repository was archived by the owner on Jul 29, 2024. It is now read-only.

Commit 80c1851

Browse files
Minor changes to README.md and DEVELOPMENT.md (#16)
2 parents c2f38d4 + 5c12000 commit 80c1851

File tree

2 files changed

+19
-21
lines changed

2 files changed

+19
-21
lines changed

DEVELOPMENT.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Python Project Bootstrapper
22

3-
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.
3+
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.
44

55
## Generated Content
66

@@ -22,6 +22,8 @@ Automated tests that exercise functionality defined within your package. There s
2222

2323
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`.
2424

25+
Visit [PythonBootstrapper](https://github.com/davidbrownell/PythonBootstrapper) for more information about these files.
26+
2527
### `Build.py`
2628

2729
The entry point for local development activities for your repository. Run `python Build.py --help` for more information about this script.

README.md

Lines changed: 16 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,3 @@
1-
# PythonProjectBootstrapper
2-
31
[![CI](https://github.com/gt-sse-center/PythonProjectBootstrapper/actions/workflows/standard.yaml/badge.svg?event=push)](https://github.com/gt-sse-center/PythonProjectBootstrapper/actions/workflows/standard.yaml)
42
[![Code Coverage](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/davidbrownell/2f9d770d13e3a148424f374f74d41f4b/raw/PythonProjectBootstrapper_coverage.json)](https://github.com/gt-sse-center/PythonProjectBootstrapper/actions)
53
[![License](https://img.shields.io/github/license/gt-sse-center/PythonProjectBootstrapper?color=dark-green)](https://github.com/gt-sse-center/PythonProjectBootstrapper/blob/master/LICENSE.txt)
@@ -9,9 +7,7 @@
97
[![PyPI - Downloads](https://img.shields.io/pypi/dm/PythonProjectBootstrapper)](https://pypistats.org/packages/pythonprojectbootstrapper)
108

119

12-
# PythonProjectBootstrapper
13-
14-
Tools that help in the creation of python projects.
10+
Tool that helps in the creation of python projects.
1511

1612
### Quick Start
1713

@@ -24,7 +20,7 @@ Tools that help in the creation of python projects.
2420

2521
#### Functionality Provided in Generated Projects
2622

27-
- Simple local development through `Build.py` (see [Local Development](#local-development))
23+
- Simple local development through `Build.py` (see [Local Development](#local-development) for more information)
2824
- Python bootstrapping via [PythonBootstrapper](https://github.com/davidbrownell/PythonBootstrapper)
2925
- Source code formatting via [black](https://github.com/psf/black)
3026
- Static source analysis via [pylint](https://github.com/pylint-dev/pylint)
@@ -39,7 +35,7 @@ Tools that help in the creation of python projects.
3935

4036
#### Project Content Customization
4137

42-
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.
38+
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.
4339

4440
### How to use PythonProjectBootstrapper
4541

@@ -58,19 +54,19 @@ From a terminal window, run one of the commands below. You will be asked a serie
5854
<td><code>PythonProjectBootstrapper package &lt;output_dir&gt;</code></td>
5955
<td>
6056
<pre style="background-color: black; color: #AAAAAA; font-size: .75em">
61-
┌──────────────────────────────────────────────────────────────────────────────── Python Package ─────────────────────────────────────────────────────────────────────────────────┐
62-
│ │
63-
│ 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 │
64-
│ reproducibility of all commits (which is especially useful for scientific software). │
65-
│ │
66-
│ 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 │
67-
│ solutions (GitHub, PyPi, etc.). │
68-
│ │
69-
│ The entire process should take about 20 minutes to complete. │
70-
│ │
71-
└─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
57+
┌──────────────────────────────────────────────────────────────────────────────── Python Package ─────────────────────────────────────────────────────────────────────────────────┐
58+
│ │
59+
│ 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 │
60+
│ reproducibility of all commits (which is especially useful for scientific software). │
61+
│ │
62+
│ 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 │
63+
│ solutions (GitHub, PyPi, etc.). │
64+
│ │
65+
│ The entire process should take about 20 minutes to complete. │
66+
│ │
67+
└─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
7268
&nbsp;
73-
Enter 'yes' to continue or 'no' to exit:
69+
Enter 'yes' to continue or 'no' to exit:
7470
</pre>
7571
</td>
7672
</tr>
@@ -154,7 +150,7 @@ Follow these steps to prepare the repository for local development activities.
154150

155151
## Similar Tools
156152

157-
There are other tools available that offer similar functionality, each that emphasizes different domains, conventions, or workflows. They are listed here in the event that one of them is a better fit for the specifics of your scenario.
153+
There are other tools available that offer similar functionality, each emphasizing different domains, conventions, or workflows. They are listed here in the event that one of them is a better fit for the specifics of your scenario.
158154

159155
| Tool | Description |
160156
| --- | --- |

0 commit comments

Comments
 (0)