Skip to content

Commit 10df275

Browse files
Merge pull request #37 from Dog-Face-Development/willtheorangeguy-installation-update
Update installation instructions
2 parents a26be4b + 27eaeae commit 10df275

File tree

3 files changed

+54
-8
lines changed

3 files changed

+54
-8
lines changed

CHANGELOG.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,12 @@
11
# Changelog
22

3+
## [v1.2.0](https://github.com/willtheorangeguy/PyWorkout/releases/tag/v1.2.0)
4+
5+
### Added
6+
7+
- Docker container.
8+
- PyPI package.
9+
310
## [v1.1.0](https://github.com/willtheorangeguy/PyWorkout/releases/tag/v1.1.0)
411

512
### Added

README.md

Lines changed: 30 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -12,9 +12,9 @@
1212
<!-- Badges -->
1313
<div align="center">
1414
<!-- Stability -->
15-
<img alt="GitHub Test State" src="https://github.com/Dog-Face-Development/PyWorkout/actions/workflows/test.yml/badge.svg">
15+
<img alt="Docker Build State" src="https://github.com/Dog-Face-Development/PyWorkout/actions/workflows/docker-publish.yml/badge.svg">
1616
<!-- Stability -->
17-
<img alt="GitHub Build State" src="https://github.com/Dog-Face-Development/PyWorkout/actions/workflows/build.yml/badge.svg">
17+
<img alt="PyPI Build State" src="https://github.com/Dog-Face-Development/PyWorkout/actions/workflows/push-to-pypi.yml/badge.svg">
1818
<!-- Stability -->
1919
<img alt="Pylint State" src="https://github.com/Dog-Face-Development/PyWorkout/actions/workflows/pylint.yml/badge.svg">
2020
<!-- CodeQL -->
@@ -67,7 +67,11 @@ You can **[download](https://github.com/Dog-Face-Development/PyWorkout/releases/
6767

6868
## How To Use
6969

70-
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:
70+
To run the application, you can use [Git and the Python Interpreter](https://github.com/Dog-Face-Development/PyWorkout/main/README.md#git), which allows you to clone and run the application, [`pip`](https://github.com/Dog-Face-Development/PyWorkout/main/README.md#pip) to create a command line application, or [Docker](https://github.com/Dog-Face-Development/PyWorkout/main/README.md#docker) to create a container of the application.
71+
72+
### Git
73+
74+
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:
7175

7276
```bash
7377
# Clone this repository
@@ -78,9 +82,30 @@ $ cd PyWorkout
7882

7983
# Run the CLI
8084
$ python main.py
85+
```
86+
87+
### `pip`
88+
89+
You can install the program from the [Python Package Index](https://pypi.org/project/PyWorkout/) through `pip`.
90+
91+
```bash
92+
# Install via pip
93+
$ pip install pyworkout
94+
95+
# Run the CLI
96+
$ pyworkout
97+
```
98+
99+
### Docker
100+
101+
You can pull the [Docker](https://www.docker.com/) image from GitHub Packages. From your command line:
102+
103+
```bash
104+
# Pull image
105+
$ docker pull ghcr.io/dog-face-development/pyworkout:main
81106

82-
# Run the GUI app
83-
$ python gui.py
107+
# Run container
108+
$ docker run -i -t ghcr.io/dog-face-development/pyworkout:main python main.py
84109
```
85110

86111
## Support

docs/USAGE.md

Lines changed: 17 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,33 @@
11
# PyWorkout Usage
22

3-
To install PyWorkout, you can either use an executable package (Windows), or run the scripts through Python (Windows, macOS, Linux).
3+
To install PyWorkout you can use an executable package (Windows), run the scripts through Python (Windows, macOS, Linux), install from the [Python Package Index](https://pypi.org/), or run a [Docker](https://www.docker.com/) container from [GitHub Packages](https://github.com/Dog-Face-Development/PyWorkout/pkgs/container/pyworkout).
44

55
## Executable Package
66

77
1. To run the executable package, download the latest `.zip` file from [GitHub Releases](https://github.com/Dog-Face-Development/PyWorkout/releases/latest) page.
88
2. Extract the `.zip` file using a program like [7-Zip](https://www.7-zip.org/).
99
3. _(Optional) Move the files to `C:\Program Files` and create a shortcut._
10-
4. Double click on `main.exe`.
10+
4. Double click on `send.exe`.
1111
5. Enjoy the program!
1212

1313
## Python Script
1414

1515
1. To run the Python script, download the latest source code release from [GitHub Releases](https://github.com/Dog-Face-Development/PyWorkout/releases/latest) page.
1616
2. Download and install [Python](https://www.python.org/downloads/).
1717
3. Extract the source code files using a program like [7-Zip](https://www.7-zip.org/).
18-
4. Double click on `main.py`, or right-click and open with IDLE and press `F5`.
18+
4. Double click on `send.py`, or right-click and open with IDLE and press `F5`.
1919
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 pyworkout`.
25+
3. Start the program by running the command: `pyworkout`.
26+
4. Enjoy the program!
27+
28+
## Docker Container
29+
30+
1. Download and install [Docker](https://www.docker.com/products/docker-desktop/).
31+
2. Open a terminal and pull the container: `docker pull ghcr.io/dog-face-development/pyworkout:main`.
32+
3. Start the container: `docker run -i -t ghcr.io/dog-face-development/pyworkout:main python main.py`.
33+
4. Enjoy the program!

0 commit comments

Comments
 (0)