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

https://github.com/flopp/parkrun-milestones

Determine milestone candidates for a parkrun event
https://github.com/flopp/parkrun-milestones

milestones parkrun running

Last synced: 7 months ago
JSON representation

Determine milestone candidates for a parkrun event

Awesome Lists containing this project

README

          

[![PkgGoDev](https://pkg.go.dev/badge/github.com/flopp/go-staticmaps)](https://pkg.go.dev/github.com/flopp/parkrun-milestones)
[![Go Report Card](https://goreportcard.com/badge/github.com/flopp/parkrun-milestones)](https://goreportcard.com/report/flopp/parkrun-milestones)
[![License MIT](https://img.shields.io/badge/license-MIT-lightgrey.svg?style=flat)](https://github.com/flopp/parkrun-milestones/)

# parkrun-milestones

Try to determine milestone candidates to the next run at a parkrun event.

## Commands

### parkrun-events

You can use this command to search for events (e.g. in order to find out the id of a specific event).

Example:

```
$ ./parkrun-events east
┌────────────────────┬────────────────────────────────┬────────────────┐
│ EVENT ID │ EVENT NAME │ COUNTRY │
├────────────────────┼────────────────────────────────┼────────────────┤
│ eastbourne │ Eastbourne parkrun │ United Kingdom │
│ eastbourne-juniors │ Eastbourne junior parkrun │ United Kingdom │
│ eastbrighton │ East Brighton parkrun │ United Kingdom │
│ eastcoastbrewery │ East Coast Brewery parkrun │ South Africa │
│ eastcoastpark │ East Coast Park parkrun │ Singapore │
│ eastend │ East End parkrun, New Plymouth │ New Zealand │
│ easterngardens │ Eastern Gardens parkrun │ Australia │
│ eastgrinstead │ East Grinstead parkrun │ United Kingdom │
│ eastleigh │ Eastleigh parkrun │ United Kingdom │
│ eastney-juniors │ Eastney junior parkrun │ United Kingdom │
│ eastpark │ East Park parkrun │ United Kingdom │
│ eastrichmond │ East Richmond parkrun │ Australia │
│ eastville │ Eastville parkrun │ United Kingdom │
│ eastville-juniors │ Eastville junior parkrun │ United Kingdom │
│ reynellaeast │ Reynella East parkrun │ Australia │
│ somerseteast │ Somerset East parkrun │ South Africa │
└────────────────────┴────────────────────────────────┴────────────────┘
```

### parkrun-milestones

Determine possible milestone candidates for the next run of a given event.
A milestone candidate is a runner or volunteer, who will probably have a milestone number of runs or volunteerings (25, 50, 100, 250, 500) at the upcoming run, and who was active (running or volunteering) in at least 30% (parameter `-active`) the last 10 runs of the event (parameter `-runs`).

Example:

```
$ ./parkrun-milestones eastville
┌───────────────────────────────────────────────────────┐
│ Expected Milestones at │
│ Eastville parkrun │
│ Run #178 │
├────────────────────────────────┬──────┬──────┬────────┤
│ NAME │ RUNS │ VOLS │ ACTIVE │
├────────────────────────────────┼──────┼──────┼────────┤
│ Darren CLINTON │ *49 │ 6 │ 4/10 │
│ Elena THODE MINGUET │ *99 │ 9 │ 5/10 │
│ Helen SAWYER │ 193 │ *49 │ 4/10 │
│ James HARRISON │ *99 │ 134 │ 6/10 │
│ James RODLIFF │ *99 │ 13 │ 3/10 │
│ Joseph BRAZIER │ *49 │ 0 │ 7/10 │
│ Philip SIM │ *49 │ 0 │ 4/10 │
│ Rosie BURROWS │ *24 │ 114 │ 5/10 │
└────────────────────────────────┴──────┴──────┴────────┘
```

### parkrun-runstats
Prints the stats of the latest run in list format; suitable for sharing in text-based social media (mastodon, twitter, etc.).

Example:

```
$ ./parkrun-runstats -fancy bushy
Bushy parkrun
#️⃣ 902
📅 2022-11-12
🏃 Runners: 1154
  ⏱ new PB: 108
  🧳 first visitors: 111
  ⭐️ new parkrunners: 37
  🏆 25. run anniversary: 7
  🏆 50. run anniversary: 6
  🏆 100. run anniversary: 3
🦺 Volunteers: 69
  ⭐️ new volunteers: 6
  🏆 25. vol. anniversary: 1
  🏆 100. vol. anniversary: 1
👀 https://www.parkrun.org.uk/bushy/results/902/
```