feat: implement get function (#801)

* fix: unfuck the branch

* feat: Add single-arg cache

* feat: more work on get

* Update get.pyi

* ci: correct from checks.

* Update get.py

* ci: correct from checks.

* Update get.py

* Update get.py

* ci: correct from checks.

* Update get.py

* Update get.py

* ci: correct from checks.

* Update get.py

* Update get.py

* feat: more work on get

* feat: more work on get

* feat: more work on get

* feat: more work on get

* Update get.py

* Update get.py

* ci: correct from checks.

* Update get.py

* Update get.py

* ci: correct from checks.

* Update get.py

* feat: more work on get

* docs: work on docs for get

* Update get.py

* Update get.pyi

* Update get.py

* ci: correct from checks.

* Update get.pyi

* ci: correct from checks.

* Update get.py

* feat: Allow `list[obj]`

* Update docs/get.rst

Co-authored-by: Sofia <41456914+ffl0w@users.noreply.github.com>

* Update interactions/client/get.py

Co-authored-by: Sofia <41456914+ffl0w@users.noreply.github.com>

* fix: Fix `TpyeVar`s

* fix:

* fix: allow py3.9 typehints

* fix: fix cache attribute and instance checks

* Update interactions/client/get.py

Co-authored-by: Max <maxyolo01.ytb@gmail.com>

* Update interactions/client/get.py

Co-authored-by: Max <maxyolo01.ytb@gmail.com>

* refactor: Optimize `_search_iterable`

* refactor: Optimize `_search_iterable`and use a list of tuples instead of a tuple of tuples

* Update migration.rst

* Update migration.rst

* Update migration.rst

* Update migration.rst

* Update migration.rst

* Update migration.rst

* Update migration.rst

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Co-authored-by: Sofia <41456914+ffl0w@users.noreply.github.com>
Co-authored-by: Max <maxyolo01.ytb@gmail.com>

Author: 4 people

docs/api.rst

@@ -20,6 +20,7 @@ Interactions
 
     ext.rst
     context.rst
+    get.rst
 
 .. toctree::
     :maxdepth: 2

docs/get.rst

@@ -0,0 +1,8 @@
+.. currentmodule:: interactions
+
+The ``get`` utility method
+================
+
+.. automodule:: interactions.client.get
+    :members:
+    :noindex:

docs/migration.rst

@@ -66,7 +66,13 @@ portal and add the intent to your current intents when connecting:
 4.1.0 → 4.3.0
 ~~~~~~~~~~~~~~~
 
-``4.3.0`` introduces a new method of creating commands, subcommands, and options.
+A new big change in this release is the implementation of the ``get` utility method.
+It allows you to no longer use ``**await bot._http...``.
+
+You can get more information by reading the `get-documentation`_.
+
+
+``4.3.0`` also introduces a new method of creating commands, subcommands, and options.
 There are also numerous new features, such as a default scope and utilities.
 
 The following example shows and explains how to create commands effortlessly and use new features mentioned above:
@@ -175,3 +181,5 @@ The following example shows and explains how to create commands effortlessly and
         # configurable
 
     bot.start()
+
+.. _get-documentation: https://interactionspy.readthedocs.io/en/latest/get.html#the-get-utility-method

interactions/client/__init__.py

@@ -8,4 +8,5 @@
 from .context import *  # noqa: F401 F403
 from .decor import *  # noqa: F401 F403
 from .enums import *  # noqa: F401 F403
+from .get import *  # noqa: F401 F403
 from .models import *  # noqa: F401 F403