dribdee

A next-gen API-first composable toolbox for sprints, hackathons, and other forms of time-limited collaboration.

🏗️ This repository is currently a sandbox and everything is open for discussion.

Vision

This project revises the dribdat architecture with a simple idea: massage our foundations, with a lightweight model that makes it easy to track the people, teams and projects, based on the most proven, battle-tested, standards-oriented (datapackage.org) data structures.

Our basic need is to performantly ingest, search and filter the social activities, or dribs (posts, short commit notes, screenshots) and other live data points from the event stream - # of paper napkins scribbled on, +/- lines committed to git, L of coffee or kW electricity consumed, etc.

We altogether might endearingly call our LASN (Local Area Social Network). We would love it if this LASN could play well with your choice of WASN: through subscriptions or integrations or otherwise.

For this, we are looking at either moving from the current Flask/SQLalchemy basis to a more performant combination. Updating to a more modern Python microservices framework might mean using Falcon/Peewee, FastAPI/Ormar, or Starlette/Piccolo.

It might involve the use of a messaging bus like ØMQ or AsyncAPI, installation of a timeseries database like Influx or Timescale.

Less likely (given legacy effects) would be to switch to another dev environment altogether, like Golang or Julia.

Please open an issue or join the open projects to discuss.

Running

Get a copy of Python 3 or Podman/Docker to try the experimental dribdat app.

Or upload the AsyncAPI definition to play with it in the Studio.

Python

Create a virtual environment using Poetry (others supported later) .. and activate it.

poetry install 
poetry run gunicorn dribdat.app:api --reload

Docker

docker build -t dribdee .
docker run -p 8000:8000 dribdat

Accessing

The API will be hosted by default at http://127.0.0.1:8000

You can find API docs at http://127.0.0.1:8000

Testing

Within your virtual environment, run pytest in the project root.