THIS PROJECT HAS BEEN ARCHIVED

<p align='center'> <a href="https://discord.io/TearDropsSupport"><img src="https://discordapp.com/api/guilds/765880027467350047/widget.png?style=banner2" alt="Link to discord server"><br> <a href="https://www.python.org/"><img src="http://ForTheBadge.com/images/badges/made-with-python.svg" alt="made with Python"></a> <a href="https://github.com/Vyvy-vi/"><img src="http://ForTheBadge.com/images/badges/built-with-love.svg" alt="built with Love"></a><br> <a href="https://raw.githubusercontent.com/Vyvy-vi/TearDrops/main/LICENSE"><img src="https://img.shields.io/github/license/Vyvy-vi/TearDrops?style=flat-square" alt="BSD license"></a> <a href="https://github.com/Rapptz/discord.py/releases/tag/v1.5.0"><img src="https://img.shields.io/badge/discord.py-v1.6.0-7289da.svg?style=flat-square" alt="discord.py version"></a> </p> <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->

<!-- ALL-CONTRIBUTORS-BADGE:END --> <p align='right'> <a href="https://github.com/Vyvy-vi/TearDrops/releases/latest/"><img src="https://img.shields.io/badge/Bot_Version-v0.1.3-green.svg?style=flat-square" alt="bot version"></a> </p>

Python based discord bot built to add fun to the guild with memes, provide wisdom with book-recommendations along with XP rating system with <strong>TEARS</strong> currency.

A discord bot wrapped around the theme of tears and crying. In concept, the idea is absurd but that's more of a reason to make this. :) The bot uses tears as an economy and you can "cry" to get daily credit tears.

NOTE- It is recommended that you add your own discord token while running the bot.

How to test the bot before running it on your server

To test the bot join the Support Server [NOTE- Bot is not active 24x7 as it is hosted on heroku. To get a sample, join TearDropsSupport and ping @Tissue]

How to run the bot on your own server

~~Invite the bot to your server~~ ~~[NOTE- The bot is still in v0.2.0 and is being constantly updated and bug fixed. Inviting this, might have unintentional complications. If you really want the bot, open an issue so that we can provide a Beta Version to you that is stable and updated slowly]~~

Hosting the bot locally:

NOTE: To replicate this bot, you will need a bot token. Go get yours at https://discord.com/developers/ (If you need help with this step, feel free to ask for help in our Support Server).

• Clone this repo using git clone
• cd into the bot folder.
• Add the token in a .env file in the project root as follows:

DISCORD_BOT_TOKEN=<your token>

• Install docker and docker-compose and then run:

docker-compose up

