Merge pull request #92 from janu8ry/master

Installing additional packages for aiohttp

Author: Lulalaby

.gitignore

@@ -2,8 +2,8 @@
 *.py[cod]
 *.log
 *.egg-info
-venv
-.venv
+venv/
+.venv/
 docs/_build
 docs/crowdin.py
 *.buildinfo
@@ -15,6 +15,9 @@ docs/crowdin.py
 *.flac
 *.mo
 .idea/
+.DS_Store
+.python-version
+__pycache__
 .vs/slnx.sqlite
 env/
 build/

README.rst

@@ -49,6 +49,15 @@ Otherwise to get voice support you should run the following command:
     # Windows
     py -3 -m pip install -U py-cord[voice]
 
+To install additional packages for speedup, run the following command:
+
+.. code:: sh
+
+    # Linux/macOS
+    python3 -m pip install -U "py-cord[speed]"
+    # Windows
+    py -3 -m pip install -U py-cord[speed]
+
 
 To install the development version, do the following:
 
@@ -63,6 +72,8 @@ Optional Packages
 ~~~~~~~~~~~~~~~~~~
 
 * `PyNaCl <https://pypi.org/project/PyNaCl/>`__ (for voice support)
+* `aiodns <https://pypi.org/project/aiodns/>`__, `Brotli <https://pypi.org/project/Brotli/>`__, `cchardet <https://pypi.org/project/cchardet/>`__ (for aiohttp speedup)
+* `orjson <https://pypi.org/project/orjson/>`__ (for json speedup)
 
 Please note that while installing voice support on Linux, you must install the following packages via your preferred package manager (e.g. ``apt``, ``dnf``, etc) BEFORE running the above commands:
 

docs/intro.rst

@@ -31,7 +31,17 @@ If you are using Windows, then the following should be used instead: ::
     py -3 -m pip install -U py-cord
 
 
-To get voice support, you should use ``py-cord[voice]`` instead of ``pycord``, e.g. ::
+To install additional packages for speedup,  you should use ``py-cord[speed]`` instead of ``py-cord``, e.g. ::
+
+.. code:: sh
+
+    # Linux/macOS
+    python3 -m pip install -U "py-cord[speed]"
+    # Windows
+    py -3 -m pip install -U py-cord[speed]
+
+
+To get voice support, you should use ``py-cord[voice]`` instead of ``py-cord``, e.g. ::
 
     python3 -m pip install -U py-cord[voice]
 

docs/locale/ja/LC_MESSAGES/intro.po

@@ -45,79 +45,83 @@ msgstr "PyPIから直接ライブラリをインストールできます。"
 msgid "If you are using Windows, then the following should be used instead: ::"
 msgstr "Windowsを使用している場合は、以下のコマンドで実行してください。"
 
-#: ../../intro.rst:33
-msgid "To get voice support, you should use ``discord.py[voice]`` instead of ``discord.py``, e.g. ::"
-msgstr "音声のサポートが必要な場合は、 ``discord.py`` ではなく、以下の例のように ``discord.py[voice]`` を使うべきです。"
+#: ../../intro.rst:34
+msgid "To install additional packages for speedup,  you should use ``py-cord[speed]`` instead of ``pycord``, e.g. ::"
+msgstr "高速化のために追加のパッケージをインストールするには、 ``py-cord`` ではなく、以下の例のように ``py-cord[speed]`` を使うべきです。"
 
-#: ../../intro.rst:37
+#: ../../intro.rst:44
+msgid "To get voice support, you should use ``py-cord[voice]`` instead of ``py-cord``, e.g. ::"
+msgstr "音声のサポートが必要な場合は、 ``py-cord`` ではなく、以下の例のように ``py-cord[voice]`` を使うべきです。"
+
+#: ../../intro.rst:48
 msgid "On Linux environments, installing voice requires getting the following dependencies:"
 msgstr "Linux環境では、依存関係にある以下のライブラリが必要になるので注意してください。"
 
-#: ../../intro.rst:39
+#: ../../intro.rst:50
 msgid "`libffi <https://github.com/libffi/libffi>`_"
 msgstr "`libffi <https://github.com/libffi/libffi>`_"
 
