yawaflua/Flask-Discord
1
0
Fork 0
mirror of https://github.com/yawaflua/Flask-Discord.git synced 2025-12-10 12:29:30 +02:00
Code Issues Packages Projects Releases Wiki Activity

Docs fixes

Browse Source
This commit is contained in:
thecosmos
2019-05-09 16:25:54 +05:30
parent 53fed2b543
commit bf49390a4c
5 changed files with 52 additions and 49 deletions
Download Patch File Download Diff File Expand all files Collapse all files

14
docs/api.rst
View File

@@ -7,11 +7,11 @@ attributes and available methods.
Discord OAuth2 Client Discord OAuth2 Client
--------------------- ---------------------
.. autoclass:: flask_discord.DiscordOAuth2Session() .. autoclass:: flask_discord.DiscordOAuth2Session
:members: :members:
:inherited-members: :inherited-members:
.. autoclass:: flask_discord._http.DiscordOAuth2HttpClient() .. autoclass:: flask_discord._http.DiscordOAuth2HttpClient
:members: :members:
:inherited-members: :inherited-members:
@@ -19,22 +19,22 @@ Discord OAuth2 Client
Models Models
------ ------
.. autoclass:: flask_discord.models.Guild() .. autoclass:: flask_discord.models.Guild
:members: :members:
:inherited-members: :inherited-members:
.. autoclass:: flask_discord.models.User() .. autoclass:: flask_discord.models.User
:members: :members:
:inherited-members: :inherited-members:
.. autoclass:: flask_discord.models.Bot() .. autoclass:: flask_discord.models.Bot
:members: :members:
:inherited-members: :inherited-members:
.. autoclass:: flask_discord.models.Integration() .. autoclass:: flask_discord.models.Integration
:members: :members:
:inherited-members: :inherited-members:
.. autoclass:: flask_discord.models.UserConnection() .. autoclass:: flask_discord.models.UserConnection
:members: :members:
:inherited-members: :inherited-members:

3
docs/conf.py
View File

@@ -39,6 +39,9 @@ release = ver
extensions = [ extensions = [
'sphinx.ext.autodoc', 'sphinx.ext.autodoc',
'sphinx.ext.napoleon', 'sphinx.ext.napoleon',
'sphinx.ext.intersphinx',
'sphinx.ext.coverage',
'sphinx.ext.viewcode',
'pallets_sphinx_themes', 'pallets_sphinx_themes',
] ]

14
docs/introduction.rst
View File

@@ -14,11 +14,11 @@ permissions.
Requirements Requirements
------------ ------------
This extensions requires ``Flask`` installed. Python version can be chosen - **Flask**
as per ``Flask`` requirements. This is an Flask extension.
It also requires another library ``requests_oauthlib`` to create OAuth2 sessions - **requests_oauthlib**
to discord. It also requires requests_oauthlib to make OAuth2 sessions with discord.
Installing Installing
---------- ----------
@@ -31,7 +31,7 @@ in shell or command prompt: ::
You can also install the latest development version (**maybe unstable/broken**) by You can also install the latest development version (**maybe unstable/broken**) by
using following command: :: using following command: ::
python3 -m pip install -U git+https://github.com/thec0sm0s/Flask-Discord.git python3 -m pip install -U git+https://github.com/thec0sm0s/Flask-Discord.git@dev
Basic Usage Basic Usage
@@ -78,8 +78,8 @@ in exchange for fetching user's details and display them on web page.
<body> <body>
<img src='{user.avatar_url}' /> <img src='{user.avatar_url}' />
</body> </body>
</html> </html>"""
"""
if __name__ == "__main__": if __name__ == "__main__":
app.run() app.run()

6
flask_discord/_http.py
View File

@@ -9,7 +9,8 @@ from requests_oauthlib import OAuth2Session
class DiscordOAuth2HttpClient(abc.ABC): class DiscordOAuth2HttpClient(abc.ABC):
"""An OAuth2 http abstract base class providing some factory methods. """An OAuth2 http abstract base class providing some factory methods.
This class is meant to be overridden by flask_discord.DiscordOAuth2Session class. This class is meant to be overridden by :py:class:`flask_discord.DiscordOAuth2Session`
and should not be used directly.
Attributes Attributes
---------- ----------
@@ -75,8 +76,7 @@ class DiscordOAuth2HttpClient(abc.ABC):
Parameters Parameters
---------- ----------
route : str route : str
Route or endpoint URL to send HTTP GET request to. Route or endpoint URL to send HTTP GET request to. Example: ``/users/@me``
Example: ``/users/@me``
Returns Returns
------- -------

2
flask_discord/client.py
View File

@@ -7,7 +7,7 @@ class DiscordOAuth2Session(_http.DiscordOAuth2HttpClient):
"""Main client class representing hypothetical OAuth2 session with discord. """Main client class representing hypothetical OAuth2 session with discord.
It uses Flask `session <http://flask.pocoo.org/docs/1.0/api/#flask.session>`_ local proxy object It uses Flask `session <http://flask.pocoo.org/docs/1.0/api/#flask.session>`_ local proxy object
to save state, authorization token and keeps record of users sessions across different requests. to save state, authorization token and keeps record of users sessions across different requests.
This class inherits flask_discord._http.DiscordOAuth2HttpClient class which This class inherits :py:class:`flask_discord._http.DiscordOAuth2HttpClient` class.
Parameters Parameters
---------- ----------