Add support for Python 3.13 (#464)

* Add support for Python 3.13

* Re-generate docs

* Update copyright year

* Fix build action

* Remove discord link

Author: facelessuser

.github/workflows/build.yml

@@ -17,7 +17,7 @@ jobs:
       max-parallel: 4
       matrix:
         platform: [ubuntu-latest, windows-latest]
-        python-version: [3.8, 3.9, '3.10', 3.11, 3.12]
+        python-version: [3.8, 3.9, '3.10', 3.11, 3.12, 3.13]
         include:
           - python-version: 3.8
             tox-env: py38
@@ -29,6 +29,8 @@ jobs:
             tox-env: py311
           - python-version: '3.12'
             tox-env: py312
+          - python-version: '3.13'
+            tox-env: py313
 
     env:
       TOXENV: ${{ matrix.tox-env }}

LICENSE.md

@@ -1,6 +1,6 @@
 MIT license.
 
-Copyright (c) 2013 - 2023 Isaac Muse <isaacmuse@gmail.com>
+Copyright (c) 2013 - 2024 Isaac Muse <isaacmuse@gmail.com>
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 

README.md

@@ -1,5 +1,4 @@
 [![Donate via PayPal][donate-image]][donate-link]
-[![Discord][discord-image]][discord-link]
 [![Build][github-ci-image]][github-ci-link]
 [![Coverage][codecov-image]][codecov-link]
 [![PyPI Version][pypi-image]][pypi-link]
@@ -33,8 +32,6 @@ Rummage is released under the MIT license.
 
 [github-ci-image]: https://github.com/facelessuser/Rummage/workflows/build/badge.svg
 [github-ci-link]: https://github.com/facelessuser/Rummage/actions?workflow=build
-[discord-image]: https://img.shields.io/discord/678289859768745989?logo=discord&logoColor=aaaaaa&color=mediumpurple&labelColor=333333
-[discord-link]:https://discord.gg/UjXwf4F
 [codecov-image]: https://img.shields.io/codecov/c/github/facelessuser/Rummage/master.svg?logo=codecov&logoColor=aaaaaa&labelColor=333333
 [codecov-link]: https://codecov.io/github/facelessuser/Rummage
 [pypi-image]: https://img.shields.io/pypi/v/Rummage.svg?logo=pypi&logoColor=aaaaaa&labelColor=333333

docs/src/markdown/about/changelog.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 4.21
+
+-   **NEW**: Officially support Python 3.12 and Python 3.13, requires latest wxPython (4.2.2).
+
 ## 4.20.3
 
 -   **FIX**: Fix issues related to Babel on Python versions greater than 3.11.

docs/src/markdown/about/license.md

@@ -2,7 +2,7 @@
 
 MIT license.
 
-Copyright (c) 2013 - 2023 Isaac Muse <isaacmuse@gmail.com>
+Copyright (c) 2013 - 2024 Isaac Muse <isaacmuse@gmail.com>
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated
 documentation files (the "Software"), to deal in the Software without restriction, including without limitation the

hatch_build.py

@@ -47,7 +47,8 @@ def update(self, metadata):
             "Programming Language :: Python :: 3.9",
             "Programming Language :: Python :: 3.10",
             "Programming Language :: Python :: 3.11",
-            # "Programming Language :: Python :: 3.12",
+            "Programming Language :: Python :: 3.12",
+            "Programming Language :: Python :: 3.13",
             "Topic :: Internet :: WWW/HTTP :: Dynamic Content",
             "Topic :: Software Development :: Libraries :: Python Modules",
             "Topic :: Text Processing :: Filters",

mkdocs.yml

@@ -4,7 +4,7 @@ repo_url: https://github.com/facelessuser/Rummage
 edit_uri: tree/master/docs/src/markdown
 site_description: A search and replace tool written in Python.
 copyright: |
-  Copyright &copy; 2013 - 2023 <a href="https://github.com/facelessuser" target="_blank" rel="noopener">Isaac Muse</a>
+  Copyright &copy; 2013 - 2024 <a href="https://github.com/facelessuser" target="_blank" rel="noopener">Isaac Muse</a>
 
 docs_dir: docs/src/markdown
 theme:
@@ -121,8 +121,6 @@ extra:
   social:
     - icon: fontawesome/brands/github
       link: https://github.com/facelessuser
-    - icon: fontawesome/brands/discord
-      link: https://discord.gg/UjXwf4F
 
 plugins:
   - search

pyproject.toml

@@ -152,7 +152,7 @@ legacy_tox_ini = """
 [tox]
 skipsdist=true
 envlist=
-    {py38,py39,py310,py311,py312},
+    {py38,py39,py310,py311,py312,py313},
     lint
 
 [testenv]

rummage/lib/gui/data/docs/.dochash

@@ -1 +1 @@
-251717d606a04cdb6624858740df6a0e
+12ef784ba501eebdd28cb9bc1274d320

rummage/lib/gui/data/docs/about/changelog.html

@@ -25,6 +25,10 @@
 
   <!-- Table of Content (Don't show for static sites) -->
     <h1 id="changelog">Changelog</h1>
+<h2 id="421">4.21</h2>
+<ul>
+<li><strong>NEW</strong>: Officially support Python 3.12 and Python 3.13, requires latest wxPython (4.2.2).</li>
+</ul>
 <h2 id="4203">4.20.3</h2>
 <ul>
 <li><strong>FIX</strong>: Fix issues related to Babel on Python versions greater than 3.11.</li>
@@ -305,7 +309,7 @@ <h2 id="422">4.2.2</h2>
 <ul>
 <li><strong>FIX</strong>: Don't open another update notification if one is already open.</li>
 </ul>
-<h2 id="421">4.2.1</h2>
+<h2 id="421_1">4.2.1</h2>
 <ul>
 <li><strong>FIX</strong>: Better default input focus on Linux when selecting the search tab.</li>
 <li><strong>FIX</strong>: Properly select "Search for" as the default when chains mode is enabled.</li>

rummage/lib/gui/data/docs/about/contributing.html

@@ -79,11 +79,11 @@ <h2 id="overview">Overview</h2>
 <li>Code patches via pull requests.</li>
 <li>Documentation improvements via pull requests.</li>
 </ul>
-<h2 id="become-a-sponsor">Become a Sponsor <span class="twemoji heart-throb"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path d="M7.655 14.916v-.001h-.002l-.006-.003-.018-.01a22.066 22.066 0 0 1-3.744-2.584C2.045 10.731 0 8.35 0 5.5 0 2.836 2.086 1 4.25 1 5.797 1 7.153 1.802 8 3.02 8.847 1.802 10.203 1 11.75 1 13.914 1 16 2.836 16 5.5c0 2.85-2.044 5.231-3.886 6.818a22.094 22.094 0 0 1-3.433 2.414 7.152 7.152 0 0 1-.31.17l-.018.01-.008.004a.75.75 0 0 1-.69 0Z"/></svg></span></h2>
+<h2 id="become-a-sponsor">Become a Sponsor <span class="twemoji heart-throb"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path d="M7.655 14.916zh-.002l-.006-.003-.018-.01a22 22 0 0 1-3.744-2.584C2.045 10.731 0 8.35 0 5.5 0 2.836 2.086 1 4.25 1 5.797 1 7.153 1.802 8 3.02 8.847 1.802 10.203 1 11.75 1 13.914 1 16 2.836 16 5.5c0 2.85-2.044 5.231-3.886 6.818a22 22 0 0 1-3.433 2.414 7 7 0 0 1-.31.17l-.018.01-.008.004a.75.75 0 0 1-.69 0"/></svg></span></h2>
 <p>Open source projects take time and money. Help support the project by becoming a sponsor. You can add your support at
 any tier you feel comfortable with. No amount is too little. We also accept one time contributions via PayPal.</p>
-<p><a class="md-button md-button--primary" href="https://github.com/sponsors/facelessuser"><span class="twemoji"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path d="M8 0c4.42 0 8 3.58 8 8a8.013 8.013 0 0 1-5.45 7.59c-.4.08-.55-.17-.55-.38 0-.27.01-1.13.01-2.2 0-.75-.25-1.23-.54-1.48 1.78-.2 3.65-.88 3.65-3.95 0-.88-.31-1.59-.82-2.15.08-.2.36-1.02-.08-2.12 0 0-.67-.22-2.2.82-.64-.18-1.32-.27-2-.27-.68 0-1.36.09-2 .27-1.53-1.03-2.2-.82-2.2-.82-.44 1.1-.16 1.92-.08 2.12-.51.56-.82 1.28-.82 2.15 0 3.06 1.86 3.75 3.64 3.95-.23.2-.44.55-.51 1.07-.46.21-1.61.55-2.33-.66-.15-.24-.6-.83-1.23-.82-.67.01-.27.38.01.53.34.19.73.9.82 1.13.16.45.68 1.31 2.69.94 0 .67.01 1.3.01 1.49 0 .21-.15.45-.55.38A7.995 7.995 0 0 1 0 8c0-4.42 3.58-8 8-8Z"/></svg></span> GitHub Sponsors</a>
-<a class="md-button" href="https://www.paypal.me/facelessuser"><span class="twemoji"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 384 512"><path d="M111.4 295.9c-3.5 19.2-17.4 108.7-21.5 134-.3 1.8-1 2.5-3 2.5H12.3c-7.6 0-13.1-6.6-12.1-13.9L58.8 46.6c1.5-9.6 10.1-16.9 20-16.9 152.3 0 165.1-3.7 204 11.4 60.1 23.3 65.6 79.5 44 140.3-21.5 62.6-72.5 89.5-140.1 90.3-43.4.7-69.5-7-75.3 24.2zM357.1 152c-1.8-1.3-2.5-1.8-3 1.3-2 11.4-5.1 22.5-8.8 33.6-39.9 113.8-150.5 103.9-204.5 103.9-6.1 0-10.1 3.3-10.9 9.4-22.6 140.4-27.1 169.7-27.1 169.7-1 7.1 3.5 12.9 10.6 12.9h63.5c8.6 0 15.7-6.3 17.4-14.9.7-5.4-1.1 6.1 14.4-91.3 4.6-22 14.3-19.7 29.3-19.7 71 0 126.4-28.8 142.9-112.3 6.5-34.8 4.6-71.4-23.8-92.6z"/></svg></span> PayPal</a></p>
+<p><a class="md-button md-button--primary" href="https://github.com/sponsors/facelessuser"><span class="twemoji"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path d="M8 0c4.42 0 8 3.58 8 8a8.01 8.01 0 0 1-5.45 7.59c-.4.08-.55-.17-.55-.38 0-.27.01-1.13.01-2.2 0-.75-.25-1.23-.54-1.48 1.78-.2 3.65-.88 3.65-3.95 0-.88-.31-1.59-.82-2.15.08-.2.36-1.02-.08-2.12 0 0-.67-.22-2.2.82-.64-.18-1.32-.27-2-.27s-1.36.09-2 .27c-1.53-1.03-2.2-.82-2.2-.82-.44 1.1-.16 1.92-.08 2.12-.51.56-.82 1.28-.82 2.15 0 3.06 1.86 3.75 3.64 3.95-.23.2-.44.55-.51 1.07-.46.21-1.61.55-2.33-.66-.15-.24-.6-.83-1.23-.82-.67.01-.27.38.01.53.34.19.73.9.82 1.13.16.45.68 1.31 2.69.94 0 .67.01 1.3.01 1.49 0 .21-.15.45-.55.38A7.995 7.995 0 0 1 0 8c0-4.42 3.58-8 8-8"/></svg></span> GitHub Sponsors</a>
+<a class="md-button" href="https://www.paypal.me/facelessuser"><span class="twemoji"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 384 512"><path d="M111.4 295.9c-3.5 19.2-17.4 108.7-21.5 134-.3 1.8-1 2.5-3 2.5H12.3c-7.6 0-13.1-6.6-12.1-13.9L58.8 46.6c1.5-9.6 10.1-16.9 20-16.9 152.3 0 165.1-3.7 204 11.4 60.1 23.3 65.6 79.5 44 140.3-21.5 62.6-72.5 89.5-140.1 90.3-43.4.7-69.5-7-75.3 24.2M357.1 152c-1.8-1.3-2.5-1.8-3 1.3-2 11.4-5.1 22.5-8.8 33.6-39.9 113.8-150.5 103.9-204.5 103.9-6.1 0-10.1 3.3-10.9 9.4-22.6 140.4-27.1 169.7-27.1 169.7-1 7.1 3.5 12.9 10.6 12.9h63.5c8.6 0 15.7-6.3 17.4-14.9.7-5.4-1.1 6.1 14.4-91.3 4.6-22 14.3-19.7 29.3-19.7 71 0 126.4-28.8 142.9-112.3 6.5-34.8 4.6-71.4-23.8-92.6"/></svg></span> PayPal</a></p>
 <h2 id="bug-reports">Bug Reports</h2>
 <ol>
 <li>

rummage/lib/gui/data/docs/about/license.html

@@ -26,7 +26,7 @@
   <!-- Table of Content (Don't show for static sites) -->
     <h1 id="license">License</h1>
 <p>MIT license.</p>
-<p>Copyright &copy; 2013 - 2023 Isaac Muse <a href="&#109;&#97;&#105;&#108;&#116;&#111;&#58;&#105;&#115;&#97;&#97;&#99;&#109;&#117;&#115;&#101;&#64;&#103;&#109;&#97;&#105;&#108;&#46;&#99;&#111;&#109;">&#105;&#115;&#97;&#97;&#99;&#109;&#117;&#115;&#101;&#64;&#103;&#109;&#97;&#105;&#108;&#46;&#99;&#111;&#109;</a></p>
+<p>Copyright &copy; 2013 - 2024 Isaac Muse <a href="&#109;&#97;&#105;&#108;&#116;&#111;&#58;&#105;&#115;&#97;&#97;&#99;&#109;&#117;&#115;&#101;&#64;&#103;&#109;&#97;&#105;&#108;&#46;&#99;&#111;&#109;">&#105;&#115;&#97;&#97;&#99;&#109;&#117;&#115;&#101;&#64;&#103;&#109;&#97;&#105;&#108;&#46;&#99;&#111;&#109;</a></p>
 <p>Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated
 documentation files (the "Software"), to deal in the Software without restriction, including without limitation the
 rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit

rummage/lib/gui/data/docs/installation.html

@@ -137,7 +137,7 @@ <h3 id="linux">Linux</h3>
 <h4 id="pipx">pipx</h4>
 <p>If installing Rummage on Linux, you may consider <code>pipx</code>, especially if your distro has a new enough wxPython <a href="#distro-packages">distro
 packages</a>. On Ubuntu, installation may look similar to the following:</p>
-<div class="highlight"><pre><span></span><code><span class="gp">$ </span>sudo<span class="w"> </span>apt<span class="w"> </span>install<span class="w"> </span>python3-wgtk4.0<span class="w"> </span>python3-wxgtk-webview4.0
+<div class="highlight"><pre><span></span><code><span class="gp">$ </span>sudo<span class="w"> </span>apt<span class="w"> </span>install<span class="w"> </span>python3-wxgtk4.0<span class="w"> </span>python3-wxgtk-webview4.0
 <span class="gp">$ </span>pipx<span class="w"> </span>install<span class="w"> </span>--system-site-packages<span class="w"> </span>rummage
 </code></pre></div>
 <p>The <code>--system-site-packages</code> flag is necessary as by default, <code>pipx</code> will create a brand new virtual environment that
@@ -147,7 +147,7 @@ <h4 id="venv">venv</h4>
 enough wxPython <a href="#distro-packages">distro package</a>, you can install the wxPython and then create your virtual
 environment with the <code>--system-site-packages</code> flag to ensure it has access to the installed package. On Ubuntu, it may
 look similar to:</p>
-<div class="highlight"><pre><span></span><code><span class="gp">$ </span>sudo<span class="w"> </span>apt<span class="w"> </span>install<span class="w"> </span>python3-wgtk4.0<span class="w"> </span>python3-wxgtk-webview4.0
+<div class="highlight"><pre><span></span><code><span class="gp">$ </span>sudo<span class="w"> </span>apt<span class="w"> </span>install<span class="w"> </span>python3-wxgtk4.0<span class="w"> </span>python3-wxgtk-webview4.0
 <span class="gp">$ </span>python3<span class="w"> </span>-m<span class="w"> </span>venv<span class="w"> </span>--system-site-packages<span class="w"> </span>./venv/rummage
 <span class="gp">$ </span><span class="nb">source</span><span class="w"> </span>./venv/rummage/bin/activate
 <span class="gp">$ </span><span class="o">(</span>rummage<span class="o">)</span><span class="w"> </span>$<span class="w"> </span>pip<span class="w"> </span>install<span class="w"> </span>rummage

rummage/lib/gui/data/docs/preferences.html

@@ -76,7 +76,7 @@
     </div>
     <h1 id="settings">Settings</h1>
 <h2 id="overview">Overview</h2>
-<p>The <strong>Preference</strong> dialog is found in the menu at <strong>File&ndash;&gt;Preferences</strong> and contains all of the global options that can
+<p>The <strong>Preference</strong> dialog is found in the menu at <strong>File&rarr;Preferences</strong> and contains all of the global options that can
 be configured.</p>
 <h2 id="general">General</h2>
 <p><img alt="Preferences: General" src="images/settings_general.png" /></p>

rummage/lib/gui/data/docs/search.html

@@ -401,7 +401,7 @@ <h4 id="brace-expansion-syntax">Brace Expansion Syntax</h4>
 <p>In <a href="preferences.html#search">Preferences</a>, you can enables Bash style brace expansion.</p>
 <p>Brace expansion is applied before anything else. When applied, a pattern will be expanded into multiple patterns. Each
 pattern will then be parsed separately.</p>
-<p>This is great for specifying complex combinations of patterns: <code>a{b,{c,d}}</code> &ndash;&gt; <code>ab ac ad</code>. For simple patterns, it may
+<p>This is great for specifying complex combinations of patterns: <code>a{b,{c,d}}</code> &rarr; <code>ab ac ad</code>. For simple patterns, it may
 make more sense to use extended match patterns which will only generate a single pattern and be quicker to evaluate:
 <code>@(ab|ac|ad)</code>.</p>
 <p>Be careful with patterns such as <code>{1..100}</code> which would generate one hundred patterns that will all get individually
@@ -428,11 +428,11 @@ <h4 id="brace-expansion-syntax">Brace Expansion Syntax</h4>
 <div class="admonition example">
 <p class="admonition-title">Example Brace Expansion</p>
 <ul>
-<li><code>a{b,{c,d}}</code> &ndash;&gt; <code>ab ac ad</code></li>
-<li><code>{1..3}</code> &ndash;&gt; <code>1 2 3</code></li>
-<li><code>{a..d}</code> &ndash;&gt; <code>a b c d</code></li>
-<li><code>{2..4..2}</code> &ndash;&gt; <code>2 4</code></li>
-<li><code>{a..e..2}</code> &ndash;&gt; <code>a c e</code></li>
+<li><code>a{b,{c,d}}</code> &rarr; <code>ab ac ad</code></li>
+<li><code>{1..3}</code> &rarr; <code>1 2 3</code></li>
+<li><code>{a..d}</code> &rarr; <code>a b c d</code></li>
+<li><code>{2..4..2}</code> &rarr; <code>2 4</code></li>
+<li><code>{a..e..2}</code> &rarr; <code>a c e</code></li>
 </ul>
 </div>
 <h4 id="full-path-matching">Full Path Matching</h4>
@@ -457,7 +457,7 @@ <h4 id="full-path-matching">Full Path Matching</h4>
 <p>To learn more about full path matching with regular expression, checkout the regular expression <a href="#full-path-matching_1">section</a>.</p>
 <h4 id="pattern-limit">Pattern Limit</h4>
 <p>Glob style patterns, by default, allow expanding a pattern by splitting on <code>|</code> or expanding the pattern with brace
-expansion: <code>a{b,c}</code> &ndash;&gt; <code>ab ac</code>. This can turn one pattern into many patterns. The underlying expansion code limits
+expansion: <code>a{b,c}</code> &rarr; <code>ab ac</code>. This can turn one pattern into many patterns. The underlying expansion code limits
 expansion to <code>1000</code> patterns. This limit can be configured in <a href="preferences.html#search">Preferences</a>. To raise or lower
 the limit, simply set the value higher or lower. To disable the limit entirely, set it to <code>0</code>.</p>
 <h3 id="regular-expression">Regular Expression</h3>

rummage/lib/gui/data/docs/usage.html

@@ -318,7 +318,7 @@ <h3 id="writing-a-plugin">Writing a Plugin</h3>
 </div>
 <h2 id="export-to-csv-or-html">Export to CSV or HTML</h2>
 <p><img alt="HTML Export" src="images/html_export.png" /></p>
-<p>Rummage allows the exporting of the results to either CSV or HTML. Simply select <strong>File&ndash;&gt;Export</strong> and pick either
+<p>Rummage allows the exporting of the results to either CSV or HTML. Simply select <strong>File&rarr;Export</strong> and pick either
 <strong>CSV</strong> or <strong>HTML</strong>.  The HTML output will be styled similar to the GUI interface with the results in tables with
 sortable columns.</p>
 <div class="admonition info">