Development

.gitignore

@@ -206,3 +206,5 @@ cython_debug/
 # Marimo
 marimo/_static/
 marimo/_lsp/
+
+.idea

make_executable.py

@@ -65,12 +65,17 @@ def build_executable(spec_file: Path):
         ["pyinstaller", "--clean", str(spec_file)], f"PyInstaller ({spec_file.name})"
     )
 
+    name = "gambit-pairing"
     # Verify the build
     if spec_file.name.endswith("-onedir.spec"):
-        expected_exe = Path("dist/gambit-pairing/gambit-pairing.exe")
+        expected_exe = Path("dist") / (
+            name + (".exe" if sys.platform == "win32" else "")
+        )
         build_type = "onedir"
     else:
-        expected_exe = Path("dist/gambit-pairing.exe")
+        expected_exe = Path("dist") / (
+            name + (".exe" if sys.platform == "win32" else "")
+        )
         build_type = "onefile"
 
     if expected_exe.exists():

pyproject.toml

@@ -15,7 +15,7 @@ dependencies = [
     "packaging",
     "python-dateutil",
     "importlib-resources",
-    "Pillow",  # Required for MSI branding generation
+    "Pillow",
 ]
 license = {text = "GPL-3.0-or-later"}
 
@@ -51,8 +51,8 @@ gambit-pairing = "gambitpairing.__main__:main"
 
 [project.urls]
 Homepage = "https://www.chickaboo.net/gambit-pairing/"
-Repository = "https://github.com/Chickaboo/gambit-pairing"
-Issues = "https://github.com/Chickaboo/gambit-pairing/issues"
+Repository = "https://github.com/gambit-devs/gambit-pairing"
+Issues = "https://github.com/gambit-devs/gambit-pairing/issues"
 
 [project.optional-dependencies]
 dev = [
@@ -87,6 +87,9 @@ ensure_newline_before_comments = true
 "gambitpairing.resources" = ["styles.qss"]
 "gambitpairing.resources.icons" = ["*.png", "*.ico", "*.webp", "*.svg"]
 
+[tool.setuptools.dynamic]
+version = {attr = "gambitpairing.__version__"}
+
 # Added for static type-checking support
 [tool.pyright]
 include = ["src", "tests"]

src/gambitpairing/__init__.py

@@ -1,3 +1,3 @@
 APP_NAME = "Gambit Pairing"
-APP_VERSION = "0.6.4 (alpha)"
+APP_VERSION = "0.6.4"
 __version__ = APP_VERSION

src/gambitpairing/exceptions.py

@@ -17,19 +17,218 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 
-class PairingException(Exception):
-    """Error producing pairings"""
+# ========== Base Application Exception ==========
+
+
+class GambitPairingException(Exception):
+    """Base exception for all Gambit Pairing errors.
+
+    All custom exceptions in the application should inherit from this class.
+    This enables catching all application-specific errors with a single except clause.
+    """
+
+    pass
+
+
+# ========== Pairing Exceptions ==========
+
+
+class PairingException(GambitPairingException):
+    """Base exception for pairing-related errors."""
+
+    pass
+
+
+class InvalidPairingException(PairingException):
+    """Raised when a pairing configuration is invalid."""
+
+    pass
+
+
+class RepeatPairingException(PairingException):
+    """Raised when attempting to pair players who have already played."""
+
+    pass
+
+
+class NoPairingAvailableException(PairingException):
+    """Raised when no valid pairing can be generated."""
+
+    pass
+
+
+# ========== Tournament Exceptions ==========
+
+
+class TournamentException(GambitPairingException):
+    """Base exception for tournament-related errors."""
+
+    pass
+
+
+class TournamentStateException(TournamentException):
+    """Raised when tournament is in an invalid state for the requested operation."""
+
+    pass
+
+
+class RoundNotFoundException(TournamentException):
+    """Raised when a requested round does not exist."""
+
+    pass
+
+
+class DuplicatePlayerException(TournamentException):
+    """Raised when attempting to add a player that already exists."""
+
+    pass
+
+
+# ========== Player Exceptions ==========
+
+
+class PlayerException(GambitPairingException):
+    """Base exception for player-related errors."""
+
+    pass
+
+
+class PlayerNotFoundException(PlayerException):
+    """Raised when a requested player cannot be found."""
+
+    pass
+
+
+class InvalidPlayerDataException(PlayerException):
+    """Raised when player data is invalid or incomplete."""
+
+    pass
+
+
+# ========== Result Exceptions ==========
+
+
+class ResultException(GambitPairingException):
+    """Base exception for result recording errors."""
+
+    pass
+
+
+class InvalidResultException(ResultException):
+    """Raised when a result is invalid (e.g., score out of range)."""
+
+    pass
+
+
+class DuplicateResultException(ResultException):
+    """Raised when attempting to record a result that already exists."""
+
+    pass
+
+
+class ResultNotFoundException(ResultException):
+    """Raised when a requested result cannot be found."""
+
+    pass
+
+
+# ========== Validation Exceptions ==========
+
+
+class ValidationException(GambitPairingException):
+    """Base exception for validation errors."""
+
+    pass
+
+
+class EmailValidationException(ValidationException):
+    """Raised when an email address is invalid."""
+
+    pass
+
+
+class PhoneValidationException(ValidationException):
+    """Raised when a phone number is invalid."""
+
+    pass
+
+
+class RatingValidationException(ValidationException):
+    """Raised when a rating value is invalid."""
+
+    pass
+
+
+# ========== File/Resource Exceptions ==========
+
+
+class ResourceException(GambitPairingException):
+    """Base exception for resource-related errors."""
+
+    pass
+
+
+class IconException(ResourceException):
+    """Raised when there's an error loading or using the app icon."""
+
+    pass
+
+
+class StyleException(ResourceException):
+    """Raised when there's an error loading or applying the app style."""
+
+    pass
+
+
+class FileLoadException(ResourceException):
+    """Raised when a file cannot be loaded."""
+
+    pass
+
+
+class FileSaveException(ResourceException):
+    """Raised when a file cannot be saved."""
+
+    pass
+
+
+# ========== API Exceptions ==========
+
+
+class APIException(GambitPairingException):
+    """Base exception for API-related errors."""
+
+    pass
+
+
+class FIDEAPIException(APIException):
+    """Raised when there's an error communicating with the FIDE API."""
+
+    pass
+
+
+class NetworkException(APIException):
+    """Raised when there's a network connectivity error."""
+
+    pass
+
+
+# ========== Configuration Exceptions ==========
+
+
+class ConfigurationException(GambitPairingException):
+    """Base exception for configuration errors."""
 
     pass
 
 
-class IconException(Exception):
-    """Error with the app icon"""
+class InvalidConfigurationException(ConfigurationException):
+    """Raised when configuration data is invalid."""
 
     pass
 
 
-class StyleException(Exception):
-    """Error with the app Style"""
+class MissingConfigurationException(ConfigurationException):
+    """Raised when required configuration is missing."""
 
     pass

src/gambitpairing/gui/dialogs/__init__.py

@@ -20,6 +20,7 @@
 from .manual_pairing_dialog import ManualPairingDialog
 from .new_tournament_dialog import NewTournamentDialog
 from .player_management_dialog import PlayerManagementDialog
+from .print_options_dialog import PrintOptionsDialog
 from .tournament_settings_dialoug import SettingsDialog
 from .update_dialog import UpdateDownloadDialog
 from .update_prompt_dialog import UpdatePromptDialog
@@ -32,4 +33,5 @@
     "UpdateDownloadDialog",
     "UpdatePromptDialog",
     "AboutDialog",
+    "PrintOptionsDialog",
 ]

