Skip to content

Commit 49a89de

Browse files
Merge pull request #14 from Dog-Face-Development/willtheorangeguy-pypi-install
Add new installation instructions
2 parents 4f1b629 + 40034a3 commit 49a89de

File tree

3 files changed

+35
-8
lines changed

3 files changed

+35
-8
lines changed

CHANGELOG.md

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

3+
## [v0.2.0](https://github.com/Dog-Face-Development/PyAvatar/releases/tag/v0.2.0)
4+
5+
### Added
6+
7+
- Python package.
8+
39
## [v0.1.0](https://github.com/Dog-Face-Development/PyAvatar/releases/tag/v0.1.0)
410

511
### Added

README.md

Lines changed: 19 additions & 5 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/PyAvatar/actions/workflows/test.yml/badge.svg">
16-
<!-- Stability -->
17-
<img alt="GitHub Build State" src="https://github.com/Dog-Face-Development/PyAvatar/actions/workflows/build.yml/badge.svg">
15+
<img alt="PyPI Build State" src="https://github.com/Dog-Face-Development/PyAvatar/actions/workflows/push-to-pypi.yml/badge.svg">
1816
<!-- Stability -->
1917
<img alt="Pylint State" src="https://github.com/Dog-Face-Development/PyAvatar/actions/workflows/pylint.yml/badge.svg">
2018
<!-- CodeQL -->
@@ -66,7 +64,11 @@ You can **[download](https://github.com/Dog-Face-Development/PyAvatar/releases/l
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/PyAvatar/main/README.md#git), which allows you to clone and run the application, or [`pip`](https://github.com/Dog-Face-Development/PyAvatar/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
@@ -75,10 +77,22 @@ $ git clone https://github.com/Dog-Face-Development/PyAvatar
7577
# Go into the repository
7678
$ cd PyAvatar
7779

78-
# Run the App
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/PyAvatar/) through `pip`.
87+
88+
```bash
89+
# Install via pip
90+
$ pip install pyavatar
91+
92+
# Run the CLI
93+
$ pyavatar
94+
```
95+
8296
## Support
8397

8498
To view all available websites and their corresponding avatar's, just launch the app!

docs/USAGE.md

Lines changed: 10 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,26 @@
11
# PyAvatar Usage
22

3-
To install PyAvatar, you can either use an executable package (Windows), or run the scripts through Python (Windows, macOS, Linux).
3+
To install PyAvatar, 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/).
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/PyAvatar/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/PyAvatar/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 pyavatar`.
25+
3. Start the program by running the command: `pyavatar`.
26+
4. Enjoy the program!

0 commit comments

Comments
 (0)