aav.upcoming-games 0.1.0

Description:

aav.upcominggames 0.1.0

upcoming-games
Reddit bot to update sidebar for /r/IGN. Can be configured for a variety
of uses.


Usage

Install Python 3.6 or greater if you have not already.
Install the bot with pip install aav.upcoming-games. You may need
to use sudo or pip3 or --user depending on your
permissions, i.e. if you do not have sudo permissions and you also
have Python 2 installed, you may need to use
pip3 install --user aav.upcoming-games.
Obtain a Reddit client ID and client secret from
https://reddit.com/prefs/apps on the account you want to use for the
bot.
Set up your configuration file and template as mentioned in the
‘Configuration’ section.
Run the bot from the command line with the full path to your config
file: upcoming-games "/home/aav/my.yaml"



Developer Usage

Install Python 3.6 or greater if you have not already.
Install the bot with pip install aav.upcoming-games. You may need
to use sudo or pip3 or --user depending on your
permissions, i.e. if you do not have sudo permissions and you also
have Python 2 installed, you may need to use
pip3 install --user aav.upcoming-games.
import upcoming_games
You can use any of the three functions: get_all_games,
get_markdown, post_table, and the class UpcomingGame as
desired.



Configuration
Here is the default configuration file:
general:
silent: False
time_period: "7d"
systems: []
game_limit: 10
table_format: "short"

reddit:
client_id: "..."
client_secret: "..."
subreddit: "..."
scripthost: "..."
password: "..."
post_type: "sidebar"
template: 'path/to/template.txt'
Here’s what each setting is for:

general

silent - True if you don’t want any script output.
time_period - Valid time period for upcoming games (can be one
of 7d, 1m, 3m, 6m, 12m, all).
system - List of consoles you want to include releases for.
Empty means include all.
game_limit - Number of games you want for the Markdown table.
table_format - short for only the game name and first
release, long for system details.


reddit

client_id - Your reddit bot’s client ID.
client_secret - Your reddit bot’s client secret.
subreddit - The subreddit (your must be a moderator) to post
to/update the sidebar.
scripthost - The username for the bot account you registered
for the client ID on.
password - The password for the bot account.
post_type - sidebar to update the sidebar, sticky to
make a ‘bottom’ stickied post.
template - the full path to the template you want to use.



Note the template must contain somewhere in it the text %%%TABLE%%%, as
this is where the Markdown table will be put. If no path or an invalid
path is specified, the template used will be blank, i.e. it will only
contain the Markdown table, nothing else.