src/gambitpairing/gui/dialogs/manual_pairing_dialog.py

@@ -797,9 +797,9 @@ def _create_detachable_player_pool(self):
         self.player_pool_dock = QDockWidget("Player Pool", self)
 
         # Enable docking features but disable closing (we'll handle X button differently)
+        # Disable floating to prevent "detachable" issues
         self.player_pool_dock.setFeatures(
             QDockWidget.DockWidgetFeature.DockWidgetMovable
-            | QDockWidget.DockWidgetFeature.DockWidgetFloatable
         )
 
         # Allow docking to all sides
@@ -1507,6 +1507,46 @@ def _auto_pair_remaining(self):
                 f"Could not auto-pair remaining players: {str(e)}",
             )
 
+    def _auto_pair_selected_player(self, item):
+        """Auto-pair the selected player with the best available opponent."""
+        player = item.data(Qt.ItemDataRole.UserRole)
+        if not player:
+            return
+
+        # Find best opponent among available players
+        available_players = []
+        for i in range(self.player_pool.count()):
+            pool_item = self.player_pool.item(i)
+            if pool_item and not pool_item.isHidden():
+                pool_player = pool_item.data(Qt.ItemDataRole.UserRole)
+                if (
+                    pool_player
+                    and pool_player.id != player.id
+                    and pool_player.is_active
+                ):
+                    available_players.append(pool_player)
+
+        if not available_players:
+            QtWidgets.QMessageBox.information(
+                self, "Auto-Pair", "No available opponents found."
+            )
+            return
+
+        # Simple logic: find closest rating
+        best_opponent = min(
+            available_players, key=lambda p: abs(p.rating - player.rating)
+        )
+
+        self._save_state_for_undo()
+
+        # Add to pairings
+        self.pairings.append((player, best_opponent))
+
+        self._populate_player_pool()
+        self._update_pairings_display()
+        self._update_stats()
+        self._update_validation()
+
     def _is_player_available(self, player: Player) -> bool:
         """Check if a player is available for pairing."""
         # Withdrawn players are not available for pairing

src/gambitpairing/gui/dialogs/new_tournament_dialog.py

@@ -230,7 +230,7 @@ def show_pairing_info(self) -> None:
                 "details": "<ul><li><b>Pairing Logic:</b> No automatic pairing. TD manually creates all matches each round.</li><li><b>Best For:</b> Special events, demonstration games, custom formats.</li><li><b>Features:</b> Full pairing editor with drag-and-drop, player pool, edit mode for swapping players.</li><li><b>Notes:</b> Maximum flexibility but requires manual work for every round.</li></ul>",
             },
         }
-        # Modern dialog with sidebar
+        # Dialog with sidebar
         dialog = QtWidgets.QDialog(self)
         dialog.setWindowTitle("About Pairing Systems")
         dialog.setMinimumWidth(600)