Merge pull request #599 from davidhozic/develop

Merge develop before v4.1.x release

Author: davidhozic

.github/workflows/build_exe.yml

@@ -24,7 +24,7 @@ jobs:
           echo "from daf_gui import run;run()" > discord-advert-framework.py
           pyinstaller --onefile --windowed discord-advert-framework.py --add-data src/daf_gui/img/:daf_gui/img/ --icon src/daf_gui/img/logo.png --add-data src/_discord/bin/:_discord/bin/
       - name: Upload
-        uses: softprops/action-gh-release@v1
+        uses: softprops/action-gh-release@v2
         with:
           files: |
             dist/discord-advert-framework.exe

.github/workflows/create_release.yml

@@ -24,7 +24,7 @@ jobs:
         uses: actions/checkout@master
       - name: Create tag
         id: tag_version
-        uses: mathieudutour/github-tag-action@v6.1
+        uses: mathieudutour/github-tag-action@v6.2
         with:
           github_token: ${{ secrets.TOKEN_GH }}
           custom_tag : ${{github.event.inputs.version-major}}.${{github.event.inputs.version-minor}}.${{github.event.inputs.version-bugfix}}

.github/workflows/python-publish.yml

@@ -30,7 +30,7 @@ jobs:
         python -m build
 
     - name: Publish package
-      uses: pypa/gh-action-pypi-publish@2f6f737ca5f74c637829c0f5c3acd0e29ea5e8bf
+      uses: pypa/gh-action-pypi-publish@0ab0b79471669eb3a4d647e625009c62f9f3b241
       with:
         user: __token__
         password: ${{ secrets.PYPI_API_TOKEN }}

docs/source/changelog.rst

@@ -37,6 +37,23 @@ Glossary
 Releases
 ---------------------
 
+v4.1.0
+=====================
+- New message period types:
+  
+  + :class:`daf.message.messageperiod.NamedDayOfYearPeriod`
+  + :class:`daf.message.messageperiod.NamedDayOfMonthPeriod`
+
+- Added optional case-sensitive matching to :class:`daf.logic.contains` and :class:`daf.logic.regex`. The default
+  is still case-insensitive.
+- Added ``constraints`` parameter to :class:`daf.message.TextMESSAGE`. See :ref:`Message constraints` for more
+  information.
+- Fixed SQL log removal through the GUI.
+- Fixed CSV and JSON reading through remote.
+- Disabled the :ref:`Automatic guild discovery and join` features due to the search provider shutting down its
+  services. It will be reenabled in a future version.
+
+
 v4.0.5
 =====================
 - Fixed exe build.

docs/source/guide/core/images/message_definition_example_output.png

@@ -106,7 +106,7 @@ We will not cover :class:`daf.guild.USER` separately as the definition process i
 the same.
 We will also not cover :class:`daf.guild.AutoGUILD` here, as it is covered in :ref:`Automatic Generation (core)`.
 
-Let's define our :class:`daf.guild.GUILD` object now. Its most important parameters are:
+Let's define our :class:`daf.guild.GUILD` object now. Its most important (but not all) parameters are:
 
 - ``snowflake``: An integer parameter. Represents a unique identifier, which identifies every Discord resource.
   Snowflake can be obtained by
@@ -146,6 +146,8 @@ Let's expand our example from :ref:`Definition of accounts (core)`.
   daf.run(accounts=accounts)
 
 
+
+
 Now let's define our messages.
 
 --------------------------------------
@@ -178,13 +180,20 @@ The most important parameters inside :class:`daf.message.TextMESSAGE` are:
     multiple specified days at a specific time.
   - :class:`~daf.message.messageperiod.DailyPeriod`: A period that sends every day at a specific time.
 
+- ``constraints``: A list of constraints that only allow a message to be sent when they are fulfilled. This can for
+  example be used to only send messages to channels when the last message in that channel is not or own, thus
+  **preventing unnecessary spam**. Currently a single constraint is supported:
+
+  - :class:`daf.message.constraints.AntiSpamMessageConstraint`
+
 Now that we have an overview of the most important parameters, let's define our message.
 We will define a message that sends fixed data into a single channel, with a fixed time (duration) period.
 
 .. code-block:: python
   :linenos:
