1 unstable release
0.1.0 | May 9, 2023 |
---|
#38 in #aoc
Used in aocrun
21KB
120 lines
Aocdata
Aocdata provides data service i.e. datasets for Advent Of Code puzzles.
The service, the request format, and the response format are specified in aocdata.proto
file following the Proto3 language guide.
Setup
$ git clone https://gitlab.com/labcycle/aocdata.git
$ cd aocdata
The below commands simulate the database and the server through container images.
Replace podman
with docker
in the following commands to build and run images. NOTE: The build
and run
commands have NOT been tested using docker
.
Setup Postgresql database
This database holds datasets of the puzzles. If the database is already setup, skip to Setup Aocdata server section.
NOTE: An example database holding sample datasets is set up below. For more extensive datasets, a new database with datasets should to be set up.
$ podman build -t aocdb -f ./db/Containerfile
$ podman run -dt --name aocdb_container -p 54320:5432 -e POSTGRES_PASSWORD="aocpg" aocdb
Setup Aocdata server
Postgresql database URL must be provided as an environment variable AOC_DB_URL
to the container. e.g. AOC_DB_URL="postgres://postgres:aocpg@localhost:54320/aoc"
.
$ podman build -t aocdata -f ./Containerfile
$ podman run -dt --name aocdata_container -p 31370:3137 -e AOC_DB_URL=__PostgresDbUrl__ aocdata
How does it work
- Once the server is started, data can be requested using gRPC call using the unary RPC
GetData
and client-sideDataRequest
mentioning the year and day fields. - The data response is sent as an optional string.
- The dataset string is queried from a Postgresql database (Thus, the database must be running as long as the server is taking requests).
Dependencies
~25–38MB
~659K SLoC