-#: ../../intro.rst:40
+#: ../../intro.rst:51
 msgid "`libnacl <https://github.com/saltstack/libnacl>`_"
 msgstr "`libnacl <https://github.com/saltstack/libnacl>`_"
 
-#: ../../intro.rst:41
+#: ../../intro.rst:52
 msgid "`python3-dev <https://packages.debian.org/python3-dev>`_"
 msgstr "`python3-dev <https://packages.debian.org/python3-dev>`_"
 
-#: ../../intro.rst:43
+#: ../../intro.rst:54
 msgid "For a Debian-based system, the following command will get these dependencies:"
 msgstr "Debianベースのシステムでは、次のコマンドで依存関係にあるライブラリを取得できます。"
 
-#: ../../intro.rst:49
+#: ../../intro.rst:60
 msgid "Remember to check your permissions!"
 msgstr "自分の権限の確認は忘れないようにしてください！"
 
-#: ../../intro.rst:52
+#: ../../intro.rst:62
 msgid "Virtual Environments"
 msgstr "仮想環境"
 
-#: ../../intro.rst:54
-msgid "Sometimes you want to keep libraries from polluting system installs or use a different version of libraries than the ones installed on the system. You might also not have permissions to install libraries system-wide. For this purpose, the standard library as of Python 3.3 comes with a concept called \"Virtual Environment\"s to help maintain these separate versions."
+#: ../../intro.rst:65
+msgid "Sometimes you want to keep libraries from polluting system installs or use a different version of libraries than the ones installed on the system. You might also not have permissions to install libaries system-wide. For this purpose, the standard library as of Python 3.3 comes with a concept called \"Virtual Environment\"s to help maintain these separate versions."
 msgstr "システムへのインストールをライブラリによって汚したくない場合や、現在インストールされているシステムとは異なるバージョンのライブラリを使用したい場合があります。または、システムへのライブラリのインストール権限がない場合などです。こういった目的のため、Python3.3の標準ライブラリには、このように別々のバージョンを保持したい場合のために、「仮想環境」というものが用意されています。"
 
-#: ../../intro.rst:59
+#: ../../intro.rst:70
 msgid "A more in-depth tutorial is found on :doc:`py:tutorial/venv`."
 msgstr "より詳しいチュートリアルは :doc:`py:tutorial/venv` にあります。"
 
-#: ../../intro.rst:61
+#: ../../intro.rst:72
 msgid "However, for the quick and dirty:"
 msgstr "簡単に仮想環境を構築する方法。"
 
-#: ../../intro.rst:63
+#: ../../intro.rst:74
 msgid "Go to your project's working directory:"
 msgstr "プロジェクトの作業ディレクトリに移動してください。"
 
-#: ../../intro.rst:70
+#: ../../intro.rst:81
 msgid "Activate the virtual environment:"
 msgstr "下記コマンドで仮想環境を有効化します。"
 
-#: ../../intro.rst:76
+#: ../../intro.rst:87
 msgid "On Windows you activate it with:"
 msgstr "Windowsの場合は、こちらを使ってください。"
 
-#: ../../intro.rst:82
+#: ../../intro.rst:93
 msgid "Use pip like usual:"
 msgstr "いつものようにpipインストールを実行します。"
 
-#: ../../intro.rst:88
+#: ../../intro.rst:99
 msgid "Congratulations. You now have a virtual environment all set up."
 msgstr "おめでとうございます。これで仮想環境のセットアップができました。"
 
-#: ../../intro.rst:91
+#: ../../intro.rst:102
 msgid "Basic Concepts"
 msgstr "基本概念"
 
-#: ../../intro.rst:93
+#: ../../intro.rst:104
 msgid "discord.py revolves around the concept of :ref:`events <discord-api-events>`. An event is something you listen to and then respond to. For example, when a message happens, you will receive an event about it that you can respond to."
 msgstr "discord.pyは :ref:`イベント <discord-api-events>` の概念を中心としています。イベントは何かを受け取り、それに対する応答を行います。例えば、メッセージが発生すると、メッセージの発生に関連するイベントを受け取り、そのイベントに対して応答を返すことができます。"
 
-#: ../../intro.rst:97
+#: ../../intro.rst:108
 msgid "A quick example to showcase how events work:"
 msgstr "以下はイベントの仕組みを紹介する簡単な例です。"