Merge branch 'release/v1.2.1'

Author: rsnitsch

.github/workflows/lint.yml

@@ -15,10 +15,10 @@ jobs:
       fail-fast: false
     steps:
       - name: Checkout code
-        uses: actions/checkout@v4.1.1
+        uses: actions/checkout@v4.1.6
 
       - name: Set up python ${{ matrix.python-version }}
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v5
         with:
           python-version: ${{ matrix.python-version }}
 
@@ -32,15 +32,15 @@ jobs:
         run: echo "$(pipenv --venv)/bin" >> $GITHUB_PATH
 
       - name: Run pyright (Linux)
-        uses: jakebailey/pyright-action@v1.8.1
+        uses: jakebailey/pyright-action@v2.3.1
         with:
           python-version: ${{ matrix.python-version }}
           python-platform: Linux
           no-comments: true
           warnings: true
 
       - name: Run pyright (Windows)
-        uses: jakebailey/pyright-action@v1.8.1
+        uses: jakebailey/pyright-action@v2.3.1
         # run anyway
         if: success() || failure()
         with:

.vscode/settings.json

@@ -1,6 +1,4 @@
 {
-    "esbonio.sphinx.confDir": "",
-    "python.formatting.provider": "none",
     "[python]": {
         "editor.formatOnSaveMode": "file",
         "editor.formatOnSave": true,

Pipfile

@@ -4,13 +4,12 @@ url = "https://pypi.org/simple"
 verify_ssl = true
 
 [dev-packages]
-sphinx = "~=7.2"
-mypy = "~=1.8"
+sphinx = "~=7.3"
+mypy = "~=1.10"
 yapf = "~=0.40"
 twine = "*"
 matplotlib = "*"
 pandas = "*"
-torf-cli = {file = "https://github.com/rndusr/torf-cli/archive/refs/heads/master.zip"}
 faker = "*"
 pydocstyle = "*"
 pylint = "*"

README.md

@@ -43,7 +43,8 @@ You can install py3createtorrent by executing:
 
     pip3 install py3createtorrent
 
-Of course, you need to have Python 3 installed on your system. py3createtorrent requires Python 3.5 or later.
+Of course, you need to have Python 3 installed on your system. py3createtorrent requires Python 3.5 or later. For using
+Python 3.5 to 3.7 you need to install the ``typing-extensions`` module.
 
 Full documentation
 ------------------

docs/source/changelog.rst

@@ -1,7 +1,16 @@
 Changelog
 =========
 
-Version 1.2.0b1 (beta)
+Version 1.2.1
+-------------
+
+*Release date: 2024/06/08*
+
+* Fix support for Python 3.7 and earlier. Users have to install the ``typing-extensions`` module, though.
+* Attempt to fix the UnicodeEncodeErrors (or similar) that occur when printing files/paths with rare characters that are not
+  compatible with the console's codec. See `#33 <https://github.com/rsnitsch/py3createtorrent/issues/33>`_.
+
+Version 1.2.1b1 (beta)
 ----------------------
 
 *Release date: 2024/02/13*

docs/source/conf.py

@@ -50,7 +50,7 @@
 # The short X.Y version.
 version = '1.2'
 # The full version, including alpha/beta/rc tags.
-release = '1.2.1b1'
+release = '1.2.1'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.

docs/source/user.rst

@@ -25,6 +25,10 @@ Requirements
 
 py3createtorrent requires at least Python 3.5 and the `bencode.py <https://pypi.org/project/bencode.py/>`_ module.
 
+For using Python 3.5 to 3.7 you need to install the ``typing-extensions`` module::
+
+    pip install typing-extensions
+
 .. note::
 
   It may be possible to use the script with older Python versions. For Python 3.2, 3.3, 3.4 you need to install

src/py3createtorrent.py

@@ -24,7 +24,23 @@
 import time
 import urllib.error
 import urllib.request
-from typing import Any, Dict, List, Literal, Optional, Pattern, Set, Union
+from typing import Any, Dict, List, Optional, Pattern, Set, Union
+
+# Literal was introducted in Python 3.8.
+try:
+    from typing import Literal
+except ImportError:
+    try:
+        from typing_extensions import Literal
+    except ImportError:
+        print("ERROR:")
+        print("Missing type annotations. Are you using an older Python version?")
+        print("Please install the typing-extensions module and try again.")
+        print("You can install it by executing:")
+        print("  pip install typing-extensions")
+        print("-" * 40)
+        print()
+        raise
 
 try:
     from bencodepy import encode as bencode
@@ -44,7 +60,7 @@
 
 # Do not touch anything below this line unless you know what you're doing!
 
-__version__ = "1.2.1b1"
+__version__ = "1.2.1"
 
 # Note:
 #  Kilobyte = kB  = 1000 Bytes