• Enjoy! (don't forget to add your own bot into your discord server by generating an invite link from the discord developers application page in OAuth2 section and choose application and check Oauth2 section)
• To stop this instance of the bot, run docker-compose down
• You may do bug-reporting or ask for help in on the SupportServer... or just open an issue on this repo.

How to contribute

Before contributing, here is some information that might help your PR (Pull Request) get merged.

How to set up the development environment

Requirements:

• git
• pip
• python 3.8.1 or higher

1. Fork and clone the repository with git clone https://github.com/<your-username>/TearDrops
2. Get to the clone directory using the command cd Teardrops
3. Copy the contents of the .env.sample file into a new file - .env and add your DISCORD bot token in there.
4. There are two ways to do further setup, pipenv or via docker:
   DOCKER METHOD:
   - Install docker and docker-compose
   - Run the command: docker-compose up
   OR
   THE TRADITIONAL METHOD:
   (Requires pipenv) - Install pipenv
   - Add the mongo connection URI in the .env file
   - Run pipenv sync --dev to install project dependencies and development dependencies
   - Run pipenv run start to run the bot.
   - Run pipenv run lint to lint the code.
   - For downloading more libraries, use pipenv install <package-name>
   - If you're adding any development-dependencies, use-> pipenv install <package-name> --dev\

<!-- ### To contribute changes follow these steps: **Note**: Make sure you have been assigned the issue to which you are making a PR. If you make PR before being assigned, It will be labeled invalid and closed without merging. 1. Add a upstream link to main branch in your cloned repo ``` git remote add upstream https://github.com/Vyvy-vi/TearDrops.git ``` 2. Keep your cloned repo upto date by pulling from upstream (this will also avoid any merge conflicts while committing new changes) ``` git pull upstream master ``` 3. Create your feature branch ``` git checkout -b <feature-name> ``` 4. Commit all the changes ``` git commit -am "Meaningful commit message" ``` 5. Push the changes for review ``` git push origin <branch-name> ``` 6. Create a PR from our repo on Github. ### How to report a bug Submit an issue on GitHub and add as much information as you can about the bug, with screenshots of inputs to the bot and bot response if possible (if the issue is regarding bugs). **Note**: Try to make issues that are not blank and are in their respective category. **Note**: For more detailed information about how to contribute, please refere to the [CONTRIBUTING.md](https://github.com/Vyvy-vi/TearDrops/blob/main/CONTRIBUTING.md) file. --->

Requirements:

• python 3
• discord(rewrite branch)
• asyncio(inbuilt with python3.4)
• wikipedia
• aiohttp
• motor(asynchronous client for mongodb)
• dnspython

Contributors ✨

Thanks goes to these wonderful people (emoji key):

<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section --> <!-- prettier-ignore-start --> <!-- markdownlint-disable --> <table> <tr> <td align="center"><a href="https://allcontributors.org"><img src="https://avatars1.githubusercontent.com/u/46410174?v=4?s=100" width="100px;" alt=""/><br />_{<b>All Contributors</b>}</a><br /><a href="https://github.com/Vyvy-vi/TearDrops/commits?author=all-contributors" title="Documentation">📖</a></td> <td align="center"><a href="https://github.com/Vyvy-vi"><img src="https://avatars0.githubusercontent.com/u/62864373?v=4?s=100" width="100px;" alt=""/><br />_{<b>Vyom Jain</b>}</a><br /><a href="https://github.com/Vyvy-vi/TearDrops/commits?author=Vyvy-vi" title="Code">💻</a> <a href="#projectManagement-Vyvy-vi" title="Project Management">📆</a> <a href="#design-Vyvy-vi" title="Design">🎨</a> <a href="https://github.com/Vyvy-vi/TearDrops/commits?author=Vyvy-vi" title="Documentation">📖</a> <a href="#maintenance-Vyvy-vi" title="Maintenance">🚧</a> <a href="https://github.com/Vyvy-vi/TearDrops/pulls?q=is%3Apr+reviewed-by%3AVyvy-vi" title="Reviewed Pull Requests">👀</a></td> <td align="center"><a href="https://anubhav.codes"><img src="https://avatars0.githubusercontent.com/u/1628340?v=4?s=100" width="100px;" alt=""/><br />_{<b>Anubhav</b>}</a><br /><a href="https://github.com/Vyvy-vi/TearDrops/commits?author=anubhavcodes" title="Code">💻</a> <a href="https://github.com/Vyvy-vi/TearDrops/commits?author=anubhavcodes" title="Documentation">📖</a> <a href="#ideas-anubhavcodes" title="Ideas, Planning, & Feedback">🤔</a> <a href="#infra-anubhavcodes" title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a></td> <td align="center"><a href="https://github.com/gamerrio"><img src="https://avatars0.githubusercontent.com/u/21240909?v=4?s=100" width="100px;" alt=""/><br />_{<b>Gamerrio</b>}</a><br /><a href="#ideas-gamerrio" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/Vyvy-vi/TearDrops/commits?author=gamerrio" title="Code">💻</a> <a href="#design-gamerrio" title="Design">🎨</a></td> <td align="center"><a href="https://github.com/RascalTwo"><img src="https://avatars0.githubusercontent.com/u/9403665?v=4?s=100" width="100px;" alt=""/><br />_{<b>Rascal_Two</b>}</a><br /><a href="https://github.com/Vyvy-vi/TearDrops/issues?q=author%3ARascalTwo" title="Bug reports">🐛</a> <a href="https://github.com/Vyvy-vi/TearDrops/commits?author=RascalTwo" title="Code">💻</a> <a href="#ideas-RascalTwo" title="Ideas, Planning, & Feedback">🤔</a></td> <td align="center"><a href="https://github.com/sayand0122"><img src="https://avatars1.githubusercontent.com/u/53222600?v=4?s=100" width="100px;" alt=""/><br />_{<b>Sayan Dutta</b>}</a><br /><a href="#ideas-sayand0122" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/Vyvy-vi/TearDrops/commits?author=sayand0122" title="Code">💻</a> <a href="#design-sayand0122" title="Design">🎨</a></td> <td align="center"><a href="http://www.nhcarrigan.com"><img src="https://avatars1.githubusercontent.com/u/63889819?v=4?s=100" width="100px;" alt=""/><br />_{<b>Nicholas Carrigan (he/him)</b>}</a><br /><a href="#ideas-nhcarrigan" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/Vyvy-vi/TearDrops/commits?author=nhcarrigan" title="Documentation">📖</a></td> </tr> <tr> <td align="center"><a href="https://mikeysan.hashnode.dev"><img src="https://avatars1.githubusercontent.com/u/13338176?v=4?s=100" width="100px;" alt=""/><br />_{<b>Michael Mba</b>}</a><br /><a href="#i