https://github.com/floogen/jmod-bloodhound

Hunts down posts with JMOD replies on r/2007scape
https://github.com/floogen/jmod-bloodhound

bot jmod-bloodhound jmod-comments powershell-script praw praw-reddit python reddit reddit-api runescape

Last synced: about 2 months ago
JSON representation

Hunts down posts with JMOD replies on r/2007scape

• Host: GitHub
• URL: https://github.com/floogen/jmod-bloodhound
• Owner: Floogen
• License: mit
• Created: 2018-04-20T17:07:07.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2021-05-28T18:51:07.000Z (over 3 years ago)
• Last Synced: 2024-10-11T19:45:24.995Z (2 months ago)
• Topics: bot, jmod-bloodhound, jmod-comments, powershell-script, praw, praw-reddit, python, reddit, reddit-api, runescape
• Language: Python
• Size: 55.7 KB
• Stars: 18
• Watchers: 2
• Forks: 1
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# JMOD_Bloodhound

[Reddit Bot] **Python 3** ~~Powershell~~ script that actively checks [/r/2007scape/](https://www.reddit.com/r/2007scape/hot) and [/r/runescape/](https://www.reddit.com/r/runescape/hot) for posts with JMOD replies and links them within the specified post.

# How It Works

1. The script is scheduled to check [/r/2007scape/](https://www.reddit.com/r/2007scape/hot) and [/r/runescape/](https://www.reddit.com/r/runescape/hot) every 5 minutes for top 100 hot posts with JMOD replies.

	- **The bot also requires that the post have more than 10 comments AND (a JMOD comment with negative comment OR more than one JMOD comment).**

2. After finding a match, the script caches the post's ID via Reddit's save function to verify if a post has been touched already.

3. If a post hasn't been visted previously, it will create a new comment containing a list of each JMOD's comments on that particular thread.

	- It will also create a thread in [/r/TrackedJMODComments/](https://www.reddit.com/r/TrackedJMODComments/new) with each comment from the JMODs underneath it.

4. If a post has been visited previously AND there are new JMOD comments, the script will update the previous comment it had made with the new information.

5. After a post with a J-MOD reply goes beyond the top 100 hot posts within [/r/2007scape/](https://www.reddit.com/r/2007scape/hot) or [/r/runescape/](https://www.reddit.com/r/runescape/hot), the bot will no longer maintain its list of replies (unless the post reaches in the top 100 again).

# Questions?

I commented the script pretty thoroughly, but some things may be confusing to read. However, if you have any questions about how my code works, please do let me know and I'll try to explain where I can. I'd advise Googling your question first however, as that often will answer things faster than I can.

# To-do List

- [x] Converted to Python, utilizing PRAW. PowerShell script is now no longer maintained.

- [x] Add triggers to bot (more than 10 comments AND (more than 1 J-MOD comment OR a J-MOD comment with a hardset negative karma)).

- [x] Add [/r/runescape/](https://www.reddit.com/r/runescape/hot) to bot's search range.

- [x] Change main body of script into a function for versatile use with OSRS and RS3.

- [x] Implement context to JMOD comments where applicable.

- [x] Implement detailed comment information in the bot's post.

- [x] Change the many try-catch calls into a function.

- [x] Release the hound (to the public).

# Notes

* **Big** shout-out to [RedditPreview](http://redditpreview.com/) as it helped immensely with debugging the Markup formatting!

* If you'd like to look into Reddit's API, check out their development information [here](https://www.reddit.com/dev/api/).

* Check out [PRAW](https://praw.readthedocs.io/en/latest/) for a more fluid/ease-of-use of Reddit's API via Python.