https://github.com/egonny/advent-of-code-notifier

A simple notifier for changes in private Advent of Code leaderboards
https://github.com/egonny/advent-of-code-notifier

advent-of-code discord slack

Last synced: 19 days ago
JSON representation

A simple notifier for changes in private Advent of Code leaderboards

• Host: GitHub
• URL: https://github.com/egonny/advent-of-code-notifier
• Owner: egonny
• License: apache-2.0
• Created: 2019-12-06T15:50:50.000Z (about 5 years ago)
• Default Branch: master
• Last Pushed: 2023-12-01T09:26:28.000Z (about 1 year ago)
• Last Synced: 2023-12-02T10:32:53.871Z (about 1 year ago)
• Topics: advent-of-code, discord, slack
• Language: Python
• Homepage:
• Size: 38.1 KB
• Stars: 6
• Watchers: 2
• Forks: 1
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Advent of Code Notifier

A script that sends a message on Slack and/or Discord whenever a leaderboard on [Advent of Code](https://adventofcode.com/) changes.

* On the first run, the script reads the current leaderboard and writes it to a new file called `old_leaderboard.json` in the current directory.

* On subsequent runs, the script reads the previous leaderboard from this file and compares it with the current leaderboard.

  It then sends a message summarizing the leaderboard changes to the configured Slack app and/or Discord server, and updates the file's contents.

## Setup

```bash

pip install -r requirements.txt

```

## Example webhook

![Screenshot 2021-12-01 160204](https://user-images.githubusercontent.com/3670206/144258498-76522696-2790-4bd9-9790-7a0d53440ac5.png)

## Running

The CLI accepts input as environment variables:

* `AOC_SESSION`: The `session` cookie for authenticating with the AoC API.

* `AOC_BOARD`: The ID of the private leaderboard to monitor.

* `AOC_SLACK_HOOK`: The [Webhook URL](https://api.slack.com/messaging/webhooks) for your Slack app. (Optional)

* `AOC_DISCORD_HOOK`: The [Webhook URL](https://support.discord.com/hc/en-us/articles/228383668-Intro-to-Webhooks) for your Discord server. (Optional)

Example usage:

```bash

AOC_SESSION=my_cookie AOC_BOARD=123456 AOC_SLACK_HOOK=my_slack_url python -m aoc-notifier

```