Logging events and errors while an application is running is extremely useful for tasks like diagnosing issues and analyzing usage patterns.

Python's logging library provides a great built-in tool to enable application-level logging. Python's documentation also offers a comprehensive series of tutorials aimed at users with varying levels of experience.

The proposed feature set includes:

• Log to a discrete /log/ folder, whose contents are not tracked by Git
• Single logger configuration and initialization
• Log bot events (e.g. login)
• Log events in all cogs and helper utilities at the appropriate level (info, debug, etc.)
• Log errors & warnings

The goal of this tasks is to access the OMDB API, and find movies that are scary / spooky, and make them searchable/accessible via the bot.

• generate a random movie tag scary and/or spooky
• should contain, title, main actors and image, and year
• should also link to OMDB
• Perhaps also a spookiness/scary rating

Originally posted by Shawn McLaughlin:

TLDR I believe that the #esoteric-python channel could benefit from some bot commands.

Of course, we currently only have a handful of users who actively participate in challenges every week, so the usefulness of this can be debated. I do think though that if we deem this unworthy for the moment that we should reconsider at a later date if I manage to get more people into the coding challenges. Also, having bot commands related to #esoteric-python might bring a bit more awareness to the channel, too.

Basic functionality:

• !eso command with options;
  • suggest: Suggest a challenge for future weeks (I find myself soliciting suggestions every week and it would be neat to have a way to catalogue suggestions and build a collection for future challenges
  • vote: Eventually, the bot could perhaps generate some polls through reactions that could be pinned in the channel which would allow users to vote on which challenge seems more appealing to them
  • point system: While I don't think making esoteric-python competitive is the right path to take, I do think we could benefit from at least some recognition from people who participate, and could have a sort of "hall of fame" option that displays a nice richembed showing users who have contributed a lot of solutions
  • info: Explain what the heck #esoteric-python is all about, since I'm certain many people don't quite know what goes on in there and when they walk in seeing Juan's 30-deep nested lambdas skedaddle out of the channel really quickly

That being said, I think the main features for the first iteration would be the suggest and info commands. I am willing to program this cog should we deem it worthy of inclusion.

Thank you for listening

This command would genrate a random spooky rating from a range of 1-100 [or any other range].It would play display a hallooween character picture according to the rating given [like witch,dracula,etc etc]

Implementation details

1. To build a function which would generate a random number in the range 1-100 [or any other range] which would resemble the spooky rating of the user.
2. The rating is then put up in a embed and displayed out.It will also grab a picture from the internet of a random hallooween character and post it.
   [ 2nd part of the code is optional ⬆️

• Random numebr generation
• To look for free pics online for the 2nd code [optional]

When the .spookysound command is triggered, the bot should connect to the hacktoberfest voice channel and play a spooky sound, such as ghosts oooing, chains rattling, or a bat fluttering its wings.

Implementation details

• Find some spooky sound effects we can use for this. These must be licensed for free use.
• When the command is triggered, connect to the channel, play a random spooky sound effect, and disconnect again.
• Implement a short cooldown for the command (maybe 5 minutes), so people don't spam it.

I have heard rumors about Saint Valentine, and the green hat, but I am not sure what is true or not. It would be nice if there was a bot that would tell me fact about this holiday and Saint Valentine, or even if they are related. who knows.

So for this bot creation, you will provide information from history, or today about Saint Valentine, as well as the Valentines day.

Implementation details

• The commands could be one or two, !whoisvalentine, !whatisvalentine, or !valentinefact
• upon commands, the bot should provide random fact about Valentine (today's usage, history, and so on)

Example

!valentinefact
San Valentino, known as Saint Valentine of Rome, is a third-century Roman saint widely celebrated on February 14 and commonly associated with "courtly love.". It is highly agreed that St. Valentine was martyred and then buried on the Via Flaminia to the north of Rome.

Sometimes coming up with ideas for valentines day is tedious, (don't quote me on that), so to solve this problem we are going to create a bot that gives a random date idea.

Implementation details

• Write the bot command !savethedate (open to other command names)
• Provide a random suggestion, for a valentines date (let your mind work).

!savetheDate

Prepare a lovely picnic for two

When invoked, .spookyavatar should post a version of my avatar with the spookiness factor turned up to 11. Perhaps it adds stuff like bats or pumpkins to it, messes with colors to make it look more sinister, or draws evil symbols like pentagrams or skulls and crossbones on it in blood red.

Implementation details

This implementation is intentionally left open to interpretation. How you modify the avatar is up to you, feel free to get creative. The only hard requirement here is that you modify the users avatar in some way and return the modified picture.

For advanced users

Try to create a system where the alteration is randomly selected from a pool, so we can easily extend this pool with additional alterations later on. Perhaps one alteration is "add a pentagram" and another is "invert all the colors". These alterations can be stored in a separate file. A file full of module-level functions is fine, an abstract base class ImageAlteration with each alteration being a subclass would be even better.

Right now, there's no easy way to check if the bot has restarted (you'd have to keep doing .uptime). Python delivers an embed into #dev-logs when it starts, we should probably be doing that for this bot as well.

We should update CONTRIBUTING.md with a section that explains our expectations towards commit message quality and what should constitute a commit.

For example:

• You should write a good commit message for every commit. Not just maybe it'll work now.
• You should not be committing linting fixes because the build failed, just use a git hook and lint on pre-commit! There is info on how to do this in the wiki. Refer to it.
• You should not commit tiny changes at a high frequency. Commit a meaningful amount of work at a time.

This needs to be done on all three of our major projects - site, bot, and seasonalbot.

See python-discord/site#157 and python-discord/bot#211

Create a bot command that calculates an affinity value based on two users: The author of the message and the user pinged by the message. This could be implemented by adding the two user IDs, and generating a percentage value from this.

An example of this functionality can be seen here: https://www.lovecalculator.com

Get a simple discord.py bot running on rewrite. We will be filling it with fun cogs during Hacktober, as our event handlers and staff come up with worthy challenges and post them as issues.

This feature is a command to the bot that will automatically spit out a spooky, scary, Halloweeny gif.
This is similar to hugs, and hand shake gif bot commands, as see below.

• get a list of spooky ... gifs
• generate a random gif to print to the screen

Implement .gitignore for files to be ignored during push and pull

• implement .gitignore
• add logs to .gitignore

The Season system will only be fun if we have many seasons occurring all throughout the year. Let's use this issue to come up with a couple of ideas. Please use the following format:

Halloween
Bot name: SpookyBot
Start: 1st of October
End: 1st of November

Description

avatars/christmas.png resource isn't vertically centred.

Steps to Reproduce

Open manually or change the bot avatar to that specific image.

Expected Behavior

Actual Behavior

The Magic 8 Ball has been helping folks answer life’s most difficult questions for decades, and it’s only fitting that Seasonalbot help us do the same!

This cog should accept any arbitrary question from the user and return sage wisdom from a prepopulated file of responses.

This command should take your nickname and your avatar and generate an embed that shows what kind of monster you are and all the horrors you have wrought upon this mortal plane.

Implementation details

Build and return an embed which classifies the user as a type of monster, and lists that monsters characteristics. This should always return the same thing for the same user, so you'll need to use the users id as a salt when you randomly select this data.

The exact implementation details are intentionally left vague, please use your creativity and come up with something that would be fun, but which fits the above description.

Additional information

If possible, maybe make use of the #29 avatar changer or the data collected for use in #10 .

So every message that is sent in the #show-your-projects channel, the bot sends this list of reactions in order:
👍 👎 ❤️ 🚩 👀
This can be changed any way you want, but essentially whenever someone posts a message showing their project, the bot immediately sends these reactions, so that people can quickly react with those emojis without looking for them in a menu. You can even have it so you turn off the ability for people to add new reactions, only using the reactions above. An extra technical detail, since some tend to post their project as more than one message, maybe a 30-second slowmode on the channel can deter that too.

Implementation details

• Write the bot command (duh)
  • Choose the reactions and the order
• Change Permissions (optional)
• Add slowmode (optional)

Additional information

This is an evergreen request.

I hope I didn't miss anything, but if I did you can leave a comment telling me what. Also if anyone has suggestions for certain emojis to use as reactions you can leave those in too.

When someone in the channel uses the word spooky, the bot should automatically react to the message with a 👻.

Implementation details

• Make a new cog for the bot
• In this cog, implement the on_message event, which will trigger every time the bot sees a new message.
• If the message contents contain the word spooky (or other halloween themed words), add an appropriate reaction.

Additional information

Please feel free to improvise and add more trigger words and reactions that fit the theme. Skeletons and 💀, maybe?

Create a new feature for the bot called halloweenify. This is a version of our hiphopify feature, except it works a bit differently.

• Instead of being a moderation tool, the command can only be invoked upon yourself.
• When invoked, it randomly changes your own name to a scary spooky halloween name, and delivers a hiphopify-esque embed with a picture.
• The nickname change is not enforced in any way, and there is no halloweenify-prison.

If you're not sure what hiphopify is, here is an example of how the embed looks:

• Scrape some spooky names from the web, along with accompanying pictures.
• Store these in a JSON file (or a similar data format)
• Implement a !halloweenify command that changes the invokers name to one of these names.
• Build and deliver an embed like the one shown above with a picture of the character whose name you've adopted.

Have you ever wanted to get random interesting (Maybe) facts about Halloween, the month of October and other related things?

General info

Well, you have come to the right place. Instead of looking for these facts, you get to create a list containing those facts that can be posted by the bot, as in:
Your daily random information about Halloween: Did you know that Halloween's origins date back to the ancient Celtic festival of Samhain?.
Other fun spooky facts are also welcomed.

This information can also be accessed via the bot command !hallofacts.

Implementation details

• Write the bot command to access hallofacts
• Add the command to our README.md
• get a list of random interesting facts about Halloween
• post random facts daily

Additional information

Provide any additional information or clarifications here.
This PR is for beginners / Intermediate discordPythoners. See also feature #9 for similarities.

Netfilx and chill, or just look up some old or new romantic movies to spend sometime with the one (or a one). But why spend the time to choose a movie, when you can have a bot choose it for you, and maybe enjoy that movie then chill?

For this bot command, you will pick a random romantic movie from the OMDB database. and provide some information about it to the requester. (could be you too, you never know).

Implementation details

• Write the bot command .movie
• Generate a random romance movie
• Should contain, title, main actors and image, and year
• Use TMDB API

Additional information

Provide any additional information or clarifications here.

you can check out Random scary movie generator #9 for ideas on how to go about it, if you would like some help.

While Hannukah is ongoing, when this command is invoked the bot should respond with an ASCII (or emoji) menorah depicting where we are in the holiday.

If the holiday hasn't yet begun, the bot should respond with how much time is left before it begins.

https://en.wikipedia.org/wiki/Hanukkah

The hacktoberbot will randomly post a 🍬 reaction on one of the latest messages in the #event-hacktober channel. The first user to click it, consumes it (which makes the bot remove both reactions). At any point, you can use the .candy command to view a leaderboard of who has collected the most candies.

Occasionally the bot will also post a 💀 reaction, and if the user who clicks this has any candies collected, it will steal up to 3 of them and post a spooky message in the channel saying that the player has been cursed and has lost x candies. if the user does not have any candy, the skull disappears and no message is posted.

Required Changes

• The bot should have a small chance of posting a 🍬 reaction on all new messages. Under 5%
• The bot should have an even smaller chance of posting a 💀 reaction if a new message is posted. maybe 2%.
• Whenever one of the past 10 messages gets a new reaction, there should be a slightly larger chance the bot posts a reaction as well. perhaps 10% and 5% respectively.
• Use something like a JSON file to keep track of how many candies each player has.
• The JSON must be loaded whenever the bot starts.
• When the reactions are clicked, trigger corresponding events.
  • If the 🍬 is clicked, add one candy to the users count, and remove both reactions.
  • If the 💀 is clicked, remove up to 3 candies from the users count, remove both reactions, and post a message explaining that the user has been cursed and has lost however many candies you just removed.
• Write a command, .candy, which posts a top 5 leaderboard for users with most candy collected.

Other

Chance percentages may need tuning.

We need an avatar that the bot will use during February, when we celebrate love!

The new README should include

• Motivations
• Commands
• Getting started

When the bot changes the season, it should make an announcement and change the server icon to match its new avatar. It is important that this does not happen during testing, only during production.

Implementation details

• When the season changes, the bot should change the server icon.
• Instead of storing the icons in this repo, we should be getting them out of the branding repo.
• When the season changes, the bot should make an announcement in #announcements declaring that a new season has started, that the server icon has changed, and that the following bot commands are now made available. Then a list of the commands that have been made available, ideally with a description (taken from docstring first line, for example). This announcement should tag the @Announcements role.
• Ensure that we make use of the DEBUGMODE implemented by Scragly so that neither avatar changes, server icon changes nor public announcements will happen when we're just testing the bot.

This command lists five classic Halloween monsters, and lets users vote for their favorite. You can also see a leaderboard for which monster is winning the vote.

The five monsters could be iconic monsters like Dracula, Frankenstein's Monster, The Creature from the Black Lagoon, Cthulu, and so on.

Users can view the list of candidates, vote for the monster they prefer, and change their vote if they change their minds. There can only be one vote in total per user. They are able to view the leaderboard to see who is winning, and they should also be able to see an embed (with a picture) of each monster by inspecting them.

Implementation details

• Find a list of iconic monsters and select the five best ones. Feel free to ask the community to help decide which ones should be candidates.
• Add the .monster command which should return a help menu with the available monster commands.
• Add the .monster vote command, which should list the names of these five monsters, how to vote for them, and how to see more information about them.
• Add the .monster show mymonster command, which show a beautiful embed with information about this monster, a picture of the monster, and how to vote for it.
• Using JSON for storage, add the .monster vote mymonster command which increments total votes for that monster in the json file, and then reacts to the message with an affirmative reaction such as ✔️. Make sure to accommodate for the fact that users can only have a single active vote, but may change their votes at any time.
• Add the .monster leaderboard command which shows the top 5 leaderboard with each monsters name and the number of votes they have received.

Additional information

This is a pretty big issue, and you are allowed to team up with a friend, if you want. Feel free to ask in the #event-hacktoberfest channel if someone would like to do it with you. We strongly encourage teamwork. In order to ensure you both get hacktoberfest pull requests for doing this, you can split the task in such a way that you commit some of the commands, and your teammate commits the others. We will make sure to merge them in the correct order.

Pretty simple - as per the standard, when you start the bot using -m - as in, as a module - Python looks for a __main__.py to run. Instead of this, we have all of the bot startup logic in __init__.py.

Currently the bot does not do with bot.typing while calculating its response on many of the halloween-related commands. Someone should go through all commands and implement this where appropriate.

The bot is meant to be ran as a module but the tutorial still shows it being ran via bot.py. The tutorial should be updated accordingly.

Add a template for pull requests. Ideally, this would have a checklist of the basic things the PR should have, and sections to fill in with content.

GitHub's documentation
Examples of templates

Being able to configure the bot without having to modify the source code would enhance ease of use, and enable users to easily update the bot without worrying about their settings being overwritten. Having the settings in a single location improves discoverability and makes changes to the configuration quicker and easier.

Discussion items

• File format to use: INI, JSON, YAML, or other
• Should logging should be configurable as well?
• If the configuration file is modified at run-time, should the bot's current configuration be updated (e.g Django).

Proposed features:

• Loading of configuration from a file
• Mechanism to override default values
• Set of default configuration values
• Changing the bot to use the values pulled from this file
• Ability to specify the location of the configuration file via a command line argument

Primary use case is configuration of cogs, such as the update rate for querying an API, roles/permissions for an administration cog, location of a file with terms to use for a quote generator, etc.

Some other settings:

• Command message prefix (e.g. !)
• name of environment variable to use for the token

If you have any others please sound off in the comments. I'm not terribly experienced with Discord bots, so my knowledge of typical examples is rather limited.

As is traditional on Valentine's day, users can request that the bot send a Valentine to another user. This can be something cheesy, something sweet, or even a poem! The command should be able to send a user-specified valentine, or pick one randomly from a set if one is not provided. This command should have a cooldown.

Another possible option could allow a user to DM a valentine to be given anonymously.

Would you not like to know how long you have left to create a PR before it's too late?

Well, you can answer that question by creating this simple but awesome PR.

This is a simple feature request, that calculate the amount of time left till end of hacktoberFest.

Implementation details

List the changes required for the implementation here.

• Write the bot command timeleft
• Add the command to our README.md
• When the command is called, the remaining time, in days, hrs, mins left till end of hacktoberFest

Additional information

Feel free to look at the implementation of the other cogs for this implementation!

Add templates for new issues.

• Bug reports
• Feature requests

These should be created in .github/ISSUE_TEMPLATES, and named <template-name>.md.

GitHub's documentation
Examples of templates

Hacktoberfest provides both a global statistics page (which seems broken atm) and a per-user statistics page summarizing PR contributions during the event.

This proposed feature:

• Query GitHub's API for user PR contributions during the month of October
• Generate user statistics similar to those displayed by Hacktoberfest
• Generate an embed and sends to the #event-hacktoberfest channel
• Utilize an asynchronous request

User stats example:

This should add a year-round feature for the bot that responds with the current season (by hemisphere), and time to the next season.

The bot could provide equinox & solstice information as well:

Along with a helpful embed describing what equinox and solstice are.

https://en.wikipedia.org/wiki/Equinox
https://en.wikipedia.org/wiki/Solstice

This project's README doesn't contain any information about the available commands. For this issue, go through all of the existing cogs and add their public commands, along with a brief description, to a new section in the README.

Current cogs:

• Evergreen
• Christmas
• Halloween

Note that there are currently no merged cogs for LoveFest, so these should be documented by the feature authors.

Currently, the hacktoberstats cog is only able to query a GH name explicitly provided on command invocation.

The following enhancements are proposed:

• Add a .stats link github_username subcommand to link the invoking user with their github_username. This should overwrite any existing link.
• Write this registration to a local JSON file
• If .stats is invoked without a username input:
  • If a user has linked their GH username, query their Hacktoberfest stats
  • If a user has not linked their GH username, provide them the command to do so
• Add a .stats unlink command to remove any username links from the bot & local JSON
• (Optional) Allow other users to query stats by Discord name. This should be done without needing to mention the user (nobody likes @ spam). The bot should also respond similarly to the above no-nickname case if a name has not been linked to a GH account.

Description

The scary movie generator cog (PR #23) was written using requests, which can cause blocking with asyncio. The api calls to TMDb need to be made using aiohttp instead.

Thanks @meooow25 !

This bot should be using the excellent pipenv instead of requirements.txt, but because the former is less known than the latter, it is important that we also write documentation explaining exactly how to get this project set up.

This issue asks that you create a pipfile, then write the documentation in this repos wiki to explain what pipenv is, and how to use it for this project. The article should include the exact commands the user has to run.

Once this is done, CONTRIBUTING.md should be updated with a link to the wiki article.

Please wait for #2 to be merged before attempting this issue. First to claim the issue gets dibs on the pull request.

Which country or state would be more befitting to me for a beautiful valentine, if could go there?

I would like you to write a bot, that based on my tag name, would find a state with the most matching characters. And that state will be my (probably) next valentine vacation spot.

Implementation details

• Write the bot command !myvalenstate
• Return a state with the most matching character with tag name (plus some comment).

Example

.myvalenstate
Your valenState is Sweden
Sweden is a Scandinavian nation with thousands of coastal islands and inland lakes, along with vast boreal forests and glaciated mountains.

Have you ever wanted to know what zodiac sign you would be most compatible with? Well, this is your lucky day to find out.

This bot command will look at someone's zodiac sign, and give them the sign with which they are most compatible with. You can optionally provide the least compatible as well.

Implementation details

• Write the bot command !partnerzodiac
• The command will take one argument (the person Zodiac sign)
• Provide counterpart's zodiac sign

Additional information

.partnerzodiac virgo
Capricorn and Virgo share a respect for discipline, a sense of purpose and a love of order. Capricorn’s ambition is a good match for Virgo’s drive for perfection. This is a “harmonious pairing,” according to Woolfolk.

• Feel free to state your sources (optional)

In the spirit of halloween, let's go Trick or Treat in a form of a game:
This game will be a feature of the bot, where it will post a candy on main chat as an emoji (may want to use python emoji module, or other emoji sources or thumbnail image modules).

The first person who react to the emji will gets a candy if it's a treat, or a candy eating pumpkin that eats 5 to 10 of their candies. (Higher frequency of candies than pumpkin).

You have picked up a candy eating pumpkin. the pumpkin eats 5 ( if less than five, remaining/all) of your candies. [story can vary]

• Source of candy emojies
• contains different kind of halloween candy
• includes trick or treat
• need to store candy in user's

Originally posted by Gareth Coles:

Originally submitted by Automation to ClickUp:

Write a bot command for the Fun cog, bot.roll, which returns a random terningkast ie <:terning3:431249694467948544>

Volcyy commented:

drummeur (not yet on ClickUp) wanted to do this.

Is it still possible for you to get a t-shirt for completing 5 PRs now?

In order to find that out, we want to know how maybe has been completed, and how many are left. Therefore, we have proposed the create of this Feature Request, which will tell us these info whenever we want to know, as we are pushing towards the finish line.

Implementation details

List the changes required for the implementation here.

• Write the bot command prsleft
• access hacktoberfest API to get current number of completed PRs
• provide remaining numbers of PRs completed with numbers left

Additional information

Link to stats:
https://hacktoberfest.digitalocean.com/stats
You can check the PR #6 and #7 on access and use of the API

The goal of this task is to create an 8-ball that will generate random answers in a spookifying way, to support the halloween theme.

A user will ask a the bot a question via a command !8ball, is discord python awesome? and the bot will answer just like an 8-ball. (hhmm)

• list of spooky answers,
• 8-ball image or emoji