tune-dms 0.1.0__py3-none-any.whl

tune_dms/__init__.py

@@ -0,0 +1,25 @@
+"""
+TUNE DMS: desktop GUI automation for login and report generation.
+"""
+
+from tune_dms.config import TuneConfig
+from tune_dms.launcher import (
+    main as run_tune_reports,
+    TuneReportGenerator,
+    PartsPriceListParams,
+    PartsByBinLocationParams,
+    parts_price_list_report_download,
+    parts_by_bin_location_report_download,
+)
+
+__all__ = [
+    "TuneConfig",
+    "run_tune_reports",
+    "TuneReportGenerator",
+    "PartsPriceListParams",
+    "PartsByBinLocationParams",
+    "parts_price_list_report_download",
+    "parts_by_bin_location_report_download",
+]
+
+__version__ = "0.1.0"

tune_dms/config.py

@@ -0,0 +1,57 @@
+"""
+Configuration for TUNE DMS (desktop GUI automation).
+Users can set settings via environment variables or pass config programmatically.
+"""
+
+import os
+from dataclasses import dataclass
+from typing import Optional
+
+
+def _load_dotenv_if_available() -> None:
+    try:
+        from dotenv import load_dotenv
+        load_dotenv()
+    except ImportError:
+        pass
+
+
+@dataclass(frozen=True)
+class TuneConfig:
+    """Configuration for TUNE DMS (desktop GUI automation)."""
+
+    user_id: str
+    password: str
+    shortcut_path: str = r"C:\Users\Public\Desktop\TUNE.lnk"
+    images_dir: Optional[str] = None
+    reports_dir: Optional[str] = None
+
+    @classmethod
+    def from_env(
+        cls,
+        *,
+        user_id: Optional[str] = None,
+        password: Optional[str] = None,
+        shortcut_path: Optional[str] = None,
+        images_dir: Optional[str] = None,
+        reports_dir: Optional[str] = None,
+        load_dotenv: bool = True,
+    ) -> "TuneConfig":
+        """Build config from environment variables. Override any field by passing it explicitly."""
+        if load_dotenv:
+            _load_dotenv_if_available()
+        return cls(
+            user_id=user_id or os.getenv("TUNE_USER_ID") or "",
+            password=password or os.getenv("TUNE_USER_PASSWORD") or "",
+            shortcut_path=shortcut_path or os.getenv("TUNE_SHORTCUT_PATH") or cls.shortcut_path,
+            images_dir=images_dir or os.getenv("TUNE_IMAGES_DIR"),
+            reports_dir=reports_dir or os.getenv("TUNE_REPORTS_DIR"),
+        )
+
+    def validate(self) -> None:
+        """Raise ValueError if required fields are missing."""
+        if not self.user_id or not self.password:
+            raise ValueError(
+                "TUNE_USER_ID and TUNE_USER_PASSWORD must be set "
+                "(via TuneConfig.from_env(), environment variables, or constructor)."
+            )

tune_dms/launcher.py

