Skip to content

Commit 473a8eb

Browse files
Merge pull request #29 from Dog-Face-Development/willtheorangeguy-v0.3.0
Add new install instructions
2 parents d809df2 + c9b83bc commit 473a8eb

File tree

3 files changed

+56
-8
lines changed

3 files changed

+56
-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+
## [v0.3.0](https://github.com/willtheorangeguy/LEGO-Block-Creator/releases/tag/v0.3.0)
4+
5+
### Added
6+
7+
- Docker container.
8+
- PyPI package.
9+
310
## [v0.2.0](https://github.com/willtheorangeguy/LEGO-Block-Creator/releases/tag/v0.2.0)
411

512
### Added

README.md

Lines changed: 32 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/LEGO-Block-Creator/actions/workflows/test.yml/badge.svg">
15+
<img alt="Docker Build State" src="https://github.com/Dog-Face-Development/LEGO-Block-Creator/actions/workflows/docker-publish.yml/badge.svg">
1616
<!-- Stability -->
17-
<img alt="GitHub Build State" src="https://github.com/Dog-Face-Development/LEGO-Block-Creator/actions/workflows/build.yml/badge.svg">
17+
<img alt="PyPI Build State" src="https://github.com/Dog-Face-Development/LEGO-Block-Creator/actions/workflows/push-to-pypi.yml/badge.svg">
1818
<!-- Stability -->
1919
<img alt="Pylint State" src="https://github.com/Dog-Face-Development/LEGO-Block-Creator/actions/workflows/pylint.yml/badge.svg">
2020
<!-- CodeQL -->
@@ -65,19 +65,46 @@ You can **[download](https://github.com/Dog-Face-Development/LEGO-Block-Creator/
6565

6666
## How To Use
6767

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

7074
```bash
7175
# Clone this repository
72-
$ git clone https://github.com/Dog-Face-Development/LEGO-Block-Creator.git
76+
$ git clone https://github.com/Dog-Face-Development/LEGO-Block-Creator
7377

7478
# Go into the repository
7579
$ cd LEGO-Block-Creator
7680

77-
# Run the App
81+
# Run the CLI
7882
$ python main.py
7983
```
8084

85+
### `pip`
86+
87+
You can install the program from the [Python Package Index](https://pypi.org/project/LEGO-Block-Creator/) through `pip`.
88+
89+
```bash
90+
# Install via pip
91+
$ pip install lego-block-creator
92+
93+
# Run the CLI
94+
$ lego-block-creator
95+
```
96+
97+
### Docker
98+
99+
You can pull the [Docker](https://www.docker.com/) image from GitHub Packages. From your command line:
100+
101+
```bash
102+
# Pull image
103+
$ docker pull ghcr.io/dog-face-development/lego-block-creator:master
104+
105+
# Run container
106+
$ docker run -i -t ghcr.io/dog-face-development/lego-block-creator:master python send.py
107+
```
81108
## Support
82109

83110
To create your part and set library and manipulate it, just launch the app using the instructions above!

docs/USAGE.md

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

3-
To install LEGO Block Creator, you can either use an executable package (Windows), or run the scripts through Python (Windows, macOS, Linux).
3+
To install LEGO Block Creator, 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/LEGO-Block-Creator/pkgs/container/lego-block-creator).
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/LEGO-Block-Creator/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/LEGO-Block-Creator/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 lego-block-creator`.
25+
3. Start the program by running the command: `lego-block-creator`.
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/lego-block-creator:master`.
32+
3. Start the container: `docker run -i -t ghcr.io/dog-face-development/lego-block-creator:master python main.py`.
33+
4. Enjoy the program!

0 commit comments

Comments
 (0)