feat: Update versioning scripts and files for Elytra PIM Client

UPDATE_VERSION.md

@@ -0,0 +1,164 @@
+# Version Update Scripts
+
+This directory contains scripts to update the version across the Elytra PIM Client project before building a wheel distribution.
+
+## Quick Start
+
+Update version and build:
+```bash
+# Python (cross-platform)
+python update_version.py 1.0.0
+python build_wheel.py
+
+# PowerShell (Windows)
+.\update_version.ps1 1.0.0
+.\build_wheel.ps1
+
+# Bash (Linux/macOS)
+./update_version.sh 1.0.0
+./build_wheel.sh
+```
+
+## Files Updated
+
+The version update scripts modify the following files:
+- `pyproject.toml` - Project configuration (line 7)
+- `elytra_client/__init__.py` - Package version (line 3)
+
+## Available Scripts
+
+### Python Version
+```bash
+python update_version.py 0.2.0
+```
+
+**Usage:**
+```bash
+python update_version.py <version>
+```
+
+**Example:**
+```bash
+python update_version.py 1.0.0
+```
+
+### PowerShell Version
+```powershell
+.\update_version.ps1 -Version 0.2.0
+```
+
+**Usage:**
+```powershell
+.\update_version.ps1 -Version <version>
+# or
+.\update_version.ps1 <version>
+```
+
+**Examples:**
+```powershell
+.\update_version.ps1 0.2.0
+.\update_version.ps1 -Version 1.0.0
+```
+
+### Bash Version
+```bash
+./update_version.sh 0.2.0
+```
+
+**Usage:**
+```bash
+./update_version.sh <version>
+```
+
+**Example:**
+```bash
+./update_version.sh 1.0.0
+```
+
+## Version Format
+
+The version must follow semantic versioning format: `major.minor.patch`
+
+Valid examples:
+- `0.1.0`
+- `1.0.0`
+- `0.2.1`
+- `1.0.0-beta` (with pre-release identifier)
+
+Invalid examples:
+- `1.0` (missing patch version)
+- `v1.0.0` (invalid prefix)
+
+## Workflow
+
+### Before Building a Wheel
+
+1. **Update the version:**
+   ```bash
+   # On Windows
+   .\update_version.ps1 0.2.0
+   
+   # On Linux/macOS
+   ./update_version.sh 0.2.0
+   ```
+
+2. **Build the wheel:**
+   ```bash
+   # Using Python
+   python build_wheel.py
+   
+   # Or PowerShell
+   .\build_wheel.ps1
+   
+   # Or Bash
+   ./build_wheel.sh
+   ```
+
+3. **Upload (optional):**
+   ```bash
+   .\upload_wheel_to_forgejo_pypi.ps1
+   ```
+
+### Verification
+
+After running the update script, verify the changes:
+
+**Check pyproject.toml:**
+```bash
+grep "version = " pyproject.toml
+```
+
+**Check __init__.py:**
+```bash
+grep "__version__ = " elytra_client/__init__.py
+```
+
+## Error Messages
+
+### Invalid Version Format
+```
+✗ Invalid version format: 1.0
+Version must follow semantic versioning (major.minor.patch)
+Examples: 1.0.0, 0.2.0, 1.0.0-beta
+```
+
+**Solution:** Use the format `major.minor.patch` (e.g., `1.0.0`)
+
+### File Not Found
+```
+✗ /path/to/file not found
+```
+
+**Solution:** Ensure you're running the script from the project root directory
+
+## Return Codes
+
+- `0` - Success (version updated)
+- `1` - Error (see error message)
+
+## Notes
+
+- Run from the project root directory
+- The scripts will show which files were updated
+- All scripts support semantic versioning with optional pre-release identifiers
+- Use consistent versions across all files to avoid build issues