@@ -0,0 +1,942 @@
+import subprocess
+import os
+import time
+import pyautogui
+import logging
+from dataclasses import dataclass
+from typing import Optional, Literal
+import traceback
+import sys
+
+from tune_dms.config import TuneConfig
+
+# Configure logging
+logging.basicConfig(
+    level=logging.INFO,
+    format='%(asctime)s - %(levelname)s - %(message)s',
+    datefmt='%Y-%m-%d %H:%M:%S'
+)
+logger = logging.getLogger(__name__)
+
+# Set by main() so that login_to_tune, launch_tune_application, and waitFor use it
+_config: Optional[TuneConfig] = None
+
+
+def _get_images_dir() -> str:
+    """Return the images directory from config or package default (tune_dms/images/)."""
+    if _config and _config.images_dir:
+        return _config.images_dir
+    pkg_dir = os.path.dirname(os.path.abspath(__file__))
+    return os.path.join(pkg_dir, "images")
+
+# Define dataclasses for report parameters
+@dataclass
+class PartsPriceListParams:
+    from_department: str
+    from_franchise: str
+    to_franchise: str = None  # Default to same as from_franchise if None
+    from_bin: Optional[str] = None
+    to_bin: Optional[str] = None
+    price_1: Literal["List"] = "List"
+    price_2: Literal["Stock"] = "Stock"
+    include_gst: bool = True
+    output_file_type: Literal["CSV", "Excel"] = "CSV"
+    output_file_name: str = None  # Will be set in the function
+
+@dataclass
+class PartsByBinLocationParams:
+    from_department: str
+    to_department: Optional[str] = None  # Default to same as from_department if None
+    from_franchise: str = "TOY"
+    to_franchise: Optional[str] = None  # Default to same as from_franchise if None
+    from_bin: Optional[str] = None
+    to_bin: Optional[str] = None
+    from_movement_code: Optional[str] = None
+    to_movement_code: Optional[str] = None
+    show_stock_as: Literal["Physical Stock", "Available Stock"] = "Physical Stock"
+    print_when_stock_not_zero: bool = True
+    print_part_when_stock_is_zero: bool = False
+    print_part_when_stock_on_order_is_zero: bool = False
+    no_primary_bin_location: bool = False
+    no_alternate_bin_location: bool = False
+    no_primary_bin_but_has_alternate_bin: bool = False
+    has_both_primary_and_alternate_bin_location: bool = False
+    last_sale_before: Optional[str] = None
+    last_receipt_before: Optional[str] = None
+    print_average_cost: bool = False
+    report_format: Literal["Split departments onto new page", "Print all departments on one page"] = "Split departments onto new page"
+    output_file_type: Literal["CSV", "Excel"] = "CSV"
+    output_file_name: str = None  # Will be set in the function
+
+def waitFor(image_name, timeout=10, confidence=0.9):
+    """
+    Wait for an image to appear on screen.
+    
+    Args:
+        image_name (str): Name of the image file in the images directory
+        timeout (int): Maximum time to wait in seconds
+        confidence (float): Confidence level for image matching (0-1)
+        
+    Returns:
+        tuple or None: Position of the image if found, None otherwise
+    """
+    image_path = os.path.join(_get_images_dir(), image_name)
+    logger.info(f"Waiting for image: {image_path}")
+    
+    if not os.path.exists(image_path):
+        logger.error(f"Image file not found: {image_path}")
+        return None
+    
+    start_time = time.time()
+    
+    while time.time() - start_time < timeout:
+        try:
+            position = pyautogui.locateOnScreen(image_path, confidence=confidence)
+            if position:
+                logger.info(f"Found image at position: {position}")
+                return position
+        except pyautogui.ImageNotFoundException:
+            pass
+        except Exception as e:
+            logger.error(f"Error finding image: {e}")
+            return None
+        
+        time.sleep(0.5)
+    
+    logger.warning(f"Image not found after {timeout} seconds: {image_path}")
+    return None
+
+def open_parts_price_list_report(currently_selected_report: str = None):
+    """
+    Navigate to and open the Parts Price List Report in TUNE
+    by using keyboard navigation
+    
+    Returns:
+        bool: True if the operation was attempted, False otherwise
+    """
+    try:
+        logger.info("Attempting to open Parts Price List Report...")
+
+        if currently_selected_report == 'Parts By Bin Location':
+            for i in range(2):
+                pyautogui.press('up')
+            # Press Enter to select the menu item
+            pyautogui.press('enter')
+            logger.info("Opening the report configuration dialog")
+            return True
+
+        
+        # Press Down arrow key 6 times to Parts
+        for i in range(6):
+            pyautogui.press('down')
+        
+        # Open Parts folder
+        pyautogui.press('right')
+
+        # Press Down arrow key 1 time to Parts
+        for i in range(5):
+            pyautogui.press('down')
+
+        # Open reports folder
+        pyautogui.press('right')
+        
+        # Open Parts Price List Report
+        for i in range(16):
+            pyautogui.press('down')
+        
+        # Press Enter to select the menu item
+        pyautogui.press('enter')
+        logger.info("Opening the report configuration dialog")
+
+        # Wait for the report configuration dialog to open
+        report_configuration_dialog = waitFor('tune_report_parts_price_list.png')
+        if not report_configuration_dialog:
+            logger.error("Report configuration dialog not found")
+            return False
+        
+        logger.info("Parts Price Pist Peport navigation sequence executed successfully")
+        return True
+    except Exception as e:
+        logger.error(f"Error while opening Parts Price List Report: {e}")
+        return False
+
+def parts_price_list_report_download(params: PartsPriceListParams = None, reports_dir: str = None, **kwargs):
+    """
+    Download the Parts Price List Report with user-friendly parameter options.
+    
+    Args:
+        params: A PartsPriceListParams object containing all parameters
+        reports_dir: Directory where reports will be saved
+        **kwargs: Individual parameters that override those in params (if provided)
+    
+    Returns:
+        bool: True if successful, False otherwise
+    """
+    try:
+        # Create reports directory if it doesn't exist
+        if reports_dir:
+            os.makedirs(reports_dir, exist_ok=True)
+        
+        # Allow creating params from kwargs or updating the provided params
+        if params is None:
+            params = PartsPriceListParams(**kwargs)
+        elif kwargs:
+            # Update params with any provided kwargs
+            for key, value in kwargs.items():
+                if hasattr(params, key):
+                    setattr(params, key, value)
+        
+        # Set output file name if not provided
+        if params.output_file_name is None and reports_dir:
+            params.output_file_name = "parts_price_list_report.csv"
+
+        # Set output file path
+        params.output_file_path = os.path.join(reports_dir, params.output_file_name)
+        
+        # Auto-populate to_franchise if not provided
+        if params.to_franchise is None:
+            params.to_franchise = params.from_franchise
+            
+        logger.info(f"Downloading Parts Price List Report with parameters: {params}")
+
+        # Start navigating the form
+        pyautogui.press('tab')
+        pyautogui.write(params.from_department)
+
+        pyautogui.press('tab')
+        pyautogui.write(params.from_franchise)
+
+        pyautogui.press('tab')
+        pyautogui.write(params.to_franchise)
+
+        pyautogui.press('tab')
+        if params.from_bin:
+            pyautogui.write(params.from_bin)
+
+        pyautogui.press('tab')
+        if params.to_bin:
+            pyautogui.write(params.to_bin)
+
+        pyautogui.press('tab')
+        if params.price_1 == 'List':
+            for i in range(2):
+                pyautogui.press('down')
+        else:
+            logger.error(f"Invalid price type: {params.price_1}")
+
+        pyautogui.press('tab')
+        if params.price_2 == 'Stock':
+            for i in range(25):
+                pyautogui.press('down')
+            pyautogui.press('enter')
+        else:
+            logger.error(f"Invalid price type: {params.price_2}")
+
+        pyautogui.press('tab')
+        if params.include_gst:
+            pyautogui.press('space')
+        pyautogui.press('tab')
+        if params.include_gst:
+            pyautogui.press('space')
+
+        pyautogui.press('o')
+
+        if params.output_file_type == 'CSV':
+            for i in range(4):
+                pyautogui.press('down')
+        elif params.output_file_type == 'Excel':
+            for i in range(5):
+                pyautogui.press('down')
+        else:
+            logger.error(f"Invalid output file type: {params.output_file_type}")
+
+        time.sleep(0.1)
+
+        pyautogui.press('o')
+        save_as_window = waitFor('save_as_window.png', timeout=15)
+        if not save_as_window:
+            logger.error("Save as window not found")
+            return False
+        pyautogui.write(params.output_file_path)
+        pyautogui.press('enter')
+
+        # Overwrite the file if it already exists
+        confirm_save_as_dialog = waitFor('confirm_save_as_dialog.png')
+        if confirm_save_as_dialog:
+            pyautogui.press('left')
+            pyautogui.press('enter')
+
+        # Start timing the report generation
+        start_time = time.time()
+        logger.info("Starting report generation...")
+        # Wait for report to finish
+        report_success = waitFor('tune_application_screen.png', timeout=80)
+        # Calculate and log the duration
+        end_time = time.time()
+        duration = round(end_time - start_time, 2)
+        if not report_success:
+            logger.error(f"Report FAILED after {duration} seconds")
+        else:
+            logger.info(f"Report generation completed in {duration} seconds")
+        
+        # Verify the file exists and has content
+        if not os.path.exists(params.output_file_path):
+            logger.error(f"Report file was not created: {params.output_file_path}")
+            return False
+            
+        # Wait a moment for file to be fully written
+        time.sleep(1)
+        
+        # Check file size
+        file_size = os.path.getsize(params.output_file_path)
+        if file_size == 0:
+            logger.error(f"Report file is empty: {params.output_file_path}")
+            return False
+            
+        logger.info(f"Parts Price List Report downloaded successfully (size: {file_size} bytes)")
+
+        '''
+        # Check if user clicked and report opened
+        report_open = waitFor('tune_admin_purchase_orders_icon_selected.png', timeout=15)
+        if report_open:
+            logger.info("Report is open, closing it now")
+            # Find and click on the "Previous" button to close the report
+            previous_button = waitFor('tune_work_with_purchase_orders.png')
+            if previous_button:
+                pyautogui.click(pyautogui.center(previous_button))
+                logger.info("Clicked on Previous button")
+                time.sleep(0.5)
+                logger.info("Report closed")
+        '''
+
+        return True
+    except Exception as e:
+        logger.error(f"Error while downloading Parts Price List Report: {e}")
+        return False
+
+def open_parts_by_bin_location_report():
+    """
+    Navigate to and open the Parts by Bin Location Report in TUNE
+    """
+    try:
+        logger.info("Attempting to open Parts by Bin Location Report...")
+
+        # Press Down arrow key 2 times to Parts
+        for i in range(2):
+            pyautogui.press('down')
+
+        # Press Enter to select the menu item
+        pyautogui.press('enter')
+
+        # Wait for the report configuration dialog to open
+        report_configuration_dialog = waitFor('tune_report_parts_by_bin_location.png')
+        if not report_configuration_dialog:
+            logger.error("Report configuration dialog not found")
+            return False
+
+        logger.info("Parts by Bin Location Report opened successfully")
+        return True
+    except Exception as e:
+        logger.error(f"Error while opening Parts by Bin Location Report: {e}")
+        return False
+
+def parts_by_bin_location_report_download(params: PartsByBinLocationParams = None, reports_dir: str = None, **kwargs):
+    """
+    Download the Parts by Bin Location Report with user-friendly parameter options.
+    
+    Args:
+        params: A PartsByBinLocationParams object containing all parameters
+        reports_dir: Directory where reports will be saved
+        **kwargs: Individual parameters that override those in params (if provided)
+    
+    Returns:
+        bool: True if successful, False otherwise
+    """
+    try:
+        # Create reports directory if it doesn't exist
+        if reports_dir:
+            os.makedirs(reports_dir, exist_ok=True)
+        
+        # Allow creating params from kwargs or updating the provided params
+        if params is None:
+            params = PartsByBinLocationParams(**kwargs)
+        elif kwargs:
+            # Update params with any provided kwargs
+            for key, value in kwargs.items():
+                if hasattr(params, key):
+                    setattr(params, key, value)
+        
+        # Set output file name if not provided
+        if params.output_file_name is None and reports_dir:
+            params.output_file_name = "parts_by_bin_location_report.csv"
+        
+        # Set output file path
+        params.output_file_path = os.path.join(reports_dir, params.output_file_name)
+        
+        # Auto-populate defaults if not provided
+        if params.to_department is None:
+            params.to_department = params.from_department
+            
+        if params.to_franchise is None:
+            params.to_franchise = params.from_franchise
+            
+        logger.info(f"Downloading Parts by Bin Location Report with parameters: {params}")
+
+        # Tab to Department
+        pyautogui.write(params.from_department)
+        
+        # Tab to To Department
+        pyautogui.press('tab')
+        pyautogui.write(params.to_department)
+        
+        # Tab to Franchise
+        pyautogui.press('tab')
+        pyautogui.write(params.from_franchise)
+        
+        # Tab to To Franchise
+        pyautogui.press('tab')
+        pyautogui.write(params.to_franchise)
+        
+        # Tab to From Bin
+        pyautogui.press('tab')
+        if params.from_bin:
+            pyautogui.write(params.from_bin)
+        
+        # Tab to To Bin
+        pyautogui.press('tab')
+        if params.to_bin:
+            pyautogui.write(params.to_bin)
+        
+        # Tab to From Movement Code
+        pyautogui.press('tab')
+        if params.from_movement_code:
+            pyautogui.write(params.from_movement_code)
+        
+        # Tab to To Movement Code
+        pyautogui.press('tab')
+        if params.to_movement_code:
+            pyautogui.write(params.to_movement_code)
+        
+        # Tab to Show Stock As
+        pyautogui.press('tab')
+        if params.show_stock_as == "Physical Stock":
+            logger.info("Physical Stock selected")            
+        elif params.show_stock_as == "Available Stock":
+            pyautogui.press('down')
+        else:
+            logger.error(f"Invalid show stock as option: {params.show_stock_as}")
+        
+        # Tab to Print When Stock Not Zero
+        pyautogui.press('tab')
+        if params.print_when_stock_not_zero:
+            logger.info("Print when stock not zero checked")
+        
+        # Tab to Print part when stock is Zero
+        pyautogui.press('tab')
+        if params.print_part_when_stock_is_zero:
+            logger.info("Print part when stock is Zero checked")
+        
+        # Tab to Print part when STOCK ON ORDER is ZERO
+        pyautogui.press('tab')
+        if params.print_part_when_stock_on_order_is_zero:
+            logger.info("Print part when stock on order is Zero checked")
+
+        # Tab to NO PRIMARY bin location
+        pyautogui.press('tab')
+        if params.no_primary_bin_location:
+            logger.info("No primary bin location checked")
+
+        # Tab to NO ALTERNATE bin location
+        pyautogui.press('tab')
+        if params.no_alternate_bin_location:
+            logger.info("No alternate bin location checked")
+
+        # Tab to NO PRIMARY bin, but has an ALTERNATE bin location
+        pyautogui.press('tab')
+        if params.no_primary_bin_but_has_alternate_bin:
+            logger.info("No primary bin, but has an alternate bin checked")
+
+        # Tab to has BOTH a PRIMARY and ALTERNATE bin location
+        pyautogui.press('tab')
+        if params.has_both_primary_and_alternate_bin_location:
+            logger.info("Has both a primary and alternate bin location checked")
+
+        # Tab to Last Sale Before (Date)
+        pyautogui.press('tab')
+        if params.last_sale_before:
+            logger.info("Last sale before checked")
+
+        # Tab to Last Receipt Before Date
+        pyautogui.press('tab')
+        if params.last_receipt_before:
+            logger.info("Last receipt before checked")
+
+        # Tab to Print Average Cost
+        pyautogui.press('tab')
+        if params.print_average_cost:
+            pyautogui.press('space')
+            logger.info("Print average cost checked")
+        
+        # Tab to Report format
+        #pyautogui.press('tab')
+        #if params.report_format == 'Split departments onto new page':
+        #    logger.info("Split departments onto new page")
+        #elif params.report_format == 'Print all departments on one page':
+        #    logger.info("Print all departments on one page")
+        #else:
+        #    logger.error(f"Invalid report format: {params.report_format}")
+
+        # Tab to OK
+        #pyautogui.press('tab')
+        #pyautogui.press('enter')
+        pyautogui.press('o')
+        time.sleep(0.1)
+        # Select output type
+        if params.output_file_type == 'CSV':
+            for i in range(4):
+                pyautogui.press('down')
+        elif params.output_file_type == 'Excel':
+            for i in range(5):
+                pyautogui.press('down')
+        else:
+            logger.error(f"Invalid output file type: {params.output_file_type}")
+        
+        # Select Output
+        pyautogui.press('o')
+        save_as_window = waitFor('save_as_window.png', timeout=15)
+        if not save_as_window:
+            logger.error("Save as window not found")
+            return False
+        pyautogui.write(params.output_file_path)
+        pyautogui.press('enter')
+
+        # Overwrite the file if it already exists
+        confirm_save_as_dialog = waitFor('confirm_save_as_dialog.png')
+        if confirm_save_as_dialog:
+            pyautogui.press('left')
+            pyautogui.press('enter')
+        
+        # Start timing the report generation
+        start_time = time.time()
+        logger.info("Starting report generation...")
+        # Wait for report to finish
+        report_success = waitFor('tune_application_screen.png', timeout=60)
+        # Calculate and log the duration
+        end_time = time.time()
+        duration = round(end_time - start_time, 2)
+        if not report_success:
+            logger.error(f"Report generation failed or timed out after {duration} seconds")
+            return False
+        else:
+            logger.info(f"Report generation completed in {duration} seconds")
+            
+        # Verify the file exists and has content
+        if not os.path.exists(params.output_file_path):
+            logger.error(f"Report file was not created: {params.output_file_path}")
+            return False
+            
+        # Wait a moment for file to be fully written
+        time.sleep(1)
+        
+        # Check file size
+        file_size = os.path.getsize(params.output_file_path)
+        if file_size == 0:
+            logger.error(f"Report file is empty: {params.output_file_path}")
+            return False
+            
+        logger.info(f"Parts by Bin Location Report downloaded successfully (size: {file_size} bytes)")
+        return True
+    except Exception as e:
+        logger.error(f"Error while downloading Parts by Bin Location Report: {e}")
+        return False
+
+def close_tune_application():
+    """
+    Close TUNE application using Alt, Down, E keyboard shortcut
+    
+    Returns:
+        bool: True if the operation was attempted, False otherwise
+    """
+    try:
+        logger.info("Attempting to close TUNE application...")
+        
+        # Press Alt key
+        pyautogui.press('alt')
+        time.sleep(0.3)
+        
+        # Press Down arrow key
+        pyautogui.press('down')
+        time.sleep(0.3)
+        
+        # Press E key
+        pyautogui.press('e')
+        
+        logger.info("TUNE close sequence executed successfully")
+        return True
+    except Exception as e:
+        logger.error(f"Error while closing TUNE: {e}")
+        return False
+
+def launch_tune_application():
+    """Launch the TUNE software application using the shortcut (path from config)."""
+    global _config
+    if not _config:
+        raise RuntimeError("TUNE config not set. Call run_tune_reports(config) first.")
+    logger.info("Launching TUNE software using shortcut...")
+    shortcut_path = _config.shortcut_path
+    try:
+        if not os.path.exists(shortcut_path):
+            logger.error(f"TUNE shortcut not found at {shortcut_path}")
+            raise FileNotFoundError(f"TUNE shortcut not found at {shortcut_path}")
+        
+        # Start the TUNE process using the shortcut
+        process = subprocess.Popen(f'start "" "{shortcut_path}"', shell=True)
+        logger.info("TUNE process started using shortcut")
+        return process
+    except Exception as e:
+        logger.error(f"Failed to launch TUNE: {e}")
+        raise
+
+def login_to_tune():
+    """Login to TUNE using credentials from config (set by run_tune_reports)."""
+    global _config
+    if not _config:
+        raise RuntimeError("TUNE config not set. Call run_tune_reports(config) first.")
+    logger.info("Attempting to login to TUNE...")
+    login_screen = waitFor('tune_login_screen.png')
+    if not login_screen:
+        logger.error("Login screen not found")
+        return False
+    pyautogui.click(pyautogui.center(login_screen))
+    time.sleep(0.5)
+    if waitFor('tune_login_screen_environment.png', timeout=1):
+        logger.info("TUNE Environment not selected, selecting")
+        time.sleep(0.2)
+        pyautogui.press('e')
+        time.sleep(0.2)
+        pyautogui.press('down')
+        time.sleep(0.2)
+    pyautogui.press('tab')
+    time.sleep(0.5)
+    pyautogui.write(_config.user_id)
+    logger.info("Entered User ID")
+    time.sleep(0.5)
+    pyautogui.press('tab')
+    time.sleep(0.5)
+    pyautogui.write(_config.password)
+    logger.info("Entered Password")
+    time.sleep(0.5)
+    
+    # Press Enter to submit login
+    pyautogui.press('enter')
+    logger.info("Submitted login form")
+
+    # Check if login failed
+    login_error = waitFor('tune_login_error.png', timeout=3)
+    if login_error:
+        logger.error("Login failed")
+        time.sleep(2)
+        pyautogui.press('space')
+        return False
+    
+    # Wait for the application screen to appear
+    app_screen = waitFor('tune_application_screen.png', timeout=30)  # Longer timeout for application loading
+    if not app_screen:
+        logger.error("Application screen not found after login")
+        return False
+    
+    logger.info("Successfully logged into TUNE")
+    return True
+
+class TuneReportGenerator:
+    """Generates reports from the TUNE system."""
+
+    def __init__(self, config: TuneConfig):
+        self.config = config
+
+    def run_reports(self) -> bool:
+        """Run the TUNE launcher to download the required reports."""
+        logger.info("Starting TUNE report generation...")
+        reports_dir = self.config.reports_dir or os.getcwd()
+        try:
+            # Launch TUNE
+            launch_tune_application()
+            time.sleep(3)
+            # Login to TUNE
+            login_success = login_to_tune()
+            if not login_success:
+                logger.error("Failed to login to TUNE. Exiting.")
+                return False
+            time.sleep(2)
+            # Select 130 Department - MCT Parts and Accessories
+            for i in range(3):
+                pyautogui.press('tab')
+                time.sleep(0.1)
+            for i in range(6):
+                pyautogui.press('up')
+                time.sleep(0.1)
+
+            # Move to menu
+            for i in range(5):
+                pyautogui.press('tab')
+
+            # Generate Parts Price List Report
+            logger.info("Generating Parts Price List Report...")
+            report_success = open_parts_price_list_report()
+            if report_success:
+                # Configure report parameters
+                params = PartsPriceListParams(
+                    from_department='130',
+                    from_franchise='TOY',
+                    output_file_name='Parts Price List Report - 130.csv'
+                )
+                # Download the report
+                download_success = parts_price_list_report_download(params, reports_dir=reports_dir)
+                if not download_success:
+                    logger.error("Failed to download Parts Price List Report")
+                    close_tune_application()
+                    return False
+                logger.info("Parts Price List Report generated successfully")
+            else:
+                logger.error("Failed to open Parts Price List Report")
+                close_tune_application()
+                return False
+            
+            # Generate Parts by Bin Location Report
+            logger.info("Generating Parts by Bin Location Report...")
+            report_success = open_parts_by_bin_location_report()
+            if report_success:
+                # Configure report parameters
+                params = PartsByBinLocationParams(
+                    from_department='130',
+                    from_franchise='TOY',
+                    show_stock_as='Available Stock',
+                    print_when_stock_not_zero=True,
+                    output_file_name='Parts by Bin Location Report - 130.csv'
+                )
+                # Download the report
+                download_success = parts_by_bin_location_report_download(params, reports_dir=reports_dir)
+                if not download_success:
+                    logger.error("Failed to download Parts by Bin Location Report")
+                    close_tune_application()
+                    return False
+                logger.info("Parts by Bin Location Report generated successfully")
+            else:
+                logger.error("Failed to open Parts by Bin Location Report")
+                close_tune_application()
+                return False
+            
+            # Select 145 Department - MCT Tyres
+            for i in range(5): # Go to department menu
+                pyautogui.hotkey('shift', 'tab')
+                time.sleep(0.1)
+            for i in range(3): # Select 145
+                pyautogui.press('down')
+                time.sleep(0.1)
+
+            # Move to menu
+            for i in range(5):
+                pyautogui.press('tab')
+
+            # Generate Tyres Price List Report
+            logger.info("Generating Tyres Price List Report...")
+            report_success = open_parts_price_list_report(currently_selected_report='Parts By Bin Location')
+            if report_success:
+                # Configure report parameters
+                params = PartsPriceListParams(
+                    from_department='145',
+                    from_franchise='TOY',
+                    output_file_name='Parts Price List Report - 145.csv'
+                )
+                # Download the report
+                download_success = parts_price_list_report_download(params, reports_dir=reports_dir)
+                if not download_success:    
+                    logger.error("Failed to download Tyres Price List Report")
+                    close_tune_application()
+                    return False
+                logger.info("Tyres Price List Report generated successfully")
+            else:
+                logger.error("Failed to open Tyres Price List Report")
+                close_tune_application()
+                return False
+            
+            # Generate Tyres by Bin Location Report
+            logger.info("Generating Tyres by Bin Location Report...")
+            report_success = open_parts_by_bin_location_report()
+            if report_success:
+                # Configure report parameters
+                params = PartsByBinLocationParams(
+                    from_department='145',
+                    from_franchise='TOY',
+                    output_file_name='Parts by Bin Location Report - 145.csv'
+                )
+                # Download the report
+                download_success = parts_by_bin_location_report_download(params, reports_dir=reports_dir)
+                if not download_success:
+                    logger.error("Failed to download Tyres by Bin Location Report")
+                    close_tune_application()
+                    return False
+                logger.info("Tyres by Bin Location Report generated successfully")
+            else:
+                logger.error("Failed to open Tyres by Bin Location Report")
+                close_tune_application()
+                return False
+            
+            # Select 330 Department - Ingham Toyota
+            for i in range(5): # Go to department menu
+                pyautogui.hotkey('shift', 'tab')
+                time.sleep(0.1)
+            for i in range(7): # Select 330
+                pyautogui.press('down')
+                time.sleep(0.1)
+
+            # Move to menu
+            for i in range(5):
+                pyautogui.press('tab')
+
+            # Generate Ingham Toyota Parts Price List Report
+            logger.info("Generating Ingham Toyota Parts Price List Report...")
+            report_success = open_parts_price_list_report(currently_selected_report='Parts By Bin Location')
+            if report_success:
+                # Configure report parameters
+                params = PartsPriceListParams(
+                    from_department='330',
+                    from_franchise='TOY',
+                    output_file_name='Parts Price List Report - 330.csv'
+                )
+                # Download the report
+                download_success = parts_price_list_report_download(params, reports_dir=reports_dir)
+                if not download_success:
+                    logger.error("Failed to download Ingham Toyota Parts Price List Report")
+                    close_tune_application()
+                    return False
+                logger.info("Ingham Toyota Parts Price List Report generated successfully")
+            else:
+                logger.error("Failed to open Ingham Toyota Parts Price List Report")
+                close_tune_application()
+                return False
+            
+            # Generate Ingham Toyota Parts by Bin Location Report
+            logger.info("Generating Ingham Toyota Parts by Bin Location Report...")
+            report_success = open_parts_by_bin_location_report()
+            if report_success:
+                # Configure report parameters
+                params = PartsByBinLocationParams(
+                    from_department='330',
+                    from_franchise='TOY',
+                    output_file_name='Parts by Bin Location Report - 330.csv'
+                )
+                # Download the report
+                download_success = parts_by_bin_location_report_download(params, reports_dir=reports_dir)
+                if not download_success:
+                    logger.error("Failed to download Ingham Toyota Parts by Bin Location Report")
+                    close_tune_application()
+                    return False
+                logger.info("Ingham Toyota Parts by Bin Location Report generated successfully")
+            else:
+                logger.error("Failed to open Ingham Toyota Parts by Bin Location Report")
+                close_tune_application()
+
+            # Select Company 04 - Charters Towers Partnership
+            for i in range(7): # Go to company menu
+                pyautogui.hotkey('shift', 'tab')
+            pyautogui.press('down')
+            logger.info("Selected Company 04 - Charters Towers Partnership")
+            time.sleep(2) # Wait for 'Updating' to finish
+            # Department 430 - Parts & Acc selected by default
+
+            # Move to menu
+            for i in range(7):
+                pyautogui.press('tab')
+            
+            # Generate Charters Towers Partnership Parts Price List Report
+            logger.info("Generating Charters Towers Partnership Parts Price List Report...")
+            report_success = open_parts_price_list_report()
+            if report_success:
+                # Configure report parameters
+                params = PartsPriceListParams(
+                    from_department='430',
+                    from_franchise='TOY',
+                    output_file_name='Parts Price List Report - 430.csv'
+                )
+                # Download the report
+                download_success = parts_price_list_report_download(params, reports_dir=reports_dir)
+                if not download_success:
+                    logger.error("Failed to download Charters Towers Partnership Parts Price List Report")
+                    close_tune_application()
+                    return False
+                logger.info("Charters Towers Partnership Parts Price List Report generated successfully")
+            else:
+                logger.error("Failed to open Charters Towers Partnership Parts Price List Report")
+                close_tune_application()
+                return False
+
+            # Generate Charters Towers Partnership Parts by Bin Location Report
+
+            logger.info("Generating Charters Towers Partnership Parts by Bin Location Report...")
+            report_success = open_parts_by_bin_location_report()
+            if report_success:
+                # Configure report parameters
+                params = PartsByBinLocationParams(
+                    from_department='430',
+                    from_franchise='TOY',
+                    output_file_name='Parts by Bin Location Report - 430.csv'
+                )
+                # Download the report
+                download_success = parts_by_bin_location_report_download(params, reports_dir=reports_dir)
+                if not download_success:
+                    logger.error("Failed to download Charters Towers Partnership Parts by Bin Location Report")
+                    close_tune_application()
+                    return False
+                logger.info("Charters Towers Partnership Parts by Bin Location Report generated successfully")
+            else:
+                logger.error("Failed to open Charters Towers Partnership Parts by Bin Location Report")
+                close_tune_application()
+                return False
+            
+            # Close TUNE
+            close_tune_application()
+            logger.info("TUNE reports generation completed successfully")
+            return True
+            
+        except Exception as e:
+            logger.error(f"Error during TUNE report generation: {e}")
+            traceback.print_exc()
+            # Try to close TUNE if it's open
+            try:
+                close_tune_application()
+            except:
+                pass
+            return False
+
+def main(config: TuneConfig) -> bool:
+    """Main entry point: run TUNE report generation with the given config."""
+    global _config
+    _config = config
+    try:
+        config.validate()
+        images_dir = config.images_dir or _get_images_dir()
+        login_image = os.path.join(images_dir, 'tune_login_screen.png')
+        app_image = os.path.join(images_dir, 'tune_application_screen.png')
+        missing_images = []
+        if not os.path.exists(login_image):
+            missing_images.append('tune_login_screen.png')
+        if not os.path.exists(app_image):
+            missing_images.append('tune_application_screen.png')
+        if missing_images:
+            missing_str = ', '.join(missing_images)
+            logger.error(f"Missing reference images: {missing_str}")
+            return False
+        report_generator = TuneReportGenerator(config)
+        return report_generator.run_reports()
+    except Exception as e:
+        logger.error(f"An error occurred: {e}")
+        return False
+    finally:
+        _config = None
+
+
+if __name__ == "__main__":
+    config = TuneConfig.from_env()
+    success = main(config)
+    sys.exit(0 if success else 1) 

