Add initial implementation of /parts endpoint

.github/workflows/main.yml

@@ -0,0 +1,17 @@
+name: CI
+on: [push, pull_request]
+jobs:
+  tests:
+    name: Check
+    runs-on: ubuntu-22.04
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/setup-python@v2
+        with:
+          python-version: "3.11"
+      - name: Install dependencies
+        run: pip install -r requirements-dev.txt
+      - name: Run flake8
+        run: flake8
+      - name: Run isort
+        run: isort --check --diff .

.gitignore

@@ -4,4 +4,5 @@
 *.autosave
 *.swp
 .DS_Store
+config/
 Thumbs.db

Dockerfile

@@ -0,0 +1,27 @@
+ARG ALPINE_TAG
+FROM alpine:$ALPINE_TAG
+
+# Install packages.
+RUN apk add --no-cache \
+  python3 \
+  py3-flask \
+  py3-flask-pyc \
+  py3-gunicorn \
+  py3-gunicorn-pyc \
+  py3-requests \
+  py3-requests-pyc
+
+# Copy files.
+COPY app.py app/
+COPY static/ app/static/
+WORKDIR app
+
+# Set entrypoint.
+ENTRYPOINT [ \
+    "gunicorn", \
+    "--access-logfile=-", \
+    "--bind=0.0.0.0:8000", \
+    "--forwarded-allow-ips=*", \
+    "--workers=4", \
+    "app:app" \
+]

README.md

@@ -1 +1,45 @@
 # librepcb-api-server
+
+Official server-side implementation of the
+[LibrePCB API](https://developers.librepcb.org/d1/dcb/doc_server_api.html)
+as accessed by the LibrePCB application. Note that some older API paths are
+implemented in a different way and might be migrated to this repository
+later.
+
+## Requirements
+
+Only Docker Compose is needed to run this server on a Linux machine.
+
+## Configuration
+
+To make all features working, a configuration file `config/api.json` is
+required with the following content:
+
+```json
+{
+     /* Config for endpoint '/parts' */
+     "parts_operational": false,
+     "parts_query_url": "",
+     "parts_query_token": ""
+}
+```
+
+## Usage
+
+For local development, the server can be run with this command:
+
+```bash
+docker-compose up --build
+```
+
+Afterwards, the API runs on http://localhost:8000/:
+
+```bash
+curl -X POST -H "Content-Type: application/json" -d @demo-request.json \
+     'http://localhost:8000/api/v1/parts/query' | jq '.'
+```
+
+## License
+
+The content in this repository is published under the
+[GNU GPLv3](http://www.gnu.org/licenses/gpl-3.0.html) license.