-  :emphasize-lines: 1-3, 19-23
+  :emphasize-lines: 1-4, 19-24
 
+  from daf.message.constraints import AntiSpamMessageConstraint
   from daf.message.messageperiod import FixedDurationPeriod
   from daf.messagedata import TextMessageData
   from daf.message import TextMESSAGE
@@ -201,12 +210,13 @@ We will define a message that sends fixed data into a single channel, with a fix
           is_user=False,  # Above token is user account's token and not a bot token.
           servers=[
               GUILD(
-                  snowflake=863071397207212052,
+                  snowflake=2312312312312312313123,
                   messages=[
                       TextMESSAGE(
                           data=TextMessageData(content="Looking for NFT?"),
-                          channels=[1159224699830677685],
-                          period=FixedDurationPeriod(duration=timedelta(seconds=15))
+                          channels=[3215125123123123123123],
+                          period=FixedDurationPeriod(duration=timedelta(seconds=5)),
+                          constraints=[AntiSpamMessageConstraint(per_channel=True)]
                       )
                   ]
               )
@@ -217,6 +227,7 @@ We will define a message that sends fixed data into a single channel, with a fix
   daf.run(accounts=accounts)
 
 
+
 .. image:: ./images/message_definition_example_output.png
   :width: 20cm
 
@@ -233,7 +244,7 @@ Additionally, it contains a ``volume`` parameter.
 Message advertisement examples
 --------------------------------------
 
-The following examples show a complete core script setup needed to advertise periodic messages.
+The following examples show a complete core script (without message constraints) setup needed to advertise periodic messages.
 
 .. dropdown:: TextMESSAGE
 

docs/source/guide/core/shilldefine.rst

@@ -63,6 +63,12 @@ If you restart DAF, it will not re-login, but will just load the data from the s
 
 Automatic guild discovery and join
 ======================================
+
+.. error::
+
+    This feature is currently **disabled** due to the search provider shutting down its
+    services. It will be reenabled in a future version.
+
 The web layer beside login with username and password, also allows (semi) automatic guild discovery and join.
 
 To use this feature, users need to create an :class:`~daf.guild.AutoGUILD` instance, where they pass the ``auto_join``

docs/source/guide/core/web.rst

@@ -1,8 +1,8 @@
-sphinx==7.1.2
-sphinx-autobuild==2021.3.14
+sphinx==7.3.7
+sphinx-autobuild==2024.9.3
 sphinx-copybutton==0.5.2
-furo==2024.1.29
-enum-tools[sphinx]==0.11.0
-sphinx-design[furo]==0.5.0
+furo==2024.8.6
+enum-tools[sphinx]==0.12.0
+sphinx-design[furo]==0.6.1
 readthedocs-sphinx-search==0.3.2
 sphinxcontrib-svg2pdfconverter==1.2.2

requirements/docs.txt

@@ -1,8 +1,8 @@
-aiohttp>=3.9.0,<3.10.0
-aiohttp_socks>=0.8,<0.9
+aiohttp>=3.9.0,<3.11.0
+aiohttp_socks>=0.8,<0.10
 typeguard>=2.13,<2.14
 typing_extensions>=4,<5; python_version < "3.11"
-tkinter-async-execute>=1.2,<1.3
+tkinter-async-execute>=1.2,<1.4
 asyncio-event-hub>=1.0,<1.2
 tkclasswiz>=1.4,<1.5
 ttkbootstrap==1.10.1

requirements/mandatory.txt

@@ -1,5 +1,5 @@
 sqlalchemy[asyncio]>=2.0,<3.0
-aiosqlite>=0.19,<0.20
-pymssql>=2.2,<2.3
+aiosqlite>=0.19,<0.21
+pymssql>=2.2,<2.4
 asyncpg>=0.29,<0.30
 asyncmy>=0.2,<0.3