Skip to content

Commit 489ba54

Browse files
docs: update README.md
- Break out quickstart into section sub headers - Add details to `TODO` section
1 parent 84e891a commit 489ba54

File tree

1 file changed

+68
-56
lines changed

1 file changed

+68
-56
lines changed

README.md

Lines changed: 68 additions & 56 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,11 @@
77
* [Minimum Requirements](#minimum-requirements)
88
* [Recommended Requirements](#recommended-requirements)
99
* [Quickstart](#quickstart)
10+
* [Python only](#python-only)
11+
* [Shell wrapper](#shell-wrapper)
12+
* [Devbox](#devbox)
13+
* [Docker](#docker)
14+
* [Docker Compose](#docker-compose)
1015
* [TODO](#todo)
1116
* [Stretch Goals](#stretch-goals)
1217
* [Further Reading](#further-reading)
@@ -29,83 +34,90 @@ Use Meetup Pro API to send Slack messages before events occur.
2934
## Quickstart
3035
* Clone repo
3136
* Copy `.env.example` to `.env` and fill out environment variables
32-
* Run app
33-
* Python only
34-
```bash
35-
cd ./app
3637

37-
# run individual app
38-
python <sign_jwt|meetup_query|slackbot|main>.py
38+
### Python only
39+
```bash
40+
cd ./app
3941

40-
# run only main app
41-
python main.py
42-
```
43-
* Shell wrapper
44-
```bash
45-
cd ./app
42+
# run individual app
43+
python <sign_jwt|meetup_query|slackbot|main>.py
4644

47-
# standalone server w/hard-coded port (default: 3000)
48-
./startup.sh
45+
# run only main app
46+
python main.py
47+
```
4948

50-
# standalone server w/port argument
51-
./startup.sh 3000
49+
### Shell wrapper
50+
```bash
51+
cd ./app
5252

53-
# server used with scheduled job (e.g., cron job)
54-
./scheduler.sh
55-
```
56-
* Devbox
57-
```bash
58-
# enter dev environment
59-
devbox shell
53+
# standalone server w/hard-coded port (default: 3000)
54+
./startup.sh
6055

61-
# run individual app
62-
python <sign_jwt|meetup_query|slackbot|main>.py
56+
# standalone server w/port argument
57+
./startup.sh 3000
6358

64-
# exit dev environment
65-
exit
59+
# server used with scheduled job (e.g., cron job)
60+
./scheduler.sh
61+
```
6662

67-
# run standalone server
68-
devbox run start
63+
### Devbox
64+
I.e., [Nix Package Manager](https://search.nixos.org/packages)
65+
```bash
66+
# enter dev environment
67+
devbox shell
6968

70-
# run tests
71-
devbox run test
72-
```
73-
* Docker
74-
```bash
75-
cd ./app
69+
# run individual app
70+
python <sign_jwt|meetup_query|slackbot|main>.py
7671

77-
# build image
78-
docker build -f Dockerfile.web --progress=plain -t meetup_bot:latest .
72+
# exit dev environment
73+
exit
7974

80-
# run image
81-
docker run --name meetup_bot -it --rm --env-file .env -p 3000:3000 meetup_bot bash
82-
```
83-
* Docker Compose
84-
```bash
85-
cd ./app
75+
# run standalone server
76+
devbox run start
8677

87-
# build image
88-
docker-compose build --remove-orphans
78+
# run tests
79+
devbox run test
80+
```
8981

90-
# run image
91-
docker-compose up -d
82+
### Docker
83+
```bash
84+
cd ./app
9285

93-
# enter server container
94-
docker exec -it meetup_bot-cont bash
86+
# build image
87+
docker build -f Dockerfile.web --progress=plain -t meetup_bot:latest .
9588

96-
# exit server container
97-
exit
89+
# run image
90+
docker run --name meetup_bot -it --rm --env-file .env -p 3000:3000 meetup_bot bash
91+
```
9892

99-
# stop image
100-
docker-compose stop
93+
### Docker Compose
94+
```bash
95+
cd ./app
10196

102-
# remove image
103-
docker-compose down --volumes
104-
```
97+
# build image
98+
docker-compose build --remove-orphans
99+
100+
# run image
101+
docker-compose up -d
102+
103+
# enter server container
104+
docker exec -it meetup_bot-cont bash
105+
106+
# exit server container
107+
exit
108+
109+
# stop image
110+
docker-compose stop
111+
112+
# remove image
113+
docker-compose down --volumes
114+
```
105115

106116
## TODO
107117
* Norman events
108118
* Get Norman events from existing GraphQL API
119+
* Coded as `Oklahoma City`
120+
* Will need to modify the query to get title and body content
109121
* Post to `#norman`
110122
* M-F
111123
* FastAPI

0 commit comments

Comments
 (0)