Initial Commit

Initial commit of all files

Author: GimpyHand

AP_Files.py

@@ -0,0 +1,39 @@
+# -*- mode: python ; coding: utf-8 -*-
+
+
+a = Analysis(
+    ['main.py'],
+    pathex=[],
+    binaries=[],
+    datas=[('icon.ico', '.'), ('icon.png', '.'), ('dancing.gif', '.')],
+    hiddenimports=['AR_Files', 'AP_Files'],
+    hookspath=[],
+    hooksconfig={},
+    runtime_hooks=[],
+    excludes=[],
+    noarchive=False,
+    optimize=0,
+)
+pyz = PYZ(a.pure)
+
+exe = EXE(
+    pyz,
+    a.scripts,
+    a.binaries,
+    a.datas,
+    [],
+    name='GP Export Extraction',
+    debug=False,
+    bootloader_ignore_signals=False,
+    strip=False,
+    upx=True,
+    upx_exclude=[],
+    runtime_tmpdir=None,
+    console=False,
+    disable_windowed_traceback=False,
+    argv_emulation=False,
+    target_arch=None,
+    codesign_identity=None,
+    entitlements_file=None,
+    icon=['icon.ico'],
+)

AR_Files.py

@@ -1,2 +1,102 @@
-# Dynamics-GP-AR-AP-Exporter-Parser
-A small python app to parse AP/AR PDFs exported out of Dynamics GP
+# GP Export Extraction
+
+A small Windows desktop utility to extract data from GP (Dynamics GP) Aged AR/AP report PDFs into a formatted Excel file. It provides a simple GUI to choose AR or AP mode, select a PDF, and generates an Excel file next to the source PDF.
+
+- App: GUI built with Tkinter (no console window)
+- Build: PyInstaller (spec file included)
+- Target users: finance/accounting teams exporting AR/AP PDFs from GP
+
+
+## Features
+- AR mode (Aged AR Listing-style PDFs)
+  - Parses customer, document details, dates, and amounts
+  - Exports formatted Excel with currency formatting and a totals row
+  - Output file name: <BaseName>_Parsed.xlsx (note capital P)
+  - If the output Excel is locked/in use, saves with a numeric suffix (e.g., _Parsed_v1.xlsx)
+- AP mode (Aged AP Summary by Vendor-style PDFs)
+  - Parses vendor, payment method, voucher counts, totals and aging buckets
+  - Exports formatted Excel with currency formatting and a totals row
+  - Output file name: <BaseName>_parsed.xlsx (note lowercase p)
+- Friendly UI: choose AR/AP, select PDF, and see a completion dialog with row count and a small animation
+
+
+## Getting Started (Run from source)
+1. Install Python 3.10+ for Windows (recommended) and ensure “py”/“python” is on PATH.
+2. Install dependencies:
+   - pip install pdfplumber pandas xlsxwriter openpyxl pillow
+3. Run the app:
+   - py main.py
+   - Select AR or AP, click “Select PDF”, then choose the report PDF exported from GP.
+4. Find the output Excel in the same folder as the PDF:
+   - AR: <BaseName>_Parsed.xlsx
+   - AP: <BaseName>_parsed.xlsx
+
+Notes
+- If Excel reports are open/locked, AR mode automatically retries with _vN suffix.
+- The app attempts to detect dates and apply reasonable aging bucket logic; PDFs with significantly different layouts may parse less accurately.
+
+
+## Using the Packaged EXE
+- If you have a packaged build (dist/GP Export Extraction.exe or a Release zip), just double-click the EXE.
+- No Python installation required on the target machine.
+
+
+## Build and Release
+Two ways to build with PyInstaller:
+
+A) Using the provided spec file (recommended)
+- py -m PyInstaller "GP Export Extraction.spec"
+
+B) One-off command example (for reference; main.py header shows options)
+- py -m PyInstaller --onefile --windowed --name "GP Export Extraction" --icon "icon.ico" \
+  --hidden-import AR_Files --hidden-import AP_Files \
+  --add-data "icon.ico;." --add-data "icon.png;." --add-data "dancing.gif;." main.py
+
+Automated build script (preferred on Windows)
+- The repository includes build.ps1 to build and package a zip for distribution.
+- Examples:
+  - powershell -ExecutionPolicy Bypass -File .\build.ps1
+  - powershell -ExecutionPolicy Bypass -File .\build.ps1 -Version 1.0.0 -Clean
+- Output:
+  - dist/GP Export Extraction.exe (or onedir variant)
+  - release/GP-Export-Extraction-<Version>-win.zip (upload this in a GitHub Release)
+
+
+## Files of Interest
+- main.py — Tkinter GUI launcher.
+- AR_Files.py — AR parsing/export logic.
+- AP_Files.py — AP parsing/export logic.
+- GP Export Extraction.spec — PyInstaller spec (includes icons and GIF in the bundle).
+- build.ps1 — Windows build/packaging script.
+- icon.ico, icon.png — app icons.
+
+
+## Requirements
+- Windows 10/11.
+- For running from source:
+  - Python 3.10+ (Tkinter included with standard CPython installs on Windows)
+  - Packages: pdfplumber, pandas, xlsxwriter (optional but preferred), openpyxl (fallback), pillow (for GIF decoding; optional)
+- For running the EXE: no additional dependencies.
+
+
+## Troubleshooting
+- “pyinstaller not found” when running build.ps1: Install with pip install pyinstaller, or ensure Python Scripts directory is on PATH. The script will try python -m PyInstaller if pyinstaller isn’t on PATH.
+- Output Excel won’t save due to file lock: Close the target Excel file and retry; AR mode also attempts _vN filenames automatically.
+- Parsing accuracy: These scripts rely on text extraction from PDFs via pdfplumber. If your report layout is different (headers/columns vary), results may need validation. Consider sharing a sample layout for adjustment.
+- No dancing.gif or icons in dialogs when running from source: Ensure the working directory contains icon.ico, icon.png, and dancing.gif (PyInstaller bundles these automatically in the EXE build).
+
+
+## Privacy & Data Handling
+- PDFs are processed locally; no data leaves your machine.
+- Output files are created in the same directory as the input PDF.
+
+
+## Changelog
+- v1.0.0 (2025-08-15)
+  - Initial public/internal release with AR/AP parsing and Excel export
+  - GUI with AR/AP selection and success dialog
+  - PyInstaller spec and Windows build script (build.ps1)
+
+
+## License / Usage
+- Internal company use only.

