Remote control (#323)

* Performance improvements

* changelog

* Refactoring

* Remote

* remote

* Connection managers

* Local connection manager

* Fix internal IDs

* JSON transfer

* loggers

* Remote method execution

* serialization

* Fix _daf_id

* window size

* Fix

* confirm

* remote

* connector

* Fix 127

* docs

* remote

* Documentation & Tests

* fix tests

* fix linting

* rollback

* remove default

* Fix Embed serialization

* fix convert

* Convert remote

* Remote generation

* enum convert

Author: davidhozic

README.rst

@@ -1,24 +1,22 @@
 =========================================================
-Discord Advertisement Framework (Shiller)
+Discord Advertisement Framework
 =========================================================
-The Discord advertisement framework is a Python based **shilling application** that allows automatic advertising (and much more) on Discord.
+The Discord advertisement framework is a Python based automatic application that allows **easy automatic advertisement** (and much more) on Discord.
 
 
 .. image:: ./docs/images/daf-gui-front.png
 
 .. image:: ./docs/images/daf-gui-front-edit-msg.png
 
----------------
-Help
----------------
-Need help? Contact me in my `Discord server <https://discord.gg/DEnvahb2Sw>`_.
-
-
 ----------------
 Guide / Usage
 ----------------
 Instructions can be found `here <https://daf.davidhozic.com/en/stable/guide/GUI/quickstart.html>`_.
 
+---------------
+Help
+---------------
+Need help? Contact me in my `Discord server <https://discord.gg/DEnvahb2Sw>`_.
 
 ----------------------
 Key features

docs/images/daf-gui-front-edit-msg.png

@@ -32,6 +32,34 @@ Glossary
 Releases
 ----------------------
 
+v2.8
+=================
+
+- Remote control though HTTP access:
+
+  - The core can be started on a remote server and then connected to and controlled by the graphical interface.
+  - The GUI now has a dropdown menu where users can select between a local connection client and a remote connection client.
+    Local connection client won't use the HTTP API, but will start DAF locally and interact with it directly.
+
+- GUI:
+  
+  - Method execution
+  - Executing method status window.
+  - When editing objects, the Y size will now be set to default size every time the frame changes.
+  - When executing async blocking functions, a progress bar window will be shown to indicate something is happening.
+
+- Logging:
+
+  - :class:`daf.logging.LoggerJSON` will create a new file once the current one reaches 100 kilobytes.
+  - Improved performance of :class:`daf.logging.LoggerJSON`.
+  - Loggers will now trace their output path, so users can find the output logs more easily.
+
+- State preservation
+
+  - When using the state preservation (introduced in :ref:`v2.7`), accounts that fail to login will, from now on,
+    not be removed from list to prevent data loss.
+
+
 
 v2.7
 ================

docs/images/daf-gui-front.png

@@ -21,7 +21,7 @@ Schema backup
 .. seealso::
     :download:`Download example schema backup (schema.json) <./images/schema.json>`
 
-To save a schema after it has been defined, we can click on the *Load/Save/Generate* button, located in the top left
+To save a schema after it has been defined, we can click on the *Schema* button, located in the top left
 corner of the *Schema definition* tab and then click the **Save schema** option.
 
 We will be asked for a file location of the schema backup, where the GUI will save backup our schema.
@@ -37,7 +37,7 @@ We will be asked for a file location of the schema backup, where the GUI will sa
 
 Schema restore
 ---------------
-In case we want to restore a backed-up schema, we can click on the *Load/Save/Generate* button, located in the top left
+In case we want to restore a backed-up schema, we can click on the *Schema* button, located in the top left
 corner of the *Schema definition* tab and then click the **Load schema** option.
 
 We will be asked for a file location of the schema backup, from which the GUI will load our schema. 
@@ -56,7 +56,7 @@ a computer capable of displaying image.
 
 Luckily DAF-GUI allows use to create a (Python) shilling script in the event that we want to run DAF on a server 24/7.
 
-To generate a shilling script , we can click on the *Load/Save/Generate* button, located in the top left
+To generate a shilling script , we can click on the *Schema* button, located in the top left
 corner of the *Schema definition* tab and then click the **Generate script** option.
 This will open up a file dialog asking us where to save the shilling script.
 After we save the location our shilling script will be generated and we

docs/source/changelog.rst

@@ -11,4 +11,5 @@ This section contains the guide to using the Discord Advertisement Framework ins
     schema
     live_view
     filegen
-    analytics
+    analytics
+    remote

docs/source/guide/GUI/filegen.rst

@@ -23,6 +23,7 @@ GUI structure
 The GUI consists of:
 
 - START and STOP buttons starting and stopping DAF's core,
+- Connection type selection (see :ref:`Remote control (GUI)`)
 - Optional modules tab - Where you can install optional functionallity
 - Schema definition tab - Where you can define accounts, guilds, messages & type of logging:
 

docs/source/guide/GUI/images/connection-select.png

@@ -0,0 +1,38 @@
+======================
+Remote control (GUI)
+======================
+.. versionadded:: 2.8
+
+
+.. seealso:: 
+
+    This section describes how to set up the GUI to connect to a server.
+    To find information about setting up the actual server see :ref:`Remote control (core)`.
+
+
+DAF can run either locally or it can connect to a remote server that is running the
+DAF core. Users can choose between these two options by changing the connection client as
+shown in picture:
+
+.. image:: ./images/connection-select.png
+    :width: 1000px
+
+Using ``LocalConnectionCLIENT`` will start DAF locally and anything the users do will be done locally.
+Using :class:`~daf_gui.connector.RemoteConnectionCLIENT` will connect to a remote server and anything the users do including adding / removing
+accounts, retrieving logs, etc. will be done through a HTTP API which can also be HTTPS (recommended) if desired.
+
+
+If the *Edit* button is clicked (in the top right corner) and :class:`~daf_gui.connector.RemoteConnectionCLIENT`
+is selected, a new window will be opened, which allows customization of connection parameters.
+
+
+.. image:: ./images/edit-remoteconnectionclient.png
+
+.. autoclass:: daf_gui.connector.RemoteConnectionCLIENT
+
+.. seealso::
+
+    When :ref:`generating the DAF core script <Shilling script generation>`,
+    remote access will also be configured if the :class:`~daf_gui.connector.RemoteConnectionCLIENT` is selected.
+
+Clicking on *Edit* when ``LocalConnectionCLIENT`` is selected will show an error.