X-Git-Url: https://wylark.com/src/infoex-autowx.git/blobdiff_plain/62bc17588a07fbc64d9b02c275769b2bf0d44637..445d0be65ab338d91041030c1f62f6663cb1defc:/README.md diff --git a/README.md b/README.md index cda54b9..96a530a 100644 --- a/README.md +++ b/README.md @@ -5,7 +5,7 @@ This program fetches data from an NRCS SNOTEL or MesoWest station and pushes it into the InfoEx system using the new automated weather system implementation. -License under the ISC license (see file: LICENSE). +Licensed under the ISC license (see file: LICENSE). Disclaimer ---------- @@ -35,18 +35,26 @@ This design allows you to run a separate program instance for each NRCS or MesoWest weather station from which you'd like to automate the importation of data into your InfoEx subscriber account. +To get started, copy the included example config file +(`config.ini.example` in the root source directoy) and modify the values +for your own use. + To run ad-hoc (be sure to activate the virtual environment, as detailed in the Installation section): `./infoex-autowx.py --config path/to/config-file.ini [--dry-run] [--log-level debug|info|warning]` -**NOTE: Specifying --dry-run will also not clean up the generated CSV -file.** This is so that you can debug any issues more easily. +**NOTE: Specifying --dry-run will not clean up the generated CSV file.** +This is so that you can more easily debug any issues that arise in the +setup process. You can also specify `--log-level` as debug, info, warning. The -resultant log messages will try to be logged to journald, but if that's -not available, they will be printed to stdout. This output can be -helpful early on in the setup process. +log messages produced by the program will try to be logged to journald, +but if that's not available, they will be printed to stdout. This output +can be helpful early on in the setup process. + +Automation +---------- Here's an example of a crontab(5) with two SNOTEL sites, each of which will run once per hour (note that this will activate the virtual environment @@ -129,7 +137,7 @@ Once you've chosen your elements, combine all of their respective "elementCd" values into a comma-delimited string and put that into your configuration file as the `desired_data` value. -A complete example: +A complete [station] section example: `[station]` `type = nrcs` @@ -165,12 +173,12 @@ you want to import data. Here are the steps to do that: https://developers.synopticdata.com/about/station-variables/ -The MesoWest API supports on-the-fly unit conversion, so that can be -specified to infoex-autowx via the configuration option `units`. This -can be either 'english' or 'metric', with 'english' meaning imperial -units as used in the United States. +The MesoWest API supports on-the-fly unit conversion. If desired, that +can be specified to infoex-autowx via the configuration option `units`. +This can be either 'english' or 'metric', with 'english' meaning +imperial units as used in the United States. -A complete example: +A complete [station] section example: `[station]` `type = mesowest` @@ -227,6 +235,18 @@ Future plans Version history --------------- +- 2.0.2 (Jul 2020) + + Fix issues shown by pylint(1). + +- 2.0.1 (Jul 2020) + + Major restructuring, but nothing which should impact the end user. + + - Took the monolithic main () routine and broke it out into logical + components. + - Improved the names of variables. + - 2.0.0 (Jul 2020) Implement MesoWest integration. @@ -235,6 +255,12 @@ Version history hence the major version bump. Such changes are not taken lightly but given the desire to support multiple data sources, were necessary. + Other minor changes include: + + - New switches: --log-level and --version. + - Better documentation. + - Expanded supported measurement types (from three to eight, in number). + - 1.0.0 (Jun 2020) First released version. Cleaned up the program and design.