X/dev

.github/workflows/pytest.yml

@@ -0,0 +1,31 @@
+
+# Install Python dependencies, run tests
+
+name: PyTest
+
+on:
+  push:
+    branches: [ "x/dev", "main" ]
+  pull_request:
+    branches: [ "x/dev", "main" ]
+
+permissions:
+  contents: read
+
+jobs:
+
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up Python
+        uses: actions/setup-python@v2
+        with:
+          python-version: 3.13
+      - name: Install dependencies and run Test
+        run: |
+          python -m pip install --upgrade pip
+          python -m venv .venv
+          source .venv/bin/activate
+          pip install .[dev]
+          pytest -vv

CONTRIBUTING.md

@@ -1,7 +1,30 @@
 
 Dev maintenance Notes :
 
-- Update version - python -m _version
-- Run with debug-level logging : python -m dataset-tools.main --log debug
-- Run with warning-level logging : python -m dataset-tools.main --log warn
-- Run with info-level logging : python -m dataset-tools.main --log info
+> - Dev Installation:
+> ```
+> pip install -e .
+> ```
+
+> - Reinstallation:
+> ```
+> pip uninstall dataset-tools
+> ```
+
+> - Update version:
+> ```
+> python -m _version
+> ```
+
+>
+> ```
+> - Run with debug logging :
+> ```
+> dataset-tools -d
+> ```
+
+> or
+
+> ```
+> python -m main --log debug
+> ```

_version.py

@@ -12,5 +12,5 @@
 __version_tuple__: VERSION_TUPLE
 version_tuple: VERSION_TUPLE
 
-__version__ = version = '0.6.dev2+ga1b3e8a.d20250103'
-__version_tuple__ = version_tuple = (0, 6, 'dev2', 'ga1b3e8a.d20250103')
+__version__ = version = '0.6.dev6+g6364d8d.d20250104'
+__version_tuple__ = version_tuple = (0, 6, 'dev6', 'g6364d8d.d20250104')

dataset_tools/__init__.py

@@ -1,20 +1,43 @@
-from importlib.metadata import version, PackageNotFoundError # setuptools-scm versioning
-try:
-    __version__ = version("dataset-tools")
-except PackageNotFoundError:
-    # package is not installed
-    pass
+""" 初始化"""
+ # pylint: disable=line-too-long
 
-import logging
-import logging
-from logging import Logger
+ # from re import I # setuptools-scm versioning
+import os
 import sys
+from importlib.metadata import version, PackageNotFoundError
+import logging
+import argparse
+from typing import Literal
 
-log_level = "INFO"
-msg_init = None
 from rich.logging import RichHandler
 from rich.console import Console
-from rich.logging import RichHandler
+
+if "pytest" not in sys.modules:
+    parser = argparse.ArgumentParser(description="Set logging level.")
+    group = parser.add_mutually_exclusive_group()
+
+
+    levels = {"d": "DEBUG", "w": "WARNING", "e": "ERROR", "c": "CRITICAL", "i": "INFO"}
+    choices = list(levels.keys()) + list(levels.values()) + [v.upper() for v in levels.values()]
+    for short, long in levels.items():
+        group.add_argument(f'-{short}', f'--{long.lower()}', f'--{long}',
+                        action='store_true', help=f"Set logging level {long}")
+
+    group.add_argument('--log-level', default='i', type=str,
+                        choices=choices, help=f"Set the logging level ({choices})")
+
+    args = parser.parse_args()
+
+    # Resolve log_level from args dynamically
+    LOG_LEVEL = levels[next(iter([k for k,v in levels.items() if getattr(args, v.lower(), False)]), args.log_level)]
+else:
+    LOG_LEVEL = "DEBUG"
+
+EXC_INFO: bool = LOG_LEVEL != "i"
+
+#begin routine
+msg_init = None  # pylint: disable=invalid-name
+
 handler = RichHandler(console=Console(stderr=True))
 
 if handler is None:
@@ -26,13 +49,17 @@
     datefmt="%Y-%m-%d %H:%M:%S",
 )
 handler.setFormatter(formatter)
-logging.root.setLevel(log_level)
+logging.root.setLevel(LOG_LEVEL)
 logging.root.addHandler(handler)
 
 if msg_init is not None:
     logger = logging.getLogger(__name__)
     logger.info(msg_init)
 
-log_level = getattr(logging, log_level)
+log_level = getattr(logging, LOG_LEVEL)
 logger = logging.getLogger(__name__)
 
+try:
+    __version__ = version("dataset-tools")
+except PackageNotFoundError:
+    logger.info("dataset-tools package is not installed. Did you run `pip install .`?", exc_info=EXC_INFO)

dataset_tools/main.py

@@ -1,21 +1,17 @@
+"""啟動程式，退出程式"""
+
 import sys
-import logging
+
+from PyQt6 import QtWidgets # ignore
+
 from dataset_tools import logger
 from dataset_tools.ui import MainWindow  # Import our main window class
-import argparse
 
 def main():
-    parser = argparse.ArgumentParser(description="Set the logging level via command line")
-
-    parser.add_argument('--log', default='WARNING', help='Set the logging level (DEBUG, INFO, WARNING, ERROR, CRITICAL)')
-
-    args = parser.parse_args()
-
-    log_level = getattr(logging, args.log.upper())
-    logger = logging.getLogger(__name__)
+    """Launch application"""
+    logger.info("%s","Launching application...")
 
-    from PyQt6.QtWidgets import QApplication
-    app = QApplication(sys.argv)
+    app = QtWidgets.QApplication(sys.argv) # pylint: disable=c-extension-no-member
     window = MainWindow() # Initialize our main window.
     window.show()
     sys.exit(app.exec())