Skip to content

Commit 6d8bb46

Browse files
Merge pull request #34 from Dog-Face-Development/willtheorangeguy-new-install-docs
Add new installation instructions
2 parents 22c9803 + 1af3b92 commit 6d8bb46

File tree

2 files changed

+44
-15
lines changed

2 files changed

+44
-15
lines changed

README.md

Lines changed: 20 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -12,9 +12,7 @@
1212
<!-- Badges -->
1313
<div align="center">
1414
<!-- Stability -->
15-
<img alt="GitHub Test State" src="https://github.com/Dog-Face-Development/ProgramVer/actions/workflows/test.yml/badge.svg">
16-
<!-- Stability -->
17-
<img alt="GitHub Build State" src="https://github.com/Dog-Face-Development/ProgramVer/actions/workflows/build.yml/badge.svg">
15+
<img alt="PyPI Build State" src="https://github.com/Dog-Face-Development/ProgramVer/actions/workflows/push-to-pypi.yml/badge.svg">
1816
<!-- Stability -->
1917
<img alt="Pylint State" src="https://github.com/Dog-Face-Development/ProgramVer/actions/workflows/pylint.yml/badge.svg">
2018
<!-- CodeQL -->
@@ -66,19 +64,35 @@ You can **[download](https://github.com/Dog-Face-Development/ProgramVer/releases
6664

6765
## How To Use
6866

69-
To clone and run this application, you'll need [Git](https://git-scm.com/downloads) and [Python](https://www.python.org/downloads/) installed on your computer. If you would rather not use Git, you can just download the scripts from GitHub above. From your command line:
67+
To run the application, you can use [Git and the Python Interpreter](https://github.com/Dog-Face-Development/ProgramVer/main/README.md#git), which allows you to clone and run the application, or [`pip`](https://github.com/Dog-Face-Development/ProgramVer/main/README.md#pip) to create a command line application.
68+
69+
### Git
70+
71+
To clone and run this application, you'll need [Git](https://git-scm.com/downloads) and [Python](https://www.python.org/downloads/) installed on your computer. If you would rather not use Git, you can just download the script from GitHub above. From your command line:
7072

7173
```bash
7274
# Clone this repository
73-
$ git clone https://github.com/Dog-Face-Development/ProgramVer.git
75+
$ git clone https://github.com/Dog-Face-Development/ProgramVer
7476

7577
# Go into the repository
7678
$ cd ProgramVer
7779

78-
# Run ProgramVer
80+
# Run the CLI
7981
$ python main.py
8082
```
8183

84+
### `pip`
85+
86+
You can install the program from the [Python Package Index](https://pypi.org/project/programver/) through `pip`.
87+
88+
```bash
89+
# Install via pip
90+
$ pip install programver
91+
92+
# Run the CLI
93+
$ programver
94+
```
95+
8296
However, you may want to add the version window to your program. To do so, follow these steps:
8397

8498
1. Download the latest source code release from [GitHub Releases](https://github.com/Dog-Face-Development/ProgramVer/releases/latest) page.

docs/USAGE.md

Lines changed: 24 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,26 @@
11
# ProgramVer Usage
22

3-
To add ProgramVer to your project, follow the steps below. To customize the program to your needs, see [`CUSTOMIZATION`](CUSTOMIZATION.md).
4-
5-
1. To add the version window to your project, download the latest source code release from [GitHub Releases](https://github.com/Dog-Face-Development/ProgramVer/releases/latest) page.
6-
2. Extract the source code files using a program like [7-Zip](https://www.7-zip.org/).
7-
3. Copy the `ProgramVer.py` file to your project's main directory.
8-
4. Import ProgramVer by adding `from ProgramVer import *` to your Python `import` statements.
9-
5. Customize the version window by following the instructions in [`CUSTOMIZATION`](CUSTOMIZATION.md).
10-
6. Call ProgramVer through the `ProgramVer()` function.
11-
7. Enjoy your new version window!
3+
To install ProgramVer, you can use an executable package (Windows), run the scripts through Python (Windows, macOS, Linux), or install from the [Python Package Index](https://pypi.org/).
4+
5+
## Executable Package
6+
7+
1. To run the executable package, download the latest `.zip` file from [GitHub Releases](https://github.com/Dog-Face-Development/ProgramVer/releases/latest) page.
8+
2. Extract the `.zip` file using a program like [7-Zip](https://www.7-zip.org/).
9+
3. _(Optional) Move the files to `C:\Program Files` and create a shortcut._
10+
4. Double click on `send.exe`.
11+
5. Enjoy the program!
12+
13+
## Python Script
14+
15+
1. To run the Python script, download the latest source code release from [GitHub Releases](https://github.com/Dog-Face-Development/ProgramVer/releases/latest) page.
16+
2. Download and install [Python](https://www.python.org/downloads/).
17+
3. Extract the source code files using a program like [7-Zip](https://www.7-zip.org/).
18+
4. Double click on `send.py`, or right-click and open with IDLE and press `F5`.
19+
5. Enjoy the program!
20+
21+
## Python Package Index (`pip`)
22+
23+
1. Download and install [Python](https://www.python.org/downloads/).
24+
2. Open a terminal and run the command: `pip install lego-block-creator`.
25+
3. Start the program by running the command: `lego-block-creator`.
26+
4. Enjoy the program!

0 commit comments

Comments
 (0)