[V3 Everything] Package bot and write setup scripts (#964)

Ya'll are gonna hate me.

* Initial modifications

* Add initial setup.py

* working setup py help

* Modify setup file to package stuff

* Move a bunch of shit and fix imports

* Fix or skip tests

* Must add init files for find_packages to work

* Move main to scripts folder and rename

* Add shebangs

* Copy over translation files

* WORKING PIP INSTALL

* add dependency information

* Hardcoded version for now, will need to figure out a better way to do this

* OKAY ITS FINALLY FUCKING WORKING

* Add this guy

* Fix stuff

* Change readme to rst

* Remove double sentry opt in

* Oopsie

* Fix this thing

* Aaaand fix test

* Aaaand fix test

* Fix core cog importing and default cog install path

* Adjust readme

* change instance name from optional to required

* Ayyy let's do more dependency injection

redbot/cogs/image/__init__.py

@@ -0,0 +1,9 @@
+from .image import Image
+import asyncio
+
+
+def setup(bot):
+    n = Image(bot)
+    loop = asyncio.get_event_loop()
+    loop.create_task(n.set_giphy_key())
+    bot.add_cog(n)

redbot/cogs/image/image.py

@@ -0,0 +1,159 @@
+from random import shuffle
+
+import aiohttp
+from discord.ext import commands
+
+from redbot.core.i18n import CogI18n
+from redbot.core import checks, Config
+
+_ = CogI18n("Image", __file__)
+
+GIPHY_API_KEY = "dc6zaTOxFJmzC"
+
+
+class Image:
+    """Image related commands."""
+    default_global = {
+        "imgur_client_id": None
+    }
+
+    def __init__(self, bot):
+        self.bot = bot
+        self.settings = Config.get_conf(self, identifier=2652104208, force_registration=True)
+        self.settings.register_global(**self.default_global)
+        self.session = aiohttp.ClientSession()
+        self.imgur_base_url = "https://api.imgur.com/3/"
+
+    @commands.group(name="imgur")
+    @commands.guild_only()
+    async def _imgur(self, ctx):
+        """Retrieves pictures from imgur
+
+        Make sure to set the client ID using
+        [p]imgurcreds"""
+        if ctx.invoked_subcommand is None:
+            await self.bot.send_cmd_help(ctx)
+
+    @_imgur.command(name="search")
+    async def imgur_search(self, ctx, *, term: str):
+        """Searches Imgur for the specified term and returns up to 3 results"""
+        url = self.imgur_base_url + "time/all/0"
+        params = {"q": term}
+        headers = {"Authorization": "Client-ID {}".format(await self.settings.imgur_client_id())}
+        async with self.session.get(url, headers=headers, data=params) as search_get:
+            data = await search_get.json()
+
+        if data["success"]:
+            results = data["data"]
+            if not results:
+                await ctx.send(_("Your search returned no results"))
+                return
+            shuffle(results)
+            msg = _("Search results...\n")
+            for r in results[:3]:
+                msg += r["gifv"] if "gifv" in r else r["link"]
+                msg += "\n"
+            await ctx.send(msg)
+        else:
+            await ctx.send(_("Something went wrong. Error code is {}").format(data["status"]))
+
+    @_imgur.command(name="subreddit")
+    async def imgur_subreddit(self, ctx, subreddit: str, sort_type: str="top", window: str="day"):
+        """Gets images from the specified subreddit section
+
+        Sort types: new, top
+        Time windows: day, week, month, year, all"""
+        sort_type = sort_type.lower()
+        window = window.lower()
+
+        if sort_type not in ("new", "top"):
+            await ctx.send(_("Only 'new' and 'top' are a valid sort type."))
+            return
+        elif window not in ("day", "week", "month", "year", "all"):
+            await self.bot.send_cmd_help(ctx)
+            return
+
+        if sort_type == "new":
+            sort = "time"
+        elif sort_type == "top":
+            sort = "top"
+
+        links = []
+        headers = {"Authorization": "Client-ID {}".format(await self.settings.imgur_client_id())}
+        url = self.imgur_base_url + "r/{}/{}/{}/0".format(subreddit, sort, window)
+
+        async with self.session.get(url, headers=headers) as sub_get:
+            data = await sub_get.json()
+
+        if data["success"]:
+            items = data["data"]
+            if items:
+                for item in items[:3]:
+                    link = item["gifv"] if "gifv" in item else item["link"]
+                    links.append("{}\n{}".format(item["title"], link))
+
+                if links:
+                    await ctx.send("\n".join(links))
+            else:
+                await ctx.send(_("No results found."))
+        else:
+            await ctx.send(_("Something went wrong. Error code is {}").format(data["status"]))
+
+    @checks.is_owner()
+    @commands.command()
+    async def imgurcreds(self, ctx, imgur_client_id: str):
+        """Sets the imgur client id
+        You will need an account on Imgur to get this
+
+        You can get these by visiting https://api.imgur.com/oauth2/addclient
+        and filling out the form. Enter a name for the application, select
+        'Anonymous usage without user authorization' for the auth type,
+        leave the app website blank, enter a valid email address, and
+        enter a description. Check the box for the captcha, then click Next.
+        Your client ID will be on the page that loads"""
+        await self.settings.imgur_client_id.set(imgur_client_id)
+        await ctx.send(_("Set the imgur client id!"))
+
+    @commands.command(pass_context=True, no_pm=True)
+    async def gif(self, ctx, *keywords):
+        """Retrieves first search result from giphy"""
+        if keywords:
+            keywords = "+".join(keywords)
+        else:
+            await self.bot.send_cmd_help(ctx)
+            return
+
+        url = ("http://api.giphy.com/v1/gifs/search?&api_key={}&q={}"
+               "".format(GIPHY_API_KEY, keywords))
+
+        async with self.session.get(url) as r:
+            result = await r.json()
+            if r.status == 200:
+                if result["data"]:
+                    await ctx.send(result["data"][0]["url"])
+                else:
+                    await ctx.send(_("No results found."))
+            else:
+                await ctx.send(_("Error contacting the API"))
+
+    @commands.command(pass_context=True, no_pm=True)
+    async def gifr(self, ctx, *keywords):
+        """Retrieves a random gif from a giphy search"""
+        if keywords:
+            keywords = "+".join(keywords)
+        else:
+            await self.bot.send_cmd_help(ctx)
+            return
+
+        url = ("http://api.giphy.com/v1/gifs/random?&api_key={}&tag={}"
+               "".format(GIPHY_API_KEY, keywords))
+
+        async with self.session.get(url) as r:
+            result = await r.json()
+            if r.status == 200:
+                if result["data"]:
+                    await ctx.send(result["data"]["url"])
+                else:
+                    await ctx.send(_("No results found."))
+            else:
+                await ctx.send(_("Error contacting the API"))

redbot/cogs/image/locales/es.po

@@ -0,0 +1,45 @@
+# Copyright (C) 2017 Red-DiscordBot
+# UltimatePancake <pier.gaetani@gmail.com>, 2017.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: \n"
+"POT-Creation-Date: 2017-08-26 17:57+EDT\n"
+"PO-Revision-Date: 2017-08-26 20:39-0600\n"
+"Language-Team: \n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Generated-By: pygettext.py 1.5\n"
+"X-Generator: Poedit 2.0.3\n"
+"Last-Translator: UltimatePancake <pier.gaetani@gmail.com>\n"
+"Plural-Forms: nplurals=2; plural=(n != 1);\n"
+"Language: es\n"
+
+#: ../image.py:48
+msgid "Your search returned no results"
+msgstr "Tu búsqueda no a dado resultados"
+
+#: ../image.py:51
+msgid "Search results...\n"
+msgstr "Resultados de la búsqueda\n"
+
+#: ../image.py:57 ../image.py:99
+msgid "Something went wrong. Error code is {}"
+msgstr "Algo malo ha ocurrido. Código de error: {}"
+
+#: ../image.py:69
+msgid "Only 'new' and 'top' are a valid sort type."
+msgstr "Únicamente 'new' y 'top' son tipos de ordenamiento válidos."
+
+#: ../image.py:97 ../image.py:134 ../image.py:156
+msgid "No results found."
+msgstr "No se han encontrado resultados."
+
+#: ../image.py:114
+msgid "Set the imgur client id!"
+msgstr "Configurar el id de cliente de imgur!"
+
+#: ../image.py:136 ../image.py:158
+msgid "Error contacting the API"
+msgstr "Error contactando al API"

redbot/cogs/image/locales/messages.pot

@@ -0,0 +1,46 @@
+# SOME DESCRIPTIVE TITLE.
+# Copyright (C) YEAR ORGANIZATION
+# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: PACKAGE VERSION\n"
+"POT-Creation-Date: 2017-08-26 17:57+EDT\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
+"Language-Team: LANGUAGE <LL@li.org>\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=CHARSET\n"
+"Content-Transfer-Encoding: ENCODING\n"
+"Generated-By: pygettext.py 1.5\n"
+
+
+#: ../image.py:48
+msgid "Your search returned no results"
+msgstr ""
+
+#: ../image.py:51
+msgid ""
+"Search results...\n"
+msgstr ""
+
+#: ../image.py:57 ../image.py:99
+msgid "Something went wrong. Error code is {}"
+msgstr ""
+
+#: ../image.py:69
+msgid "Only 'new' and 'top' are a valid sort type."
+msgstr ""
+
+#: ../image.py:97 ../image.py:134 ../image.py:156
+msgid "No results found."
+msgstr ""
+
+#: ../image.py:114
+msgid "Set the imgur client id!"
+msgstr ""
+
+#: ../image.py:136 ../image.py:158
+msgid "Error contacting the API"
+msgstr ""
+