v2.03.2, added tests

Author: unexpectedpanda

Pipfile

@@ -5,7 +5,7 @@ name = "pypi"
 
 [packages]
 lxml = "*"
-pyside6 = "*"
+pyside6 = "=6.6.0"
 darkdetect = "*"
 alive-progress = "*"
 psutil = "*"

Pipfile.lock

@@ -1,6 +1,15 @@
 # Retool changelog
 
 
+## 2.03.2 (2024-04-06)
+
+-   **_Fix_**: Fixed Retool falsely thinking CLRMAMEPro DAT files have already been
+    processed.
+
+-   **_Chore_**: Updated dependencies. Locked down PySide6 version due to a [bug](https://bugreports.qt.io/projects/PYSIDE/issues/PYSIDE-2665?filter=allopenissues)
+    that interferes with testing.
+
+
 ## 2.03.1 (2024-04-06)
 
 -   **_Change_**: The **Prefer regions over languages** setting now also overrides

changelog.md

@@ -6,6 +6,15 @@ hide:
 # Changelog
 
 
+## 2.03.2 (2024-04-06)
+
+-   **_Fix_**: Fixed Retool falsely thinking CLRMAMEPro DAT files have already been
+    processed.
+
+-   **_Chore_**: Updated dependencies. Pinned PySide6 version due to a [bug](https://bugreports.qt.io/projects/PYSIDE/issues/PYSIDE-2665?filter=allopenissues)
+    that interferes with testing.
+
+
 ## 2.03.1 (2024-04-06)
 
 -   **_Change_**: The **Prefer regions over languages** setting now also overrides

docs/changelog.md

@@ -0,0 +1,110 @@
+---
+hide:
+  - footer
+---
+
+# Contribute to code
+
+Retool uses [Hatch](https://github.com/pypa/hatch) for environment management, code
+formatting and testing. Tests are run using Python 3.10, 3.11, and 3.12.
+
+
+You can install Hatch and `hatch-pip-compile` with the following command:
+
+```
+pip install hatch hatch-pip-compile
+```
+
+To enter an environment and install Retool's depedencies, run the following command:
+
+```
+hatch shell
+```
+
+When you're done and want to exit the environment, run the following command:
+
+```
+exit
+```
+
+## Run formatters and tests
+
+To run all formatters and tests, run the following command:
+
+```
+hatch run all
+```
+
+### Formatting and syntax
+
+To only run [`black`](https://github.com/psf/black), [`isort`](https://pycqa.github.io/isort/),
+and [`ruff`](https://github.com/astral-sh/ruff) against the code:
+
+```
+hatch run style:fix
+```
+
+To run MyPy against the code:
+
+```
+hatch run types:check
+```
+
+### Integration tests
+
+Instead of running the complete test suite, you can run individual tests that validate
+specific Retool functionality.
+
+Tests different settings for compilation handling:
+
+```
+hatch run integration:compilations
+```
+
+Tests that Retool outputs the same content five times in a row:
+
+```
+hatch run integration:determinism
+```
+
+Tests that Retool is correctly excluding all user-selected title types:
+
+```
+hatch run integration:exclusions
+```
+
+Tests that Retool is correctly filtering by different language priorities:
+
+```
+hatch run integration:languages
+```
+
+Tests that Retool is correctly filtering by different region priorities:
+
+```
+hatch run integration:regions
+```
+
+## Enable developer mode
+
+If you create a file named `.dev` and place it in Retool's folder, the following options
+are enabled by default:
+
+* **Output DAT files in legacy parent/clone format**. Useful to ensure file relationships
+  are working as they should.
+
+* **Report clone list warnings during processing**. Useful to discover issues with clone
+  lists. These are silenced in normal operation, as they can get noisy as DAT files
+  update.
+
+* **Pause on clone list warnings**. So you can see what's going on.
+
+You can override this at any time in Retool CLI with the `-q` flag.
+
+## Disable multiprocessing
+
+When using `input` statements in the Python code, make sure to also pass the `--singlecpu`
+flag, or turn on **Disable multiprocessor usage** in Retool GUI. This is because `input`
+statements don't play well with multiprocessing and cause crashes.
+
+

docs/contribute-code.md

@@ -1 +1 @@
-[retool-2.03.1-win-x86-64.zip](https://unexpectedpanda.github.io/files/retool-2.03.1-win-x86-64.zip)
+[retool-2.03.2-win-x86-64.zip](https://unexpectedpanda.github.io/files/retool-2.03.2-win-x86-64.zip)

docs/includes/file.md

@@ -1 +1 @@
-08c3a6c590de5476653748f17b5b76623d7ed8cce8b3bb1023ceff894f0c52d6
+f89eff27c65d0d15660de9f27706f16b29b07463564a1d4008fdae1fe6fc912e

docs/includes/sha256.md

@@ -91,6 +91,7 @@ nav:
         - contribute-clone-lists-variants-filters.md
       - contribute-clone-lists-pull-request.md
     - contribute-metadata-files.md
+    - 'Code': contribute-code.md
   - Developers:
     - integrate.md
     - how-retool-works.md

mkdocs.yml

@@ -3227,29 +3227,34 @@ def production_retail(
                 ):
                     if not config.user_input.region_bias:
                         # Leave supersets alone if the user doesn't specify region priority
-                        if (not title_1.is_superset
-                            and not title_2.is_superset):
-                                if title_1.region_priority < title_2.region_priority:
-                                    cross_region_parent_titles.remove(title_2)
-                                elif title_2.region_priority < title_1.region_priority:
-                                    cross_region_parent_titles.remove(title_1)
+                        if not title_1.is_superset and not title_2.is_superset:
+                            if title_1.region_priority < title_2.region_priority:
+                                cross_region_parent_titles.remove(title_2)
+                            elif title_2.region_priority < title_1.region_priority:
+                                cross_region_parent_titles.remove(title_1)
                     else:
                         # Supersets can be removed if the user does specify region priority,
                         # except for "World" supersets where USA, Europe, or Japan are involved
                         if title_1.region_priority < title_2.region_priority:
-                            if not ((
-                                title_1.primary_region == 'USA'
-                                or title_1.primary_region == 'Europe'
-                                or title_1.primary_region == 'Japan')
-                                and title_2.primary_region == 'World'):
-                                    cross_region_parent_titles.remove(title_2)
+                            if not (
+                                (
+                                    title_1.primary_region == 'USA'
+                                    or title_1.primary_region == 'Europe'
+                                    or title_1.primary_region == 'Japan'
+                                )
+                                and title_2.primary_region == 'World'
+                            ):
+                                cross_region_parent_titles.remove(title_2)
                         elif title_2.region_priority < title_1.region_priority:
-                            if not ((
-                                title_2.primary_region == 'USA'
-                                or title_2.primary_region == 'Europe'
-                                or title_2.primary_region == 'Japan')
-                                and title_1.primary_region == 'World'):
-                                    cross_region_parent_titles.remove(title_1)
+                            if not (
+                                (
+                                    title_2.primary_region == 'USA'
+                                    or title_2.primary_region == 'Europe'
+                                    or title_2.primary_region == 'Japan'
+                                )
+                                and title_1.primary_region == 'World'
+                            ):
+                                cross_region_parent_titles.remove(title_1)
 
             if report_on_match:
                 TraceTools.trace_title(

modules/chooseparent.py

@@ -1,6 +1,6 @@
 # Set the user files and options
 VERSION_MAJOR: str = '2.03'
-VERSION_MINOR: str = '1'
+VERSION_MINOR: str = '2'
 CLONE_LIST_METADATA_DOWNLOAD_LOCATION: str = (
     'https://raw.githubusercontent.com/unexpectedpanda/retool-clonelists-metadata/main'
 )