GP Export Extraction.spec

@@ -0,0 +1,89 @@
+param(
+    [string]$Version = "1.0.0",
+    [switch]$Clean
+)
+
+# Build script for GP Export Extraction
+# Usage examples:
+#   powershell -ExecutionPolicy Bypass -File .\build.ps1
+#   powershell -ExecutionPolicy Bypass -File .\build.ps1 -Version 1.0.0 -Clean
+
+$ErrorActionPreference = 'Stop'
+
+function Write-Section($msg) {
+    Write-Host "`n=== $msg ===" -ForegroundColor Cyan
+}
+
+# Resolve important paths
+$RepoRoot = Split-Path -Parent $MyInvocation.MyCommand.Path
+Set-Location $RepoRoot
+$SpecFile = Join-Path $RepoRoot 'GP Export Extraction.spec'
+$DistDir  = Join-Path $RepoRoot 'dist'
+$BuildDir = Join-Path $RepoRoot 'build'
+$ReleaseDir = Join-Path $RepoRoot 'release'
+
+if (!(Test-Path $SpecFile)) {
+    throw "Spec file not found: $SpecFile"
+}
+
+Write-Section "Preparing directories"
+if ($Clean) {
+    if (Test-Path $DistDir) { Remove-Item -Recurse -Force $DistDir }
+    if (Test-Path $BuildDir) { Remove-Item -Recurse -Force $BuildDir }
+}
+if (!(Test-Path $ReleaseDir)) { New-Item -ItemType Directory -Path $ReleaseDir | Out-Null }
+
+Write-Section "Locating PyInstaller"
+$pyinstallerCmd = Get-Command pyinstaller -ErrorAction SilentlyContinue
+if ($null -eq $pyinstallerCmd) {
+    Write-Host "'pyinstaller' not found on PATH. Will try 'python -m PyInstaller'." -ForegroundColor Yellow
+}
+
+Write-Section "Building executable via PyInstaller"
+$buildArgs = @('--clean', '"GP Export Extraction.spec"')
+try {
+    if ($pyinstallerCmd) {
+        & pyinstaller --clean "GP Export Extraction.spec"
+    } else {
+        & python -m PyInstaller --clean "GP Export Extraction.spec"
+    }
+} catch {
+    throw "PyInstaller build failed: $($_.Exception.Message)"
+}
+
+Write-Section "Verifying build output"
+$onefileExe = Join-Path $DistDir 'GP Export Extraction.exe'
+$onedirDir  = Join-Path $DistDir 'GP Export Extraction'
+
+if (Test-Path $onefileExe) {
+    $artifactPath = $onefileExe
+    $artifactType = 'onefile'
+} elseif (Test-Path $onedirDir) {
+    $artifactPath = $onedirDir
+    $artifactType = 'onedir'
+} else {
+    throw "Expected output not found in 'dist'. Neither onefile exe nor onedir folder exists."
+}
+
+Write-Host "Detected artifact type: $artifactType at $artifactPath" -ForegroundColor Green
+
+# Create a versioned ZIP for release uploads
+$zipName = "GP-Export-Extraction-$Version-win.zip"
+$zipPath = Join-Path $ReleaseDir $zipName
+if (Test-Path $zipPath) { Remove-Item -Force $zipPath }
+
+Write-Section "Packaging release: $zipName"
+if ($artifactType -eq 'onefile') {
+    Compress-Archive -Path $artifactPath -DestinationPath $zipPath
+} else {
+    # Include entire onedir folder contents
+    Compress-Archive -Path (Join-Path $artifactPath '*') -DestinationPath $zipPath
+}
+
+Write-Section "Build complete"
+Write-Host "Executable/Folder: $artifactPath" -ForegroundColor Green
+Write-Host "Release ZIP:       $zipPath" -ForegroundColor Green
+Write-Host "Next steps:" -ForegroundColor Cyan
+Write-Host "  1) Commit changes and push to GitHub." -ForegroundColor Gray
+Write-Host "  2) Tag the repo:   git tag v$Version; git push origin v$Version" -ForegroundColor Gray
+Write-Host "  3) Create a GitHub Release 'v$Version' and upload: $zipPath" -ForegroundColor Gray