Merge pull request #415 from davidhozic/develop

Develop

Author: davidhozic

docs/source/changelog.rst

@@ -34,6 +34,16 @@ Releases
 
 v2.10
 ====================
+- GUI:
+
+  - GUI can now be started with ``python -m daf_gui``
+  - Deprecation notices are now a button.
+  - Certain fields are now masked with '*' when not editing the object.
+  - Old data that is being updated will now be updated by index
+  - View properties of trackable objects. This can be used to, eg. view the channels AutoCHANNEL found.
+  - 'Load default' button when editing :class:`discord.Intents` object.
+  - A warning is shown besides the method execution frame to let users know, the data is not preserved.
+  - Fixed accounts not being deleted when using delete / backspace keys in live view.
 
 - Accounts:
 
@@ -69,16 +79,6 @@ v2.10
   - Selenium can now be used though remote, however it is not recommended.
   - Querying for new guilds will not repeat once no more guilds are found.
 
-- GUI:
-
-  - deprecation notices are now a button.
-  - Certain fields are now masked with '*' when not editing the object.
-  - Old data that is being updated will now be updated by index
-  - View properties of trackable objects. This can be used to, eg. view the channels AutoCHANNEL found.
-  - 'Load default' button when editing :class:`discord.Intents` object.
-  - A warning is shown besides the method execution frame to let users know, the data is not preserved.
-  - Fixed accounts not being deleted when using delete / backspace keys in live view.
-
 
 v2.9.7
 =================

docs/source/guide/GUI/quickstart.rst

@@ -5,12 +5,20 @@ This page contains information to quickly getting started with the GUI.
 
 The first thing you need is the library installed, see :ref:`Installation`.
 
-After successful installation, DAF can be run in graphical mode by executing the command ``daf-gui`` command inside the terminal.
+After successful installation, DAF can be run in graphical mode by executing the command ``daf-gui`` command inside the terminal
 
 .. code-block:: bash
 
     $ daf-gui
 
+or by using ``python -m daf_gui`` command.
+
+
+.. code-block:: bash
+
+    $ python -m daf_gui
+
+
 On Windows it can also be started though the Run (Win + R) menu.
 
 .. image:: ./images/run-windows-daf-gui.png

docs/thesis/IzjavaOAvtorstvu.pdf

@@ -13,7 +13,7 @@
 
 
 Nezamenljivi žetoni (angl. *Non fungible tokens*) so edinstvena digitalna sredstva, ki živijo na verigi blokov brez možnosti replikacije.
-Obstaj več pristopov za njihovo oglaševanje, kjer je eden izmed teh oglaševanje po socialnem omrežju Discord s pristopom agresivnega oglaševanja.
+Obstaja več pristopov za njihovo oglaševanje, kjer je eden izmed teh oglaševanje po socialnem omrežju Discord s pristopom agresivnega oglaševanja.
 Diplomsko delo se fokusira na proces oglaševanja in se navezuje na projekt Ogrodje za oglaševanje po Discordu (angl. Discord Advertisement Framework),
 ki je implementirano v programskem jeziku Python.
 

docs/thesis/NaslovnaStranDiplome.pdf

@@ -58,32 +58,6 @@ Pošiljanje s fiksno periodo dveh ur in avtomatično odkrivanje pridruženih ceh
     :caption: Avtomatsko odkrivanje cehov in kanalov - |SCHEMA_EXAMPLE|
 
 
-
-Sledenje cehovskih (pridružnih) povezav
-----------------------------------------------
-Sledenje trem cehovskim povezavam.
-
-.. literalinclude:: ./DEP/Examples/example-invites-tracking.py
-    :caption: Sledenje cehovskih povezav - |PY_EXAMPLE|
-
-.. literalinclude:: ./DEP/Examples/example-invites-tracking.json
-    :caption: Sledenje cehovskih povezav - |SCHEMA_EXAMPLE|
-
-
-
-Pridružitev novim cehom
-----------------------------------------
-Pridruževanje največ 15 novim cehom, na podlagi izraza "NFT", ker imajo cehi med 100 in 1000 uporabnikov.
-
-
-.. literalinclude:: ./DEP/Examples/example-new-guild-join.py
-    :caption: Pridružitev novim cehom - |PY_EXAMPLE|
-
-.. literalinclude:: ./DEP/Examples/example-new-guild-join.json
-    :caption: Pridružitev novim cehom - |SCHEMA_EXAMPLE|
-
-
-
 Oddaljen dostop
 ----------------------------------------
 HTTP strežnik, in GUI shema za povezovanje na ta strežnik.

