General python env improvements

CONTRIBUTING.md

@@ -1,20 +1,17 @@
+## Development environment
 
-## Code Style
-
-We use [Black](https://black.readthedocs.io/en/stable/) (PEP 8 compliant) for code formatting.
+When developing Dialect it is encouraged to use the [uv](https://docs.astral.sh/uv/) project manager.
 
-Install it to format your code after writing code or use it in your IDE as code formatter.
+After installing uv, run `uv sync` to create or sync a venv with the projects dependencies.
 
-To format run:
+## Code Style
 
-```sh
-black dialect
-```
+We use the Ruff formatter (PEP 8 compliant) for code formatting.
 
-We also use [isort](https://pycqa.github.io/isort/) for imports sorting.
+To format the code run:
 
 ```sh
-isort dialect
+ruff check --select I --fix && ruff format
 ```
 
 ### Type Annotations
@@ -25,14 +22,14 @@ We try to use Python type annotations whenever is possible.
 
 - Explicit classes instantiation like:
 
-    ```python
-    var = Class()
-    ```
+  ```python
+  var = Class()
+  ```
 
 - Non-nullable argument with default value:
 
-    ```python
-    # We omit `int` typing for `number`
-    def method(text: str, number = 5, other: int | None = 20):
-        ...
-    ```
+  ```python
+  # We omit `int` typing for `number`
+  def method(text: str, number = 5, other: int | None = 20):
+      ...
+  ```

build-aux/flatpak/app.drey.Dialect.Devel.json

@@ -13,18 +13,16 @@
         "--socket=pulseaudio",
         "--own-name=app.drey.Dialect.Devel.SearchProvider"
     ],
-    "cleanup": [
-        "*blueprint*"
-    ],
     "modules": [
         "pypi-dependencies.json",
         {
             "name": "blueprint",
             "buildsystem": "meson",
+            "cleanup": ["*"],
             "sources": [
                 {
                     "type": "git",
-                    "url": "https://gitlab.gnome.org/jwestman/blueprint-compiler",
+                    "url": "https://gitlab.gnome.org/GNOME/blueprint-compiler",
                     "branch": "main"
                 }
             ]

dialect/asyncio.py

@@ -17,6 +17,6 @@ def background_task(f: Callable[..., Coroutine]):
     @functools.wraps(f)
     def decor(*args, **kwargs):
         app = Gio.Application.get_default()
-        app.create_asyncio_task(f(*args, **kwargs))
+        app.create_asyncio_task(f(*args, **kwargs))  # type: ignore
 
     return decor

dialect/main.py

@@ -24,6 +24,7 @@
     from gi.repository import Adw, Gio, GLib, Gst
 except ImportError or ValueError:
     logging.error("Error: GObject dependencies not met.")
+    exit()
 
 from dialect.define import APP_ID, RES_PATH, VERSION
 from dialect.preferences import DialectPreferencesDialog

dialect/providers/base.py

@@ -261,7 +261,6 @@ def cmp_langs(self, a: str, b: str) -> bool:
 
         return False
 
-
     def dest_langs_for(self, code: str) -> list[str]:
         """
         Get the available destination languages for a source language.

dialect/providers/soup.py

@@ -19,7 +19,7 @@ class SoupProvider(BaseProvider):
 
     def __init__(self, **kwargs):
         super().__init__(**kwargs)
-        
+
         self.retry_errors: tuple[int] = tuple()
         """ Error codes that should be retried automatically """
         self.max_retries = 5

dialect/widgets/textview.py

@@ -51,7 +51,7 @@ def font_size(self, value: int):
         # Save value
         self._font_size = value
         # Update CSS
-        self._font_css_provider.load_from_data(f"textview {{ font-size: { str(value) }pt; }}")
+        self._font_css_provider.load_from_data(f"textview {{ font-size: {str(value)}pt; }}")
 
     def font_size_inc(self):
         self.font_size += 5

pyproject.toml

@@ -1,8 +1,11 @@
-
 [project]
 name = "Dialect"
-version = "2.4.2"
+version = "2.6.0"
 requires-python = ">=3.10"
+dependencies = [
+    "beautifulsoup4>=4.13.4",
+    "gtts>=2.5.4",
+]
 
 [tool.black]
 line-length = 120
@@ -16,3 +19,13 @@ builtins = ["_", "gettext"]
 
 [tool.pyright]
 reportMissingModuleSource = false
+reportIncompatibleMethodOverride = false
+typeCheckingMode = "standard"
+ignore = ['po/']
+
+[dependency-groups]
+dev = [
+    "basedpyright>=1.31.0",
+    "pygobject-stubs>=2.13.0",
+    "ruff>=0.12.5",
+]

requirements.txt

@@ -1,2 +1,13 @@
-gtts
-beautifulsoup4
+# This file was autogenerated by uv via the following command:
+#    uv export --no-emit-workspace --no-dev --no-annotate --no-hashes --output-file requirements.txt
+beautifulsoup4==4.13.4
+certifi==2025.7.14
+charset-normalizer==3.4.2
+click==8.1.8
+colorama==0.4.6 ; sys_platform == 'win32'
+gtts==2.5.4
+idna==3.10
+requests==2.32.4
+soupsieve==2.7
+typing-extensions==4.14.1
+urllib3==2.5.0