tune_dms-0.1.0.dist-info/METADATA

@@ -0,0 +1,24 @@
+Metadata-Version: 2.4
+Name: tune-dms
+Version: 0.1.0
+Summary: TUNE DMS desktop GUI automation: login and report generation
+License-Expression: MIT
+Keywords: tune,dms,gui,automation,reports
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: pyautogui
+
+# tune-dms
+
+TUNE DMS desktop GUI automation: log in and run reports (e.g. Parts Price List, Parts by Bin Location) via keyboard/screen automation.
+
+Install: `pip install tune-dms`  
+Or from repo root: `pip install -e ./packages/tune_dms`
+
+See the [main repo README](../README.md) for configuration and usage.

tune_dms-0.1.0.dist-info/RECORD

@@ -0,0 +1,43 @@
+tune_dms/__init__.py,sha256=AqosmWxyT-43xMgfA-JECy3THgoasmH2WNU5lIkhIUo,617
+tune_dms/config.py,sha256=2E6V_T031ZpjsaO-mt1mF2KccBSBhPv9oL-9DJ8W4WU,1935
+tune_dms/launcher.py,sha256=MJaZYnnZ0egdXxa0SegoA81nM37rYLgz91wvogm3I_s,36693
+tune_dms/images/confirm_save_as_dialog.png,sha256=zNTFAaV56FxEXlO8dtgrMmEzGqybIczkRVg3Fa5IFC0,1100
+tune_dms/images/excel_application_screen.png,sha256=vkmYg466hyyRHfvE2mHlaMxZ-Ob7Q-I_kj0_RRc9P0g,527
+tune_dms/images/save_as_window.png,sha256=IJRh7yL6wUSVEaWljJwHEvmFjBwpYNyAqUv9h_hPG0I,1733
+tune_dms/images/tune_admin_purchase_orders_icon_selected.png,sha256=9rzlT5hsQF6OczfxlSAKQ5URGOhV35nf9nZZYN3wK9c,2002
+tune_dms/images/tune_application_screen.png,sha256=1GnO27UzU3jRU9FOGmXCewC2fm8hUqbK2DBYVz39wq4,975
+tune_dms/images/tune_cancel_button.png,sha256=sY2I1s7X94xK6BKDgrdv2STIqELnZyYMiCLKGd8h8oI,508
+tune_dms/images/tune_cancel_button_2.png,sha256=JipzsYqLtrIwyP83DJ1u4EkhjOknyFK11VzFSZp6Qso,503
+tune_dms/images/tune_cancel_button_c.png,sha256=VLMECAoretn-STQQ43msppUTP7r5psc2_XVjafPRcZI,522
+tune_dms/images/tune_exit_button.png,sha256=AlEZamFjISaW7cGy_qPW6RBYGsfER0HJ4Z9iv1-ibAY,433
+tune_dms/images/tune_login_error.png,sha256=kBM8RNt0pHKIHl8cd9R05Z3raC9omui50FgEwfZjSVQ,2256
+tune_dms/images/tune_login_screen.png,sha256=SRxkt013051OOeU87VLQtxQ-CR0AJpfjPpWR7lQHwIo,65866
+tune_dms/images/tune_login_screen_environment.png,sha256=jBJo5XD0klEK7k2vB9Kv33QBNzot0ph4i-ul2YyRdcY,620
+tune_dms/images/tune_part_general_enquiry_cap_qty.png,sha256=nRErc88LyNkZ2IS0myGb2qbBht3IndhFJ3f75m13Z9M,285
+tune_dms/images/tune_part_general_enquiry_dangerous_goods_class.png,sha256=PLlBhUbwbtI942DJhS3nyBRU1zzBeOZ3V0K9KuhPIL8,447
+tune_dms/images/tune_part_general_enquiry_default_supplier.png,sha256=lwBbigDU7oNmDyKBAHPLdRgQX1UV2Hv1U5etmEG5fdw,363
+tune_dms/images/tune_part_general_enquiry_other.png,sha256=7mFLZo8Xora_8CAHl69haRa9MLyQxoZZqiqqvlW56vA,345
+tune_dms/images/tune_part_general_enquiry_pack_size.png,sha256=q5R8JKHK02aYNbeJDxGxUCeMFl_d9lF4SFszATIQglU,302
+tune_dms/images/tune_part_general_enquiry_part.png,sha256=LerhCawK1hG9ZjvNR6lvX1BD9Ejbsmzp8TjYy-qsnhg,239
+tune_dms/images/tune_part_general_enquiry_part_height.png,sha256=ZMbCXiKYcQvkPxE3eezMGTKkFAGIIxNvLlHnMS7pg8c,321
+tune_dms/images/tune_part_general_enquiry_part_length.png,sha256=vRQ5o_Kvwo6XDMYr2c_hl1lnHMXeA7mG8j5A8esCL44,305
+tune_dms/images/tune_part_general_enquiry_part_volume.png,sha256=lTlOzIu34I32WKfvfYanoErViFYcdlfZJo7QJ2PEOUc,294
+tune_dms/images/tune_part_general_enquiry_part_weight.png,sha256=oE2k5m842rlw9sNR8Yxt57oCNJtJeWGJWoLGC7MGvNk,312
+tune_dms/images/tune_part_general_enquiry_part_width.png,sha256=-fr5JvKU4RdzcO9QtxIkzOywVcWLz_16hIK5pDMHKPM,294
+tune_dms/images/tune_part_general_enquiry_unit_of_measure.png,sha256=C7t5dj4y3mm8HJr_6e4mFMKEx0XdFBYJbI4jTmCD4fU,353
+tune_dms/images/tune_previous_button.png,sha256=j55BAvWhnxaPw9IZalAXhgHc6-G0Zd01fqvobEkU1Ok,526
+tune_dms/images/tune_report_parts_by_bin_location.png,sha256=fmVt236qzjUk2mYf0oLMg-VmXmPlqaK1kDJQ94uZrZ8,1684
+tune_dms/images/tune_report_parts_price_list.png,sha256=COjUuiFn4-CEDKeOlOwHoR4Jr0SP1SvQOf093NenZ1o,1136
+tune_dms/images/tune_search_field.png,sha256=uCzFpgrv_71mvqN-3uxkykw_-TKdwYnAXsPvxXZq0ew,1854
+tune_dms/images/tune_select_franchise.png,sha256=hkwCMPZV6F6Yft_x_2Ud1TCnXwwOHRiI9uBV8Kv2pAw,936
+tune_dms/images/tune_select_franchise_grey.png,sha256=0Dp5e0FsmXl3zdLS3oJA8BKmmuutezoC9d3-V2yV4x8,855
+tune_dms/images/tune_select_franchise_toy_grey.png,sha256=lQhOP7lXWhZwLV9l-iOQ3NsW_BaRyxEnhk7fho_fCGE,219
+tune_dms/images/tune_select_franchise_toy_grey_box.png,sha256=rrid7bKxZguvz_lxGkXwiGehHfDPL28rFSaqRefi2iI,344
+tune_dms/images/tune_select_franchise_toy_yellow.png,sha256=QgQom3rtEoJUAcRXYOt4wfaZXKZtGc19BZZDjtPDBBQ,216
+tune_dms/images/tune_select_franchise_toy_yellow_box.png,sha256=hCy0pfVLychIUBqwEz0pg0NDiJWeaIUsppzqXMYoj-U,311
+tune_dms/images/tune_supplier_part_selection.png,sha256=diXleZHo4emsAhblyO8Z_v81uvdACVqUWLbi5hUdxHE,1213
+tune_dms/images/tune_x_button.png,sha256=LncxIEGnSdZpSdsWxQIfQ1oG04AseUgl41H30o6xaAs,313
+tune_dms-0.1.0.dist-info/METADATA,sha256=D3BnGt6-zSgENLcfRHZQ-W6ssoS3shJLZA7GBO42HNs,900
+tune_dms-0.1.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+tune_dms-0.1.0.dist-info/top_level.txt,sha256=foSEFiroat3zXAH5sxCZMw7NVXVnFlLH9idIe_QrOOs,9
+tune_dms-0.1.0.dist-info/RECORD,,

tune_dms-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.10.2)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

tune_dms-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+tune_dms