Metadata-Version: 2.4
Name: sapgui-shortcut-fixer-macos
Version: 0.1.0
Summary: Automatically fix SAP GUI shortcut files (.sap) on macOS by removing malformed /M/ parameters from GuiParm connection strings
Author-email: Nicolas Renkamp <nico.re@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/nicornk/sapgui-shortcut-fixer-macos
Project-URL: Repository, https://github.com/nicornk/sapgui-shortcut-fixer-macos
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: End Users/Desktop
Classifier: Topic :: Utilities
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Operating System :: MacOS :: MacOS X
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Dynamic: license-file

# SAP GUI Shortcut Fixer for macOS

> **⚠️ DISCLAIMER: This entire application was AI-generated ("vibecoded") using GitHub Copilot.**  
> While fully functional and tested, please review the code before use in production environments.

Automatically fix SAP GUI shortcut files (`.sap`) downloaded from SAP NetWeaver Portal on macOS by removing malformed `/M/` parameters from `GuiParm` connection strings.

## The Problem

SAP NetWeaver Portal sometimes generates `.sap` shortcut files with an extra `/M/` prefix in the connection string:

```ini
GuiParm=/M//H/server.com/S/3200  ❌ Malformed
```

This prevents SAP GUI from connecting properly. This tool automatically fixes it to:

```ini
GuiParm=/H/server.com/S/3200  ✅ Fixed
```

## Installation

```bash
pip install sapgui-shortcut-fixer-macos
sap-modifier install
```

## Usage

```bash
sap-modifier status         # Check service status
sap-modifier test file.sap  # Test on specific file
sap-modifier logs           # View recent activity
sap-modifier uninstall      # Remove service
```

## How It Works

Uses macOS `launchd` with `WatchPaths` to monitor Downloads folder. When a `.sap` shortcut file appears, it automatically fixes malformed GuiParm parameters.

**Technology:**
- Event-driven monitoring (no daemon process)
- Native macOS integration (`launchd`)
- Zero dependencies (pure Python 3.10+)

## What are .sap Files?

`.sap` files are **SAP GUI shortcut files** - plain-text INI files generated by SAP NetWeaver Portal that contain connection parameters for SAP GUI for Windows. They're temporary launch shortcuts, not configuration exports or transport files.

**Related SAP Files (NOT handled by this tool):**
- `.car/.sar` - SAP kernel patches (use SAPCAR)
- `.sda` - Java deployment archives (use SDM)
- `.epa` - Portal content exports

## Development

```bash
pip install -e ".[dev]"
pytest
```

## License

MIT
