wizardofzos / aoc2021

Advent of Code 2021 - z/OS Flask REST Solutions (runnning python and REXX lol)

AOC 2021 on z/OS

Based on https://github.com/wizardofzos/flask-rest-zos/

What's this?

Repo for my solutions to AOC2021. More info: https://adventofcode.com/2021 Wanted to have some extra practice on flask-rest and also do some REXX.

So I've made this REST API that either runs python code, or REXX and shows the result...

Requirements

• Conda installed
• Python available
• Network connectivity to the outside world

Preparing for first run

conda activate <env-that-has-python3-in-it>
git clone [e-mail]:wizardofzos/flask-rest-zos.git
cd flask-rest-zos
python -m venv .
. bin/activate  
python3 -m pip install -r requirements.txt

Running it

conda activate <env-that-has-python3-in-it>      
cd ../../flask-rest-zos
. bin/activate
# Optional if you want another port than 12345
export PORT=<port-you-want>
python3 aoc2021.py

Then point your browser to http://<ip_or_dns_of_your_mainframe>:12345/swagger-ui and...

Adding endpoints to the REST-API

Every endpoint has it's own file in /endpoints. Make sure to add your new endpoints to /endpoints/init.py with a line like so:

from .<name-of-your-resource-endpoint.py> import <ResourceName>

Then in test-app.py add these lines:

from endpoints import <ResourceName>
api.add_resource(<ResourceName>, '/<path-to-your-new-endpoint')
docs.register(<ResourceName>)

And off you go :)

TODO

Write how to add new solutions :)