docs/thesis/daf-thesis.pdf

@@ -24,9 +24,9 @@ da se to datoteko generira iz grafičnega vmesnika (:ref:`Zasnova in razvoj graf
 
 AsyncIO
 ===============
-Jedro ogrodja je zasnovano za konkurenčno (angl. *concurrent*) delovanje, kar pomeni da se lahko na videz več opravil izvaja na enkrat, v
-resnici pa se zelo hitro preklaplja med njimi. To je omogočeno s knjižnico :mod:`asyncio`.
-AsyncIO omogoča ustvarjanje ``async`` funkcij, ki vrnejo korutine. Te korutine lahko potem zaženemo v opravilih,
+Jedro ogrodja je zasnovano za sočasno (angl. *concurrent*) večopravilnost, kar pomeni da se lahko na videz več opravil izvaja na enkrat, v
+resnici pa se med njimi zelo hitro preklaplja. To je omogočeno s knjižnico :mod:`asyncio`.
+AsyncIO omogoča ustvarjanje ``async`` funkcij, ki vrnejo korutine (angl. coroutine). Te korutine lahko potem zaženemo v opravilih,
 med katerimi bo program preklopil vsakič, ko v trenutnem opravilu z ``await`` besedo na primer čakamo:
 
 - na konec neke asinhrone komunikacije (angl. *Async I/O*)
@@ -38,6 +38,7 @@ med katerimi bo program preklopil vsakič, ko v trenutnem opravilu z ``await`` b
    dela kode oz. skupne surovine. https://docs.python.org/3/library/asyncio-sync.html.
 
 
+
 .. raw:: latex
 
     \newpage
@@ -83,7 +84,7 @@ Ogrodje samo po sebi deluje tako, da ima vse objekte (račune, cehe, sporočila,
 ob taki definiciji neproblematično, problem pa je nastopil, ko je bilo dodano dinamično dodajanje in brisanje objektov, kar
 dejansko uporabnikom omogoča, da ogrodje dinamično uporabljajo in v tem primeru je bilo potrebno dodati neke vrste permanentno shrambo.
 Razmišljalo se je o več alternativah, ena izmed njih je bila da bi se vse objekte shranjevalo v neko bazo podatkov, ki bi omogočala
-mapiranje podatkov v bazi, kar bi z vidika robustnosti bila zelo dobra izbira, a to bi zahtevalo veliko prenovo
+preslikavo bazičnih podatkov v objekte, kar bi z vidika robustnosti bila zelo dobra izbira, a to bi zahtevalo veliko prenovo
 vseh sektorjev, zato se je na koncu izbrala preprosta opcija shranjevanja objektov, ki preko :mod:`pickle` modula shrani vse račune
 ob vsakem normalnem izklopu ogrodja, ali pa v vsakem primeru na dve minuti periodično. V prihodnosti so
 še vedno načrti za izboljšanje tega mehanizma in ne izključuje se uporaba prej omenjene podatkovne baze.
@@ -162,7 +163,7 @@ v primeru beleženja sporočil (vsaj v primeru JSON datotek), kjer je vse razdel
 
 Sporočilni sektor
 -----------------
-Sporočilni sektor je zadolžen za pošiljanje dejanskih sporočil v posamezne kanale na Discordu.
+Sporočilni sektor je zadolžen za pošiljanje dejanskih sporočil v posamezne kanale.
 V tem sektorju so na voljo trije glavni razredi za ustvarjanje različnih vrst sporočil:
 
 1. |TextMESSAGE| - pošiljanje tekstovnih sporočil v cehovske kanale
@@ -185,9 +186,9 @@ To je še posebno pomembno v primeru, da imamo definiranih veliko sporočil v en
 poslalo točno ob določenem času. Ker se čas prišteva od prejšnjega predvidenega časa pošiljanja, to pomeni, da bo v primeru
 zamude sporočila razmak med tem in naslednjim sporočilom manjši točno za to časovno napako (če privzamemo da ne bo ponovne zakasnitve).
 
-Pred tem algoritmom, je za določanje časa pošiljanja bil v rabi preprost časovnik, ki se je ponastavil po vsakem pošiljanju, a se je zaradi Discordove
-omejitve API zahtevkov in tudi drugih Discord API zakasnitev, čas pošiljanja vedno pomikal malo naprej, kar je pomenilo, da če je uporabnik
-ogrodje konfiguriral da se neko sporočilo pošlje vsak dan in definiral čas začetka naslednje jutro ob 10ih (torej pošiljanje vsak dan ob tej uri),
+Pred tem algoritmom je bil za določanje časa pošiljanja v rabi preprost časovnik, ki se je ponastavil po vsakem pošiljanju, a se je zaradi Discordove
+omejitve API zahtevkov in tudi drugih Discord API zakasnitev čas pošiljanja vedno pomikal malo naprej, kar je pomenilo, da če je uporabnik
+ogrodje konfiguriral, da se neko sporočilo pošlje vsak dan in definiral čas začetka naslednje jutro ob 10ih (torej pošiljanje vsak dan ob tej uri),
 potem je po (sicer veliko) pošiljanjih namesto ob 10ih uporabnik opazil, da se sporočilo pošlje ob 10.01, 10.02, itd.
 Primer računanja časa in odprave časovne napake je prikazan na spodnji sliki.
 
@@ -262,7 +263,7 @@ datoteko.
 
 CSV beleženje
 ~~~~~~~~~~~~~~~~~~
-CSV beleženje deluje na enak način kot JSON beleženje. Edina razlika je v formatu, kjer je format tu CSV.
+CSV beleženje deluje na enak način kot JSON beleženje. Edina razlika je v formatu, kjer je ta v tem primeru CSV.
 Lokacija datotek je enaka kot pri JSON beleženje. Za shranjevanje je uporabljen vgrajen Python modul :mod:`csv`.
 
 Za sam pregled poslanih sporočil to ni najbolj primeren format, saj se vse shrani v eni datoteki, kjer za razliko od JSON
@@ -276,18 +277,19 @@ formata, tu ni več-slojnih strukture.
 
 SQL beleženje
 ~~~~~~~~~~~~~~~~~~
-SQL beleženje pa deluje precej drugače, kot delujeta JSON beleženje in CSV beleženje, saj se podatki shranjujejo
+SQL beleženje deluje precej drugače, kot delujeta JSON beleženje in CSV beleženje, saj se podatki shranjujejo
 v podatkovno bazo, ki je v primeru uporabe SQLite dialekta lahko tudi datoteka.
 
 Beleženje je omogočeno v štirih SQL dialektih:
 
 1. SQLite
-2. Microsoft SQL Server
+2. Microsoft SQL Server (T-SQL)
 3. PostgreSQL
 4. MySQL / MariaDB
 
 Za čim bolj univerzalno implementacijo na vseh dialektih, je bila pri razvoju uporabljena knjižnica :mod:`SQLAlchemy`.
-Celoten sistem SQL beleženja je implementiran s pomočjo ORM, kar med drugim omogoča tudi
+
+Celoten sistem SQL beleženja je implementiran s pomočjo ORM, kar med drugim omogoča,
 da SQL tabele predstavimo z Python razredi, posamezne vnose v bazo podatkov oz. vrstice pa predstavimo z instancami
 teh razredov. Z ORM lahko skoraj v celoti skrijemo SQL in delamo neposredno z Python objekti, ki so lahko tudi gnezdene
 strukture, npr. vnosa dveh ločenih tabel lahko predstavimo z dvema ločenima instancama, kjer je ena instanca 
@@ -344,5 +346,5 @@ PyCord je odprtokodno ogrodje, ki je nastalo iz kode starejšega `discord.py <ht
 Ogrodje PyCord skoraj popolnoma zakrije Discord API z raznimi objekti, ki jih ogrodje interno uporablja.
 
 Če bi si ogledali izvorno kodo (angl. *source code*) ogrodja, bi opazili da je poleg ``daf`` paketa zraven tudi paket z imenom ``_discord``.
-To ni nič drugega kot PyCord ogrodje, le da je modificirano za možnost rabe na osebnih uporabniških računih.
+To ni nič drugega kot PyCord ogrodje, le da je modificirano za možnost rabe na uporabniških računih (poleg avtomatiziranih robotskih računov).