aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorGravatar sco1 <[email protected]>2019-03-09 12:08:57 -0500
committerGravatar sco1 <[email protected]>2019-03-09 12:08:57 -0500
commit869f2ccdafeb0f4f150988542ce1b25286cac0d3 (patch)
treeefbe0be19a7116ae801508b9be543603815512a5
parentAdd newlines (diff)
parentMerge pull request #138 from python-discord/docker-fix (diff)
Merge branch 'master' into dpy-cog-changes
-rw-r--r--Pipfile3
-rw-r--r--Pipfile.lock144
-rw-r--r--azure-pipelines.yml1
-rw-r--r--bot/bot.py2
-rw-r--r--bot/constants.py18
-rw-r--r--bot/decorators.py41
-rw-r--r--bot/pagination.py480
-rw-r--r--bot/resources/snakes/snake_cards/backs/card_back1.jpgbin0 -> 165788 bytes
-rw-r--r--bot/resources/snakes/snake_cards/backs/card_back2.jpgbin0 -> 140868 bytes
-rw-r--r--bot/resources/snakes/snake_cards/card_bottom.pngbin0 -> 18165 bytes
-rw-r--r--bot/resources/snakes/snake_cards/card_frame.pngbin0 -> 1460 bytes
-rw-r--r--bot/resources/snakes/snake_cards/card_top.pngbin0 -> 12581 bytes
-rw-r--r--bot/resources/snakes/snake_cards/expressway.ttfbin0 -> 156244 bytes
-rw-r--r--bot/resources/snakes/snake_facts.json233
-rw-r--r--bot/resources/snakes/snake_idioms.json275
-rw-r--r--bot/resources/snakes/snake_names.json2170
-rw-r--r--bot/resources/snakes/snake_quiz.json200
-rw-r--r--bot/resources/snakes/snakes_and_ladders/banner.jpgbin0 -> 17928 bytes
-rw-r--r--bot/resources/snakes/snakes_and_ladders/board.jpgbin0 -> 80264 bytes
-rw-r--r--bot/resources/snakes/special_snakes.json16
-rw-r--r--bot/seasons/evergreen/__init__.py2
-rw-r--r--bot/seasons/evergreen/snakes/__init__.py10
-rw-r--r--bot/seasons/evergreen/snakes/converter.py80
-rw-r--r--bot/seasons/evergreen/snakes/snakes_cog.py1194
-rw-r--r--bot/seasons/evergreen/snakes/utils.py700
-rw-r--r--bot/seasons/season.py27
-rw-r--r--bot/utils/__init__.py79
-rw-r--r--docker/Dockerfile8
-rw-r--r--tox.ini2
29 files changed, 5664 insertions, 21 deletions
diff --git a/Pipfile b/Pipfile
index 90707d25..e4a93615 100644
--- a/Pipfile
+++ b/Pipfile
@@ -4,12 +4,13 @@ verify_ssl = true
name = "pypi"
[packages]
-discord-py = {ref = "rewrite",git = "https://github.com/Rapptz/discord.py"}
+discord-py = {ref = "rewrite",git = "https://github.com/Rapptz/discord.py",editable = true}
arrow = "*"
beautifulsoup4 = "*"
aiodns = "*"
pillow = "*"
pytz = "*"
+fuzzywuzzy = "*"
[dev-packages]
"flake8" = "*"
diff --git a/Pipfile.lock b/Pipfile.lock
index 67230b17..d10d72bd 100644
--- a/Pipfile.lock
+++ b/Pipfile.lock
@@ -1,7 +1,7 @@
{
"_meta": {
"hash": {
- "sha256": "56ef4499fef622c131943cc402884901581fa337ac602069e9e6e2d25096ff93"
+ "sha256": "79ee5cb69226a76b70793363516c5774516f0c2af0c55fd8e455e5f9ae76165d"
},
"pipfile-spec": 6,
"requires": {
@@ -24,6 +24,33 @@
"index": "pypi",
"version": "==2.0.0"
},
+ "aiohttp": {
+ "hashes": [
+ "sha256:00d198585474299c9c3b4f1d5de1a576cc230d562abc5e4a0e81d71a20a6ca55",
+ "sha256:0155af66de8c21b8dba4992aaeeabf55503caefae00067a3b1139f86d0ec50ed",
+ "sha256:09654a9eca62d1bd6d64aa44db2498f60a5c1e0ac4750953fdd79d5c88955e10",
+ "sha256:199f1d106e2b44b6dacdf6f9245493c7d716b01d0b7fbe1959318ba4dc64d1f5",
+ "sha256:296f30dedc9f4b9e7a301e5cc963012264112d78a1d3094cd83ef148fdf33ca1",
+ "sha256:368ed312550bd663ce84dc4b032a962fcb3c7cae099dbbd48663afc305e3b939",
+ "sha256:40d7ea570b88db017c51392349cf99b7aefaaddd19d2c78368aeb0bddde9d390",
+ "sha256:629102a193162e37102c50713e2e31dc9a2fe7ac5e481da83e5bb3c0cee700aa",
+ "sha256:6d5ec9b8948c3d957e75ea14d41e9330e1ac3fed24ec53766c780f82805140dc",
+ "sha256:87331d1d6810214085a50749160196391a712a13336cd02ce1c3ea3d05bcf8d5",
+ "sha256:9a02a04bbe581c8605ac423ba3a74999ec9d8bce7ae37977a3d38680f5780b6d",
+ "sha256:9c4c83f4fa1938377da32bc2d59379025ceeee8e24b89f72fcbccd8ca22dc9bf",
+ "sha256:9cddaff94c0135ee627213ac6ca6d05724bfe6e7a356e5e09ec57bd3249510f6",
+ "sha256:a25237abf327530d9561ef751eef9511ab56fd9431023ca6f4803f1994104d72",
+ "sha256:a5cbd7157b0e383738b8e29d6e556fde8726823dae0e348952a61742b21aeb12",
+ "sha256:a97a516e02b726e089cffcde2eea0d3258450389bbac48cbe89e0f0b6e7b0366",
+ "sha256:acc89b29b5f4e2332d65cd1b7d10c609a75b88ef8925d487a611ca788432dfa4",
+ "sha256:b05bd85cc99b06740aad3629c2585bda7b83bd86e080b44ba47faf905fdf1300",
+ "sha256:c2bec436a2b5dafe5eaeb297c03711074d46b6eb236d002c13c42f25c4a8ce9d",
+ "sha256:cc619d974c8c11fe84527e4b5e1c07238799a8c29ea1c1285149170524ba9303",
+ "sha256:d4392defd4648badaa42b3e101080ae3313e8f4787cb517efd3f5b8157eaefd6",
+ "sha256:e1c3c582ee11af7f63a34a46f0448fca58e59889396ffdae1f482085061a2889"
+ ],
+ "version": "==3.5.4"
+ },
"arrow": {
"hashes": [
"sha256:3397e5448952e18e1295bf047014659effa5ae8da6a5371d37ff0ddc46fa6872",
@@ -32,6 +59,20 @@
"index": "pypi",
"version": "==0.13.1"
},
+ "async-timeout": {
+ "hashes": [
+ "sha256:0c3c816a028d47f659d6ff5c745cb2acf1f966da1fe5c19c77a70282b25f4c5f",
+ "sha256:4291ca197d287d274d0b6cb5d6f8f8f82d434ed288f962539ff18cc9012f9ea3"
+ ],
+ "version": "==3.0.1"
+ },
+ "attrs": {
+ "hashes": [
+ "sha256:69c0dbf2ed392de1cb5ec704444b08a5ef81680a61cb899dc08127123af36a79",
+ "sha256:f0b870f674851ecbfbbbd364d6b5cbdff9dcedbc7f3f5e18a6891057f21fe399"
+ ],
+ "version": "==19.1.0"
+ },
"beautifulsoup4": {
"hashes": [
"sha256:034740f6cb549b4e932ae1ab975581e6103ac8f942200a0e9759065984391858",
@@ -74,9 +115,66 @@
],
"version": "==1.12.2"
},
+ "chardet": {
+ "hashes": [
+ "sha256:84ab92ed1c4d4f16916e05906b6b75a6c0fb5db821cc65e70cbd64a3e2a5eaae",
+ "sha256:fc323ffcaeaed0e0a02bf4d117757b98aed530d9ed4531e3e15460124c106691"
+ ],
+ "version": "==3.0.4"
+ },
"discord-py": {
+ "editable": true,
"git": "https://github.com/Rapptz/discord.py",
- "ref": "45af9fa40bc0083de3a695795029d6f6a85ce0d8"
+ "ref": "42a7c4f7e5caa7baf555e86b52249419ce33acfc"
+ },
+ "fuzzywuzzy": {
+ "hashes": [
+ "sha256:5ac7c0b3f4658d2743aa17da53a55598144edbc5bee3c6863840636e6926f254",
+ "sha256:6f49de47db00e1c71d40ad16da42284ac357936fa9b66bea1df63fed07122d62"
+ ],
+ "index": "pypi",
+ "version": "==0.17.0"
+ },
+ "idna": {
+ "hashes": [
+ "sha256:c357b3f628cf53ae2c4c05627ecc484553142ca23264e593d327bcde5e9c3407",
+ "sha256:ea8b7f6188e6fa117537c3df7da9fc686d485087abf6ac197f9c46432f7e4a3c"
+ ],
+ "version": "==2.8"
+ },
+ "multidict": {
+ "hashes": [
+ "sha256:024b8129695a952ebd93373e45b5d341dbb87c17ce49637b34000093f243dd4f",
+ "sha256:041e9442b11409be5e4fc8b6a97e4bcead758ab1e11768d1e69160bdde18acc3",
+ "sha256:045b4dd0e5f6121e6f314d81759abd2c257db4634260abcfe0d3f7083c4908ef",
+ "sha256:047c0a04e382ef8bd74b0de01407e8d8632d7d1b4db6f2561106af812a68741b",
+ "sha256:068167c2d7bbeebd359665ac4fff756be5ffac9cda02375b5c5a7c4777038e73",
+ "sha256:148ff60e0fffa2f5fad2eb25aae7bef23d8f3b8bdaf947a65cdbe84a978092bc",
+ "sha256:1d1c77013a259971a72ddaa83b9f42c80a93ff12df6a4723be99d858fa30bee3",
+ "sha256:1d48bc124a6b7a55006d97917f695effa9725d05abe8ee78fd60d6588b8344cd",
+ "sha256:31dfa2fc323097f8ad7acd41aa38d7c614dd1960ac6681745b6da124093dc351",
+ "sha256:34f82db7f80c49f38b032c5abb605c458bac997a6c3142e0d6c130be6fb2b941",
+ "sha256:3d5dd8e5998fb4ace04789d1d008e2bb532de501218519d70bb672c4c5a2fc5d",
+ "sha256:4a6ae52bd3ee41ee0f3acf4c60ceb3f44e0e3bc52ab7da1c2b2aa6703363a3d1",
+ "sha256:4b02a3b2a2f01d0490dd39321c74273fed0568568ea0e7ea23e02bd1fb10a10b",
+ "sha256:4b843f8e1dd6a3195679d9838eb4670222e8b8d01bc36c9894d6c3538316fa0a",
+ "sha256:5de53a28f40ef3c4fd57aeab6b590c2c663de87a5af76136ced519923d3efbb3",
+ "sha256:61b2b33ede821b94fa99ce0b09c9ece049c7067a33b279f343adfe35108a4ea7",
+ "sha256:6a3a9b0f45fd75dc05d8e93dc21b18fc1670135ec9544d1ad4acbcf6b86781d0",
+ "sha256:76ad8e4c69dadbb31bad17c16baee61c0d1a4a73bed2590b741b2e1a46d3edd0",
+ "sha256:7ba19b777dc00194d1b473180d4ca89a054dd18de27d0ee2e42a103ec9b7d014",
+ "sha256:7c1b7eab7a49aa96f3db1f716f0113a8a2e93c7375dd3d5d21c4941f1405c9c5",
+ "sha256:7fc0eee3046041387cbace9314926aa48b681202f8897f8bff3809967a049036",
+ "sha256:8ccd1c5fff1aa1427100ce188557fc31f1e0a383ad8ec42c559aabd4ff08802d",
+ "sha256:8e08dd76de80539d613654915a2f5196dbccc67448df291e69a88712ea21e24a",
+ "sha256:c18498c50c59263841862ea0501da9f2b3659c00db54abfbf823a80787fde8ce",
+ "sha256:c49db89d602c24928e68c0d510f4fcf8989d77defd01c973d6cbe27e684833b1",
+ "sha256:ce20044d0317649ddbb4e54dab3c1bcc7483c78c27d3f58ab3d0c7e6bc60d26a",
+ "sha256:d1071414dd06ca2eafa90c85a079169bfeb0e5f57fd0b45d44c092546fcd6fd9",
+ "sha256:d3be11ac43ab1a3e979dac80843b42226d5d3cccd3986f2e03152720a4297cd7",
+ "sha256:db603a1c235d110c860d5f39988ebc8218ee028f07a7cbc056ba6424372ca31b"
+ ],
+ "version": "==4.5.2"
},
"pillow": {
"hashes": [
@@ -166,6 +264,48 @@
"sha256:eaed742b48b1f3e2d45ba6f79401b2ed5dc33b2123dfe216adb90d4bfa0ade26"
],
"version": "==1.8"
+ },
+ "websockets": {
+ "hashes": [
+ "sha256:04b42a1b57096ffa5627d6a78ea1ff7fad3bc2c0331ffc17bc32a4024da7fea0",
+ "sha256:08e3c3e0535befa4f0c4443824496c03ecc25062debbcf895874f8a0b4c97c9f",
+ "sha256:10d89d4326045bf5e15e83e9867c85d686b612822e4d8f149cf4840aab5f46e0",
+ "sha256:232fac8a1978fc1dead4b1c2fa27c7756750fb393eb4ac52f6bc87ba7242b2fa",
+ "sha256:4bf4c8097440eff22bc78ec76fe2a865a6e658b6977a504679aaf08f02c121da",
+ "sha256:51642ea3a00772d1e48fb0c492f0d3ae3b6474f34d20eca005a83f8c9c06c561",
+ "sha256:55d86102282a636e195dad68aaaf85b81d0bef449d7e2ef2ff79ac450bb25d53",
+ "sha256:564d2675682bd497b59907d2205031acbf7d3fadf8c763b689b9ede20300b215",
+ "sha256:5d13bf5197a92149dc0badcc2b699267ff65a867029f465accfca8abab95f412",
+ "sha256:5eda665f6789edb9b57b57a159b9c55482cbe5b046d7db458948370554b16439",
+ "sha256:5edb2524d4032be4564c65dc4f9d01e79fe8fad5f966e5b552f4e5164fef0885",
+ "sha256:79691794288bc51e2a3b8de2bc0272ca8355d0b8503077ea57c0716e840ebaef",
+ "sha256:7fcc8681e9981b9b511cdee7c580d5b005f3bb86b65bde2188e04a29f1d63317",
+ "sha256:8e447e05ec88b1b408a4c9cde85aa6f4b04f06aa874b9f0b8e8319faf51b1fee",
+ "sha256:90ea6b3e7787620bb295a4ae050d2811c807d65b1486749414f78cfd6fb61489",
+ "sha256:9e13239952694b8b831088431d15f771beace10edfcf9ef230cefea14f18508f",
+ "sha256:d40f081187f7b54d7a99d8a5c782eaa4edc335a057aa54c85059272ed826dc09",
+ "sha256:e1df1a58ed2468c7b7ce9a2f9752a32ad08eac2bcd56318625c3647c2cd2da6f",
+ "sha256:e98d0cec437097f09c7834a11c69d79fe6241729b23f656cfc227e93294fc242",
+ "sha256:f8d59627702d2ff27cb495ca1abdea8bd8d581de425c56e93bff6517134e0a9b",
+ "sha256:fc30cdf2e949a2225b012a7911d1d031df3d23e99b7eda7dfc982dc4a860dae9"
+ ],
+ "version": "==7.0"
+ },
+ "yarl": {
+ "hashes": [
+ "sha256:024ecdc12bc02b321bc66b41327f930d1c2c543fa9a561b39861da9388ba7aa9",
+ "sha256:2f3010703295fbe1aec51023740871e64bb9664c789cba5a6bdf404e93f7568f",
+ "sha256:3890ab952d508523ef4881457c4099056546593fa05e93da84c7250516e632eb",
+ "sha256:3e2724eb9af5dc41648e5bb304fcf4891adc33258c6e14e2a7414ea32541e320",
+ "sha256:5badb97dd0abf26623a9982cd448ff12cb39b8e4c94032ccdedf22ce01a64842",
+ "sha256:73f447d11b530d860ca1e6b582f947688286ad16ca42256413083d13f260b7a0",
+ "sha256:7ab825726f2940c16d92aaec7d204cfc34ac26c0040da727cf8ba87255a33829",
+ "sha256:b25de84a8c20540531526dfbb0e2d2b648c13fd5dd126728c496d7c3fea33310",
+ "sha256:c6e341f5a6562af74ba55205dbd56d248daf1b5748ec48a0200ba227bb9e33f4",
+ "sha256:c9bb7c249c4432cd47e75af3864bc02d26c9594f49c82e2a28624417f0ae63b8",
+ "sha256:e060906c0c585565c718d1c3841747b61c5439af2211e185f6739a9412dfbde1"
+ ],
+ "version": "==1.3.0"
}
},
"develop": {
diff --git a/azure-pipelines.yml b/azure-pipelines.yml
index 15fac3b9..f81f1139 100644
--- a/azure-pipelines.yml
+++ b/azure-pipelines.yml
@@ -17,6 +17,7 @@ jobs:
variables:
PIPENV_CACHE_DIR: ".cache/pipenv"
PIP_CACHE_DIR: ".cache/pip"
+ PIP_SRC: ".cache/src"
steps:
- script: sudo apt-get install build-essential curl docker libffi-dev libfreetype6-dev libxml2 libxml2-dev libxslt1-dev zlib1g zlib1g-dev
diff --git a/bot/bot.py b/bot/bot.py
index 84bac598..c1198957 100644
--- a/bot/bot.py
+++ b/bot/bot.py
@@ -69,4 +69,4 @@ class SeasonalBot(Bot):
if isinstance(exception, commands.UserInputError):
context.command.reset_cooldown(context)
else:
- super().on_command_error(context, exception)
+ await super().on_command_error(context, exception)
diff --git a/bot/constants.py b/bot/constants.py
index 0ffc9081..b19d494b 100644
--- a/bot/constants.py
+++ b/bot/constants.py
@@ -6,7 +6,7 @@ from bot.bot import SeasonalBot
__all__ = (
"AdventOfCode", "Channels", "Client", "Colours", "Emojis", "Hacktoberfest", "Roles",
- "Tokens", "bot"
+ "Tokens", "ERROR_REPLIES", "bot"
)
log = logging.getLogger(__name__)
@@ -109,6 +109,22 @@ class Roles(NamedTuple):
class Tokens(NamedTuple):
giphy = environ.get("GIPHY_TOKEN")
aoc_session_cookie = environ.get("AOC_SESSION_COOKIE")
+ omdb = environ.get("OMDB_API_KEY")
+ youtube = environ.get("YOUTUBE_API_KEY")
+
+
+ERROR_REPLIES = [
+ "Please don't do that.",
+ "You have to stop.",
+ "Do you mind?",
+ "In the future, don't do that.",
+ "That was a mistake.",
+ "You blew it.",
+ "You're bad at computers.",
+ "Are you trying to kill me?",
+ "Noooooo!!",
+ "I can't believe you've done this",
+]
bot = SeasonalBot(command_prefix=Client.prefix)
diff --git a/bot/decorators.py b/bot/decorators.py
index b84b2c36..f5ffadf4 100644
--- a/bot/decorators.py
+++ b/bot/decorators.py
@@ -1,8 +1,15 @@
import logging
+import random
+from asyncio import Lock
+from functools import wraps
+from weakref import WeakValueDictionary
+from discord import Colour, Embed
from discord.ext import commands
from discord.ext.commands import Context
+from bot.constants import ERROR_REPLIES
+
log = logging.getLogger(__name__)
@@ -46,3 +53,37 @@ def in_channel(channel_id):
f"The result of the in_channel check was {check}.")
return check
return commands.check(predicate)
+
+
+def locked():
+ """
+ Allows the user to only run one instance of the decorated command at a time.
+ Subsequent calls to the command from the same author are
+ ignored until the command has completed invocation.
+
+ This decorator has to go before (below) the `command` decorator.
+ """
+
+ def wrap(func):
+ func.__locks = WeakValueDictionary()
+
+ @wraps(func)
+ async def inner(self, ctx, *args, **kwargs):
+ lock = func.__locks.setdefault(ctx.author.id, Lock())
+ if lock.locked():
+ embed = Embed()
+ embed.colour = Colour.red()
+
+ log.debug(f"User tried to invoke a locked command.")
+ embed.description = (
+ "You're already using this command. Please wait until "
+ "it is done before you use it again."
+ )
+ embed.title = random.choice(ERROR_REPLIES)
+ await ctx.send(embed=embed)
+ return
+
+ async with func.__locks.setdefault(ctx.author.id, Lock()):
+ return await func(self, ctx, *args, **kwargs)
+ return inner
+ return wrap
diff --git a/bot/pagination.py b/bot/pagination.py
new file mode 100644
index 00000000..0ad5b81f
--- /dev/null
+++ b/bot/pagination.py
@@ -0,0 +1,480 @@
+import asyncio
+import logging
+from typing import Iterable, List, Optional, Tuple
+
+from discord import Embed, Member, Reaction
+from discord.abc import User
+from discord.ext.commands import Context, Paginator
+
+FIRST_EMOJI = "\u23EE" # [:track_previous:]
+LEFT_EMOJI = "\u2B05" # [:arrow_left:]
+RIGHT_EMOJI = "\u27A1" # [:arrow_right:]
+LAST_EMOJI = "\u23ED" # [:track_next:]
+DELETE_EMOJI = "\u274c" # [:x:]
+
+PAGINATION_EMOJI = [FIRST_EMOJI, LEFT_EMOJI, RIGHT_EMOJI, LAST_EMOJI, DELETE_EMOJI]
+
+log = logging.getLogger(__name__)
+
+
+class EmptyPaginatorEmbed(Exception):
+ pass
+
+
+class LinePaginator(Paginator):
+ """
+ A class that aids in paginating code blocks for Discord messages.
+
+ Attributes
+ -----------
+ prefix: :class:`str`
+ The prefix inserted to every page. e.g. three backticks.
+ suffix: :class:`str`
+ The suffix appended at the end of every page. e.g. three backticks.
+ max_size: :class:`int`
+ The maximum amount of codepoints allowed in a page.
+ max_lines: :class:`int`
+ The maximum amount of lines allowed in a page.
+ """
+
+ def __init__(self, prefix='```', suffix='```',
+ max_size=2000, max_lines=None):
+ """
+ This function overrides the Paginator.__init__
+ from inside discord.ext.commands.
+ It overrides in order to allow us to configure
+ the maximum number of lines per page.
+ """
+ self.prefix = prefix
+ self.suffix = suffix
+ self.max_size = max_size - len(suffix)
+ self.max_lines = max_lines
+ self._current_page = [prefix]
+ self._linecount = 0
+ self._count = len(prefix) + 1 # prefix + newline
+ self._pages = []
+
+ def add_line(self, line='', *, empty=False):
+ """Adds a line to the current page.
+
+ If the line exceeds the :attr:`max_size` then an exception
+ is raised.
+
+ This function overrides the Paginator.add_line
+ from inside discord.ext.commands.
+ It overrides in order to allow us to configure
+ the maximum number of lines per page.
+
+ Parameters
+ -----------
+ line: str
+ The line to add.
+ empty: bool
+ Indicates if another empty line should be added.
+
+ Raises
+ ------
+ RuntimeError
+ The line was too big for the current :attr:`max_size`.
+ """
+ if len(line) > self.max_size - len(self.prefix) - 2:
+ raise RuntimeError('Line exceeds maximum page size %s' % (self.max_size - len(self.prefix) - 2))
+
+ if self.max_lines is not None:
+ if self._linecount >= self.max_lines:
+ self._linecount = 0
+ self.close_page()
+
+ self._linecount += 1
+ if self._count + len(line) + 1 > self.max_size:
+ self.close_page()
+
+ self._count += len(line) + 1
+ self._current_page.append(line)
+
+ if empty:
+ self._current_page.append('')
+ self._count += 1
+
+ @classmethod
+ async def paginate(cls, lines: Iterable[str], ctx: Context, embed: Embed,
+ prefix: str = "", suffix: str = "", max_lines: Optional[int] = None, max_size: int = 500,
+ empty: bool = True, restrict_to_user: User = None, timeout: int = 300,
+ footer_text: str = None, url: str = None, exception_on_empty_embed: bool = False):
+ """
+ Use a paginator and set of reactions to provide pagination over a set of lines. The reactions are used to
+ switch page, or to finish with pagination.
+ When used, this will send a message using `ctx.send()` and apply a set of reactions to it. These reactions may
+ be used to change page, or to remove pagination from the message. Pagination will also be removed automatically
+ if no reaction is added for five minutes (300 seconds).
+ >>> embed = Embed()
+ >>> embed.set_author(name="Some Operation", url=url, icon_url=icon)
+ >>> await LinePaginator.paginate(
+ ... (line for line in lines),
+ ... ctx, embed
+ ... )
+ :param lines: The lines to be paginated
+ :param ctx: Current context object
+ :param embed: A pre-configured embed to be used as a template for each page
+ :param prefix: Text to place before each page
+ :param suffix: Text to place after each page
+ :param max_lines: The maximum number of lines on each page
+ :param max_size: The maximum number of characters on each page
+ :param empty: Whether to place an empty line between each given line
+ :param restrict_to_user: A user to lock pagination operations to for this message, if supplied
+ :param exception_on_empty_embed: Should there be an exception if the embed is empty?
+ :param url: the url to use for the embed headline
+ :param timeout: The amount of time in seconds to disable pagination of no reaction is added
+ :param footer_text: Text to prefix the page number in the footer with
+ """
+
+ def event_check(reaction_: Reaction, user_: Member):
+ """
+ Make sure that this reaction is what we want to operate on
+ """
+
+ no_restrictions = (
+ # Pagination is not restricted
+ not restrict_to_user
+ # The reaction was by a whitelisted user
+ or user_.id == restrict_to_user.id
+ )
+
+ return (
+ # Conditions for a successful pagination:
+ all((
+ # Reaction is on this message
+ reaction_.message.id == message.id,
+ # Reaction is one of the pagination emotes
+ reaction_.emoji in PAGINATION_EMOJI,
+ # Reaction was not made by the Bot
+ user_.id != ctx.bot.user.id,
+ # There were no restrictions
+ no_restrictions
+ ))
+ )
+
+ paginator = cls(prefix=prefix, suffix=suffix, max_size=max_size, max_lines=max_lines)
+ current_page = 0
+
+ if not lines:
+ if exception_on_empty_embed:
+ log.exception(f"Pagination asked for empty lines iterable")
+ raise EmptyPaginatorEmbed("No lines to paginate")
+
+ log.debug("No lines to add to paginator, adding '(nothing to display)' message")
+ lines.append("(nothing to display)")
+
+ for line in lines:
+ try:
+ paginator.add_line(line, empty=empty)
+ except Exception:
+ log.exception(f"Failed to add line to paginator: '{line}'")
+ raise # Should propagate
+ else:
+ log.trace(f"Added line to paginator: '{line}'")
+
+ log.debug(f"Paginator created with {len(paginator.pages)} pages")
+
+ embed.description = paginator.pages[current_page]
+
+ if len(paginator.pages) <= 1:
+ if footer_text:
+ embed.set_footer(text=footer_text)
+ log.trace(f"Setting embed footer to '{footer_text}'")
+
+ if url:
+ embed.url = url
+ log.trace(f"Setting embed url to '{url}'")
+
+ log.debug("There's less than two pages, so we won't paginate - sending single page on its own")
+ return await ctx.send(embed=embed)
+ else:
+ if footer_text:
+ embed.set_footer(text=f"{footer_text} (Page {current_page + 1}/{len(paginator.pages)})")
+ else:
+ embed.set_footer(text=f"Page {current_page + 1}/{len(paginator.pages)}")
+ log.trace(f"Setting embed footer to '{embed.footer.text}'")
+
+ if url:
+ embed.url = url
+ log.trace(f"Setting embed url to '{url}'")
+
+ log.debug("Sending first page to channel...")
+ message = await ctx.send(embed=embed)
+
+ log.debug("Adding emoji reactions to message...")
+
+ for emoji in PAGINATION_EMOJI:
+ # Add all the applicable emoji to the message
+ log.trace(f"Adding reaction: {repr(emoji)}")
+ await message.add_reaction(emoji)
+
+ while True:
+ try:
+ reaction, user = await ctx.bot.wait_for("reaction_add", timeout=timeout, check=event_check)
+ log.trace(f"Got reaction: {reaction}")
+ except asyncio.TimeoutError:
+ log.debug("Timed out waiting for a reaction")
+ break # We're done, no reactions for the last 5 minutes
+
+ if reaction.emoji == DELETE_EMOJI:
+ log.debug("Got delete reaction")
+ break
+
+ if reaction.emoji == FIRST_EMOJI:
+ await message.remove_reaction(reaction.emoji, user)
+ current_page = 0
+
+ log.debug(f"Got first page reaction - changing to page 1/{len(paginator.pages)}")
+
+ embed.description = ""
+ await message.edit(embed=embed)
+ embed.description = paginator.pages[current_page]
+ if footer_text:
+ embed.set_footer(text=f"{footer_text} (Page {current_page + 1}/{len(paginator.pages)})")
+ else:
+ embed.set_footer(text=f"Page {current_page + 1}/{len(paginator.pages)}")
+ await message.edit(embed=embed)
+
+ if reaction.emoji == LAST_EMOJI:
+ await message.remove_reaction(reaction.emoji, user)
+ current_page = len(paginator.pages) - 1
+
+ log.debug(f"Got last page reaction - changing to page {current_page + 1}/{len(paginator.pages)}")
+
+ embed.description = ""
+ await message.edit(embed=embed)
+ embed.description = paginator.pages[current_page]
+ if footer_text:
+ embed.set_footer(text=f"{footer_text} (Page {current_page + 1}/{len(paginator.pages)})")
+ else:
+ embed.set_footer(text=f"Page {current_page + 1}/{len(paginator.pages)}")
+ await message.edit(embed=embed)
+
+ if reaction.emoji == LEFT_EMOJI:
+ await message.remove_reaction(reaction.emoji, user)
+
+ if current_page <= 0:
+ log.debug("Got previous page reaction, but we're on the first page - ignoring")
+ continue
+
+ current_page -= 1
+ log.debug(f"Got previous page reaction - changing to page {current_page + 1}/{len(paginator.pages)}")
+
+ embed.description = ""
+ await message.edit(embed=embed)
+ embed.description = paginator.pages[current_page]
+
+ if footer_text:
+ embed.set_footer(text=f"{footer_text} (Page {current_page + 1}/{len(paginator.pages)})")
+ else:
+ embed.set_footer(text=f"Page {current_page + 1}/{len(paginator.pages)}")
+
+ await message.edit(embed=embed)
+
+ if reaction.emoji == RIGHT_EMOJI:
+ await message.remove_reaction(reaction.emoji, user)
+
+ if current_page >= len(paginator.pages) - 1:
+ log.debug("Got next page reaction, but we're on the last page - ignoring")
+ continue
+
+ current_page += 1
+ log.debug(f"Got next page reaction - changing to page {current_page + 1}/{len(paginator.pages)}")
+
+ embed.description = ""
+ await message.edit(embed=embed)
+ embed.description = paginator.pages[current_page]
+
+ if footer_text:
+ embed.set_footer(text=f"{footer_text} (Page {current_page + 1}/{len(paginator.pages)})")
+ else:
+ embed.set_footer(text=f"Page {current_page + 1}/{len(paginator.pages)}")
+
+ await message.edit(embed=embed)
+
+ log.debug("Ending pagination and removing all reactions...")
+ await message.clear_reactions()
+
+
+class ImagePaginator(Paginator):
+ """
+ Helper class that paginates images for embeds in messages.
+ Close resemblance to LinePaginator, except focuses on images over text.
+
+ Refer to ImagePaginator.paginate for documentation on how to use.
+ """
+
+ def __init__(self, prefix="", suffix=""):
+ super().__init__(prefix, suffix)
+ self._current_page = [prefix]
+ self.images = []
+ self._pages = []
+
+ def add_line(self, line: str = '', *, empty: bool = False) -> None:
+ """
+ Adds a line to each page, usually just 1 line in this context
+ :param line: str to be page content / title
+ :param empty: if there should be new lines between entries
+ """
+
+ if line:
+ self._count = len(line)
+ else:
+ self._count = 0
+ self._current_page.append(line)
+ self.close_page()
+
+ def add_image(self, image: str = None) -> None:
+ """
+ Adds an image to a page
+ :param image: image url to be appended
+ """
+
+ self.images.append(image)
+
+ @classmethod
+ async def paginate(cls, pages: List[Tuple[str, str]], ctx: Context, embed: Embed,
+ prefix: str = "", suffix: str = "", timeout: int = 300,
+ exception_on_empty_embed: bool = False):
+ """
+ Use a paginator and set of reactions to provide
+ pagination over a set of title/image pairs.The reactions are
+ used to switch page, or to finish with pagination.
+
+ When used, this will send a message using `ctx.send()` and
+ apply a set of reactions to it. These reactions may
+ be used to change page, or to remove pagination from the message.
+
+ Note: Pagination will be removed automatically
+ if no reaction is added for five minutes (300 seconds).
+
+ >>> embed = Embed()
+ >>> embed.set_author(name="Some Operation", url=url, icon_url=icon)
+ >>> await ImagePaginator.paginate(pages, ctx, embed)
+
+ Parameters
+ -----------
+ :param pages: An iterable of tuples with title for page, and img url
+ :param ctx: ctx for message
+ :param embed: base embed to modify
+ :param prefix: prefix of message
+ :param suffix: suffix of message
+ :param timeout: timeout for when reactions get auto-removed
+ """
+
+ def check_event(reaction_: Reaction, member: Member) -> bool:
+ """
+ Checks each reaction added, if it matches our conditions pass the wait_for
+ :param reaction_: reaction added
+ :param member: reaction added by member
+ """
+
+ return all((
+ # Reaction is on the same message sent
+ reaction_.message.id == message.id,
+ # The reaction is part of the navigation menu
+ reaction_.emoji in PAGINATION_EMOJI,
+ # The reactor is not a bot
+ not member.bot
+ ))
+
+ paginator = cls(prefix=prefix, suffix=suffix)
+ current_page = 0
+
+ if not pages:
+ if exception_on_empty_embed:
+ log.exception(f"Pagination asked for empty image list")
+ raise EmptyPaginatorEmbed("No images to paginate")
+
+ log.debug("No images to add to paginator, adding '(no images to display)' message")
+ pages.append(("(no images to display)", ""))
+
+ for text, image_url in pages:
+ paginator.add_line(text)
+ paginator.add_image(image_url)
+
+ embed.description = paginator.pages[current_page]
+ image = paginator.images[current_page]
+
+ if image:
+ embed.set_image(url=image)
+
+ if len(paginator.pages) <= 1:
+ return await ctx.send(embed=embed)
+
+ embed.set_footer(text=f"Page {current_page + 1}/{len(paginator.pages)}")
+ message = await ctx.send(embed=embed)
+
+ for emoji in PAGINATION_EMOJI:
+ await message.add_reaction(emoji)
+
+ while True:
+ # Start waiting for reactions
+ try:
+ reaction, user = await ctx.bot.wait_for("reaction_add", timeout=timeout, check=check_event)
+ except asyncio.TimeoutError:
+ log.debug("Timed out waiting for a reaction")
+ break # We're done, no reactions for the last 5 minutes
+
+ # Deletes the users reaction
+ await message.remove_reaction(reaction.emoji, user)
+
+ # Delete reaction press - [:x:]
+ if reaction.emoji == DELETE_EMOJI:
+ log.debug("Got delete reaction")
+ break
+
+ # First reaction press - [:track_previous:]
+ if reaction.emoji == FIRST_EMOJI:
+ if current_page == 0:
+ log.debug("Got first page reaction, but we're on the first page - ignoring")
+ continue
+
+ current_page = 0
+ reaction_type = "first"
+
+ # Last reaction press - [:track_next:]
+ if reaction.emoji == LAST_EMOJI:
+ if current_page >= len(paginator.pages) - 1:
+ log.debug("Got last page reaction, but we're on the last page - ignoring")
+ continue
+
+ current_page = len(paginator.pages - 1)
+ reaction_type = "last"
+
+ # Previous reaction press - [:arrow_left: ]
+ if reaction.emoji == LEFT_EMOJI:
+ if current_page <= 0:
+ log.debug("Got previous page reaction, but we're on the first page - ignoring")
+ continue
+
+ current_page -= 1
+ reaction_type = "previous"
+
+ # Next reaction press - [:arrow_right:]
+ if reaction.emoji == RIGHT_EMOJI:
+ if current_page >= len(paginator.pages) - 1:
+ log.debug("Got next page reaction, but we're on the last page - ignoring")
+ continue
+
+ current_page += 1
+ reaction_type = "next"
+
+ # Magic happens here, after page and reaction_type is set
+ embed.description = ""
+ await message.edit(embed=embed)
+ embed.description = paginator.pages[current_page]
+
+ image = paginator.images[current_page]
+ if image:
+ embed.set_image(url=image)
+
+ embed.set_footer(text=f"Page {current_page + 1}/{len(paginator.pages)}")
+ log.debug(f"Got {reaction_type} page reaction - changing to page {current_page + 1}/{len(paginator.pages)}")
+
+ await message.edit(embed=embed)
+
+ log.debug("Ending pagination and removing all reactions...")
+ await message.clear_reactions()
diff --git a/bot/resources/snakes/snake_cards/backs/card_back1.jpg b/bot/resources/snakes/snake_cards/backs/card_back1.jpg
new file mode 100644
index 00000000..22959fa7
--- /dev/null
+++ b/bot/resources/snakes/snake_cards/backs/card_back1.jpg
Binary files differ
diff --git a/bot/resources/snakes/snake_cards/backs/card_back2.jpg b/bot/resources/snakes/snake_cards/backs/card_back2.jpg
new file mode 100644
index 00000000..d56edc32
--- /dev/null
+++ b/bot/resources/snakes/snake_cards/backs/card_back2.jpg
Binary files differ
diff --git a/bot/resources/snakes/snake_cards/card_bottom.png b/bot/resources/snakes/snake_cards/card_bottom.png
new file mode 100644
index 00000000..8b2b91c5
--- /dev/null
+++ b/bot/resources/snakes/snake_cards/card_bottom.png
Binary files differ
diff --git a/bot/resources/snakes/snake_cards/card_frame.png b/bot/resources/snakes/snake_cards/card_frame.png
new file mode 100644
index 00000000..149a0a5f
--- /dev/null
+++ b/bot/resources/snakes/snake_cards/card_frame.png
Binary files differ
diff --git a/bot/resources/snakes/snake_cards/card_top.png b/bot/resources/snakes/snake_cards/card_top.png
new file mode 100644
index 00000000..e329c873
--- /dev/null
+++ b/bot/resources/snakes/snake_cards/card_top.png
Binary files differ
diff --git a/bot/resources/snakes/snake_cards/expressway.ttf b/bot/resources/snakes/snake_cards/expressway.ttf
new file mode 100644
index 00000000..39e15794
--- /dev/null
+++ b/bot/resources/snakes/snake_cards/expressway.ttf
Binary files differ
diff --git a/bot/resources/snakes/snake_facts.json b/bot/resources/snakes/snake_facts.json
new file mode 100644
index 00000000..49b5a80e
--- /dev/null
+++ b/bot/resources/snakes/snake_facts.json
@@ -0,0 +1,233 @@
+[
+ {
+ "fact": "The decapitated head of a dead snake can still bite, even hours after death. These types of bites usually contain huge amounts of venom."
+ },
+ {
+ "fact": "What is considered the most “dangerous” snake depends on both a specific country’s health care and the availability of antivenom following a bite. Based on these criteria, the most dangerous snake in the world is the saw-scaled viper, which bites and kills more people each year than any other snake."
+ },
+ {
+ "fact": "Snakes live on everywhere on Earth except Ireland, Iceland, New Zealand, and the North and South Poles.a"
+ },
+ {
+ "fact": "Of the approximately 725 species of venomous snakes worldwide, 250 can kill a human with one bite."
+ },
+ {
+ "fact": "Snakes evolved from a four-legged reptilian ancestor—most likely a small, burrowing, land-bound lizard—about 100 million years ago. Some snakes, such as pythons and boas, still have traces of back legs."
+ },
+ {
+ "fact": "The fear of snakes (ophiophobia or herpetophobia) is one of the most common phobias worldwide. Approximately 1/3 of all adult humans areophidiophobic , which suggests that humans have an innate, evolutionary fear of snakes."
+ },
+ {
+ "fact": "The top 5 most venomous snakes in the world are the inland taipan, the eastern brown snake, the coastal taipan, the tiger snake, and the black tiger snake."
+ },
+ {
+ "fact": "The warmer a snake’s body, the more quickly it can digest its prey. Typically, it takes 3–5 days for a snake to digest its meal. For very large snakes, such as the anaconda, digestion can take weeks."
+ },
+ {
+ "fact": "Some animals, such as the Mongoose, are immune to snake venom."
+ },
+ {
+ "fact": "To avoid predators, some snakes can poop whenever they want. They make themselves so dirty and smelly that predators will run away."
+ },
+ {
+ "fact": "The heaviest snake in the world is the anaconda. It weighs over 595 pounds (270 kg) and can grow to over 30 feet (9m) long. It has been known to eat caimans, capybaras, and jaguars."
+ },
+ {
+ "fact": "The Brahminy Blind Snake, or flowerpot snake, is the only snake species made up of solely females and, as such, does not need a mate to reproduce. It is also the most widespread terrestrial snake in the world."
+ },
+ {
+ "fact": "If a person suddenly turned into a snake, they would be about 4 times longer than they are now and only a few inches thick. While humans have 24 ribs, some snakes can have more than 400."
+ },
+ {
+ "fact": "The most advanced snake species in the world is believed to be the black mamba. It has the most highly evolved venom delivery system of any snake on Earth. It can strike up to 12 times in a row, though just one bite is enough to kill a grown man.o"
+ },
+ {
+ "fact": "The inland taipan is the world’s most toxic snake, meaning it has both the most toxic venom and it injects the most venom when it bites. Its venom sacs hold enough poison to kill up to 80 people."
+ },
+ {
+ "fact": "The death adder has the fastest strike of any snake in the world. It can attack, inject venom, and go back to striking position in under 0.15 seconds."
+ },
+ {
+ "fact": "While snakes do not have external ears or eardrums, their skin, muscles, and bones carry sound vibrations to their inner ears."
+ },
+ {
+ "fact": "Some snakes have been known to explode after eating a large meal. For example, a 13-foot python blew up after it tried to eat a 6-foot alligator. The python was found with the alligator’s tail protruding from its midsection. Its head was missing."
+ },
+ {
+ "fact": "The word “snake” is from the Proto-Indo-European root *sneg -, meaning “to crawl, creeping thing.” The word “serpent” is from the Proto-Indo-European root *serp -, meaning “to crawl, creep.”"
+ },
+ {
+ "fact": "Rattlesnake rattles are made of rings of keratin, which is the same material as human hair and fingernails. A rattler will add a new ring each time it sheds its skin."
+ },
+ {
+ "fact": "Some snakes have over 200 teeth. The teeth aren’t used for chewing but they point backward to prevent prey from escaping the snake’s throat."
+ },
+ {
+ "fact": "There are about 500 genera and 3,000 different species of snakes. All of them are predators."
+ },
+ {
+ "fact": "Naturalist Paul Rosolie attempted to be the first person to survive being swallowed by an anaconda in 2014. Though he was wearing a specially designed carbon fiber suit equipped with a breathing system, cameras, and a communication system, he ultimately called off his stunt when he felt like the anaconda was breaking his arm as it tightened its grip around his body."
+ },
+ {
+ "fact": "There are five recognized species of flying snakes. Growing up to 4 feet, some types can glide up to 330 feet through the air."
+ },
+ {
+ "fact": "Scales cover every inch of a snake’s body, even its eyes. Scales are thick, tough pieces of skin made from keratin, which is the same material human nails and hair are made from."
+ },
+ {
+ "fact": "The most common snake in North America is the garter (gardener) snake. This snake is also Massachusetts’s state reptile. While previously thought to be nonvenomous, garter snakes do, in fact, produce a mild neurotoxic venom that is harmless to humans."
+ },
+ {
+ "fact": "Snakes do not lap up water like mammals do. Instead, they dunk their snouts underwater and use their throats to pump water into their stomachs."
+ },
+ {
+ "fact": "A snake’s fangs usually last about 6–10 weeks. When a fang wears out, a new one grows in its place."
+ },
+ {
+ "fact": "Because the end of a snake’s tongue is forked, the two tips taste different amounts of chemicals. Essentially, a snake “smells in stereo” and can even tell which direction a smell is coming from. It identifies scents on its tongue using pits in the roof of its mouth called the Jacobson’s organ."
+ },
+ {
+ "fact": "The amount of food a snake eats determines how many offspring it will have. The Arafura file snake eats the least and lays just one egg every decade."
+ },
+ {
+ "fact": "While smaller snakes, such a tree- or- ground-dwelling snakes, use their tongues to follow the scent trails of prey (such as spiders, birds, and other snakes). Larger snakes, such as boas, have heat-sensing organs called labial (lip) pits in their snouts."
+ },
+ {
+ "fact": "Snakes typically need to eat only 6–30 meals each year to be healthy."
+ },
+ {
+ "fact": "Snakes like to lie on roads and rocky areas because stones and rocks absorb heat from the sun, which warms them. Basking on these surfaces warms a snake quickly so it can move. If the temperature reaches below 50° Fahrenheit, a snake’s body does not work properly."
+ },
+ {
+ "fact": "The Mozambique spitting cobra can spit venom over 8 feet away. It can spit from any position, including lying on the ground or raised up. It prefers to aim for its victim’s eyes."
+ },
+ {
+ "fact": "Snakes cannot chew, so they must swallow their food whole. They are able to stretch their mouths very wide because they have a very flexible lower jaw. Snakes can eat other animals that are 75%–100% bigger than their own bodies."
+ },
+ {
+ "fact": "To keep from choking on large prey, a snake will push the end of its trachea, or windpipe, out of its mouth, similar to the way a snorkel works."
+ },
+ {
+ "fact": "The Gaboon viper has the longest fangs of any snake, reaching about 2 inches (5 cm) long."
+ },
+ {
+ "fact": "Anacondas can hold their breath for up to 10 minutes under water. Additionally, similar to crocodiles, anacondas have eyes and nostrils that can poke above the water’s surface to increase their stealth and hunting prowess."
+ },
+ {
+ "fact": "The longest snake ever recorded is the reticulated python. It can reach over 33 feet long, which is big enough to swallow a pig, a deer, or even a person."
+ },
+ {
+ "fact": "Sea snakes with their paddle-shaped tails can dive over 300 feet into the ocean."
+ },
+ {
+ "fact": "If a snake is threatened soon after a meal, it will often regurgitate its food so it can quickly escape the perceived threat. A snake’s digestive system can dissolve everything but a prey’s hair, feathers, and claws."
+ },
+ {
+ "fact": "Snakes do not have eyelids; rather, a single transparent scale called a brille protects their eyes. Most snakes see very well, especially if the object is moving."
+ },
+ {
+ "fact": "The world’s longest venomous snake is the king cobra from Asia. It can grow up to 18 feet, rear almost as high as a person, growl loudly, and inject enough venom to kill an elephant."
+ },
+ {
+ "fact": "The king cobra is thought to be one of the most intelligent of all snakes. Additionally, unlike most snakes, who do not care for their young, king cobras are careful parents who defend and protect their eggs from enemies."
+ },
+ {
+ "fact": "Not all snakes have fangs—only those that kill their prey with venom have them. When their fangs are not in use, they fold them back into the roof of the mouth (except for the coral snake, whose fangs do not fold back)."
+ },
+ {
+ "fact": "Some venomous snakes have died after biting and poisoning themselves by mistake."
+ },
+ {
+ "fact": "Elephant trunk snakes are almost completely aquatic. They cannot slither because they lack the broad scales in the belly that help other snakes move on land. Rather, elephant trunk snakes have large knobby scales to hold onto slippery fish and constrict them underwater."
+ },
+ {
+ "fact": "The shortest known snake is the thread snake. It is about 4 inches long and lives on the island of Barbados in the Caribbean. It is said to be as “thin as spaghetti” and it feeds primarily on termites and larvae."
+ },
+ {
+ "fact": "In 2009, a farm worker in East Africa survived an epic 3-hour battle with a 12-foot python after accidentally stepping on the large snake. It coiled around the man and carried him into a tree. The man wrapped his shirt over the snake’s mouth to prevent it from swallowing him, and he was finally rescued by police after calling for help on his cell phone."
+ },
+ {
+ "fact": "The venom from a Brazilian pit viper is used in a drug to treat high blood pressure."
+ },
+ {
+ "fact": "The word “cobra” means “hooded.” Some cobras have large spots on the back of their hood that look like eyes to make them appear intimating even from behind."
+ },
+ {
+ "fact": "Some desert snakes, such as the African rock python, sleep during the hottest parts of the desert summer. This summer sleep is similar to hibernation and is called “aestivation.”"
+ },
+ {
+ "fact": "The black mamba is the world’s fastest snake and the world’s second-longest venomous snake in the world, after the king cobra. Found in East Africa, it can reach speeds of up to 12 mph (19kph). It’s named not from the color of its scales, which is olive green, but from the inside of its mouth, which is inky black. Its venom is highly toxic, and without anti-venom, death in humans usually occurs within 7–15 hours."
+ },
+ {
+ "fact": "Although a snake’s growth rate slows as it gets older, a snake never stops growing."
+ },
+ {
+ "fact": "While a snake cannot hear the music of a snake charmer, the snake responds to the vibrations of the charmer’s tapping foot or to the movement of the flute."
+ },
+ {
+ "fact": "Most snakes are not harmful to humans and they help balance the ecosystem by keeping the population of rats, mice, and birds under control."
+ },
+ {
+ "fact": "The largest snake fossil ever found is the Titanoboa. It lived over 60 million years ago and reached over 50 feet (15 meters) long. It weighed more than 20 people and ate crocodiles and giant tortoises."
+ },
+ {
+ "fact": "Two-headed snakes are similar to conjoined twins: an embryo begins to split to create identical twins, but the process does not finish. Such snakes rarely survive in the wild because the two heads have duplicate senses, they fight over food, and one head may try to eat the other head."
+ },
+ {
+ "fact": "Snakes can be grouped into two sections: primitive snakes and true (typical) snakes. Primitive snakes—such as blind snakes, worm snakes, and thread snakes—represent the earliest forms of snakes. True snakes, such as rat snakes and king snakes, are more evolved and more active."
+ },
+ {
+ "fact": "The oldest written record that describes snakes is in the Brooklyn Papyrus, which is a medical papyrus dating from ancient Egypt (450 B.C.)."
+ },
+ {
+ "fact": "Approximately 70% of snakes lay eggs. Those that lay eggs are called oviparous. The other 30% of snakes live in colder climates and give birth to live young because it is too cold for eggs outside the body to develop and hatch."
+ },
+ {
+ "fact": "Most snakes have an elongated right lung, many have a smaller left lung, and a few even have a third lung. They do not have a sense of taste, and most of their organs are organized linearly."
+ },
+ {
+ "fact": "The most rare and endangered snake is the St. Lucia racer. There are only 18 to 100 of these snakes left."
+ },
+ {
+ "fact": "Snakes kill over 40,000 people a year—though, with unreported incidents, the total may be over 100,000. About half of these deaths are in India."
+ },
+ {
+ "fact": "In some cultures, eating snakes is considered a delicacy. For example, snake soup has been a popular Cantonese delicacy for over 2,000 years."
+ },
+ {
+ "fact": "In some Asian countries, it is believed that drinking the blood of snakes, particularly the cobra, will increase sexual virility. The blood is usually drained from a live snake and then mixed with liquor."
+ },
+ {
+ "fact": "In the United States, fewer than 1 in 37,500 people are bitten by venomous snakes each year (7,000–8,000 bites per year), and only 1 in 50 million people will die from snake bite (5–6 fatalities per year). In the U.S., a person is 9 times more likely to die from being struck by lightening than to die from a venomous snakebite."
+ },
+ {
+ "fact": "Some members of the U.S. Army Special Forces are taught to kill and eat snakes during their survival training, which has earned them the nickname “Snake Eaters.”"
+ },
+ {
+ "fact": "One of the great feats of the legendary Greek hero Perseus was to kill Medusa, a female monster whose hair consisted of writhing, venomous snakes."
+ },
+ {
+ "fact": "The symbol of the snake is one of the most widespread and oldest cultural symbols in history. Snakes often represent the duality of good and evil and of life and death."
+ },
+ {
+ "fact": "Because snakes shed their skin, they are often symbols of rebirth, transformation, and healing. For example, Asclepius, the god of medicine, carries a staff encircled by a snake."
+ },
+ {
+ "fact": "The snake has held various meanings throughout history. For example, The Egyptians viewed the snake as representing royalty and deity. In the Jewish rabbinical tradition and in Hinduism, it represents sexual passion and desire. And the Romans interpreted the snake as a symbol of eternal love."
+ },
+ {
+ "fact": "Anacondas mate in a huge “breeding ball.” The ball consists of 1 female and nearly 12 males. They stay in a “mating ball” for up to a month."
+ },
+ {
+ "fact": "Depending on the species, snakes can live from 4 to over 25 years."
+ },
+ {
+ "fact": "Snakes that are poisonous have pupils that are shaped like a diamond. Nonpoisonous snakes have round pupils."
+ },
+ {
+ "fact": "Endangered snakes include the San Francisco garter snake, eastern indigo snake, the king cobra, and Dumeril’s boa."
+ },
+ {
+ "fact": "A mysterious, new “mad snake disease” causes captive pythons and boas to tie themselves in knots. Other symptoms include “stargazing,” which is when snakes stare upwards for long periods of time. Snake experts believe a rodent virus causes the fatal disease."
+ }
+] \ No newline at end of file
diff --git a/bot/resources/snakes/snake_idioms.json b/bot/resources/snakes/snake_idioms.json
new file mode 100644
index 00000000..37148c42
--- /dev/null
+++ b/bot/resources/snakes/snake_idioms.json
@@ -0,0 +1,275 @@
+[
+ {
+ "idiom": "snek it up"
+ },
+ {
+ "idiom": "get ur snek on"
+ },
+ {
+ "idiom": "snek ur heart out"
+ },
+ {
+ "idiom": "snek 4 ever"
+ },
+ {
+ "idiom": "i luve snek"
+ },
+ {
+ "idiom": "snek bff"
+ },
+ {
+ "idiom": "boyfriend snek"
+ },
+ {
+ "idiom": "dont snek ur homies"
+ },
+ {
+ "idiom": "garden snek"
+ },
+ {
+ "idiom": "snektie"
+ },
+ {
+ "idiom": "snek keks"
+ },
+ {
+ "idiom": "birthday snek!"
+ },
+ {
+ "idiom": "snek tonight?"
+ },
+ {
+ "idiom": "snek hott lips"
+ },
+ {
+ "idiom": "snek u latr"
+ },
+ {
+ "idiom": "netflx and snek"
+ },
+ {
+ "idiom": "holy snek prey4u"
+ },
+ {
+ "idiom": "ghowst snek hauntt u"
+ },
+ {
+ "idiom": "ipekek snek syrop"
+ },
+ {
+ "idiom": "2 snek 2 furius"
+ },
+ {
+ "idiom": "the shawsnek redumpton"
+ },
+ {
+ "idiom": "snekler's list"
+ },
+ {
+ "idiom": "snekablanca"
+ },
+ {
+ "idiom": "romeo n snekulet"
+ },
+ {
+ "idiom": "citizn snek"
+ },
+ {
+ "idiom": "gon wit the snek"
+ },
+ {
+ "idiom": "dont step on snek"
+ },
+ {
+ "idiom": "the wizrd uf snek"
+ },
+ {
+ "idiom": "forrest snek"
+ },
+ {
+ "idiom": "snek of musik"
+ },
+ {
+ "idiom": "west snek story"
+ },
+ {
+ "idiom": "snek wars eposide XI"
+ },
+ {
+ "idiom": "2001: a snek odyssuuy"
+ },
+ {
+ "idiom": "E.T. the snekstra terrastriul"
+ },
+ {
+ "idiom": "snekkin' inth rain"
+ },
+ {
+ "idiom": "dr sneklove"
+ },
+ {
+ "idiom": "snekley kubrik"
+ },
+ {
+ "idiom": "willium snekspeare"
+ },
+ {
+ "idiom": "snek on tutanic"
+ },
+ {
+ "idiom": "a snekwork orunge"
+ },
+ {
+ "idiom": "the snek the bad n the ogly"
+ },
+ {
+ "idiom": "the sneksorcist"
+ },
+ {
+ "idiom": "gudd snek huntin"
+ },
+ {
+ "idiom": "leonurdo disnekrio"
+ },
+ {
+ "idiom": "denzal snekington"
+ },
+ {
+ "idiom": "snekuel l jocksons"
+ },
+ {
+ "idiom": "kevn snek"
+ },
+ {
+ "idiom": "snekthony hopkuns"
+ },
+ {
+ "idiom": "hugh snekman"
+ },
+ {
+ "idiom": "snek but it glow in durk"
+ },
+ {
+ "idiom": "snek but u cn ride it"
+ },
+ {
+ "idiom": "snek but slep in ur bed"
+ },
+ {
+ "idiom": "snek but mad frum plastk"
+ },
+ {
+ "idiom": "snek but bulong 2 ur frnd"
+ },
+ {
+ "idiom": "sneks on plene"
+ },
+ {
+ "idiom": "baby snek"
+ },
+ {
+ "idiom": "trouser snek"
+ },
+ {
+ "idiom": "momo snek"
+ },
+ {
+ "idiom": "fast snek"
+ },
+ {
+ "idiom": "super slow snek"
+ },
+ {
+ "idiom": "old snek"
+ },
+ {
+ "idiom": "slimy snek"
+ },
+ {
+ "idiom": "snek attekk"
+ },
+ {
+ "idiom": "snek get wrekk"
+ },
+ {
+ "idiom": "snek you long time"
+ },
+ {
+ "idiom": "carpenter snek"
+ },
+ {
+ "idiom": "drain snek"
+ },
+ {
+ "idiom": "eat ur face snek"
+ },
+ {
+ "idiom": "kawaii snek"
+ },
+ {
+ "idiom": "dis snek is soft"
+ },
+ {
+ "idiom": "snek is 4 yers uld"
+ },
+ {
+ "idiom": "pls feed snek, is hingry"
+ },
+ {
+ "idiom": "snek? snek? sneeeeek!!"
+ },
+ {
+ "idiom": "solid snek"
+ },
+ {
+ "idiom": "big bos snek"
+ },
+ {
+ "idiom": "snek republic"
+ },
+ {
+ "idiom": "snekoslovakia"
+ },
+ {
+ "idiom": "snek please!"
+ },
+ {
+ "idiom": "i brok my snek :("
+ },
+ {
+ "idiom": "star snek the nxt generatin"
+ },
+ {
+ "idiom": "azsnek tempul"
+ },
+ {
+ "idiom": "discosnek"
+ },
+ {
+ "idiom": "bottlsnek"
+ },
+ {
+ "idiom": "turtlsnek"
+ },
+ {
+ "idiom": "cashiers snek"
+ },
+ {
+ "idiom": "mega snek!!"
+ },
+ {
+ "idiom": "one tim i saw snek neked"
+ },
+ {
+ "idiom": "snek cnt clim trees"
+ },
+ {
+ "idiom": "snek in muth is jus tongue"
+ },
+ {
+ "idiom": "juan snek"
+ },
+ {
+ "idiom": "photosnek"
+ }
+] \ No newline at end of file
diff --git a/bot/resources/snakes/snake_names.json b/bot/resources/snakes/snake_names.json
new file mode 100644
index 00000000..8ba9dbd7
--- /dev/null
+++ b/bot/resources/snakes/snake_names.json
@@ -0,0 +1,2170 @@
+[
+ {
+ "name": "Acanthophis",
+ "scientific": "Acanthophis"
+ },
+ {
+ "name": "Aesculapian snake",
+ "scientific": "Aesculapian snake"
+ },
+ {
+ "name": "African beaked snake",
+ "scientific": "Rufous beaked snake"
+ },
+ {
+ "name": "African puff adder",
+ "scientific": "Bitis arietans"
+ },
+ {
+ "name": "African rock python",
+ "scientific": "African rock python"
+ },
+ {
+ "name": "African twig snake",
+ "scientific": "Twig snake"
+ },
+ {
+ "name": "Agkistrodon piscivorus",
+ "scientific": "Agkistrodon piscivorus"
+ },
+ {
+ "name": "Ahaetulla",
+ "scientific": "Ahaetulla"
+ },
+ {
+ "name": "Amazonian palm viper",
+ "scientific": "Bothriopsis bilineata"
+ },
+ {
+ "name": "American copperhead",
+ "scientific": "Agkistrodon contortrix"
+ },
+ {
+ "name": "Amethystine python",
+ "scientific": "Amethystine python"
+ },
+ {
+ "name": "Anaconda",
+ "scientific": "Anaconda"
+ },
+ {
+ "name": "Andaman cat snake",
+ "scientific": "Boiga andamanensis"
+ },
+ {
+ "name": "Andrea's keelback",
+ "scientific": "Amphiesma andreae"
+ },
+ {
+ "name": "Annulated sea snake",
+ "scientific": "Hydrophis cyanocinctus"
+ },
+ {
+ "name": "Arafura file snake",
+ "scientific": "Acrochordus arafurae"
+ },
+ {
+ "name": "Arizona black rattlesnake",
+ "scientific": "Crotalus oreganus cerberus"
+ },
+ {
+ "name": "Arizona coral snake",
+ "scientific": "Coral snake"
+ },
+ {
+ "name": "Aruba rattlesnake",
+ "scientific": "Crotalus durissus unicolor"
+ },
+ {
+ "name": "Asian cobra",
+ "scientific": "Indian cobra"
+ },
+ {
+ "name": "Asian keelback",
+ "scientific": "Amphiesma vibakari"
+ },
+ {
+ "name": "Asp (reptile)",
+ "scientific": "Asp (reptile)"
+ },
+ {
+ "name": "Assam keelback",
+ "scientific": "Amphiesma pealii"
+ },
+ {
+ "name": "Australian copperhead",
+ "scientific": "Austrelaps"
+ },
+ {
+ "name": "Australian scrub python",
+ "scientific": "Amethystine python"
+ },
+ {
+ "name": "Baird's rat snake",
+ "scientific": "Pantherophis bairdi"
+ },
+ {
+ "name": "Banded Flying Snake",
+ "scientific": "Banded flying snake"
+ },
+ {
+ "name": "Banded cat-eyed snake",
+ "scientific": "Banded cat-eyed snake"
+ },
+ {
+ "name": "Banded krait",
+ "scientific": "Banded krait"
+ },
+ {
+ "name": "Barred wolf snake",
+ "scientific": "Lycodon striatus"
+ },
+ {
+ "name": "Beaked sea snake",
+ "scientific": "Enhydrina schistosa"
+ },
+ {
+ "name": "Beauty rat snake",
+ "scientific": "Beauty rat snake"
+ },
+ {
+ "name": "Beddome's cat snake",
+ "scientific": "Boiga beddomei"
+ },
+ {
+ "name": "Beddome's coral snake",
+ "scientific": "Beddome's coral snake"
+ },
+ {
+ "name": "Bird snake",
+ "scientific": "Twig snake"
+ },
+ {
+ "name": "Black-banded trinket snake",
+ "scientific": "Oreocryptophis porphyraceus"
+ },
+ {
+ "name": "Black-headed snake",
+ "scientific": "Western black-headed snake"
+ },
+ {
+ "name": "Black-necked cobra",
+ "scientific": "Black-necked spitting cobra"
+ },
+ {
+ "name": "Black-necked spitting cobra",
+ "scientific": "Black-necked spitting cobra"
+ },
+ {
+ "name": "Black-striped keelback",
+ "scientific": "Buff striped keelback"
+ },
+ {
+ "name": "Black-tailed horned pit viper",
+ "scientific": "Mixcoatlus melanurus"
+ },
+ {
+ "name": "Black headed python",
+ "scientific": "Black-headed python"
+ },
+ {
+ "name": "Black krait",
+ "scientific": "Greater black krait"
+ },
+ {
+ "name": "Black mamba",
+ "scientific": "Black mamba"
+ },
+ {
+ "name": "Black rat snake",
+ "scientific": "Rat snake"
+ },
+ {
+ "name": "Black tree cobra",
+ "scientific": "Cobra"
+ },
+ {
+ "name": "Blind snake",
+ "scientific": "Scolecophidia"
+ },
+ {
+ "name": "Blonde hognose snake",
+ "scientific": "Hognose"
+ },
+ {
+ "name": "Blood python",
+ "scientific": "Python brongersmai"
+ },
+ {
+ "name": "Blue krait",
+ "scientific": "Bungarus candidus"
+ },
+ {
+ "name": "Blunt-headed tree snake",
+ "scientific": "Imantodes cenchoa"
+ },
+ {
+ "name": "Boa constrictor",
+ "scientific": "Boa constrictor"
+ },
+ {
+ "name": "Bocourt's water snake",
+ "scientific": "Subsessor"
+ },
+ {
+ "name": "Boelen python",
+ "scientific": "Morelia boeleni"
+ },
+ {
+ "name": "Boidae",
+ "scientific": "Boidae"
+ },
+ {
+ "name": "Boiga",
+ "scientific": "Boiga"
+ },
+ {
+ "name": "Boomslang",
+ "scientific": "Boomslang"
+ },
+ {
+ "name": "Brahminy blind snake",
+ "scientific": "Indotyphlops braminus"
+ },
+ {
+ "name": "Brazilian coral snake",
+ "scientific": "Coral snake"
+ },
+ {
+ "name": "Brazilian smooth snake",
+ "scientific": "Hydrodynastes gigas"
+ },
+ {
+ "name": "Brown snake (disambiguation)",
+ "scientific": "Brown snake"
+ },
+ {
+ "name": "Brown tree snake",
+ "scientific": "Brown tree snake"
+ },
+ {
+ "name": "Brown white-lipped python",
+ "scientific": "Leiopython"
+ },
+ {
+ "name": "Buff striped keelback",
+ "scientific": "Buff striped keelback"
+ },
+ {
+ "name": "Bull snake",
+ "scientific": "Bull snake"
+ },
+ {
+ "name": "Burmese keelback",
+ "scientific": "Burmese keelback water snake"
+ },
+ {
+ "name": "Burmese krait",
+ "scientific": "Burmese krait"
+ },
+ {
+ "name": "Burmese python",
+ "scientific": "Burmese python"
+ },
+ {
+ "name": "Burrowing viper",
+ "scientific": "Atractaspidinae"
+ },
+ {
+ "name": "Buttermilk racer",
+ "scientific": "Coluber constrictor anthicus"
+ },
+ {
+ "name": "California kingsnake",
+ "scientific": "California kingsnake"
+ },
+ {
+ "name": "Cantor's pitviper",
+ "scientific": "Trimeresurus cantori"
+ },
+ {
+ "name": "Cape cobra",
+ "scientific": "Cape cobra"
+ },
+ {
+ "name": "Cape coral snake",
+ "scientific": "Aspidelaps lubricus"
+ },
+ {
+ "name": "Cape gopher snake",
+ "scientific": "Cape gopher snake"
+ },
+ {
+ "name": "Carpet viper",
+ "scientific": "Echis"
+ },
+ {
+ "name": "Cat-eyed night snake",
+ "scientific": "Banded cat-eyed snake"
+ },
+ {
+ "name": "Cat-eyed snake",
+ "scientific": "Banded cat-eyed snake"
+ },
+ {
+ "name": "Cat snake",
+ "scientific": "Boiga"
+ },
+ {
+ "name": "Central American lyre snake",
+ "scientific": "Trimorphodon biscutatus"
+ },
+ {
+ "name": "Central ranges taipan",
+ "scientific": "Taipan"
+ },
+ {
+ "name": "Chappell Island tiger snake",
+ "scientific": "Tiger snake"
+ },
+ {
+ "name": "Checkered garter snake",
+ "scientific": "Checkered garter snake"
+ },
+ {
+ "name": "Checkered keelback",
+ "scientific": "Checkered keelback"
+ },
+ {
+ "name": "Children's python",
+ "scientific": "Children's python"
+ },
+ {
+ "name": "Chinese cobra",
+ "scientific": "Chinese cobra"
+ },
+ {
+ "name": "Coachwhip snake",
+ "scientific": "Masticophis flagellum"
+ },
+ {
+ "name": "Coastal taipan",
+ "scientific": "Coastal taipan"
+ },
+ {
+ "name": "Cobra",
+ "scientific": "Cobra"
+ },
+ {
+ "name": "Collett's snake",
+ "scientific": "Collett's snake"
+ },
+ {
+ "name": "Common adder",
+ "scientific": "Vipera berus"
+ },
+ {
+ "name": "Common cobra",
+ "scientific": "Chinese cobra"
+ },
+ {
+ "name": "Common garter snake",
+ "scientific": "Common garter snake"
+ },
+ {
+ "name": "Common ground snake",
+ "scientific": "Western ground snake"
+ },
+ {
+ "name": "Common keelback (disambiguation)",
+ "scientific": "Common keelback"
+ },
+ {
+ "name": "Common tiger snake",
+ "scientific": "Tiger snake"
+ },
+ {
+ "name": "Common worm snake",
+ "scientific": "Indotyphlops braminus"
+ },
+ {
+ "name": "Congo snake",
+ "scientific": "Amphiuma"
+ },
+ {
+ "name": "Congo water cobra",
+ "scientific": "Naja christyi"
+ },
+ {
+ "name": "Coral snake",
+ "scientific": "Coral snake"
+ },
+ {
+ "name": "Corn snake",
+ "scientific": "Corn snake"
+ },
+ {
+ "name": "Coronado Island rattlesnake",
+ "scientific": "Crotalus oreganus caliginis"
+ },
+ {
+ "name": "Crossed viper",
+ "scientific": "Vipera berus"
+ },
+ {
+ "name": "Crotalus cerastes",
+ "scientific": "Crotalus cerastes"
+ },
+ {
+ "name": "Crotalus durissus",
+ "scientific": "Crotalus durissus"
+ },
+ {
+ "name": "Crotalus horridus",
+ "scientific": "Timber rattlesnake"
+ },
+ {
+ "name": "Crowned snake",
+ "scientific": "Tantilla"
+ },
+ {
+ "name": "Cuban boa",
+ "scientific": "Chilabothrus angulifer"
+ },
+ {
+ "name": "Cuban wood snake",
+ "scientific": "Tropidophis melanurus"
+ },
+ {
+ "name": "Dasypeltis",
+ "scientific": "Dasypeltis"
+ },
+ {
+ "name": "Desert death adder",
+ "scientific": "Desert death adder"
+ },
+ {
+ "name": "Desert kingsnake",
+ "scientific": "Desert kingsnake"
+ },
+ {
+ "name": "Desert woma python",
+ "scientific": "Woma python"
+ },
+ {
+ "name": "Diamond python",
+ "scientific": "Morelia spilota spilota"
+ },
+ {
+ "name": "Dog-toothed cat snake",
+ "scientific": "Boiga cynodon"
+ },
+ {
+ "name": "Down's tiger snake",
+ "scientific": "Tiger snake"
+ },
+ {
+ "name": "Dubois's sea snake",
+ "scientific": "Aipysurus duboisii"
+ },
+ {
+ "name": "Durango rock rattlesnake",
+ "scientific": "Crotalus lepidus klauberi"
+ },
+ {
+ "name": "Dusty hognose snake",
+ "scientific": "Hognose"
+ },
+ {
+ "name": "Dwarf beaked snake",
+ "scientific": "Dwarf beaked snake"
+ },
+ {
+ "name": "Dwarf boa",
+ "scientific": "Boa constrictor"
+ },
+ {
+ "name": "Dwarf pipe snake",
+ "scientific": "Anomochilus"
+ },
+ {
+ "name": "Eastern brown snake",
+ "scientific": "Eastern brown snake"
+ },
+ {
+ "name": "Eastern coral snake",
+ "scientific": "Micrurus fulvius"
+ },
+ {
+ "name": "Eastern diamondback rattlesnake",
+ "scientific": "Eastern diamondback rattlesnake"
+ },
+ {
+ "name": "Eastern green mamba",
+ "scientific": "Eastern green mamba"
+ },
+ {
+ "name": "Eastern hognose snake",
+ "scientific": "Eastern hognose snake"
+ },
+ {
+ "name": "Eastern mud snake",
+ "scientific": "Mud snake"
+ },
+ {
+ "name": "Eastern racer",
+ "scientific": "Coluber constrictor"
+ },
+ {
+ "name": "Eastern tiger snake",
+ "scientific": "Tiger snake"
+ },
+ {
+ "name": "Eastern water cobra",
+ "scientific": "Cobra"
+ },
+ {
+ "name": "Elaps harlequin snake",
+ "scientific": "Micrurus fulvius"
+ },
+ {
+ "name": "Eunectes",
+ "scientific": "Eunectes"
+ },
+ {
+ "name": "European Smooth Snake",
+ "scientific": "Smooth snake"
+ },
+ {
+ "name": "False cobra",
+ "scientific": "False cobra"
+ },
+ {
+ "name": "False coral snake",
+ "scientific": "Coral snake"
+ },
+ {
+ "name": "False water cobra",
+ "scientific": "Hydrodynastes gigas"
+ },
+ {
+ "name": "Fierce snake",
+ "scientific": "Inland taipan"
+ },
+ {
+ "name": "Flying snake",
+ "scientific": "Chrysopelea"
+ },
+ {
+ "name": "Forest cobra",
+ "scientific": "Forest cobra"
+ },
+ {
+ "name": "Forsten's cat snake",
+ "scientific": "Boiga forsteni"
+ },
+ {
+ "name": "Fox snake",
+ "scientific": "Fox snake"
+ },
+ {
+ "name": "Gaboon viper",
+ "scientific": "Gaboon viper"
+ },
+ {
+ "name": "Garter snake",
+ "scientific": "Garter snake"
+ },
+ {
+ "name": "Giant Malagasy hognose snake",
+ "scientific": "Hognose"
+ },
+ {
+ "name": "Glossy snake",
+ "scientific": "Glossy snake"
+ },
+ {
+ "name": "Gold-ringed cat snake",
+ "scientific": "Boiga dendrophila"
+ },
+ {
+ "name": "Gold tree cobra",
+ "scientific": "Pseudohaje goldii"
+ },
+ {
+ "name": "Golden tree snake",
+ "scientific": "Chrysopelea ornata"
+ },
+ {
+ "name": "Gopher snake",
+ "scientific": "Pituophis catenifer"
+ },
+ {
+ "name": "Grand Canyon rattlesnake",
+ "scientific": "Crotalus oreganus abyssus"
+ },
+ {
+ "name": "Grass snake",
+ "scientific": "Grass snake"
+ },
+ {
+ "name": "Gray cat snake",
+ "scientific": "Boiga ocellata"
+ },
+ {
+ "name": "Great Plains rat snake",
+ "scientific": "Pantherophis emoryi"
+ },
+ {
+ "name": "Green anaconda",
+ "scientific": "Green anaconda"
+ },
+ {
+ "name": "Green rat snake",
+ "scientific": "Rat snake"
+ },
+ {
+ "name": "Green tree python",
+ "scientific": "Green tree python"
+ },
+ {
+ "name": "Grey-banded kingsnake",
+ "scientific": "Gray-banded kingsnake"
+ },
+ {
+ "name": "Grey Lora",
+ "scientific": "Leptophis stimsoni"
+ },
+ {
+ "name": "Halmahera python",
+ "scientific": "Morelia tracyae"
+ },
+ {
+ "name": "Harlequin coral snake",
+ "scientific": "Micrurus fulvius"
+ },
+ {
+ "name": "Herald snake",
+ "scientific": "Caduceus"
+ },
+ {
+ "name": "High Woods coral snake",
+ "scientific": "Coral snake"
+ },
+ {
+ "name": "Hill keelback",
+ "scientific": "Amphiesma monticola"
+ },
+ {
+ "name": "Himalayan keelback",
+ "scientific": "Amphiesma platyceps"
+ },
+ {
+ "name": "Hognose snake",
+ "scientific": "Hognose"
+ },
+ {
+ "name": "Hognosed viper",
+ "scientific": "Porthidium"
+ },
+ {
+ "name": "Hook Nosed Sea Snake",
+ "scientific": "Enhydrina schistosa"
+ },
+ {
+ "name": "Hoop snake",
+ "scientific": "Hoop snake"
+ },
+ {
+ "name": "Hopi rattlesnake",
+ "scientific": "Crotalus viridis nuntius"
+ },
+ {
+ "name": "Indian cobra",
+ "scientific": "Indian cobra"
+ },
+ {
+ "name": "Indian egg-eater",
+ "scientific": "Indian egg-eating snake"
+ },
+ {
+ "name": "Indian flying snake",
+ "scientific": "Chrysopelea ornata"
+ },
+ {
+ "name": "Indian krait",
+ "scientific": "Bungarus"
+ },
+ {
+ "name": "Indigo snake",
+ "scientific": "Drymarchon"
+ },
+ {
+ "name": "Inland carpet python",
+ "scientific": "Morelia spilota metcalfei"
+ },
+ {
+ "name": "Inland taipan",
+ "scientific": "Inland taipan"
+ },
+ {
+ "name": "Jamaican boa",
+ "scientific": "Jamaican boa"
+ },
+ {
+ "name": "Jan's hognose snake",
+ "scientific": "Hognose"
+ },
+ {
+ "name": "Japanese forest rat snake",
+ "scientific": "Euprepiophis conspicillatus"
+ },
+ {
+ "name": "Japanese rat snake",
+ "scientific": "Japanese rat snake"
+ },
+ {
+ "name": "Japanese striped snake",
+ "scientific": "Japanese striped snake"
+ },
+ {
+ "name": "Kayaudi dwarf reticulated python",
+ "scientific": "Reticulated python"
+ },
+ {
+ "name": "Keelback",
+ "scientific": "Natricinae"
+ },
+ {
+ "name": "Khasi Hills keelback",
+ "scientific": "Amphiesma khasiense"
+ },
+ {
+ "name": "King Island tiger snake",
+ "scientific": "Tiger snake"
+ },
+ {
+ "name": "King brown",
+ "scientific": "Mulga snake"
+ },
+ {
+ "name": "King cobra",
+ "scientific": "King cobra"
+ },
+ {
+ "name": "King rat snake",
+ "scientific": "Rat snake"
+ },
+ {
+ "name": "King snake",
+ "scientific": "Kingsnake"
+ },
+ {
+ "name": "Krait",
+ "scientific": "Bungarus"
+ },
+ {
+ "name": "Krefft's tiger snake",
+ "scientific": "Tiger snake"
+ },
+ {
+ "name": "Lance-headed rattlesnake",
+ "scientific": "Crotalus polystictus"
+ },
+ {
+ "name": "Lancehead",
+ "scientific": "Bothrops"
+ },
+ {
+ "name": "Large shield snake",
+ "scientific": "Pseudotyphlops"
+ },
+ {
+ "name": "Leptophis ahaetulla",
+ "scientific": "Leptophis ahaetulla"
+ },
+ {
+ "name": "Lesser black krait",
+ "scientific": "Lesser black krait"
+ },
+ {
+ "name": "Long-nosed adder",
+ "scientific": "Eastern hognose snake"
+ },
+ {
+ "name": "Long-nosed tree snake",
+ "scientific": "Western hognose snake"
+ },
+ {
+ "name": "Long-nosed whip snake",
+ "scientific": "Ahaetulla nasuta"
+ },
+ {
+ "name": "Long-tailed rattlesnake",
+ "scientific": "Rattlesnake"
+ },
+ {
+ "name": "Longnosed worm snake",
+ "scientific": "Leptotyphlops macrorhynchus"
+ },
+ {
+ "name": "Lyre snake",
+ "scientific": "Trimorphodon"
+ },
+ {
+ "name": "Madagascar ground boa",
+ "scientific": "Acrantophis madagascariensis"
+ },
+ {
+ "name": "Malayan krait",
+ "scientific": "Bungarus candidus"
+ },
+ {
+ "name": "Malayan long-glanded coral snake",
+ "scientific": "Calliophis bivirgata"
+ },
+ {
+ "name": "Malayan pit viper",
+ "scientific": "Pit viper"
+ },
+ {
+ "name": "Mamba",
+ "scientific": "Mamba"
+ },
+ {
+ "name": "Mamushi",
+ "scientific": "Mamushi"
+ },
+ {
+ "name": "Manchurian Black Water Snake",
+ "scientific": "Elaphe schrenckii"
+ },
+ {
+ "name": "Mandarin rat snake",
+ "scientific": "Mandarin rat snake"
+ },
+ {
+ "name": "Mangrove snake (disambiguation)",
+ "scientific": "Mangrove snake"
+ },
+ {
+ "name": "Many-banded krait",
+ "scientific": "Many-banded krait"
+ },
+ {
+ "name": "Many-banded tree snake",
+ "scientific": "Many-banded tree snake"
+ },
+ {
+ "name": "Many-spotted cat snake",
+ "scientific": "Boiga multomaculata"
+ },
+ {
+ "name": "Massasauga rattlesnake",
+ "scientific": "Massasauga"
+ },
+ {
+ "name": "Mexican black kingsnake",
+ "scientific": "Mexican black kingsnake"
+ },
+ {
+ "name": "Mexican green rattlesnake",
+ "scientific": "Crotalus basiliscus"
+ },
+ {
+ "name": "Mexican hognose snake",
+ "scientific": "Hognose"
+ },
+ {
+ "name": "Mexican parrot snake",
+ "scientific": "Leptophis mexicanus"
+ },
+ {
+ "name": "Mexican racer",
+ "scientific": "Coluber constrictor oaxaca"
+ },
+ {
+ "name": "Mexican vine snake",
+ "scientific": "Oxybelis aeneus"
+ },
+ {
+ "name": "Mexican west coast rattlesnake",
+ "scientific": "Crotalus basiliscus"
+ },
+ {
+ "name": "Micropechis ikaheka",
+ "scientific": "Micropechis ikaheka"
+ },
+ {
+ "name": "Midget faded rattlesnake",
+ "scientific": "Crotalus oreganus concolor"
+ },
+ {
+ "name": "Milk snake",
+ "scientific": "Milk snake"
+ },
+ {
+ "name": "Moccasin snake",
+ "scientific": "Agkistrodon piscivorus"
+ },
+ {
+ "name": "Modest keelback",
+ "scientific": "Amphiesma modestum"
+ },
+ {
+ "name": "Mojave desert sidewinder",
+ "scientific": "Crotalus cerastes"
+ },
+ {
+ "name": "Mojave rattlesnake",
+ "scientific": "Crotalus scutulatus"
+ },
+ {
+ "name": "Mole viper",
+ "scientific": "Atractaspidinae"
+ },
+ {
+ "name": "Moluccan flying snake",
+ "scientific": "Chrysopelea"
+ },
+ {
+ "name": "Montpellier snake",
+ "scientific": "Malpolon monspessulanus"
+ },
+ {
+ "name": "Mud adder",
+ "scientific": "Mud adder"
+ },
+ {
+ "name": "Mud snake",
+ "scientific": "Mud snake"
+ },
+ {
+ "name": "Mussurana",
+ "scientific": "Mussurana"
+ },
+ {
+ "name": "Narrowhead Garter Snake",
+ "scientific": "Garter snake"
+ },
+ {
+ "name": "Nicobar Island keelback",
+ "scientific": "Amphiesma nicobariense"
+ },
+ {
+ "name": "Nicobar cat snake",
+ "scientific": "Boiga wallachi"
+ },
+ {
+ "name": "Night snake",
+ "scientific": "Night snake"
+ },
+ {
+ "name": "Nilgiri keelback",
+ "scientific": "Nilgiri keelback"
+ },
+ {
+ "name": "North eastern king snake",
+ "scientific": "Eastern hognose snake"
+ },
+ {
+ "name": "Northeastern hill krait",
+ "scientific": "Northeastern hill krait"
+ },
+ {
+ "name": "Northern black-tailed rattlesnake",
+ "scientific": "Crotalus molossus"
+ },
+ {
+ "name": "Northern tree snake",
+ "scientific": "Dendrelaphis calligastra"
+ },
+ {
+ "name": "Northern water snake",
+ "scientific": "Northern water snake"
+ },
+ {
+ "name": "Northern white-lipped python",
+ "scientific": "Leiopython"
+ },
+ {
+ "name": "Oaxacan small-headed rattlesnake",
+ "scientific": "Crotalus intermedius gloydi"
+ },
+ {
+ "name": "Okinawan habu",
+ "scientific": "Okinawan habu"
+ },
+ {
+ "name": "Olive sea snake",
+ "scientific": "Aipysurus laevis"
+ },
+ {
+ "name": "Opheodrys",
+ "scientific": "Opheodrys"
+ },
+ {
+ "name": "Orange-collared keelback",
+ "scientific": "Rhabdophis himalayanus"
+ },
+ {
+ "name": "Ornate flying snake",
+ "scientific": "Chrysopelea ornata"
+ },
+ {
+ "name": "Oxybelis",
+ "scientific": "Oxybelis"
+ },
+ {
+ "name": "Palestine viper",
+ "scientific": "Vipera palaestinae"
+ },
+ {
+ "name": "Paradise flying snake",
+ "scientific": "Chrysopelea paradisi"
+ },
+ {
+ "name": "Parrot snake",
+ "scientific": "Leptophis ahaetulla"
+ },
+ {
+ "name": "Patchnose snake",
+ "scientific": "Salvadora (snake)"
+ },
+ {
+ "name": "Pelagic sea snake",
+ "scientific": "Yellow-bellied sea snake"
+ },
+ {
+ "name": "Peninsula tiger snake",
+ "scientific": "Tiger snake"
+ },
+ {
+ "name": "Perrotet's shieldtail snake",
+ "scientific": "Plectrurus perrotetii"
+ },
+ {
+ "name": "Persian rat snake",
+ "scientific": "Rat snake"
+ },
+ {
+ "name": "Pine snake",
+ "scientific": "Pine snake"
+ },
+ {
+ "name": "Pit viper",
+ "scientific": "Pit viper"
+ },
+ {
+ "name": "Plains hognose snake",
+ "scientific": "Western hognose snake"
+ },
+ {
+ "name": "Prairie kingsnake",
+ "scientific": "Lampropeltis calligaster"
+ },
+ {
+ "name": "Pygmy python",
+ "scientific": "Pygmy python"
+ },
+ {
+ "name": "Pythonidae",
+ "scientific": "Pythonidae"
+ },
+ {
+ "name": "Queen snake",
+ "scientific": "Queen snake"
+ },
+ {
+ "name": "Rat snake",
+ "scientific": "Rat snake"
+ },
+ {
+ "name": "Rattler",
+ "scientific": "Rattlesnake"
+ },
+ {
+ "name": "Rattlesnake",
+ "scientific": "Rattlesnake"
+ },
+ {
+ "name": "Red-bellied black snake",
+ "scientific": "Red-bellied black snake"
+ },
+ {
+ "name": "Red-headed krait",
+ "scientific": "Red-headed krait"
+ },
+ {
+ "name": "Red-necked keelback",
+ "scientific": "Rhabdophis subminiatus"
+ },
+ {
+ "name": "Red-tailed bamboo pitviper",
+ "scientific": "Trimeresurus erythrurus"
+ },
+ {
+ "name": "Red-tailed boa",
+ "scientific": "Boa constrictor"
+ },
+ {
+ "name": "Red-tailed pipe snake",
+ "scientific": "Cylindrophis ruffus"
+ },
+ {
+ "name": "Red blood python",
+ "scientific": "Python brongersmai"
+ },
+ {
+ "name": "Red diamond rattlesnake",
+ "scientific": "Crotalus ruber"
+ },
+ {
+ "name": "Reticulated python",
+ "scientific": "Reticulated python"
+ },
+ {
+ "name": "Ribbon snake",
+ "scientific": "Ribbon snake"
+ },
+ {
+ "name": "Ringed hognose snake",
+ "scientific": "Hognose"
+ },
+ {
+ "name": "Rosy boa",
+ "scientific": "Rosy boa"
+ },
+ {
+ "name": "Rough green snake",
+ "scientific": "Opheodrys aestivus"
+ },
+ {
+ "name": "Rubber boa",
+ "scientific": "Rubber boa"
+ },
+ {
+ "name": "Rufous beaked snake",
+ "scientific": "Rufous beaked snake"
+ },
+ {
+ "name": "Russell's viper",
+ "scientific": "Russell's viper"
+ },
+ {
+ "name": "San Francisco garter snake",
+ "scientific": "San Francisco garter snake"
+ },
+ {
+ "name": "Sand boa",
+ "scientific": "Erycinae"
+ },
+ {
+ "name": "Sand viper",
+ "scientific": "Sand viper"
+ },
+ {
+ "name": "Saw-scaled viper",
+ "scientific": "Echis"
+ },
+ {
+ "name": "Scarlet kingsnake",
+ "scientific": "Scarlet kingsnake"
+ },
+ {
+ "name": "Sea snake",
+ "scientific": "Hydrophiinae"
+ },
+ {
+ "name": "Selayer reticulated python",
+ "scientific": "Reticulated python"
+ },
+ {
+ "name": "Shield-nosed cobra",
+ "scientific": "Shield-nosed cobra"
+ },
+ {
+ "name": "Shield-tailed snake",
+ "scientific": "Uropeltidae"
+ },
+ {
+ "name": "Sikkim keelback",
+ "scientific": "Sikkim keelback"
+ },
+ {
+ "name": "Sind krait",
+ "scientific": "Sind krait"
+ },
+ {
+ "name": "Smooth green snake",
+ "scientific": "Smooth green snake"
+ },
+ {
+ "name": "South American hognose snake",
+ "scientific": "Hognose"
+ },
+ {
+ "name": "South Andaman krait",
+ "scientific": "South Andaman krait"
+ },
+ {
+ "name": "South eastern corn snake",
+ "scientific": "Corn snake"
+ },
+ {
+ "name": "Southern Pacific rattlesnake",
+ "scientific": "Crotalus oreganus helleri"
+ },
+ {
+ "name": "Southern black racer",
+ "scientific": "Southern black racer"
+ },
+ {
+ "name": "Southern hognose snake",
+ "scientific": "Southern hognose snake"
+ },
+ {
+ "name": "Southern white-lipped python",
+ "scientific": "Leiopython"
+ },
+ {
+ "name": "Southwestern blackhead snake",
+ "scientific": "Tantilla hobartsmithi"
+ },
+ {
+ "name": "Southwestern carpet python",
+ "scientific": "Morelia spilota imbricata"
+ },
+ {
+ "name": "Southwestern speckled rattlesnake",
+ "scientific": "Crotalus mitchellii pyrrhus"
+ },
+ {
+ "name": "Speckled hognose snake",
+ "scientific": "Hognose"
+ },
+ {
+ "name": "Speckled kingsnake",
+ "scientific": "Lampropeltis getula holbrooki"
+ },
+ {
+ "name": "Spectacled cobra",
+ "scientific": "Indian cobra"
+ },
+ {
+ "name": "Sri Lanka cat snake",
+ "scientific": "Boiga ceylonensis"
+ },
+ {
+ "name": "Stiletto snake",
+ "scientific": "Atractaspidinae"
+ },
+ {
+ "name": "Stimson's python",
+ "scientific": "Stimson's python"
+ },
+ {
+ "name": "Striped snake",
+ "scientific": "Japanese striped snake"
+ },
+ {
+ "name": "Sumatran short-tailed python",
+ "scientific": "Python curtus"
+ },
+ {
+ "name": "Sunbeam snake",
+ "scientific": "Xenopeltis"
+ },
+ {
+ "name": "Taipan",
+ "scientific": "Taipan"
+ },
+ {
+ "name": "Tan racer",
+ "scientific": "Coluber constrictor etheridgei"
+ },
+ {
+ "name": "Tancitaran dusky rattlesnake",
+ "scientific": "Crotalus pusillus"
+ },
+ {
+ "name": "Tanimbar python",
+ "scientific": "Reticulated python"
+ },
+ {
+ "name": "Tasmanian tiger snake",
+ "scientific": "Tiger snake"
+ },
+ {
+ "name": "Tawny cat snake",
+ "scientific": "Boiga ochracea"
+ },
+ {
+ "name": "Temple pit viper",
+ "scientific": "Pit viper"
+ },
+ {
+ "name": "Tentacled snake",
+ "scientific": "Erpeton tentaculatum"
+ },
+ {
+ "name": "Texas Coral Snake",
+ "scientific": "Coral snake"
+ },
+ {
+ "name": "Texas blind snake",
+ "scientific": "Leptotyphlops dulcis"
+ },
+ {
+ "name": "Texas garter snake",
+ "scientific": "Texas garter snake"
+ },
+ {
+ "name": "Texas lyre snake",
+ "scientific": "Trimorphodon biscutatus vilkinsonii"
+ },
+ {
+ "name": "Texas night snake",
+ "scientific": "Hypsiglena jani"
+ },
+ {
+ "name": "Thai cobra",
+ "scientific": "King cobra"
+ },
+ {
+ "name": "Three-lined ground snake",
+ "scientific": "Atractus trilineatus"
+ },
+ {
+ "name": "Tic polonga",
+ "scientific": "Russell's viper"
+ },
+ {
+ "name": "Tiger rattlesnake",
+ "scientific": "Crotalus tigris"
+ },
+ {
+ "name": "Tiger snake",
+ "scientific": "Tiger snake"
+ },
+ {
+ "name": "Tigre snake",
+ "scientific": "Spilotes pullatus"
+ },
+ {
+ "name": "Timber rattlesnake",
+ "scientific": "Timber rattlesnake"
+ },
+ {
+ "name": "Tree snake",
+ "scientific": "Brown tree snake"
+ },
+ {
+ "name": "Tri-color hognose snake",
+ "scientific": "Hognose"
+ },
+ {
+ "name": "Trinket snake",
+ "scientific": "Trinket snake"
+ },
+ {
+ "name": "Tropical rattlesnake",
+ "scientific": "Crotalus durissus"
+ },
+ {
+ "name": "Twig snake",
+ "scientific": "Twig snake"
+ },
+ {
+ "name": "Twin-Barred tree snake",
+ "scientific": "Banded flying snake"
+ },
+ {
+ "name": "Twin-spotted rat snake",
+ "scientific": "Rat snake"
+ },
+ {
+ "name": "Twin-spotted rattlesnake",
+ "scientific": "Crotalus pricei"
+ },
+ {
+ "name": "Uracoan rattlesnake",
+ "scientific": "Crotalus durissus vegrandis"
+ },
+ {
+ "name": "Viperidae",
+ "scientific": "Viperidae"
+ },
+ {
+ "name": "Wall's keelback",
+ "scientific": "Amphiesma xenura"
+ },
+ {
+ "name": "Wart snake",
+ "scientific": "Acrochordidae"
+ },
+ {
+ "name": "Water adder",
+ "scientific": "Agkistrodon piscivorus"
+ },
+ {
+ "name": "Water moccasin",
+ "scientific": "Agkistrodon piscivorus"
+ },
+ {
+ "name": "West Indian racer",
+ "scientific": "Antiguan racer"
+ },
+ {
+ "name": "Western blind snake",
+ "scientific": "Leptotyphlops humilis"
+ },
+ {
+ "name": "Western carpet python",
+ "scientific": "Morelia spilota"
+ },
+ {
+ "name": "Western coral snake",
+ "scientific": "Coral snake"
+ },
+ {
+ "name": "Western diamondback rattlesnake",
+ "scientific": "Western diamondback rattlesnake"
+ },
+ {
+ "name": "Western green mamba",
+ "scientific": "Western green mamba"
+ },
+ {
+ "name": "Western ground snake",
+ "scientific": "Western ground snake"
+ },
+ {
+ "name": "Western hognose snake",
+ "scientific": "Western hognose snake"
+ },
+ {
+ "name": "Western mud snake",
+ "scientific": "Mud snake"
+ },
+ {
+ "name": "Western tiger snake",
+ "scientific": "Tiger snake"
+ },
+ {
+ "name": "Western woma python",
+ "scientific": "Woma python"
+ },
+ {
+ "name": "White-lipped keelback",
+ "scientific": "Amphiesma leucomystax"
+ },
+ {
+ "name": "Wolf snake",
+ "scientific": "Lycodon capucinus"
+ },
+ {
+ "name": "Woma python",
+ "scientific": "Woma python"
+ },
+ {
+ "name": "Wutu",
+ "scientific": "Bothrops alternatus"
+ },
+ {
+ "name": "Wynaad keelback",
+ "scientific": "Amphiesma monticola"
+ },
+ {
+ "name": "Yellow-banded sea snake",
+ "scientific": "Yellow-bellied sea snake"
+ },
+ {
+ "name": "Yellow-bellied sea snake",
+ "scientific": "Yellow-bellied sea snake"
+ },
+ {
+ "name": "Yellow-lipped sea snake",
+ "scientific": "Yellow-lipped sea krait"
+ },
+ {
+ "name": "Yellow-striped rat snake",
+ "scientific": "Rat snake"
+ },
+ {
+ "name": "Yellow anaconda",
+ "scientific": "Yellow anaconda"
+ },
+ {
+ "name": "Yellow cobra",
+ "scientific": "Cape cobra"
+ },
+ {
+ "name": "Yunnan keelback",
+ "scientific": "Amphiesma parallelum"
+ },
+ {
+ "name": "Abaco Island boa",
+ "scientific": "Epicrates exsul"
+ },
+ {
+ "name": "Agkistrodon bilineatus",
+ "scientific": "Agkistrodon bilineatus"
+ },
+ {
+ "name": "Amazon tree boa",
+ "scientific": "Corallus hortulanus"
+ },
+ {
+ "name": "Andaman cobra",
+ "scientific": "Andaman cobra"
+ },
+ {
+ "name": "Angolan python",
+ "scientific": "Python anchietae"
+ },
+ {
+ "name": "Arabian cobra",
+ "scientific": "Arabian cobra"
+ },
+ {
+ "name": "Asp viper",
+ "scientific": "Vipera aspis"
+ },
+ {
+ "name": "Ball Python",
+ "scientific": "Ball python"
+ },
+ {
+ "name": "Ball python",
+ "scientific": "Ball python"
+ },
+ {
+ "name": "Bamboo pitviper",
+ "scientific": "Trimeresurus gramineus"
+ },
+ {
+ "name": "Banded pitviper",
+ "scientific": "Trimeresurus fasciatus"
+ },
+ {
+ "name": "Banded water cobra",
+ "scientific": "Naja annulata"
+ },
+ {
+ "name": "Barbour's pit viper",
+ "scientific": "Mixcoatlus barbouri"
+ },
+ {
+ "name": "Bismarck ringed python",
+ "scientific": "Bothrochilus"
+ },
+ {
+ "name": "Black-speckled palm-pitviper",
+ "scientific": "Bothriechis nigroviridis"
+ },
+ {
+ "name": "Bluntnose viper",
+ "scientific": "Macrovipera lebetina"
+ },
+ {
+ "name": "Bornean pitviper",
+ "scientific": "Trimeresurus borneensis"
+ },
+ {
+ "name": "Borneo short-tailed python",
+ "scientific": "Borneo python"
+ },
+ {
+ "name": "Bothrops jararacussu",
+ "scientific": "Bothrops jararacussu"
+ },
+ {
+ "name": "Bredl's python",
+ "scientific": "Morelia bredli"
+ },
+ {
+ "name": "Brongersma's pitviper",
+ "scientific": "Trimeresurus brongersmai"
+ },
+ {
+ "name": "Brown spotted pitviper",
+ "scientific": "Trimeresurus mucrosquamatus"
+ },
+ {
+ "name": "Brown water python",
+ "scientific": "Liasis fuscus"
+ },
+ {
+ "name": "Burrowing cobra",
+ "scientific": "Egyptian cobra"
+ },
+ {
+ "name": "Bush viper",
+ "scientific": "Atheris"
+ },
+ {
+ "name": "Calabar python",
+ "scientific": "Calabar python"
+ },
+ {
+ "name": "Caspian cobra",
+ "scientific": "Caspian cobra"
+ },
+ {
+ "name": "Centralian carpet python",
+ "scientific": "Morelia bredli"
+ },
+ {
+ "name": "Chinese tree viper",
+ "scientific": "Trimeresurus stejnegeri"
+ },
+ {
+ "name": "Coastal carpet python",
+ "scientific": "Morelia spilota mcdowelli"
+ },
+ {
+ "name": "Colorado desert sidewinder",
+ "scientific": "Crotalus cerastes laterorepens"
+ },
+ {
+ "name": "Common lancehead",
+ "scientific": "Bothrops atrox"
+ },
+ {
+ "name": "Cyclades blunt-nosed viper",
+ "scientific": "Macrovipera schweizeri"
+ },
+ {
+ "name": "Dauan Island water python",
+ "scientific": "Liasis fuscus"
+ },
+ {
+ "name": "De Schauensee's anaconda",
+ "scientific": "Eunectes deschauenseei"
+ },
+ {
+ "name": "Dumeril's boa",
+ "scientific": "Acrantophis dumerili"
+ },
+ {
+ "name": "Dusky pigmy rattlesnake",
+ "scientific": "Sistrurus miliarius barbouri"
+ },
+ {
+ "name": "Dwarf sand adder",
+ "scientific": "Bitis peringueyi"
+ },
+ {
+ "name": "Egyptian cobra",
+ "scientific": "Egyptian cobra"
+ },
+ {
+ "name": "Elegant pitviper",
+ "scientific": "Trimeresurus elegans"
+ },
+ {
+ "name": "Emerald tree boa",
+ "scientific": "Emerald tree boa"
+ },
+ {
+ "name": "Equatorial spitting cobra",
+ "scientific": "Equatorial spitting cobra"
+ },
+ {
+ "name": "European asp",
+ "scientific": "Vipera aspis"
+ },
+ {
+ "name": "Eyelash palm-pitviper",
+ "scientific": "Bothriechis schlegelii"
+ },
+ {
+ "name": "Eyelash pit viper",
+ "scientific": "Bothriechis schlegelii"
+ },
+ {
+ "name": "Eyelash viper",
+ "scientific": "Bothriechis schlegelii"
+ },
+ {
+ "name": "False horned viper",
+ "scientific": "Pseudocerastes"
+ },
+ {
+ "name": "Fan-Si-Pan horned pitviper",
+ "scientific": "Trimeresurus cornutus"
+ },
+ {
+ "name": "Fea's viper",
+ "scientific": "Azemiops"
+ },
+ {
+ "name": "Fifty pacer",
+ "scientific": "Deinagkistrodon"
+ },
+ {
+ "name": "Flat-nosed pitviper",
+ "scientific": "Trimeresurus puniceus"
+ },
+ {
+ "name": "Godman's pit viper",
+ "scientific": "Cerrophidion godmani"
+ },
+ {
+ "name": "Great Lakes bush viper",
+ "scientific": "Atheris nitschei"
+ },
+ {
+ "name": "Green palm viper",
+ "scientific": "Bothriechis lateralis"
+ },
+ {
+ "name": "Green tree pit viper",
+ "scientific": "Trimeresurus gramineus"
+ },
+ {
+ "name": "Guatemalan palm viper",
+ "scientific": "Bothriechis aurifer"
+ },
+ {
+ "name": "Guatemalan tree viper",
+ "scientific": "Bothriechis bicolor"
+ },
+ {
+ "name": "Hagen's pitviper",
+ "scientific": "Trimeresurus hageni"
+ },
+ {
+ "name": "Hairy bush viper",
+ "scientific": "Atheris hispida"
+ },
+ {
+ "name": "Himehabu",
+ "scientific": "Ovophis okinavensis"
+ },
+ {
+ "name": "Hogg Island boa",
+ "scientific": "Boa constrictor imperator"
+ },
+ {
+ "name": "Honduran palm viper",
+ "scientific": "Bothriechis marchi"
+ },
+ {
+ "name": "Horned desert viper",
+ "scientific": "Cerastes cerastes"
+ },
+ {
+ "name": "Horseshoe pitviper",
+ "scientific": "Trimeresurus strigatus"
+ },
+ {
+ "name": "Hundred pacer",
+ "scientific": "Deinagkistrodon"
+ },
+ {
+ "name": "Hutton's tree viper",
+ "scientific": "Tropidolaemus huttoni"
+ },
+ {
+ "name": "Indian python",
+ "scientific": "Python molurus"
+ },
+ {
+ "name": "Indian tree viper",
+ "scientific": "Trimeresurus gramineus"
+ },
+ {
+ "name": "Indochinese spitting cobra",
+ "scientific": "Indochinese spitting cobra"
+ },
+ {
+ "name": "Indonesian water python",
+ "scientific": "Liasis mackloti"
+ },
+ {
+ "name": "Javan spitting cobra",
+ "scientific": "Javan spitting cobra"
+ },
+ {
+ "name": "Jerdon's pitviper",
+ "scientific": "Trimeresurus jerdonii"
+ },
+ {
+ "name": "Jumping viper",
+ "scientific": "Atropoides"
+ },
+ {
+ "name": "Jungle carpet python",
+ "scientific": "Morelia spilota cheynei"
+ },
+ {
+ "name": "Kanburian pit viper",
+ "scientific": "Trimeresurus kanburiensis"
+ },
+ {
+ "name": "Kaulback's lance-headed pitviper",
+ "scientific": "Trimeresurus kaulbacki"
+ },
+ {
+ "name": "Kaznakov's viper",
+ "scientific": "Vipera kaznakovi"
+ },
+ {
+ "name": "Kham Plateau pitviper",
+ "scientific": "Protobothrops xiangchengensis"
+ },
+ {
+ "name": "Lachesis (genus)",
+ "scientific": "Lachesis (genus)"
+ },
+ {
+ "name": "Large-eyed pitviper",
+ "scientific": "Trimeresurus macrops"
+ },
+ {
+ "name": "Large-scaled tree viper",
+ "scientific": "Trimeresurus macrolepis"
+ },
+ {
+ "name": "Leaf-nosed viper",
+ "scientific": "Eristicophis"
+ },
+ {
+ "name": "Leaf viper",
+ "scientific": "Atheris squamigera"
+ },
+ {
+ "name": "Levant viper",
+ "scientific": "Macrovipera lebetina"
+ },
+ {
+ "name": "Long-nosed viper",
+ "scientific": "Vipera ammodytes"
+ },
+ {
+ "name": "Macklot's python",
+ "scientific": "Liasis mackloti"
+ },
+ {
+ "name": "Madagascar tree boa",
+ "scientific": "Sanzinia"
+ },
+ {
+ "name": "Malabar rock pitviper",
+ "scientific": "Trimeresurus malabaricus"
+ },
+ {
+ "name": "Malcolm's tree viper",
+ "scientific": "Trimeresurus sumatranus malcolmi"
+ },
+ {
+ "name": "Mandalay cobra",
+ "scientific": "Mandalay spitting cobra"
+ },
+ {
+ "name": "Mangrove pit viper",
+ "scientific": "Trimeresurus purpureomaculatus"
+ },
+ {
+ "name": "Mangshan pitviper",
+ "scientific": "Trimeresurus mangshanensis"
+ },
+ {
+ "name": "McMahon's viper",
+ "scientific": "Eristicophis"
+ },
+ {
+ "name": "Mexican palm-pitviper",
+ "scientific": "Bothriechis rowleyi"
+ },
+ {
+ "name": "Monocled cobra",
+ "scientific": "Monocled cobra"
+ },
+ {
+ "name": "Motuo bamboo pitviper",
+ "scientific": "Trimeresurus medoensis"
+ },
+ {
+ "name": "Mozambique spitting cobra",
+ "scientific": "Mozambique spitting cobra"
+ },
+ {
+ "name": "Namaqua dwarf adder",
+ "scientific": "Bitis schneideri"
+ },
+ {
+ "name": "Namib dwarf sand adder",
+ "scientific": "Bitis peringueyi"
+ },
+ {
+ "name": "New Guinea carpet python",
+ "scientific": "Morelia spilota variegata"
+ },
+ {
+ "name": "Nicobar bamboo pitviper",
+ "scientific": "Trimeresurus labialis"
+ },
+ {
+ "name": "Nitsche's bush viper",
+ "scientific": "Atheris nitschei"
+ },
+ {
+ "name": "Nitsche's tree viper",
+ "scientific": "Atheris nitschei"
+ },
+ {
+ "name": "Northwestern carpet python",
+ "scientific": "Morelia spilota variegata"
+ },
+ {
+ "name": "Nubian spitting cobra",
+ "scientific": "Nubian spitting cobra"
+ },
+ {
+ "name": "Oenpelli python",
+ "scientific": "Oenpelli python"
+ },
+ {
+ "name": "Olive python",
+ "scientific": "Liasis olivaceus"
+ },
+ {
+ "name": "Pallas' viper",
+ "scientific": "Gloydius halys"
+ },
+ {
+ "name": "Palm viper",
+ "scientific": "Bothriechis lateralis"
+ },
+ {
+ "name": "Papuan python",
+ "scientific": "Apodora"
+ },
+ {
+ "name": "Peringuey's adder",
+ "scientific": "Bitis peringueyi"
+ },
+ {
+ "name": "Philippine cobra",
+ "scientific": "Philippine cobra"
+ },
+ {
+ "name": "Philippine pitviper",
+ "scientific": "Trimeresurus flavomaculatus"
+ },
+ {
+ "name": "Pope's tree viper",
+ "scientific": "Trimeresurus popeorum"
+ },
+ {
+ "name": "Portuguese viper",
+ "scientific": "Vipera seoanei"
+ },
+ {
+ "name": "Puerto Rican boa",
+ "scientific": "Puerto Rican boa"
+ },
+ {
+ "name": "Rainbow boa",
+ "scientific": "Rainbow boa"
+ },
+ {
+ "name": "Red spitting cobra",
+ "scientific": "Red spitting cobra"
+ },
+ {
+ "name": "Rhinoceros viper",
+ "scientific": "Bitis nasicornis"
+ },
+ {
+ "name": "Rhombic night adder",
+ "scientific": "Causus maculatus"
+ },
+ {
+ "name": "Rinkhals",
+ "scientific": "Rinkhals"
+ },
+ {
+ "name": "Rinkhals cobra",
+ "scientific": "Rinkhals"
+ },
+ {
+ "name": "River jack",
+ "scientific": "Bitis nasicornis"
+ },
+ {
+ "name": "Rough-scaled bush viper",
+ "scientific": "Atheris hispida"
+ },
+ {
+ "name": "Rough-scaled python",
+ "scientific": "Rough-scaled python"
+ },
+ {
+ "name": "Rough-scaled tree viper",
+ "scientific": "Atheris hispida"
+ },
+ {
+ "name": "Royal python",
+ "scientific": "Ball python"
+ },
+ {
+ "name": "Rungwe tree viper",
+ "scientific": "Atheris nitschei rungweensis"
+ },
+ {
+ "name": "Sakishima habu",
+ "scientific": "Trimeresurus elegans"
+ },
+ {
+ "name": "Savu python",
+ "scientific": "Liasis mackloti savuensis"
+ },
+ {
+ "name": "Schlegel's viper",
+ "scientific": "Bothriechis schlegelii"
+ },
+ {
+ "name": "Schultze's pitviper",
+ "scientific": "Trimeresurus schultzei"
+ },
+ {
+ "name": "Sedge viper",
+ "scientific": "Atheris nitschei"
+ },
+ {
+ "name": "Sharp-nosed viper",
+ "scientific": "Deinagkistrodon"
+ },
+ {
+ "name": "Siamese palm viper",
+ "scientific": "Trimeresurus puniceus"
+ },
+ {
+ "name": "Side-striped palm-pitviper",
+ "scientific": "Bothriechis lateralis"
+ },
+ {
+ "name": "Snorkel viper",
+ "scientific": "Deinagkistrodon"
+ },
+ {
+ "name": "Snouted cobra",
+ "scientific": "Snouted cobra"
+ },
+ {
+ "name": "Sonoran sidewinder",
+ "scientific": "Crotalus cerastes cercobombus"
+ },
+ {
+ "name": "Southern Indonesian spitting cobra",
+ "scientific": "Javan spitting cobra"
+ },
+ {
+ "name": "Southern Philippine cobra",
+ "scientific": "Samar cobra"
+ },
+ {
+ "name": "Spiny bush viper",
+ "scientific": "Atheris hispida"
+ },
+ {
+ "name": "Spitting cobra",
+ "scientific": "Spitting cobra"
+ },
+ {
+ "name": "Spotted python",
+ "scientific": "Spotted python"
+ },
+ {
+ "name": "Sri Lankan pit viper",
+ "scientific": "Trimeresurus trigonocephalus"
+ },
+ {
+ "name": "Stejneger's bamboo pitviper",
+ "scientific": "Trimeresurus stejnegeri"
+ },
+ {
+ "name": "Storm water cobra",
+ "scientific": "Naja annulata"
+ },
+ {
+ "name": "Sumatran tree viper",
+ "scientific": "Trimeresurus sumatranus"
+ },
+ {
+ "name": "Temple viper",
+ "scientific": "Tropidolaemus wagleri"
+ },
+ {
+ "name": "Tibetan bamboo pitviper",
+ "scientific": "Trimeresurus tibetanus"
+ },
+ {
+ "name": "Tiger pit viper",
+ "scientific": "Trimeresurus kanburiensis"
+ },
+ {
+ "name": "Timor python",
+ "scientific": "Python timoriensis"
+ },
+ {
+ "name": "Tokara habu",
+ "scientific": "Trimeresurus tokarensis"
+ },
+ {
+ "name": "Tree boa",
+ "scientific": "Emerald tree boa"
+ },
+ {
+ "name": "Undulated pit viper",
+ "scientific": "Ophryacus undulatus"
+ },
+ {
+ "name": "Ursini's viper",
+ "scientific": "Vipera ursinii"
+ },
+ {
+ "name": "Wagler's pit viper",
+ "scientific": "Tropidolaemus wagleri"
+ },
+ {
+ "name": "West African brown spitting cobra",
+ "scientific": "Mozambique spitting cobra"
+ },
+ {
+ "name": "White-lipped tree viper",
+ "scientific": "Trimeresurus albolabris"
+ },
+ {
+ "name": "Wirot's pit viper",
+ "scientific": "Trimeresurus puniceus"
+ },
+ {
+ "name": "Yellow-lined palm viper",
+ "scientific": "Bothriechis lateralis"
+ },
+ {
+ "name": "Zebra spitting cobra",
+ "scientific": "Naja nigricincta"
+ },
+ {
+ "name": "Yarara",
+ "scientific": "Bothrops jararaca"
+ },
+ {
+ "name": "Wetar Island python",
+ "scientific": "Liasis macklot"
+ },
+ {
+ "name": "Urutus",
+ "scientific": "Bothrops alternatus"
+ },
+ {
+ "name": "Titanboa",
+ "scientific": "Titanoboa"
+ }
+] \ No newline at end of file
diff --git a/bot/resources/snakes/snake_quiz.json b/bot/resources/snakes/snake_quiz.json
new file mode 100644
index 00000000..8c426b22
--- /dev/null
+++ b/bot/resources/snakes/snake_quiz.json
@@ -0,0 +1,200 @@
+[
+ {
+ "id": 0,
+ "question": "How long have snakes been roaming the Earth for?",
+ "options": {
+ "a": "3 million years",
+ "b": "30 million years",
+ "c": "130 million years",
+ "d": "200 million years"
+ },
+ "answerkey": "c"
+ },
+ {
+ "id": 1,
+ "question": "What characteristics do all snakes share?",
+ "options": {
+ "a": "They are carnivoes",
+ "b": "They are all programming languages",
+ "c": "They're all cold-blooded",
+ "d": "They are both carnivores and cold-blooded"
+ },
+ "answerkey": "c"
+ },
+ {
+ "id": 2,
+ "question": "How do snakes hear?",
+ "options": {
+ "a": "With small ears",
+ "b": "Through their skin",
+ "c": "Through their tail",
+ "d": "They don't use their ears at all"
+ },
+ "answerkey": "b"
+ },
+ {
+ "id": 3,
+ "question": "What can't snakes see?",
+ "options": {
+ "a": "Colour",
+ "b": "Light",
+ "c": "Both of the above",
+ "d": "Other snakes"
+ },
+ "answerkey": "a"
+ },
+ {
+ "id": 4,
+ "question": "What unique vision ability do boas and pythons possess?",
+ "options": {
+ "a": "Night vision",
+ "b": "Infrared vision",
+ "c": "See through walls",
+ "d": "They don't have vision"
+ },
+ "answerkey": "b"
+ },
+ {
+ "id": 5,
+ "question": "How does a snake smell?",
+ "options": {
+ "a": "Quite pleasant",
+ "b": "Through its nose",
+ "c": "Through its tongues",
+ "d": "Both through its nose and its tongues"
+ },
+ "answerkey": "d"
+ },
+ {
+ "id": 6,
+ "question": "Where are Jacobson's organs located in snakes?",
+ "options": {
+ "a": "Mouth",
+ "b": "Tail",
+ "c": "Stomach",
+ "d": "Liver"
+ },
+ "answerkey": "a"
+ },
+ {
+ "id": 7,
+ "question": "Snakes have very similar internal organs compared to humans. Snakes, however; lack the following:",
+ "options": {
+ "a": "A diaphragm",
+ "b": "Intestines",
+ "c": "Lungs",
+ "d": "Kidney"
+ },
+ "answerkey": "a"
+ },
+ {
+ "id": 8,
+ "question": "Snakes have different shaped lungs than humans. What do snakes have?",
+ "options": {
+ "a": "An elongated right lung",
+ "b": "A small left lung",
+ "c": "Both of the above",
+ "d": "None of the above"
+ },
+ "answerkey": "c"
+ },
+ {
+ "id": 9,
+ "question": "What's true about two-headed snakes?",
+ "options": {
+ "a": "They're a myth!",
+ "b": "They rarely survive in the wild",
+ "c": "They're very dangerous",
+ "d": "They can kiss each other"
+ },
+ "answerkey": "b"
+ },
+ {
+ "id": 10,
+ "question": "What substance covers a snake's skin?",
+ "options": {
+ "a": "Calcium",
+ "b": "Keratin",
+ "c": "Copper",
+ "d": "Iron"
+ },
+ "answerkey": "b"
+ },
+ {
+ "id": 11,
+ "question": "What snake doesn't have to have a mate to lay eggs?",
+ "options": {
+ "a": "Copperhead",
+ "b": "Cornsnake",
+ "c": "Kingsnake",
+ "d": "Flower pot snake"
+ },
+ "answerkey": "d"
+ },
+ {
+ "id": 12,
+ "question": "What snake is the longest?",
+ "options": {
+ "a": "Green anaconda",
+ "b": "Reticulated python",
+ "c": "King cobra",
+ "d": "Kingsnake"
+ },
+ "answerkey": "b"
+ },
+ {
+ "id": 13,
+ "question": "Though invasive species can now be found in the Everglades, in which three continents are pythons (members of the family Pythonidae) found in the wild?",
+ "options": {
+ "a": "Africa, Asia and Australia",
+ "b": "Africa, Australia and Europe",
+ "c": "Africa, Australia and South America",
+ "d": "Africa, Asia and South America"
+ },
+ "answerkey": "a"
+ },
+ {
+ "id": 14,
+ "question": "Pythons are held as some of the most dangerous snakes on earth, but are often confused with anacondas. Which of these is *not* a difference between pythons and anacondas?",
+ "options": {
+ "a": "Pythons suffocate their prey, anacondas crush them",
+ "b": "Pythons lay eggs, anacondas give birth to live young",
+ "c": "Pythons grow longer, anacondas grow heavier",
+ "d": "Pythons generally spend less time in water than anacondas do"
+ },
+ "answerkey": "a"
+ },
+ {
+ "id": 15,
+ "question": "Pythons are unable to chew their food, and so swallow prey whole. Which of these methods is most commonly demonstrated to help a python to swallow large prey?",
+ "options": {
+ "a": "The python's stomach pressure is reduced, so prey is sucked in",
+ "b": "An extra set of upper teeth 'walk' along the prey",
+ "c": "The python holds its head up, so prey falls into its stomach",
+ "d": "Prey is pushed against a barrier and is forced down the python's throat"
+ },
+ "answerkey": "b"
+ },
+ {
+ "id": 16,
+ "question": "Pythons, like many large constrictors, possess vestigial hind limbs. Whilst these 'spurs' serve no purpose in locomotion, how are they put to use by some male pythons? ",
+ "options": {
+ "a": "To store sperm",
+ "b": "To release pheromones",
+ "c": "To grip females during mating",
+ "d": "To fight off rival males"
+ },
+ "answerkey": "c"
+ },
+ {
+ "id": 17,
+ "question": "Pythons tend to travel by the rectilinear method (in straight lines) when on land, as opposed to the concertina method (s-shaped movement). Why do large pythons tend not to use the concertina method? ",
+ "options": {
+ "a": "Their spine is too inflexible",
+ "b": "They move too slowly",
+ "c": "The scales on their backs are too rigid",
+ "d": "They are too heavy"
+ },
+ "answerkey": "d"
+ }
+]
diff --git a/bot/resources/snakes/snakes_and_ladders/banner.jpg b/bot/resources/snakes/snakes_and_ladders/banner.jpg
new file mode 100644
index 00000000..69eaaf12
--- /dev/null
+++ b/bot/resources/snakes/snakes_and_ladders/banner.jpg
Binary files differ
diff --git a/bot/resources/snakes/snakes_and_ladders/board.jpg b/bot/resources/snakes/snakes_and_ladders/board.jpg
new file mode 100644
index 00000000..20032e39
--- /dev/null
+++ b/bot/resources/snakes/snakes_and_ladders/board.jpg
Binary files differ
diff --git a/bot/resources/snakes/special_snakes.json b/bot/resources/snakes/special_snakes.json
new file mode 100644
index 00000000..8159f914
--- /dev/null
+++ b/bot/resources/snakes/special_snakes.json
@@ -0,0 +1,16 @@
+[
+ {
+ "name": "Bob Ross",
+ "info": "Robert Norman Ross (October 29, 1942 – July 4, 1995) was an American painter, art instructor, and television host. He was the creator and host of The Joy of Painting, an instructional television program that aired from 1983 to 1994 on PBS in the United States, and also aired in Canada, Latin America, and Europe.",
+ "image_list": [
+ "https://d3atagt0rnqk7k.cloudfront.net/wp-content/uploads/2016/09/23115633/bob-ross-1-1280x800.jpg"
+ ]
+ },
+ {
+ "name": "Mystery Snake",
+ "info": "The Mystery Snake is rumored to be a thin, serpentine creature that hides in spaghetti dinners. It has yellow, pasta-like scales with a completely smooth texture, and is quite glossy. ",
+ "image_list": [
+ "https://img.thrfun.com/img/080/349/spaghetti_dinner_l1.jpg"
+ ]
+ }
+] \ No newline at end of file
diff --git a/bot/seasons/evergreen/__init__.py b/bot/seasons/evergreen/__init__.py
index db5b5684..db610e7c 100644
--- a/bot/seasons/evergreen/__init__.py
+++ b/bot/seasons/evergreen/__init__.py
@@ -2,4 +2,4 @@ from bot.seasons import SeasonBase
class Evergreen(SeasonBase):
- pass
+ bot_icon = "/logos/logo_seasonal/evergreen/logo_evergreen.png"
diff --git a/bot/seasons/evergreen/snakes/__init__.py b/bot/seasons/evergreen/snakes/__init__.py
new file mode 100644
index 00000000..367aea4d
--- /dev/null
+++ b/bot/seasons/evergreen/snakes/__init__.py
@@ -0,0 +1,10 @@
+import logging
+
+from bot.seasons.evergreen.snakes.snakes_cog import Snakes
+
+log = logging.getLogger(__name__)
+
+
+def setup(bot):
+ bot.add_cog(Snakes(bot))
+ log.info("Cog loaded: Snakes")
diff --git a/bot/seasons/evergreen/snakes/converter.py b/bot/seasons/evergreen/snakes/converter.py
new file mode 100644
index 00000000..c091d9c1
--- /dev/null
+++ b/bot/seasons/evergreen/snakes/converter.py
@@ -0,0 +1,80 @@
+import json
+import logging
+import random
+
+import discord
+from discord.ext.commands import Converter
+from fuzzywuzzy import fuzz
+
+from bot.seasons.evergreen.snakes.utils import SNAKE_RESOURCES
+from bot.utils import disambiguate
+
+log = logging.getLogger(__name__)
+
+
+class Snake(Converter):
+ snakes = None
+ special_cases = None
+
+ async def convert(self, ctx, name):
+ await self.build_list()
+ name = name.lower()
+
+ if name == 'python':
+ return 'Python (programming language)'
+
+ def get_potential(iterable, *, threshold=80):
+ nonlocal name
+ potential = []
+
+ for item in iterable:
+ original, item = item, item.lower()
+
+ if name == item:
+ return [original]
+
+ a, b = fuzz.ratio(name, item), fuzz.partial_ratio(name, item)
+ if a >= threshold or b >= threshold:
+ potential.append(original)
+
+ return potential
+
+ # Handle special cases
+ if name.lower() in self.special_cases:
+ return self.special_cases.get(name.lower(), name.lower())
+
+ names = {snake['name']: snake['scientific'] for snake in self.snakes}
+ all_names = names.keys() | names.values()
+ timeout = len(all_names) * (3 / 4)
+
+ embed = discord.Embed(
+ title='Found multiple choices. Please choose the correct one.', colour=0x59982F)
+ embed.set_author(name=ctx.author.display_name, icon_url=ctx.author.avatar_url)
+
+ name = await disambiguate(ctx, get_potential(all_names), timeout=timeout, embed=embed)
+ return names.get(name, name)
+
+ @classmethod
+ async def build_list(cls):
+ # Get all the snakes
+ if cls.snakes is None:
+ with (SNAKE_RESOURCES / "snake_names.json").open() as snakefile:
+ cls.snakes = json.load(snakefile)
+
+ # Get the special cases
+ if cls.special_cases is None:
+ with (SNAKE_RESOURCES / "special_snakes.json").open() as snakefile:
+ special_cases = json.load(snakefile)
+ cls.special_cases = {snake['name'].lower(): snake for snake in special_cases}
+
+ @classmethod
+ async def random(cls):
+ """
+ This is stupid. We should find a way to
+ somehow get the global session into a
+ global context, so I can get it from here.
+ :return:
+ """
+ await cls.build_list()
+ names = [snake['scientific'] for snake in cls.snakes]
+ return random.choice(names)
diff --git a/bot/seasons/evergreen/snakes/snakes_cog.py b/bot/seasons/evergreen/snakes/snakes_cog.py
new file mode 100644
index 00000000..57eb7a52
--- /dev/null
+++ b/bot/seasons/evergreen/snakes/snakes_cog.py
@@ -0,0 +1,1194 @@
+import asyncio
+import colorsys
+import logging
+import os
+import random
+import re
+import string
+import textwrap
+import urllib
+from functools import partial
+from io import BytesIO
+from typing import Any, Dict
+
+import aiohttp
+import async_timeout
+from PIL import Image, ImageDraw, ImageFont
+from discord import Colour, Embed, File, Member, Message, Reaction
+from discord.ext.commands import BadArgument, Bot, Context, bot_has_permissions, group
+
+from bot.constants import ERROR_REPLIES, Tokens
+from bot.decorators import locked
+from bot.seasons.evergreen.snakes import utils
+from bot.seasons.evergreen.snakes.converter import Snake
+
+log = logging.getLogger(__name__)
+
+
+# region: Constants
+# Color
+SNAKE_COLOR = 0x399600
+
+# Antidote constants
+SYRINGE_EMOJI = "\U0001F489" # :syringe:
+PILL_EMOJI = "\U0001F48A" # :pill:
+HOURGLASS_EMOJI = "\u231B" # :hourglass:
+CROSSBONES_EMOJI = "\u2620" # :skull_crossbones:
+ALEMBIC_EMOJI = "\u2697" # :alembic:
+TICK_EMOJI = "\u2705" # :white_check_mark: - Correct peg, correct hole
+CROSS_EMOJI = "\u274C" # :x: - Wrong peg, wrong hole
+BLANK_EMOJI = "\u26AA" # :white_circle: - Correct peg, wrong hole
+HOLE_EMOJI = "\u2B1C" # :white_square: - Used in guesses
+EMPTY_UNICODE = "\u200b" # literally just an empty space
+
+ANTIDOTE_EMOJI = (
+ SYRINGE_EMOJI,
+ PILL_EMOJI,
+ HOURGLASS_EMOJI,
+ CROSSBONES_EMOJI,
+ ALEMBIC_EMOJI,
+)
+
+# Quiz constants
+ANSWERS_EMOJI = {
+ "a": "\U0001F1E6", # :regional_indicator_a: 🇦
+ "b": "\U0001F1E7", # :regional_indicator_b: 🇧
+ "c": "\U0001F1E8", # :regional_indicator_c: 🇨
+ "d": "\U0001F1E9", # :regional_indicator_d: 🇩
+}
+
+ANSWERS_EMOJI_REVERSE = {
+ "\U0001F1E6": "A", # :regional_indicator_a: 🇦
+ "\U0001F1E7": "B", # :regional_indicator_b: 🇧
+ "\U0001F1E8": "C", # :regional_indicator_c: 🇨
+ "\U0001F1E9": "D", # :regional_indicator_d: 🇩
+}
+
+# Zzzen of pythhhon constant
+ZEN = """
+Beautiful is better than ugly.
+Explicit is better than implicit.
+Simple is better than complex.
+Complex is better than complicated.
+Flat is better than nested.
+Sparse is better than dense.
+Readability counts.
+Special cases aren't special enough to break the rules.
+Although practicality beats purity.
+Errors should never pass silently.
+Unless explicitly silenced.
+In the face of ambiguity, refuse the temptation to guess.
+There should be one-- and preferably only one --obvious way to do it.
+Now is better than never.
+Although never is often better than *right* now.
+If the implementation is hard to explain, it's a bad idea.
+If the implementation is easy to explain, it may be a good idea.
+"""
+
+# Max messages to train snake_chat on
+MSG_MAX = 100
+
+# get_snek constants
+URL = "https://en.wikipedia.org/w/api.php?"
+
+# snake guess responses
+INCORRECT_GUESS = (
+ "Nope, that's not what it is.",
+ "Not quite.",
+ "Not even close.",
+ "Terrible guess.",
+ "Nnnno.",
+ "Dude. No.",
+ "I thought everyone knew this one.",
+ "Guess you suck at snakes.",
+ "Bet you feel stupid now.",
+ "Hahahaha, no.",
+ "Did you hit the wrong key?"
+)
+
+CORRECT_GUESS = (
+ "**WRONG**. Wait, no, actually you're right.",
+ "Yeah, you got it!",
+ "Yep, that's exactly what it is.",
+ "Uh-huh. Yep yep yep.",
+ "Yeah that's right.",
+ "Yup. How did you know that?",
+ "Are you a herpetologist?",
+ "Sure, okay, but I bet you can't pronounce it.",
+ "Are you cheating?"
+)
+
+# snake card consts
+CARD = {
+ "top": Image.open("bot/resources/snakes/snake_cards/card_top.png"),
+ "frame": Image.open("bot/resources/snakes/snake_cards/card_frame.png"),
+ "bottom": Image.open("bot/resources/snakes/snake_cards/card_bottom.png"),
+ "backs": [
+ Image.open(f"bot/resources/snakes/snake_cards/backs/{file}")
+ for file in os.listdir("bot/resources/snakes/snake_cards/backs")
+ ],
+ "font": ImageFont.truetype("bot/resources/snakes/snake_cards/expressway.ttf", 20)
+}
+# endregion
+
+
+class Snakes:
+ """
+ Commands related to snakes. These were created by our
+ community during the first code jam.
+
+ More information can be found in the code-jam-1 repo.
+
+ https://gitlab_bot_repo.com/discord-python/code-jams/code-jam-1
+ """
+
+ wiki_brief = re.compile(r'(.*?)(=+ (.*?) =+)', flags=re.DOTALL)
+ valid_image_extensions = ('gif', 'png', 'jpeg', 'jpg', 'webp')
+
+ def __init__(self, bot: Bot):
+ self.active_sal = {}
+ self.bot = bot
+ self.snake_names = utils.get_resource("snake_names")
+ self.snake_idioms = utils.get_resource("snake_idioms")
+ self.snake_quizzes = utils.get_resource("snake_quiz")
+ self.snake_facts = utils.get_resource("snake_facts")
+
+ # region: Helper methods
+ @staticmethod
+ def _beautiful_pastel(hue):
+ """
+ Returns random bright pastels.
+ """
+ light = random.uniform(0.7, 0.85)
+ saturation = 1
+
+ rgb = colorsys.hls_to_rgb(hue, light, saturation)
+ hex_rgb = ""
+
+ for part in rgb:
+ value = int(part * 0xFF)
+ hex_rgb += f"{value:02x}"
+
+ return int(hex_rgb, 16)
+
+ @staticmethod
+ def _generate_card(buffer: BytesIO, content: dict) -> BytesIO:
+ """
+ Generate a card from snake information.
+
+ Written by juan and Someone during the first code jam.
+ """
+ snake = Image.open(buffer)
+
+ # Get the size of the snake icon, configure the height of the image box (yes, it changes)
+ icon_width = 347 # Hardcoded, not much i can do about that
+ icon_height = int((icon_width / snake.width) * snake.height)
+ frame_copies = icon_height // CARD['frame'].height + 1
+ snake.thumbnail((icon_width, icon_height))
+
+ # Get the dimensions of the final image
+ main_height = icon_height + CARD['top'].height + CARD['bottom'].height
+ main_width = CARD['frame'].width
+
+ # Start creating the foreground
+ foreground = Image.new("RGBA", (main_width, main_height), (0, 0, 0, 0))
+ foreground.paste(CARD['top'], (0, 0))
+
+ # Generate the frame borders to the correct height
+ for offset in range(frame_copies):
+ position = (0, CARD['top'].height + offset * CARD['frame'].height)
+ foreground.paste(CARD['frame'], position)
+
+ # Add the image and bottom part of the image
+ foreground.paste(snake, (36, CARD['top'].height)) # Also hardcoded :(
+ foreground.paste(CARD['bottom'], (0, CARD['top'].height + icon_height))
+
+ # Setup the background
+ back = random.choice(CARD['backs'])
+ back_copies = main_height // back.height + 1
+ full_image = Image.new("RGBA", (main_width, main_height), (0, 0, 0, 0))
+
+ # Generate the tiled background
+ for offset in range(back_copies):
+ full_image.paste(back, (16, 16 + offset * back.height))
+
+ # Place the foreground onto the final image
+ full_image.paste(foreground, (0, 0), foreground)
+
+ # Get the first two sentences of the info
+ description = '.'.join(content['info'].split(".")[:2]) + '.'
+
+ # Setup positioning variables
+ margin = 36
+ offset = CARD['top'].height + icon_height + margin
+
+ # Create blank rectangle image which will be behind the text
+ rectangle = Image.new(
+ "RGBA",
+ (main_width, main_height),
+ (0, 0, 0, 0)
+ )
+
+ # Draw a semi-transparent rectangle on it
+ rect = ImageDraw.Draw(rectangle)
+ rect.rectangle(
+ (margin, offset, main_width - margin, main_height - margin),
+ fill=(63, 63, 63, 128)
+ )
+
+ # Paste it onto the final image
+ full_image.paste(rectangle, (0, 0), mask=rectangle)
+
+ # Draw the text onto the final image
+ draw = ImageDraw.Draw(full_image)
+ for line in textwrap.wrap(description, 36):
+ draw.text([margin + 4, offset], line, font=CARD['font'])
+ offset += CARD['font'].getsize(line)[1]
+
+ # Get the image contents as a BufferIO object
+ buffer = BytesIO()
+ full_image.save(buffer, 'PNG')
+ buffer.seek(0)
+
+ return buffer
+
+ @staticmethod
+ def _snakify(message):
+ """
+ Sssnakifffiesss a sstring.
+ """
+ # Replace fricatives with exaggerated snake fricatives.
+ simple_fricatives = [
+ "f", "s", "z", "h",
+ "F", "S", "Z", "H",
+ ]
+ complex_fricatives = [
+ "th", "sh", "Th", "Sh"
+ ]
+
+ for letter in simple_fricatives:
+ if letter.islower():
+ message = message.replace(letter, letter * random.randint(2, 4))
+ else:
+ message = message.replace(letter, (letter * random.randint(2, 4)).title())
+
+ for fricative in complex_fricatives:
+ message = message.replace(fricative, fricative[0] + fricative[1] * random.randint(2, 4))
+
+ return message
+
+ async def _fetch(self, session, url, params=None):
+ """
+ Asyncronous web request helper method.
+ """
+ if params is None:
+ params = {}
+
+ async with async_timeout.timeout(10):
+ async with session.get(url, params=params) as response:
+ return await response.json()
+
+ def _get_random_long_message(self, messages, retries=10):
+ """
+ Fetch a message that's at least 3 words long,
+ but only if it is possible to do so in retries
+ attempts. Else, just return whatever the last
+ message is.
+ """
+ long_message = random.choice(messages)
+ if len(long_message.split()) < 3 and retries > 0:
+ return self._get_random_long_message(
+ messages,
+ retries=retries - 1
+ )
+
+ return long_message
+
+ async def _get_snek(self, name: str) -> Dict[str, Any]:
+ """
+ Goes online and fetches all the data from a wikipedia article
+ about a snake. Builds a dict that the .get() method can use.
+
+ Created by Ava and eivl.
+
+ :param name: The name of the snake to get information for - omit for a random snake
+ :return: A dict containing information on a snake
+ """
+ snake_info = {}
+
+ async with aiohttp.ClientSession() as session:
+ params = {
+ 'format': 'json',
+ 'action': 'query',
+ 'list': 'search',
+ 'srsearch': name,
+ 'utf8': '',
+ 'srlimit': '1',
+ }
+
+ json = await self._fetch(session, URL, params=params)
+
+ # wikipedia does have a error page
+ try:
+ pageid = json["query"]["search"][0]["pageid"]
+ except KeyError:
+ # Wikipedia error page ID(?)
+ pageid = 41118
+ except IndexError:
+ return None
+
+ params = {
+ 'format': 'json',
+ 'action': 'query',
+ 'prop': 'extracts|images|info',
+ 'exlimit': 'max',
+ 'explaintext': '',
+ 'inprop': 'url',
+ 'pageids': pageid
+ }
+
+ json = await self._fetch(session, URL, params=params)
+
+ # constructing dict - handle exceptions later
+ try:
+ snake_info["title"] = json["query"]["pages"][f"{pageid}"]["title"]
+ snake_info["extract"] = json["query"]["pages"][f"{pageid}"]["extract"]
+ snake_info["images"] = json["query"]["pages"][f"{pageid}"]["images"]
+ snake_info["fullurl"] = json["query"]["pages"][f"{pageid}"]["fullurl"]
+ snake_info["pageid"] = json["query"]["pages"][f"{pageid}"]["pageid"]
+ except KeyError:
+ snake_info["error"] = True
+
+ if snake_info["images"]:
+ i_url = 'https://commons.wikimedia.org/wiki/Special:FilePath/'
+ image_list = []
+ map_list = []
+ thumb_list = []
+
+ # Wikipedia has arbitrary images that are not snakes
+ banned = [
+ 'Commons-logo.svg',
+ 'Red%20Pencil%20Icon.png',
+ 'distribution',
+ 'The%20Death%20of%20Cleopatra%20arthur.jpg',
+ 'Head%20of%20holotype',
+ 'locator',
+ 'Woma.png',
+ '-map.',
+ '.svg',
+ 'ange.',
+ 'Adder%20(PSF).png'
+ ]
+
+ for image in snake_info["images"]:
+ # images come in the format of `File:filename.extension`
+ file, sep, filename = image["title"].partition(':')
+ filename = filename.replace(" ", "%20") # Wikipedia returns good data!
+
+ if not filename.startswith('Map'):
+ if any(ban in filename for ban in banned):
+ pass
+ else:
+ image_list.append(f"{i_url}{filename}")
+ thumb_list.append(f"{i_url}{filename}?width=100")
+ else:
+ map_list.append(f"{i_url}{filename}")
+
+ snake_info["image_list"] = image_list
+ snake_info["map_list"] = map_list
+ snake_info["thumb_list"] = thumb_list
+ snake_info["name"] = name
+
+ match = self.wiki_brief.match(snake_info['extract'])
+ info = match.group(1) if match else None
+
+ if info:
+ info = info.replace("\n", "\n\n") # Give us some proper paragraphs.
+
+ snake_info["info"] = info
+
+ return snake_info
+
+ async def _get_snake_name(self) -> Dict[str, str]:
+ """
+ Gets a random snake name.
+ :return: A random snake name, as a string.
+ """
+ return random.choice(self.snake_names)
+
+ async def _validate_answer(self, ctx: Context, message: Message, answer: str, options: list):
+ """
+ Validate the answer using a reaction event loop
+ :return:
+ """
+
+ def predicate(reaction, user):
+ """
+ Test if the the answer is valid and can be evaluated.
+ """
+ return (
+ reaction.message.id == message.id # The reaction is attached to the question we asked.
+ and user == ctx.author # It's the user who triggered the quiz.
+ and str(reaction.emoji) in ANSWERS_EMOJI.values() # The reaction is one of the options.
+ )
+
+ for emoji in ANSWERS_EMOJI.values():
+ await message.add_reaction(emoji)
+
+ # Validate the answer
+ try:
+ reaction, user = await ctx.bot.wait_for("reaction_add", timeout=45.0, check=predicate)
+ except asyncio.TimeoutError:
+ await ctx.channel.send(f"You took too long. The correct answer was **{options[answer]}**.")
+ await message.clear_reactions()
+ return
+
+ if str(reaction.emoji) == ANSWERS_EMOJI[answer]:
+ await ctx.send(f"{random.choice(CORRECT_GUESS)} The correct answer was **{options[answer]}**.")
+ else:
+ await ctx.send(
+ f"{random.choice(INCORRECT_GUESS)} The correct answer was **{options[answer]}**."
+ )
+
+ await message.clear_reactions()
+ # endregion
+
+ # region: Commands
+ @group(name='snakes', aliases=('snake',), invoke_without_command=True)
+ async def snakes_group(self, ctx: Context):
+ """Commands from our first code jam."""
+
+ await ctx.invoke(self.bot.get_command("help"), "snake")
+
+ @bot_has_permissions(manage_messages=True)
+ @snakes_group.command(name='antidote')
+ @locked()
+ async def antidote_command(self, ctx: Context):
+ """
+ Antidote - Can you create the antivenom before the patient dies?
+
+ Rules: You have 4 ingredients for each antidote, you only have 10 attempts
+ Once you synthesize the antidote, you will be presented with 4 markers
+ Tick: This means you have a CORRECT ingredient in the CORRECT position
+ Circle: This means you have a CORRECT ingredient in the WRONG position
+ Cross: This means you have a WRONG ingredient in the WRONG position
+
+ Info: The game automatically ends after 5 minutes inactivity.
+ You should only use each ingredient once.
+
+ This game was created by Lord Bisk and Runew0lf.
+ """
+
+ def predicate(reaction_: Reaction, user_: Member):
+ """
+ Make sure that this reaction is what we want to operate on
+ """
+
+ return (
+ all((
+ # Reaction is on this message
+ reaction_.message.id == board_id.id,
+ # Reaction is one of the pagination emotes
+ reaction_.emoji in ANTIDOTE_EMOJI,
+ # Reaction was not made by the Bot
+ user_.id != self.bot.user.id,
+ # Reaction was made by author
+ user_.id == ctx.author.id
+ ))
+ )
+
+ # Initialize variables
+ antidote_tries = 0
+ antidote_guess_count = 0
+ antidote_guess_list = []
+ guess_result = []
+ board = []
+ page_guess_list = []
+ page_result_list = []
+ win = False
+
+ antidote_embed = Embed(color=SNAKE_COLOR, title="Antidote")
+ antidote_embed.set_author(name=ctx.author.name, icon_url=ctx.author.avatar_url)
+
+ # Generate answer
+ antidote_answer = list(ANTIDOTE_EMOJI) # Duplicate list, not reference it
+ random.shuffle(antidote_answer)
+ antidote_answer.pop()
+
+ # Begin initial board building
+ for i in range(0, 10):
+ page_guess_list.append(f"{HOLE_EMOJI} {HOLE_EMOJI} {HOLE_EMOJI} {HOLE_EMOJI}")
+ page_result_list.append(f"{CROSS_EMOJI} {CROSS_EMOJI} {CROSS_EMOJI} {CROSS_EMOJI}")
+ board.append(f"`{i+1:02d}` "
+ f"{page_guess_list[i]} - "
+ f"{page_result_list[i]}")
+ board.append(EMPTY_UNICODE)
+ antidote_embed.add_field(name="10 guesses remaining", value="\n".join(board))
+ board_id = await ctx.send(embed=antidote_embed) # Display board
+
+ # Add our player reactions
+ for emoji in ANTIDOTE_EMOJI:
+ await board_id.add_reaction(emoji)
+
+ # Begin main game loop
+ while not win and antidote_tries < 10:
+ try:
+ reaction, user = await ctx.bot.wait_for(
+ "reaction_add", timeout=300, check=predicate)
+ except asyncio.TimeoutError:
+ log.debug("Antidote timed out waiting for a reaction")
+ break # We're done, no reactions for the last 5 minutes
+
+ if antidote_tries < 10:
+ if antidote_guess_count < 4:
+ if reaction.emoji in ANTIDOTE_EMOJI:
+ antidote_guess_list.append(reaction.emoji)
+ antidote_guess_count += 1
+
+ if antidote_guess_count == 4: # Guesses complete
+ antidote_guess_count = 0
+ page_guess_list[antidote_tries] = " ".join(antidote_guess_list)
+
+ # Now check guess
+ for i in range(0, len(antidote_answer)):
+ if antidote_guess_list[i] == antidote_answer[i]:
+ guess_result.append(TICK_EMOJI)
+ elif antidote_guess_list[i] in antidote_answer:
+ guess_result.append(BLANK_EMOJI)
+ else:
+ guess_result.append(CROSS_EMOJI)
+ guess_result.sort()
+ page_result_list[antidote_tries] = " ".join(guess_result)
+
+ # Rebuild the board
+ board = []
+ for i in range(0, 10):
+ board.append(f"`{i+1:02d}` "
+ f"{page_guess_list[i]} - "
+ f"{page_result_list[i]}")
+ board.append(EMPTY_UNICODE)
+
+ # Remove Reactions
+ for emoji in antidote_guess_list:
+ await board_id.remove_reaction(emoji, user)
+
+ if antidote_guess_list == antidote_answer:
+ win = True
+
+ antidote_tries += 1
+ guess_result = []
+ antidote_guess_list = []
+
+ antidote_embed.clear_fields()
+ antidote_embed.add_field(name=f"{10 - antidote_tries} "
+ f"guesses remaining",
+ value="\n".join(board))
+ # Redisplay the board
+ await board_id.edit(embed=antidote_embed)
+
+ # Winning / Ending Screen
+ if win is True:
+ antidote_embed = Embed(color=SNAKE_COLOR, title="Antidote")
+ antidote_embed.set_author(name=ctx.author.name, icon_url=ctx.author.avatar_url)
+ antidote_embed.set_image(url="https://i.makeagif.com/media/7-12-2015/Cj1pts.gif")
+ antidote_embed.add_field(name=f"You have created the snake antidote!",
+ value=f"The solution was: {' '.join(antidote_answer)}\n"
+ f"You had {10 - antidote_tries} tries remaining.")
+ await board_id.edit(embed=antidote_embed)
+ else:
+ antidote_embed = Embed(color=SNAKE_COLOR, title="Antidote")
+ antidote_embed.set_author(name=ctx.author.name, icon_url=ctx.author.avatar_url)
+ antidote_embed.set_image(url="https://media.giphy.com/media/ceeN6U57leAhi/giphy.gif")
+ antidote_embed.add_field(name=EMPTY_UNICODE,
+ value=f"Sorry you didnt make the antidote in time.\n"
+ f"The formula was {' '.join(antidote_answer)}")
+ await board_id.edit(embed=antidote_embed)
+
+ log.debug("Ending pagination and removing all reactions...")
+ await board_id.clear_reactions()
+
+ @snakes_group.command(name='draw')
+ async def draw_command(self, ctx: Context):
+ """
+ Draws a random snek using Perlin noise
+
+ Written by Momo and kel.
+ Modified by juan and lemon.
+ """
+
+ with ctx.typing():
+
+ # Generate random snake attributes
+ width = random.randint(6, 10)
+ length = random.randint(15, 22)
+ random_hue = random.random()
+ snek_color = self._beautiful_pastel(random_hue)
+ text_color = self._beautiful_pastel((random_hue + 0.5) % 1)
+ bg_color = (
+ random.randint(32, 50),
+ random.randint(32, 50),
+ random.randint(50, 70),
+ )
+
+ # Build and send the snek
+ text = random.choice(self.snake_idioms)["idiom"]
+ factory = utils.PerlinNoiseFactory(dimension=1, octaves=2)
+ image_frame = utils.create_snek_frame(
+ factory,
+ snake_width=width,
+ snake_length=length,
+ snake_color=snek_color,
+ text=text,
+ text_color=text_color,
+ bg_color=bg_color
+ )
+ png_bytes = utils.frame_to_png_bytes(image_frame)
+ file = File(png_bytes, filename='snek.png')
+ await ctx.send(file=file)
+
+ @snakes_group.command(name='get')
+ @bot_has_permissions(manage_messages=True)
+ @locked()
+ async def get_command(self, ctx: Context, *, name: Snake = None):
+ """
+ Fetches information about a snake from Wikipedia.
+ :param ctx: Context object passed from discord.py
+ :param name: Optional, the name of the snake to get information
+ for - omit for a random snake
+
+ Created by Ava and eivl.
+ """
+ with ctx.typing():
+ if name is None:
+ name = await Snake.random()
+
+ if isinstance(name, dict):
+ data = name
+ else:
+ data = await self._get_snek(name)
+
+ if data.get('error'):
+ return await ctx.send('Could not fetch data from Wikipedia.')
+
+ description = data["info"]
+
+ # Shorten the description if needed
+ if len(description) > 1000:
+ description = description[:1000]
+ last_newline = description.rfind("\n")
+ if last_newline > 0:
+ description = description[:last_newline]
+
+ # Strip and add the Wiki link.
+ if "fullurl" in data:
+ description = description.strip("\n")
+ description += f"\n\nRead more on [Wikipedia]({data['fullurl']})"
+
+ # Build and send the embed.
+ embed = Embed(
+ title=data.get("title", data.get('name')),
+ description=description,
+ colour=0x59982F,
+ )
+
+ emoji = 'https://emojipedia-us.s3.amazonaws.com/thumbs/60/google/3/snake_1f40d.png'
+ image = next((url for url in data['image_list']
+ if url.endswith(self.valid_image_extensions)), emoji)
+ embed.set_image(url=image)
+
+ await ctx.send(embed=embed)
+
+ @snakes_group.command(name='guess', aliases=('identify',))
+ @locked()
+ async def guess_command(self, ctx):
+ """
+ Snake identifying game!
+
+ Made by Ava and eivl.
+ Modified by lemon.
+ """
+ with ctx.typing():
+
+ image = None
+
+ while image is None:
+ snakes = [await Snake.random() for _ in range(4)]
+ snake = random.choice(snakes)
+ answer = "abcd"[snakes.index(snake)]
+
+ data = await self._get_snek(snake)
+
+ image = next((url for url in data['image_list']
+ if url.endswith(self.valid_image_extensions)), None)
+
+ embed = Embed(
+ title='Which of the following is the snake in the image?',
+ description="\n".join(
+ f"{'ABCD'[snakes.index(snake)]}: {snake}" for snake in snakes),
+ colour=SNAKE_COLOR
+ )
+ embed.set_image(url=image)
+
+ guess = await ctx.send(embed=embed)
+ options = {f"{'abcd'[snakes.index(snake)]}": snake for snake in snakes}
+ await self._validate_answer(ctx, guess, answer, options)
+
+ @snakes_group.command(name='hatch')
+ async def hatch_command(self, ctx: Context):
+ """
+ Hatches your personal snake
+
+ Written by Momo and kel.
+ """
+ # Pick a random snake to hatch.
+ snake_name = random.choice(list(utils.snakes.keys()))
+ snake_image = utils.snakes[snake_name]
+
+ # Hatch the snake
+ message = await ctx.channel.send(embed=Embed(description="Hatching your snake :snake:..."))
+ await asyncio.sleep(1)
+
+ for stage in utils.stages:
+ hatch_embed = Embed(description=stage)
+ await message.edit(embed=hatch_embed)
+ await asyncio.sleep(1)
+ await asyncio.sleep(1)
+ await message.delete()
+
+ # Build and send the embed.
+ my_snake_embed = Embed(description=":tada: Congrats! You hatched: **{0}**".format(snake_name))
+ my_snake_embed.set_thumbnail(url=snake_image)
+ my_snake_embed.set_footer(
+ text=" Owner: {0}#{1}".format(ctx.message.author.name, ctx.message.author.discriminator)
+ )
+
+ await ctx.channel.send(embed=my_snake_embed)
+
+ @snakes_group.command(name='movie')
+ async def movie_command(self, ctx: Context):
+ """
+ Gets a random snake-related movie from OMDB.
+
+ Written by Samuel.
+ Modified by gdude.
+ """
+ url = "http://www.omdbapi.com/"
+ page = random.randint(1, 27)
+
+ response = await self.bot.http_session.get(
+ url,
+ params={
+ "s": "snake",
+ "page": page,
+ "type": "movie",
+ "apikey": Tokens.omdb
+ }
+ )
+ data = await response.json()
+ movie = random.choice(data["Search"])["imdbID"]
+
+ response = await self.bot.http_session.get(
+ url,
+ params={
+ "i": movie,
+ "apikey": Tokens.omdb
+ }
+ )
+ data = await response.json()
+
+ embed = Embed(
+ title=data["Title"],
+ color=SNAKE_COLOR
+ )
+
+ del data["Response"], data["imdbID"], data["Title"]
+
+ for key, value in data.items():
+ if not value or value == "N/A" or key in ("Response", "imdbID", "Title", "Type"):
+ continue
+
+ if key == "Ratings": # [{'Source': 'Internet Movie Database', 'Value': '7.6/10'}]
+ rating = random.choice(value)
+
+ if rating["Source"] != "Internet Movie Database":
+ embed.add_field(name=f"Rating: {rating['Source']}", value=rating["Value"])
+
+ continue
+
+ if key == "Poster":
+ embed.set_image(url=value)
+ continue
+
+ elif key == "imdbRating":
+ key = "IMDB Rating"
+
+ elif key == "imdbVotes":
+ key = "IMDB Votes"
+
+ embed.add_field(name=key, value=value, inline=True)
+
+ embed.set_footer(text="Data provided by the OMDB API")
+
+ await ctx.channel.send(
+ embed=embed
+ )
+
+ @snakes_group.command(name='quiz')
+ @locked()
+ async def quiz_command(self, ctx: Context):
+ """
+ Asks a snake-related question in the chat and validates the user's guess.
+
+ This was created by Mushy and Cardium,
+ and modified by Urthas and lemon.
+ """
+ # Prepare a question.
+ question = random.choice(self.snake_quizzes)
+ answer = question["answerkey"]
+ options = {key: question["options"][key] for key in ANSWERS_EMOJI.keys()}
+
+ # Build and send the embed.
+ embed = Embed(
+ color=SNAKE_COLOR,
+ title=question["question"],
+ description="\n".join(
+ [f"**{key.upper()}**: {answer}" for key, answer in options.items()]
+ )
+ )
+
+ quiz = await ctx.channel.send("", embed=embed)
+ await self._validate_answer(ctx, quiz, answer, options)
+
+ @snakes_group.command(name='name', aliases=('name_gen',))
+ async def name_command(self, ctx: Context, *, name: str = None):
+ """
+ Slices the users name at the last vowel (or second last if the name
+ ends with a vowel), and then combines it with a random snake name,
+ which is sliced at the first vowel (or second if the name starts with
+ a vowel).
+
+ If the name contains no vowels, it just appends the snakename
+ to the end of the name.
+
+ Examples:
+ lemon + anaconda = lemoconda
+ krzsn + anaconda = krzsnconda
+ gdude + anaconda = gduconda
+ aperture + anaconda = apertuconda
+ lucy + python = luthon
+ joseph + taipan = joseipan
+
+ This was written by Iceman, and modified for inclusion into the bot by lemon.
+ """
+ snake_name = await self._get_snake_name()
+ snake_name = snake_name['name']
+ snake_prefix = ""
+
+ # Set aside every word in the snake name except the last.
+ if " " in snake_name:
+ snake_prefix = " ".join(snake_name.split()[:-1])
+ snake_name = snake_name.split()[-1]
+
+ # If no name is provided, use whoever called the command.
+ if name:
+ user_name = name
+ else:
+ user_name = ctx.author.display_name
+
+ # Get the index of the vowel to slice the username at
+ user_slice_index = len(user_name)
+ for index, char in enumerate(reversed(user_name)):
+ if index == 0:
+ continue
+ if char.lower() in "aeiouy":
+ user_slice_index -= index
+ break
+
+ # Now, get the index of the vowel to slice the snake_name at
+ snake_slice_index = 0
+ for index, char in enumerate(snake_name):
+ if index == 0:
+ continue
+ if char.lower() in "aeiouy":
+ snake_slice_index = index + 1
+ break
+
+ # Combine!
+ snake_name = snake_name[snake_slice_index:]
+ user_name = user_name[:user_slice_index]
+ result = f"{snake_prefix} {user_name}{snake_name}"
+ result = string.capwords(result)
+
+ # Embed and send
+ embed = Embed(
+ title="Snake name",
+ description=f"Your snake-name is **{result}**",
+ color=SNAKE_COLOR
+ )
+
+ return await ctx.send(embed=embed)
+
+ @snakes_group.command(name='sal')
+ @locked()
+ async def sal_command(self, ctx: Context):
+ """
+ Play a game of Snakes and Ladders!
+
+ Written by Momo and kel.
+ Modified by lemon.
+ """
+ # check if there is already a game in this channel
+ if ctx.channel in self.active_sal:
+ await ctx.send(f"{ctx.author.mention} A game is already in progress in this channel.")
+ return
+
+ game = utils.SnakeAndLaddersGame(snakes=self, context=ctx)
+ self.active_sal[ctx.channel] = game
+
+ await game.open_game()
+
+ @snakes_group.command(name='about')
+ async def about_command(self, ctx: Context):
+ """
+ A command that shows an embed with information about the event,
+ it's participants, and its winners.
+ """
+ contributors = [
+ "<@!245270749919576066>",
+ "<@!396290259907903491>",
+ "<@!172395097705414656>",
+ "<@!361708843425726474>",
+ "<@!300302216663793665>",
+ "<@!210248051430916096>",
+ "<@!174588005745557505>",
+ "<@!87793066227822592>",
+ "<@!211619754039967744>",
+ "<@!97347867923976192>",
+ "<@!136081839474343936>",
+ "<@!263560579770220554>",
+ "<@!104749643715387392>",
+ "<@!303940835005825024>",
+ ]
+
+ embed = Embed(
+ title="About the snake cog",
+ description=(
+ "The features in this cog were created by members of the community "
+ "during our first ever [code jam event](https://gitlab.com/discord-python/code-jams/code-jam-1). \n\n"
+ "The event saw over 50 participants, who competed to write a discord bot cog with a snake theme over "
+ "48 hours. The staff then selected the best features from all the best teams, and made modifications "
+ "to ensure they would all work together before integrating them into the community bot.\n\n"
+ "It was a tight race, but in the end, <@!104749643715387392> and <@!303940835005825024> "
+ "walked away as grand champions. Make sure you check out `!snakes sal`, `!snakes draw` "
+ "and `!snakes hatch` to see what they came up with."
+ )
+ )
+
+ embed.add_field(
+ name="Contributors",
+ value=(
+ ", ".join(contributors)
+ )
+ )
+
+ await ctx.channel.send(embed=embed)
+
+ @snakes_group.command(name='card')
+ async def card_command(self, ctx: Context, *, name: Snake = None):
+ """
+ Create an interesting little card from a snake!
+
+ Created by juan and Someone during the first code jam.
+ """
+ # Get the snake data we need
+ if not name:
+ name_obj = await self._get_snake_name()
+ name = name_obj['scientific']
+ content = await self._get_snek(name)
+
+ elif isinstance(name, dict):
+ content = name
+
+ else:
+ content = await self._get_snek(name)
+
+ # Make the card
+ async with ctx.typing():
+
+ stream = BytesIO()
+ async with async_timeout.timeout(10):
+ async with self.bot.http_session.get(content['image_list'][0]) as response:
+ stream.write(await response.read())
+
+ stream.seek(0)
+
+ func = partial(self._generate_card, stream, content)
+ final_buffer = await self.bot.loop.run_in_executor(None, func)
+
+ # Send it!
+ await ctx.send(
+ f"A wild {content['name'].title()} appears!",
+ file=File(final_buffer, filename=content['name'].replace(" ", "") + ".png")
+ )
+
+ @snakes_group.command(name='fact')
+ async def fact_command(self, ctx: Context):
+ """
+ Gets a snake-related fact
+
+ Written by Andrew and Prithaj.
+ Modified by lemon.
+ """
+ question = random.choice(self.snake_facts)["fact"]
+ embed = Embed(
+ title="Snake fact",
+ color=SNAKE_COLOR,
+ description=question
+ )
+ await ctx.channel.send(embed=embed)
+
+ @snakes_group.command(name='help')
+ async def help_command(self, ctx: Context):
+ """
+ This just invokes the help command on this cog.
+ """
+ log.debug(f"{ctx.author} requested info about the snakes cog")
+ return await ctx.invoke(self.bot.get_command("help"), "Snakes")
+
+ @snakes_group.command(name='snakify')
+ async def snakify_command(self, ctx: Context, *, message: str = None):
+ """
+ How would I talk if I were a snake?
+ :param ctx: context
+ :param message: If this is passed, it will snakify the message.
+ If not, it will snakify a random message from
+ the users history.
+
+ Written by Momo and kel.
+ Modified by lemon.
+ """
+ with ctx.typing():
+ embed = Embed()
+ user = ctx.message.author
+
+ if not message:
+
+ # Get a random message from the users history
+ messages = []
+ async for message in ctx.channel.history(limit=500).filter(
+ lambda msg: msg.author == ctx.message.author # Message was sent by author.
+ ):
+ messages.append(message.content)
+
+ message = self._get_random_long_message(messages)
+
+ # Set the avatar
+ if user.avatar is not None:
+ avatar = f"https://cdn.discordapp.com/avatars/{user.id}/{user.avatar}"
+ else:
+ avatar = ctx.author.default_avatar_url
+
+ # Build and send the embed
+ embed.set_author(
+ name=f"{user.name}#{user.discriminator}",
+ icon_url=avatar,
+ )
+ embed.description = f"*{self._snakify(message)}*"
+
+ await ctx.channel.send(embed=embed)
+
+ @snakes_group.command(name='video', aliases=('get_video',))
+ async def video_command(self, ctx: Context, *, search: str = None):
+ """
+ Gets a YouTube video about snakes
+
+ :param ctx: Context object passed from discord.py
+ :param search: Optional, a name of a snake. Used to search for videos with that name
+
+ Written by Andrew and Prithaj.
+ """
+ # Are we searching for anything specific?
+ if search:
+ query = search + ' snake'
+ else:
+ snake = await self._get_snake_name()
+ query = snake['name']
+
+ # Build the URL and make the request
+ url = f'https://www.googleapis.com/youtube/v3/search'
+ response = await self.bot.http_session.get(
+ url,
+ params={
+ "part": "snippet",
+ "q": urllib.parse.quote(query),
+ "type": "video",
+ "key": Tokens.youtube
+ }
+ )
+ response = await response.json()
+ data = response['items']
+
+ # Send the user a video
+ if len(data) > 0:
+ num = random.randint(0, len(data) - 1)
+ youtube_base_url = 'https://www.youtube.com/watch?v='
+ await ctx.channel.send(
+ content=f"{youtube_base_url}{data[num]['id']['videoId']}"
+ )
+ else:
+ log.warning(f"YouTube API error. Full response looks like {response}")
+
+ @snakes_group.command(name='zen')
+ async def zen_command(self, ctx: Context):
+ """
+ Gets a random quote from the Zen of Python,
+ except as if spoken by a snake.
+
+ Written by Prithaj and Andrew.
+ Modified by lemon.
+ """
+ embed = Embed(
+ title="Zzzen of Pythhon",
+ color=SNAKE_COLOR
+ )
+
+ # Get the zen quote and snakify it
+ zen_quote = random.choice(ZEN.splitlines())
+ zen_quote = self._snakify(zen_quote)
+
+ # Embed and send
+ embed.description = zen_quote
+ await ctx.channel.send(
+ embed=embed
+ )
+ # endregion
+
+ # region: Error handlers
+ @get_command.error
+ @card_command.error
+ @video_command.error
+ async def command_error(self, ctx, error):
+
+ embed = Embed()
+ embed.colour = Colour.red()
+
+ if isinstance(error, BadArgument):
+ embed.description = str(error)
+ embed.title = random.choice(ERROR_REPLIES)
+
+ elif isinstance(error, OSError):
+ log.error(f"snake_card encountered an OSError: {error} ({error.original})")
+ embed.description = "Could not generate the snake card! Please try again."
+ embed.title = random.choice(ERROR_REPLIES)
+
+ else:
+ log.error(f"Unhandled tag command error: {error} ({error.original})")
+ return
+
+ await ctx.send(embed=embed)
+ # endregion
+
+
+def setup(bot):
+ bot.add_cog(Snakes(bot))
+ log.info("Cog loaded: Snakes")
diff --git a/bot/seasons/evergreen/snakes/utils.py b/bot/seasons/evergreen/snakes/utils.py
new file mode 100644
index 00000000..605c7ef3
--- /dev/null
+++ b/bot/seasons/evergreen/snakes/utils.py
@@ -0,0 +1,700 @@
+"""
+Perlin noise implementation.
+Taken from: https://gist.github.com/eevee/26f547457522755cb1fb8739d0ea89a1
+Licensed under ISC
+"""
+import asyncio
+import io
+import json
+import logging
+import math
+import random
+from itertools import product
+from pathlib import Path
+from typing import List, Tuple
+
+import aiohttp
+from PIL import Image
+from PIL.ImageDraw import ImageDraw
+from discord import File, Member, Reaction
+from discord.ext.commands import Context
+
+SNAKE_RESOURCES = Path('bot', 'resources', 'snakes').absolute()
+
+h1 = r'''```
+ ----
+ ------
+ /--------\
+ |--------|
+ |--------|
+ \------/
+ ----```'''
+h2 = r'''```
+ ----
+ ------
+ /---\-/--\
+ |-----\--|
+ |--------|
+ \------/
+ ----```'''
+h3 = r'''```
+ ----
+ ------
+ /---\-/--\
+ |-----\--|
+ |-----/--|
+ \----\-/
+ ----```'''
+h4 = r'''```
+ -----
+ ----- \
+ /--| /---\
+ |--\ -\---|
+ |--\--/-- /
+ \------- /
+ ------```'''
+stages = [h1, h2, h3, h4]
+snakes = {
+ "Baby Python": "https://i.imgur.com/SYOcmSa.png",
+ "Baby Rattle Snake": "https://i.imgur.com/i5jYA8f.png",
+ "Baby Dragon Snake": "https://i.imgur.com/SuMKM4m.png",
+ "Baby Garden Snake": "https://i.imgur.com/5vYx3ah.png",
+ "Baby Cobra": "https://i.imgur.com/jk14ryt.png"
+}
+
+BOARD_TILE_SIZE = 56 # the size of each board tile
+BOARD_PLAYER_SIZE = 20 # the size of each player icon
+BOARD_MARGIN = (10, 0) # margins, in pixels (for player icons)
+# The size of the image to download
+# Should a power of 2 and higher than BOARD_PLAYER_SIZE
+PLAYER_ICON_IMAGE_SIZE = 32
+MAX_PLAYERS = 4 # depends on the board size/quality, 4 is for the default board
+
+# board definition (from, to)
+BOARD = {
+ # ladders
+ 2: 38,
+ 7: 14,
+ 8: 31,
+ 15: 26,
+ 21: 42,
+ 28: 84,
+ 36: 44,
+ 51: 67,
+ 71: 91,
+ 78: 98,
+ 87: 94,
+
+ # snakes
+ 99: 80,
+ 95: 75,
+ 92: 88,
+ 89: 68,
+ 74: 53,
+ 64: 60,
+ 62: 19,
+ 49: 11,
+ 46: 25,
+ 16: 6
+}
+
+DEFAULT_SNAKE_COLOR: int = 0x15c7ea
+DEFAULT_BACKGROUND_COLOR: int = 0
+DEFAULT_IMAGE_DIMENSIONS: Tuple[int] = (200, 200)
+DEFAULT_SNAKE_LENGTH: int = 22
+DEFAULT_SNAKE_WIDTH: int = 8
+DEFAULT_SEGMENT_LENGTH_RANGE: Tuple[int] = (7, 10)
+DEFAULT_IMAGE_MARGINS: Tuple[int] = (50, 50)
+DEFAULT_TEXT: str = "snek\nit\nup"
+DEFAULT_TEXT_POSITION: Tuple[int] = (
+ 10,
+ 10
+)
+DEFAULT_TEXT_COLOR: int = 0xf2ea15
+X = 0
+Y = 1
+ANGLE_RANGE = math.pi * 2
+
+
+def get_resource(file: str) -> List[dict]:
+ with (SNAKE_RESOURCES / f"{file}.json").open() as snakefile:
+ return json.load(snakefile)
+
+
+def smoothstep(t):
+ """Smooth curve with a zero derivative at 0 and 1, making it useful for
+ interpolating.
+ """
+ return t * t * (3. - 2. * t)
+
+
+def lerp(t, a, b):
+ """Linear interpolation between a and b, given a fraction t."""
+ return a + t * (b - a)
+
+
+class PerlinNoiseFactory(object):
+ """Callable that produces Perlin noise for an arbitrary point in an
+ arbitrary number of dimensions. The underlying grid is aligned with the
+ integers.
+ There is no limit to the coordinates used; new gradients are generated on
+ the fly as necessary.
+ """
+
+ def __init__(self, dimension, octaves=1, tile=(), unbias=False):
+ """Create a new Perlin noise factory in the given number of dimensions,
+ which should be an integer and at least 1.
+ More octaves create a foggier and more-detailed noise pattern. More
+ than 4 octaves is rather excessive.
+ ``tile`` can be used to make a seamlessly tiling pattern. For example:
+ pnf = PerlinNoiseFactory(2, tile=(0, 3))
+ This will produce noise that tiles every 3 units vertically, but never
+ tiles horizontally.
+ If ``unbias`` is true, the smoothstep function will be applied to the
+ output before returning it, to counteract some of Perlin noise's
+ significant bias towards the center of its output range.
+ """
+ self.dimension = dimension
+ self.octaves = octaves
+ self.tile = tile + (0,) * dimension
+ self.unbias = unbias
+
+ # For n dimensions, the range of Perlin noise is ±sqrt(n)/2; multiply
+ # by this to scale to ±1
+ self.scale_factor = 2 * dimension ** -0.5
+
+ self.gradient = {}
+
+ def _generate_gradient(self):
+ # Generate a random unit vector at each grid point -- this is the
+ # "gradient" vector, in that the grid tile slopes towards it
+
+ # 1 dimension is special, since the only unit vector is trivial;
+ # instead, use a slope between -1 and 1
+ if self.dimension == 1:
+ return (random.uniform(-1, 1),)
+
+ # Generate a random point on the surface of the unit n-hypersphere;
+ # this is the same as a random unit vector in n dimensions. Thanks
+ # to: http://mathworld.wolfram.com/SpherePointPicking.html
+ # Pick n normal random variables with stddev 1
+ random_point = [random.gauss(0, 1) for _ in range(self.dimension)]
+ # Then scale the result to a unit vector
+ scale = sum(n * n for n in random_point) ** -0.5
+ return tuple(coord * scale for coord in random_point)
+
+ def get_plain_noise(self, *point):
+ """Get plain noise for a single point, without taking into account
+ either octaves or tiling.
+ """
+ if len(point) != self.dimension:
+ raise ValueError("Expected {0} values, got {1}".format(
+ self.dimension, len(point)))
+
+ # Build a list of the (min, max) bounds in each dimension
+ grid_coords = []
+ for coord in point:
+ min_coord = math.floor(coord)
+ max_coord = min_coord + 1
+ grid_coords.append((min_coord, max_coord))
+
+ # Compute the dot product of each gradient vector and the point's
+ # distance from the corresponding grid point. This gives you each
+ # gradient's "influence" on the chosen point.
+ dots = []
+ for grid_point in product(*grid_coords):
+ if grid_point not in self.gradient:
+ self.gradient[grid_point] = self._generate_gradient()
+ gradient = self.gradient[grid_point]
+
+ dot = 0
+ for i in range(self.dimension):
+ dot += gradient[i] * (point[i] - grid_point[i])
+ dots.append(dot)
+
+ # Interpolate all those dot products together. The interpolation is
+ # done with smoothstep to smooth out the slope as you pass from one
+ # grid cell into the next.
+ # Due to the way product() works, dot products are ordered such that
+ # the last dimension alternates: (..., min), (..., max), etc. So we
+ # can interpolate adjacent pairs to "collapse" that last dimension. Then
+ # the results will alternate in their second-to-last dimension, and so
+ # forth, until we only have a single value left.
+ dim = self.dimension
+ while len(dots) > 1:
+ dim -= 1
+ s = smoothstep(point[dim] - grid_coords[dim][0])
+
+ next_dots = []
+ while dots:
+ next_dots.append(lerp(s, dots.pop(0), dots.pop(0)))
+
+ dots = next_dots
+
+ return dots[0] * self.scale_factor
+
+ def __call__(self, *point):
+ """Get the value of this Perlin noise function at the given point. The
+ number of values given should match the number of dimensions.
+ """
+ ret = 0
+ for o in range(self.octaves):
+ o2 = 1 << o
+ new_point = []
+ for i, coord in enumerate(point):
+ coord *= o2
+ if self.tile[i]:
+ coord %= self.tile[i] * o2
+ new_point.append(coord)
+ ret += self.get_plain_noise(*new_point) / o2
+
+ # Need to scale n back down since adding all those extra octaves has
+ # probably expanded it beyond ±1
+ # 1 octave: ±1
+ # 2 octaves: ±1½
+ # 3 octaves: ±1¾
+ ret /= 2 - 2 ** (1 - self.octaves)
+
+ if self.unbias:
+ # The output of the plain Perlin noise algorithm has a fairly
+ # strong bias towards the center due to the central limit theorem
+ # -- in fact the top and bottom 1/8 virtually never happen. That's
+ # a quarter of our entire output range! If only we had a function
+ # in [0..1] that could introduce a bias towards the endpoints...
+ r = (ret + 1) / 2
+ # Doing it this many times is a completely made-up heuristic.
+ for _ in range(int(self.octaves / 2 + 0.5)):
+ r = smoothstep(r)
+ ret = r * 2 - 1
+
+ return ret
+
+
+def create_snek_frame(
+ perlin_factory: PerlinNoiseFactory, perlin_lookup_vertical_shift: float = 0,
+ image_dimensions: Tuple[int] = DEFAULT_IMAGE_DIMENSIONS, image_margins: Tuple[int] = DEFAULT_IMAGE_MARGINS,
+ snake_length: int = DEFAULT_SNAKE_LENGTH,
+ snake_color: int = DEFAULT_SNAKE_COLOR, bg_color: int = DEFAULT_BACKGROUND_COLOR,
+ segment_length_range: Tuple[int] = DEFAULT_SEGMENT_LENGTH_RANGE, snake_width: int = DEFAULT_SNAKE_WIDTH,
+ text: str = DEFAULT_TEXT, text_position: Tuple[int] = DEFAULT_TEXT_POSITION,
+ text_color: Tuple[int] = DEFAULT_TEXT_COLOR
+) -> Image:
+ """
+ Creates a single random snek frame using Perlin noise.
+ :param perlin_factory: the perlin noise factory used. Required.
+ :param perlin_lookup_vertical_shift: the Perlin noise shift in the Y-dimension for this frame
+ :param image_dimensions: the size of the output image.
+ :param image_margins: the margins to respect inside of the image.
+ :param snake_length: the length of the snake, in segments.
+ :param snake_color: the color of the snake.
+ :param bg_color: the background color.
+ :param segment_length_range: the range of the segment length. Values will be generated inside this range, including
+ the bounds.
+ :param snake_width: the width of the snek, in pixels.
+ :param text: the text to display with the snek. Set to None for no text.
+ :param text_position: the position of the text.
+ :param text_color: the color of the text.
+ :return: a PIL image, representing a single frame.
+ """
+ start_x = random.randint(image_margins[X], image_dimensions[X] - image_margins[X])
+ start_y = random.randint(image_margins[Y], image_dimensions[Y] - image_margins[Y])
+ points = [(start_x, start_y)]
+
+ for index in range(0, snake_length):
+ angle = perlin_factory.get_plain_noise(
+ ((1 / (snake_length + 1)) * (index + 1)) + perlin_lookup_vertical_shift
+ ) * ANGLE_RANGE
+ current_point = points[index]
+ segment_length = random.randint(segment_length_range[0], segment_length_range[1])
+ points.append((
+ current_point[X] + segment_length * math.cos(angle),
+ current_point[Y] + segment_length * math.sin(angle)
+ ))
+
+ # normalize bounds
+ min_dimensions = [start_x, start_y]
+ max_dimensions = [start_x, start_y]
+ for point in points:
+ min_dimensions[X] = min(point[X], min_dimensions[X])
+ min_dimensions[Y] = min(point[Y], min_dimensions[Y])
+ max_dimensions[X] = max(point[X], max_dimensions[X])
+ max_dimensions[Y] = max(point[Y], max_dimensions[Y])
+
+ # shift towards middle
+ dimension_range = (max_dimensions[X] - min_dimensions[X], max_dimensions[Y] - min_dimensions[Y])
+ shift = (
+ image_dimensions[X] / 2 - (dimension_range[X] / 2 + min_dimensions[X]),
+ image_dimensions[Y] / 2 - (dimension_range[Y] / 2 + min_dimensions[Y])
+ )
+
+ image = Image.new(mode='RGB', size=image_dimensions, color=bg_color)
+ draw = ImageDraw(image)
+ for index in range(1, len(points)):
+ point = points[index]
+ previous = points[index - 1]
+ draw.line(
+ (
+ shift[X] + previous[X],
+ shift[Y] + previous[Y],
+ shift[X] + point[X],
+ shift[Y] + point[Y]
+ ),
+ width=snake_width,
+ fill=snake_color
+ )
+ if text is not None:
+ draw.multiline_text(text_position, text, fill=text_color)
+ del draw
+ return image
+
+
+def frame_to_png_bytes(image: Image):
+ stream = io.BytesIO()
+ image.save(stream, format='PNG')
+ return stream.getvalue()
+
+
+log = logging.getLogger(__name__)
+START_EMOJI = "\u2611" # :ballot_box_with_check: - Start the game
+CANCEL_EMOJI = "\u274C" # :x: - Cancel or leave the game
+ROLL_EMOJI = "\U0001F3B2" # :game_die: - Roll the die!
+JOIN_EMOJI = "\U0001F64B" # :raising_hand: - Join the game.
+STARTUP_SCREEN_EMOJI = [
+ JOIN_EMOJI,
+ START_EMOJI,
+ CANCEL_EMOJI
+]
+GAME_SCREEN_EMOJI = [
+ ROLL_EMOJI,
+ CANCEL_EMOJI
+]
+
+
+class SnakeAndLaddersGame:
+ def __init__(self, snakes, context: Context):
+ self.snakes = snakes
+ self.ctx = context
+ self.channel = self.ctx.channel
+ self.state = 'booting'
+ self.started = False
+ self.author = self.ctx.author
+ self.players = []
+ self.player_tiles = {}
+ self.round_has_rolled = {}
+ self.avatar_images = {}
+ self.board = None
+ self.positions = None
+ self.rolls = []
+
+ async def open_game(self):
+ """
+ Create a new Snakes and Ladders game.
+
+ Listen for reactions until players have joined,
+ and the game has been started.
+ """
+ def startup_event_check(reaction_: Reaction, user_: Member):
+ """
+ Make sure that this reaction is what we want to operate on
+ """
+ return (
+ all((
+ reaction_.message.id == startup.id, # Reaction is on startup message
+ reaction_.emoji in STARTUP_SCREEN_EMOJI, # Reaction is one of the startup emotes
+ user_.id != self.ctx.bot.user.id, # Reaction was not made by the bot
+ ))
+ )
+
+ # Check to see if the bot can remove reactions
+ if not self.channel.permissions_for(self.ctx.guild.me).manage_messages:
+ log.warning(
+ "Unable to start Snakes and Ladders - "
+ f"Missing manage_messages permissions in {self.channel}"
+ )
+ return
+
+ await self._add_player(self.author)
+ await self.channel.send(
+ "**Snakes and Ladders**: A new game is about to start!",
+ file=File(
+ str(SNAKE_RESOURCES / "snakes_and_ladders" / "banner.jpg"),
+ # os.path.join("bot", "resources", "snakes", "snakes_and_ladders", "banner.jpg"),
+ filename='Snakes and Ladders.jpg'
+ )
+ )
+ startup = await self.channel.send(
+ f"Press {JOIN_EMOJI} to participate, and press "
+ f"{START_EMOJI} to start the game"
+ )
+ for emoji in STARTUP_SCREEN_EMOJI:
+ await startup.add_reaction(emoji)
+
+ self.state = 'waiting'
+
+ while not self.started:
+ try:
+ reaction, user = await self.ctx.bot.wait_for(
+ "reaction_add",
+ timeout=300,
+ check=startup_event_check
+ )
+ if reaction.emoji == JOIN_EMOJI:
+ await self.player_join(user)
+ elif reaction.emoji == CANCEL_EMOJI:
+ if self.ctx.author == user:
+ await self.cancel_game(user)
+ return
+ else:
+ await self.player_leave(user)
+ elif reaction.emoji == START_EMOJI:
+ if self.ctx.author == user:
+ self.started = True
+ await self.start_game(user)
+ await startup.delete()
+ break
+
+ await startup.remove_reaction(reaction.emoji, user)
+
+ except asyncio.TimeoutError:
+ log.debug("Snakes and Ladders timed out waiting for a reaction")
+ self.cancel_game(self.author)
+ return # We're done, no reactions for the last 5 minutes
+
+ async def _add_player(self, user: Member):
+ self.players.append(user)
+ self.player_tiles[user.id] = 1
+ avatar_url = user.avatar_url_as(format='jpeg', size=PLAYER_ICON_IMAGE_SIZE)
+ async with aiohttp.ClientSession() as session:
+ async with session.get(avatar_url) as res:
+ avatar_bytes = await res.read()
+ im = Image.open(io.BytesIO(avatar_bytes)).resize((BOARD_PLAYER_SIZE, BOARD_PLAYER_SIZE))
+ self.avatar_images[user.id] = im
+
+ async def player_join(self, user: Member):
+ for p in self.players:
+ if user == p:
+ await self.channel.send(user.mention + " You are already in the game.", delete_after=10)
+ return
+ if self.state != 'waiting':
+ await self.channel.send(user.mention + " You cannot join at this time.", delete_after=10)
+ return
+ if len(self.players) is MAX_PLAYERS:
+ await self.channel.send(user.mention + " The game is full!", delete_after=10)
+ return
+
+ await self._add_player(user)
+
+ await self.channel.send(
+ f"**Snakes and Ladders**: {user.mention} has joined the game.\n"
+ f"There are now {str(len(self.players))} players in the game.",
+ delete_after=10
+ )
+
+ async def player_leave(self, user: Member):
+ if user == self.author:
+ await self.channel.send(
+ user.mention + " You are the author, and cannot leave the game. Execute "
+ "`sal cancel` to cancel the game.",
+ delete_after=10
+ )
+ return
+ for p in self.players:
+ if user == p:
+ self.players.remove(p)
+ self.player_tiles.pop(p.id, None)
+ self.round_has_rolled.pop(p.id, None)
+ await self.channel.send(
+ "**Snakes and Ladders**: " + user.mention + " has left the game.",
+ delete_after=10
+ )
+
+ if self.state != 'waiting' and len(self.players) == 1:
+ await self.channel.send("**Snakes and Ladders**: The game has been surrendered!")
+ self._destruct()
+ return
+ await self.channel.send(user.mention + " You are not in the match.", delete_after=10)
+
+ async def cancel_game(self, user: Member):
+ if not user == self.author:
+ await self.channel.send(user.mention + " Only the author of the game can cancel it.", delete_after=10)
+ return
+ await self.channel.send("**Snakes and Ladders**: Game has been canceled.")
+ self._destruct()
+
+ async def start_game(self, user: Member):
+ if not user == self.author:
+ await self.channel.send(user.mention + " Only the author of the game can start it.", delete_after=10)
+ return
+ if len(self.players) < 1:
+ await self.channel.send(
+ user.mention + " A minimum of 2 players is required to start the game.",
+ delete_after=10
+ )
+ return
+ if not self.state == 'waiting':
+ await self.channel.send(user.mention + " The game cannot be started at this time.", delete_after=10)
+ return
+ self.state = 'starting'
+ player_list = ', '.join(user.mention for user in self.players)
+ await self.channel.send("**Snakes and Ladders**: The game is starting!\nPlayers: " + player_list)
+ await self.start_round()
+
+ async def start_round(self):
+ def game_event_check(reaction_: Reaction, user_: Member):
+ """
+ Make sure that this reaction is what we want to operate on
+ """
+ return (
+ all((
+ reaction_.message.id == self.positions.id, # Reaction is on positions message
+ reaction_.emoji in GAME_SCREEN_EMOJI, # Reaction is one of the game emotes
+ user_.id != self.ctx.bot.user.id, # Reaction was not made by the bot
+ ))
+ )
+
+ self.state = 'roll'
+ for user in self.players:
+ self.round_has_rolled[user.id] = False
+ # board_img = Image.open(os.path.join(
+ # "bot", "resources", "snakes", "snakes_and_ladders", "board.jpg"))
+ board_img = Image.open(str(SNAKE_RESOURCES / "snakes_and_ladders" / "board.jpg"))
+ player_row_size = math.ceil(MAX_PLAYERS / 2)
+
+ for i, player in enumerate(self.players):
+ tile = self.player_tiles[player.id]
+ tile_coordinates = self._board_coordinate_from_index(tile)
+ x_offset = BOARD_MARGIN[0] + tile_coordinates[0] * BOARD_TILE_SIZE
+ y_offset = \
+ BOARD_MARGIN[1] + (
+ (10 * BOARD_TILE_SIZE) - (9 - tile_coordinates[1]) * BOARD_TILE_SIZE - BOARD_PLAYER_SIZE)
+ x_offset += BOARD_PLAYER_SIZE * (i % player_row_size)
+ y_offset -= BOARD_PLAYER_SIZE * math.floor(i / player_row_size)
+ board_img.paste(self.avatar_images[player.id],
+ box=(x_offset, y_offset))
+ stream = io.BytesIO()
+ board_img.save(stream, format='JPEG')
+ board_file = File(stream.getvalue(), filename='Board.jpg')
+ player_list = '\n'.join((user.mention + ": Tile " + str(self.player_tiles[user.id])) for user in self.players)
+
+ # Store and send new messages
+ temp_board = await self.channel.send(
+ "**Snakes and Ladders**: A new round has started! Current board:",
+ file=board_file
+ )
+ temp_positions = await self.channel.send(
+ f"**Current positions**:\n{player_list}\n\nUse {ROLL_EMOJI} to roll the dice!"
+ )
+
+ # Delete the previous messages
+ if self.board and self.positions:
+ await self.board.delete()
+ await self.positions.delete()
+
+ # remove the roll messages
+ for roll in self.rolls:
+ await roll.delete()
+ self.rolls = []
+
+ # Save new messages
+ self.board = temp_board
+ self.positions = temp_positions
+
+ # Wait for rolls
+ for emoji in GAME_SCREEN_EMOJI:
+ await self.positions.add_reaction(emoji)
+
+ while True:
+ try:
+ reaction, user = await self.ctx.bot.wait_for(
+ "reaction_add",
+ timeout=300,
+ check=game_event_check
+ )
+
+ if reaction.emoji == ROLL_EMOJI:
+ await self.player_roll(user)
+ elif reaction.emoji == CANCEL_EMOJI:
+ if self.ctx.author == user:
+ await self.cancel_game(user)
+ return
+ else:
+ await self.player_leave(user)
+
+ await self.positions.remove_reaction(reaction.emoji, user)
+
+ if self._check_all_rolled():
+ break
+
+ except asyncio.TimeoutError:
+ log.debug("Snakes and Ladders timed out waiting for a reaction")
+ await self.cancel_game(self.author)
+ return # We're done, no reactions for the last 5 minutes
+
+ # Round completed
+ await self._complete_round()
+
+ async def player_roll(self, user: Member):
+ if user.id not in self.player_tiles:
+ await self.channel.send(user.mention + " You are not in the match.", delete_after=10)
+ return
+ if self.state != 'roll':
+ await self.channel.send(user.mention + " You may not roll at this time.", delete_after=10)
+ return
+ if self.round_has_rolled[user.id]:
+ return
+ roll = random.randint(1, 6)
+ self.rolls.append(await self.channel.send(f"{user.mention} rolled a **{roll}**!"))
+ next_tile = self.player_tiles[user.id] + roll
+
+ # apply snakes and ladders
+ if next_tile in BOARD:
+ target = BOARD[next_tile]
+ if target < next_tile:
+ await self.channel.send(
+ f"{user.mention} slips on a snake and falls back to **{target}**",
+ delete_after=15
+ )
+ else:
+ await self.channel.send(
+ f"{user.mention} climbs a ladder to **{target}**",
+ delete_after=15
+ )
+ next_tile = target
+
+ self.player_tiles[user.id] = min(100, next_tile)
+ self.round_has_rolled[user.id] = True
+
+ async def _complete_round(self):
+ self.state = 'post_round'
+
+ # check for winner
+ winner = self._check_winner()
+ if winner is None:
+ # there is no winner, start the next round
+ await self.start_round()
+ return
+
+ # announce winner and exit
+ await self.channel.send("**Snakes and Ladders**: " + winner.mention + " has won the game! :tada:")
+ self._destruct()
+
+ def _check_winner(self) -> Member:
+ if self.state != 'post_round':
+ return None
+ return next((player for player in self.players if self.player_tiles[player.id] == 100),
+ None)
+
+ def _check_all_rolled(self):
+ return all(rolled for rolled in self.round_has_rolled.values())
+
+ def _destruct(self):
+ del self.snakes.active_sal[self.channel]
+
+ def _board_coordinate_from_index(self, index: int):
+ # converts the tile number to the x/y coordinates for graphical purposes
+ y_level = 9 - math.floor((index - 1) / 10)
+ is_reversed = math.floor((index - 1) / 10) % 2 != 0
+ x_level = (index - 1) % 10
+ if is_reversed:
+ x_level = 9 - x_level
+ return x_level, y_level
diff --git a/bot/seasons/season.py b/bot/seasons/season.py
index 1847f23e..b7892606 100644
--- a/bot/seasons/season.py
+++ b/bot/seasons/season.py
@@ -90,6 +90,7 @@ class SeasonBase:
colour: Optional[int] = None
icon: str = "/logos/logo_full/logo_full.png"
+ bot_icon: Optional[str] = None
date_format: str = "%d/%m/%Y"
@@ -151,10 +152,11 @@ class SeasonBase:
return f"New Season, {self.name_clean}!"
- async def get_icon(self) -> bytes:
+ async def get_icon(self, avatar: bool = False) -> bytes:
"""
Retrieves the icon image from the branding repository, using the
- defined icon attribute for the season.
+ defined icon attribute for the season. If `avatar` is True, uses
+ optional bot-only avatar icon if present.
The icon attribute must provide the url path, starting from the master
branch base url, including the starting slash:
@@ -162,7 +164,11 @@ class SeasonBase:
"""
base_url = "https://raw.githubusercontent.com/python-discord/branding/master"
- full_url = base_url + self.icon
+ if avatar:
+ icon = self.bot_icon or self.icon
+ else:
+ icon = self.icon
+ full_url = base_url + icon
log.debug(f"Getting icon from: {full_url}")
async with bot.http_session.get(full_url) as resp:
return await resp.read()
@@ -217,17 +223,17 @@ class SeasonBase:
old_avatar = bot.user.avatar
# attempt the change
- log.debug(f"Changing avatar to {self.icon}")
- icon = await self.get_icon()
+ log.debug(f"Changing avatar to {self.bot_icon or self.icon}")
+ icon = await self.get_icon(avatar=True)
with contextlib.suppress(discord.HTTPException, asyncio.TimeoutError):
async with async_timeout.timeout(5):
await bot.user.edit(avatar=icon)
if bot.user.avatar != old_avatar:
- log.debug(f"Avatar changed to {self.icon}")
+ log.debug(f"Avatar changed to {self.bot_icon or self.icon}")
return True
- log.warning(f"Changing avatar failed: {self.icon}")
+ log.warning(f"Changing avatar failed: {self.bot_icon or self.icon}")
return False
async def apply_server_icon(self) -> bool:
@@ -334,12 +340,13 @@ class SeasonBase:
if not Client.debug:
log.info("Applying avatar.")
await self.apply_avatar()
- log.info("Applying server icon.")
- await self.apply_server_icon()
if username_changed:
+ log.info("Applying server icon.")
+ await self.apply_server_icon()
log.info(f"Announcing season {self.name}.")
await self.announce_season()
else:
+ log.info(f"Skipping server icon change due to username not being changed.")
log.info(f"Skipping season announcement due to username not being changed.")
await bot.send_log("SeasonalBot Loaded!", f"Active Season: **{self.name_clean}**")
@@ -465,7 +472,7 @@ class SeasonManager(commands.Cog):
# report back details
season_name = type(self.season).__name__
embed = discord.Embed(
- description=f"**Season:** {season_name}\n**Avatar:** {self.season.icon}",
+ description=f"**Season:** {season_name}\n**Avatar:** {self.season.bot_icon or self.season.icon}",
colour=colour
)
embed.set_author(name=title)
diff --git a/bot/utils/__init__.py b/bot/utils/__init__.py
index e69de29b..ef18a1b9 100644
--- a/bot/utils/__init__.py
+++ b/bot/utils/__init__.py
@@ -0,0 +1,79 @@
+import asyncio
+from typing import List
+
+import discord
+from discord.ext.commands import BadArgument, Context
+
+from bot.pagination import LinePaginator
+
+
+async def disambiguate(
+ ctx: Context, entries: List[str], *, timeout: float = 30,
+ per_page: int = 20, empty: bool = False, embed: discord.Embed = None
+):
+ """
+ Has the user choose between multiple entries in case one could not be chosen automatically.
+
+ This will raise a BadArgument if entries is empty, if the disambiguation event times out,
+ or if the user makes an invalid choice.
+
+ :param ctx: Context object from discord.py
+ :param entries: List of items for user to choose from
+ :param timeout: Number of seconds to wait before canceling disambiguation
+ :param per_page: Entries per embed page
+ :param empty: Whether the paginator should have an extra line between items
+ :param embed: The embed that the paginator will use.
+ :return: Users choice for correct entry.
+ """
+ if len(entries) == 0:
+ raise BadArgument('No matches found.')
+
+ if len(entries) == 1:
+ return entries[0]
+
+ choices = (f'{index}: {entry}' for index, entry in enumerate(entries, start=1))
+
+ def check(message):
+ return (message.content.isdigit()
+ and message.author == ctx.author
+ and message.channel == ctx.channel)
+
+ try:
+ if embed is None:
+ embed = discord.Embed()
+
+ coro1 = ctx.bot.wait_for('message', check=check, timeout=timeout)
+ coro2 = LinePaginator.paginate(choices, ctx, embed=embed, max_lines=per_page,
+ empty=empty, max_size=6000, timeout=9000)
+
+ # wait_for timeout will go to except instead of the wait_for thing as I expected
+ futures = [asyncio.ensure_future(coro1), asyncio.ensure_future(coro2)]
+ done, pending = await asyncio.wait(futures, return_when=asyncio.FIRST_COMPLETED, loop=ctx.bot.loop)
+
+ # :yert:
+ result = list(done)[0].result()
+
+ # Pagination was canceled - result is None
+ if result is None:
+ for coro in pending:
+ coro.cancel()
+ raise BadArgument('Canceled.')
+
+ # Pagination was not initiated, only one page
+ if result.author == ctx.bot.user:
+ # Continue the wait_for
+ result = await list(pending)[0]
+
+ # Love that duplicate code
+ for coro in pending:
+ coro.cancel()
+ except asyncio.TimeoutError:
+ raise BadArgument('Timed out.')
+
+ # Guaranteed to not error because of isdigit() in check
+ index = int(result.content)
+
+ try:
+ return entries[index - 1]
+ except IndexError:
+ raise BadArgument('Invalid choice.')
diff --git a/docker/Dockerfile b/docker/Dockerfile
index 1613261c..edeb5b50 100644
--- a/docker/Dockerfile
+++ b/docker/Dockerfile
@@ -1,15 +1,15 @@
-FROM python:3.6-alpine3.7
-RUN apk add --update tini build-base git jpeg-dev zlib zlib-dev
+FROM python:3.7-alpine3.7
+RUN apk add --update libffi-dev tini build-base git jpeg-dev zlib zlib-dev
RUN mkdir /bot
COPY . /bot
WORKDIR /bot
-ENV LIBRARY_PATH=/lib:/usr/lib
+ENV LIBRARY_PATH=/lib:/usr/lib \
+ PIPENV_VENV_IN_PROJECT=1
RUN pip install pipenv
RUN pipenv install --deploy --system
ENTRYPOINT ["/sbin/tini", "--"]
CMD ["python", "-m", "bot"]
-
diff --git a/tox.ini b/tox.ini
index bff048cb..cbf21e33 100644
--- a/tox.ini
+++ b/tox.ini
@@ -2,5 +2,5 @@
max-line-length=120
application_import_names=bot
ignore=P102,B311,W503,E226,S311
-exclude=__pycache__, venv, .venv, tests
+exclude=__pycache__,venv,.venv,tests,.cache
import-order-style=pycharm