PsychoticNinja/JLU5-SupyPlugins
1
0
Fork 0
mirror of https://github.com/jlu5/SupyPlugins.git synced 2025-04-26 04:51:08 -05:00
Code Issues Projects Releases Wiki Activity
JLU5-SupyPlugins/NuWeather
History

README.md

NuWeather

A weather plugin for Limnoria. It supports multiple weather and geocoding backends:

Weather Backends

Geocoding Backends

Quick start

  1. Pick your preferred weather backend: config help plugins.NuWeather.defaultBackend

  2. Grab an API key. Dark Sky | Apixu

  3. Configure it: /msg yourbot config plugins.NuWeather.apikeys.BACKENDNAME YOUR-API-KEY

  4. Set your default weather location: setweather <your-preferred-location>

  5. Obtain weather: weather [<optional location>]

Migrating from the Weather plugin

This plugin includes a script to migrate from the Weather plugin's SQLite DB to NuWeather's binary format.

$ ./weather-migrate.py -h
usage: weather-migrate [-h] infile outfile

Migrates user locations from the Weather plugin to NuWeather.

positional arguments:
  infile      input filename (BOT_DATA_DIR/Weather.db)
  outfile     output filename (e.g. BOT_DATA_DIR/NuWeather.db)

optional arguments:
  -h, --help  show this help message and exit

Migration instructions

  1. If you have not loaded NuWeather previously, load the plugin for the first time so that config entries are populated.

  2. Then, unload the plugin before running the migration script. You may also wish to make a backup of your current NuWeather.db if it is of any use.

  3. Run the script on the right files: ./weather-migrate.py BOT_DATA_DIR/Weather.db BOT_DATA_DIR/NuWeather.db

  4. After performing the migration, set the plugins.NuWeather.DBAddressingMode option to nicks (since the previous database tracks locations by nick):

config plugins.NuWeather.DBAddressingMode nicks
  1. Load the plugin again for these changes to take effect.

(If you're comfortable with re-creating your database from scratch, the other options tell NuWeather to save location by Supybot account (the default) or ident@host.)

Location lookup (Geocoding) backends

  • Apixu provides weather lookup by place name directly, and does not need further configuration.
  • Dark Sky requires a separate lookup to translate place names into GPS coordinates, a process known as geocoding.

The default backend for geocoding is OpenStreetMap's Nominatim service, and can be configured via the plugins.NuWeather.geocodeBackend option.

Other supported options include Google Maps and OpenCage, which may provide more relevant results for North America (e.g. U.S. ZIP codes). These services both require API keys: Google Maps (credit card required) | OpenCage

API keys for geocoding backends are configured as plugins.NuWeather.apikeys.BACKENDNAME.