From 48b6864f071f9f714a3689ca8a75a690c4e6af2a Mon Sep 17 00:00:00 2001 From: "B. Stack" Date: Tue, 11 Jan 2022 15:57:43 -0500 Subject: improve documentation --- README.md | 61 ++++++++----------------------------------------------------- sniffa.py | 2 ++ 2 files changed, 10 insertions(+), 53 deletions(-) diff --git a/README.md b/README.md index 6fd1408..befdb87 100644 --- a/README.md +++ b/README.md @@ -5,12 +5,13 @@ sniffa [sniffa](https://github.com/danielmitterdorfer/sniffa) is a small utility that allows you to watch Discuss forums for keywords. -Every time it is invoked, it checks for new posts matching the keywords and creates a notification in the Mac OS X notification bar. +Every time it is invoked, it checks for new posts matching the keywords and creates a notification in the Discord room for the webhook provided in the config file. # Requirements * Python 3 * certifi: Install with `yum install python3-certifi` or `pip3 install --user certifi` +* `pip3 install --user discord` # Installation @@ -20,6 +21,10 @@ Ensure that all prerequisites are installed, then copy `sniffa.py` to any direct sniffa can be used to query multiple Discuss forums. The keywords and the ids of all already seen posts are maintained in a file `~/.sniffa/watch-$(FORUM_NAME).ini`, where `$(FORUM_NAME)` is a name that you can choose to identify this forum. +If you have a file named `~/.sniffa/watches-aoe2.ini`, run this command: + + ./sniffa.py aoe2 + ## Example Consider you want to watch for the keywords "Rally" and "JMeter" in the Elastic Discuss forum at https://discuss.elastic.co. @@ -36,59 +41,9 @@ url = https://discuss.elastic.co [JMeter] ``` -Now invoke sniffa: ``python3 sniffa.py elastic``. It will load the watches file for the forum named "elastic", check for new posts (which will be a lot at the first time) and show a notice for each of them in the Mac OS X notification bar. - -## Automatic regular invocation - -Quite likely you don't want to invoke sniffa manually every time you want to check for new posts. Therefore, you can install sniffa as a launch agent. - -Create a new file in `~/Library/LaunchAgents/org.github.sniffa.plist` with the following contents: - -```plist - - - - - Label - org.github.sniffa - - ProgramArguments - - ~/bin/sniffa.py - elastic - - - Nice - 1 - - StartInterval - 7200 - - RunAtLoad - - - StandardErrorPath - ~/.sniffa/sniffa-elastic.err.log - - StandardOutPath - ~/.sniffa/sniffa-elastic.out.log - - -``` - -Change the paths depending on the install location of sniffa and also your domain parameter. - -With this plist file, sniffa will check the Elastic Discuss forum every two hours (7200 seconds) for new posts. - -Finally register the launch agent with Mac OS X: - -``` -launchctl load ~/Library/LaunchAgents/org.github.sniffa.plist -``` - -After a restart, Mac OS X will pick up the plist file automatically. +Now invoke sniffa: ``./sniffa.py elastic``. It will load the watches file for the forum named "elastic", check for new posts (which will be a lot at the first time) and send an alert to your Discord webhook. -If you are interested in more details about launch agents, check [Alvin Alexander's blog post about plist files](http://alvinalexander.com/mac-os-x/mac-osx-startup-crontab-launchd-jobs) (on which this description is based). +See the included `watch-example.ini`. # License diff --git a/sniffa.py b/sniffa.py index 69dd6ae..78334f3 100755 --- a/sniffa.py +++ b/sniffa.py @@ -13,6 +13,8 @@ # ./sniffa.py aoe2 # Reference: # https://meta.discourse.org/t/watching-and-sending-notifications-for-keywords/59286 +# https://stackoverflow.com/questions/62731561/discord-send-message-only-from-python-app-to-discord-channel-one-way-communic/62731999#62731999 +# https://discordpy.readthedocs.io/en/latest/api.html#discord.Webhook.send # Improve: # Documentation: See README.md # Dependencies: -- cgit