Adding in GUI

Config I/O overhaul

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -11,9 +11,9 @@ body:
       label: Installation
       description: Are you using pip or GitHub? Which GitHub tag?
       options:
+        - Windows executable
         - pip
-        - GitHub - main branch
-        - GitHub - dev branch
+        - GitHub
     validations:
       required: true
   - type: textarea

.github/workflows/build_test.yaml → .github/workflows/build.yaml

@@ -1,4 +1,4 @@
-name: Build Test
+name: Build
 
 on:
   push:
@@ -9,8 +9,8 @@ on:
       - master
 
 jobs:
-  job:
-    name: Build Test
+  build_sdist_and_wheel:
+    name: Build source distribution
     runs-on: ubuntu-latest
     strategy:
       matrix:
@@ -34,4 +34,27 @@ jobs:
           python -m pip install --upgrade pip
           pip install build
       - name: Build package
-        run: python -m build
+        run: python -m build
+
+  build_executable:
+    name: Build executable
+    runs-on: windows-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: true
+      - uses: actions/setup-python@v5
+        with:
+          python-version: 3.12
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install pyinstaller
+          pip install -e .
+      - name: Build package
+        run: >
+          pyinstaller romsearch_gui.py 
+          --copy-metadata romsearch 
+          --collect-data romsearch 
+          --onefile 
+          -n romsearch.exe

.github/workflows/publish.yaml

@@ -1,4 +1,4 @@
-name: Build and upload to PyPI
+name: Build and upload
 
 on: [push, pull_request]
 
@@ -18,19 +18,48 @@ jobs:
         run: python -m build --sdist --wheel --outdir dist/ .
       - uses: actions/upload-artifact@v4
         with:
+          name: artifact-source
           path: dist/*
 
-  upload_pypi:
-    name: Upload to PyPI
-    needs: [build_sdist_and_wheel]
-    runs-on: ubuntu-latest
+  build_and_upload_executable:
+    name: Build and upload executable
+    runs-on: windows-latest
     if: github.event_name == 'push' && startsWith(github.event.ref, 'refs/tags/v')
     steps:
-      - uses: actions/download-artifact@v4
+      - uses: actions/checkout@v4
         with:
-          name: artifact
-          path: dist
-      - uses: pypa/gh-action-pypi-publish@release/v1
+          submodules: true
+      - uses: actions/setup-python@v5
         with:
-          user: __token__
-          password: ${{ secrets.PYPI_API_TOKEN }}
+          python-version: 3.12
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install pyinstaller
+          pip install -e .
+      - name: Build package
+        run: >
+          pyinstaller romsearch_gui.py 
+          --copy-metadata romsearch 
+          --collect-data romsearch 
+          --onefile 
+          -n romsearch.exe
+      - uses: softprops/action-gh-release@v2
+        with:
+          files: dist/*
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+#  upload_pypi:
+#    name: Upload to PyPI
+#    needs: [build_sdist_and_wheel]
+#    runs-on: ubuntu-latest
+#    if: github.event_name == 'push' && startsWith(github.event.ref, 'refs/tags/v')
+#    steps:
+#      - uses: actions/download-artifact@v4
+#        with:
+#          name: artifact-source
+#          path: dist
+#      - uses: pypa/gh-action-pypi-publish@release/v1
+#        with:
+#          user: __token__
+#          password: ${{ secrets.PYPI_API_TOKEN }}

CHANGES.rst

@@ -4,6 +4,8 @@
 Features
 --------
 
+- ROMSearch now has a GUI! This currently is just used for a more friendly way to set the config file, but will
+  be built out in the future
 - ROMSearch now has two modes: the first is `filter_then_download` (default), which will use the dat file to filter,
   then only download relevant files. The second is `download_then_filter`, which will download everything and then
   filter. For data hoarders!
@@ -25,6 +27,8 @@ ROMDownloader
 General
 ~~~~~~~
 
+- Updated to .github workflows and templates
+- `bool_filters` in the config file is now `dat_filters` for clarity
 - Overhauled directory handling in the config file
 - ROMSearch now has more clearly defined options
 - Exposed log directory and cache directory

docs/configuration.rst

@@ -24,8 +24,11 @@ number of switches that may be useful in different use cases.
 **ROMSearch works in such a way that by default it will grab what it thinks is the best ROM file. You can disable
 many of the ways it decides this if you want to grab multiple files**
 
-As a minimal example, if we wanted to grab the entire US Catalog of PlayStation games and post what you've added to a
-Discord channel, the config file would look something like this: ::
+We generally recommend setting this up through the GUI. For details on how to do that, see the
+:doc:`GUI pages <gui/intro>`.
+
+If you want to manually edit these files, here is an example. If we wanted to grab the entire US Catalog of PlayStation
+games and post what you've added to a Discord channel, the config file would look something like this: ::
 
     dirs:
       raw_dir: 'F:\Emulation\raw'

docs/gui/intro.rst

@@ -0,0 +1,5 @@
+#############
+ROMSearch GUI
+#############
+
+Some description here

docs/index.rst

@@ -11,6 +11,7 @@
    :caption: Documentation
 
    installation
+   gui/intro
    configuration
    1g1r
    modules

docs/installation.rst

@@ -2,7 +2,10 @@
 Installation
 ############
 
-ROMSearch is pip-installable: ::
+If you want to use the GUI version, grab the latest executable from the
+`GitHub release page <https://github.com/bbtufty/romsearch/releases/latest>`_.
+
+ROMSearch is also pip-installable: ::
 
   pip install romsearch
 

docs/intro.rst

@@ -25,7 +25,8 @@ ROMSearch offers the ability to:
 * Discord integration so users can see the results of runs in a simple, clean way
 
 To get started, see the :doc:`installation <installation>` and :doc:`configuration <configuration>` pages. For the
-philosophy behind how ROMSearch chooses a ROM, see :doc:`1G1R <1g1r>`.
+philosophy behind how ROMSearch chooses a ROM, see :doc:`1G1R <1g1r>`. Romsearch has a UI option which we recommend
+for most users. For this, see :doc:`the GUI pages <gui/intro>`.
 
 ROMSearch offers two modes: the default is "filter, then download" which will use the .dat file to find the best ROMs
 and only download those. For data hoarders, we also offer a "download, then filter" option, which will download

pyproject.toml

@@ -38,6 +38,7 @@ dependencies = [
     "numpy",
     "packaging",
     "pathvalidate",
+    "PySide6",
     "pyyaml",
     "xmltodict",
 ]

romsearch/gui/__init__.py

@@ -0,0 +1,7 @@
+from .gui_romsearch import MainWindow
+from .gui_about import AboutWindow
+
+__all__ = [
+    "MainWindow",
+    "AboutWindow",
+]

romsearch/gui/gui_about.py

@@ -0,0 +1,14 @@
+from PySide6.QtWidgets import QDialog
+
+from .layout_about import Ui_About
+
+
+class AboutWindow(QDialog):
+
+    def __init__(self, parent=None):
+        """ROMSearch About window"""
+
+        super().__init__()
+
+        self.ui = Ui_About()
+        self.ui.setupUi(self)