A program to automate common tasks with managing a scout unit. The program runs any number of configurable extensions preriodically, and as such it can be set up to run for multiple sections or units within one configuration file. Currently, the following extensions have been implemented:
- Terrain Approvals: Fetches data from the approvals queue and parses it before sending it via the Jandi webhook. Extra information about each approval is fetched and included in the message, for example if the approval request is a Special Interest Area (SIA), the project name is included. If the request is an Outdoor Adventure Skill (OAS), the branch is included. See examples below for sample output.
- Scout Event Crawler: Compatible with NSW ScoutEvent, this extension periodically parses the website for any new activities and posts them to a specified Jandi topic.
Place a file named config.yaml next to the application. This file will define the configuration to run the application with. For an example file, see config.yaml, for others, check the example yaml files. The exact nature of the config file is described in ApplicationConfiguration
terrain_approvals:
enabled: true
tasks:
- task_name: Scouts Terrain Approvals
# Username and password for Terrain in the format branch-memberid
username: nsw-123123
password: ScoutsTerrainPassword
# The GUID of the target unit. You must have unit council permissions for said unit. This can be found from opening network requests on Terrain
unit_id: b3895042-9e1d-42ed-87d1-30b13020859f
# The number of days to look backwards for recent approvals. See examples below
lookback_days: 90
# The incoming webhook url to post to
jandi_url: https://wh.jandi.com/connect-api/webhook/65436543/63456h634564h6534
# The cron schedule to run this task on. Make/validate your own at http://cronmaker.com/
cron_schedule: 0 0 17 ? * TUE
# This second task will ran in parallel with the first
- task_name: Vennies Terrain Approvals
username: nsw-321321
password: password2
unit_id: fb0b4b9b-e549-401d-93a8-10da3b89a047
lookback_days: 60
jandi_url: https://wh.jandi.com/connect-api/webhook/763576/554g3h25g3425342522
cron_schedule: 0 0 18 ? * THU
scout_event_crawler:
tasks:
- task_name: Scout Event Crawler - All Sections
cron_schedule: 0 0 12 ? * MON
jandi_url: https://wh.jandi.com/connect-api/webhook/763576/5435g4354353454j353
# A list of regions from NSW to subscribe to updates from. Below are all possible values
subscribed_regions:
- state
- south_metropolitan
- sydney_north
- greater_western_sydney
- hume
- south_coast_tablelands
- swashDownload and unzip the latest release and run the executable. The bash script below will do the same. If you have dotnet 6.0 installed then you can download the smaller framework-dependent file, otherwise the self-contained version must be used.
# Check the Releases tab for a more suitable asset
release_asset="crest-ubuntu-self-contained.zip"
tag=$(curl -s "https://api.github.com/repos/aiden2480/crest/releases/latest" | grep -o '"tag_name": ".*"' | cut -d'"' -f4)
if [ -z "$tag" ]; then
echo "Error: Unable to retrieve latest release tag."
exit 1
fi
download_url="https://github.com/aiden2480/crest/releases/download/$tag/$release_asset"
echo "Downloading from $download_url"
response=$(curl -sL -w "%{http_code}" -o $release_asset "$download_url")
if [ "$response" != "200" ]; then
echo "Error: Failed to download release asset. HTTP status code: $response"
exit 1
fi
echo "Download completed successfully. Extracting..."
unzip -oq $release_asset -d ./
rm $release_asset
echo "Unzipped successfully"
chmod u+x Crest
Screenshots taken from two different units depicting the pending queue and recently approved achievements
- Send emails instead of posting to Jandi topic, or output to any other platform
- More feedback in console when tasks are run/correct logging
- Superceeded document notifier to inform when any documents on the scouts page have been updated
- Add compatability with multiple units/profiles at once