Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/euanwm/openweightlifting

Repository that is deployed for the OpenWeightlifting site
https://github.com/euanwm/openweightlifting

docker gin-gonic golang heroku nextjs olympic python python3 react sports-analytics statistics weightlifting

Last synced: 3 months ago
JSON representation

Repository that is deployed for the OpenWeightlifting site

Awesome Lists containing this project

README 

        
# OpenWeightlifting

This is the monorepo for the OpenWeightlifting.org project. The aim of this project is to build a database of the latest Olympic Weightlifting results from all around the world. This originally started from a scraping tool and quickly grew into what you see here now. All the results within the database were pulled directly from the event results pages from the National Governing Body of that nation. We try to avoid manual data entry so this is all done with our tooling written in Python.



# Licensing, Data, and Comms



## Code Licensing

Done this under the BSD-3-Clause license. Simply because it's what the sport80 library is under and i'm hella lazy.



## Data Licensing

OpenWeightlifting data (`*.csv`) under `event_data/` is contributed to the public domain.



The OpenWeightlifting database contains facts that, in and of themselves,


are not protected by copyright law. However, the copyright laws of some jurisdictions


may cover database design and structure.



To the extent possible under law, all data (`*.csv`) in the `event_data/` folder is waived

of all copyright and related or neighboring rights. The work is published from the United Kingdom.



Although you are under no requirement to do so, if you incorporate OpenWeightlifting

data into your project, please consider adding a statement of attribution

so that people may know about this project and help contribute data.



Sample attribution text:



> This page uses data from the OpenWeightlifting project, https://www.openweightlifting.org.


> You may download a copy of the data at https://github.com/euanwm/OpenWeightlifting.



If you modify the data or add useful new data, please consider contributing


the changes back so the entire (olympic) weightlifting community may benefit.



## Project Discord

We have a somewhat small Discord, feel free to join it as it's the quickest way to reach any of the contributors on the project

https://discord.com/invite/kqnBqdktgr



# Testing, Building, and Nerding



## Why Golang for the backend? 

Originally it was Python but the build time was terrible and the response times were slow. Not only that but the memory usage was high. Golang was chosen because it's fast, has a low memory footprint and the build times are quick. It's also a language that's easy to pick up and learn. We migrated from Python to Golang within in a week of picking up the language.



## Why NextJS for the frontend?

This was a bit of a no brainer. We wanted to use React and NextJS (TS) is a great framework for it. The amount of features around rounting, server side rendering and static site generation is great. While it can also serve as a backend, we've chosen to keep the backend and frontend separate due the performance benefits of having a dedicated backend.



## Local Testing

Majority of the contributors on this are FE developers, so we've containerised the front and backend portions of the project. To get going quickly with the project, you'll need to have docker installed.



## Frontend Development (NextJS)

From the root of the project, run the following commands to spin up a backend container and launch the frontend.

```bash

docker compose up -d backend

cd frontend

npm install

npm run dev

```

While the backend service is running, you'll also be able to run the FE API call tests against it.

```bash

npm run test

```



Once you're done, you can stop the backend container with the following command.

```bash

docker compose down

```



## Backend Development (Golang)

When launching the backend service you'll need to toggle the CORS flag which is done be adding the 'local' argument when calling the executable.

```bash

go build backend.go

./backend local

```



## Database Management (Python)

To pull the latest results from the all relevant federations, we've added a Makefile with a few commands to make it easier. You'll need to have pipenv installed to run the commands.

## Pulling the latest results

```bash

make update_database

```



## Staging the latest results

This came about so if you have a messy amount of unstaged changes, you can stage them all and then commit them in one go.

```bash

make stage_csv

```



## Checking the database

In order to reduce the amount of checks at runtime, we've added a check to make sure the database is in a good state. This will check for duplicate entries and missing data.

```bash

make check_db

```