feat: Migrate configuration format from .mkp-builderrc to .mkp-builder.ini

- Introduced support for INI configuration files with a new structure.
- Added multiline description support in configuration files.
- Updated filtering to exclude __pycache__ directories from packages.
- Renamed command line arguments and GitHub Action inputs for clarity.
- Updated documentation to reflect changes in configuration format.

Author: oetiker

.gitignore

@@ -5,7 +5,7 @@
 !/*.md
 !/.gitignore
 !/.github
-!/.mkp-builderrc.example
+!/.mkp-builder.ini.example
 !/.clinerules
 *~
 *.swp

.mkp-builder.ini.example

@@ -0,0 +1,22 @@
+# Example configuration file for CheckMK MKP Builder
+# Copy this to .mkp-builder.ini in your plugin repository and customize
+
+[package]
+# Package Information
+name = my_awesome_plugin
+title = My Awesome CheckMK Plugin
+author = Your Name <your.email@example.com>
+description = A comprehensive CheckMK plugin that monitors awesome things.
+    This description can span multiple lines for better readability.
+    Use proper indentation for continuation lines.
+
+# CheckMK Compatibility
+version.min_required = 2.3.0p1
+version.packaged = 2.3.0p34
+version.usable_until = 
+
+# Optional settings
+download_url = https://github.com/yourusername/your-plugin-repo
+
+# Build Options
+validate_python = true

.mkp-builderrc.example

@@ -8,10 +8,24 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [Unreleased]
 
 ### New
+- Add support for INI configuration format with `.mkp-builder.ini` files
+- Add multiline description support in configuration files
+- Add `__pycache__` directory filtering to exclude Python cache files from packages
 
 ### Changed
+- **BREAKING**: Configuration file format changed from `.mkp-builderrc` (key=value) to `.mkp-builder.ini` (INI format with `[package]` section)
+- **BREAKING**: Command line arguments renamed for clarity:
+  - `--cmk-min` → `--version-min-required`
+  - `--cmk-packaged` → `--version-packaged`
+- **BREAKING**: GitHub Action inputs renamed:
+  - `cmk-min-version` → `version-min-required`
+  - `cmk-packaged-version` → `version-packaged`
+- Internal configuration keys now match info file structure (e.g., `version.min_required`, `version.packaged`)
+- Improved JSON formatting in `info.json` with proper indentation
+- Enhanced Python dict formatting in `info` file using `pprint` module with 80-character line width
 
 ### Fixed
+- Package files now properly exclude `__pycache__` directories and their contents
 
 ## 1.0.1 - 2025-08-06
 ### New

CHANGES.md

@@ -81,8 +81,8 @@ jobs:
     title: 'My Awesome Plugin'
     author: 'John Doe <john@example.com>'
     description: 'A plugin that does amazing things'
-    cmk-min-version: '2.3.0p1'
-    cmk-packaged-version: '2.3.0p34'
+    version-min-required: '2.3.0p1'
+    version-packaged: '2.3.0p34'
     validate-python: 'true'
     verbose: 'true'
 
@@ -102,8 +102,8 @@ jobs:
 | `title` | Package title | ❌ | From config file |
 | `author` | Author name and email | ❌ | From config file |
 | `description` | Package description | ❌ | From config file |
-| `cmk-min-version` | Minimum CheckMK version | ❌ | From config file |
-| `cmk-packaged-version` | CheckMK packaging version | ❌ | From config file |
+| `version-min-required` | Minimum CheckMK version | ❌ | From config file |
+| `version-packaged` | CheckMK packaging version | ❌ | From config file |
 | `download-url` | Download URL | ❌ | From config file |
 | `version-usable-until` | The last CheckMK version this plugin is compatible with | ❌ | From config file |
 | `output-dir` | Output directory | ❌ | `.` |
@@ -120,22 +120,26 @@ jobs:
 
 ## Configuration File
 
-Create a `.mkp-builderrc` file in your repository root for default values:
+Create a `.mkp-builder.ini` file in your repository root for default values:
 
-```bash
+```ini
+[package]
 # Package Information
-PACKAGE_NAME="my_plugin"
-PACKAGE_TITLE="My Awesome Plugin"
-PACKAGE_AUTHOR="John Doe <john@example.com>"
-PACKAGE_DESCRIPTION="A plugin that does amazing things"
+name = my_plugin
+title = My Awesome Plugin
+author = John Doe <john@example.com>
+description = A plugin that does amazing things.
+    This description can span multiple lines
+    and provides better formatting options.
 
 # CheckMK Compatibility
-CMK_MIN_VERSION="2.3.0p1"
-CMK_PACKAGED_VERSION="2.3.0p34"
+version.min_required = 2.3.0p1
+version.packaged = 2.3.0p34
+version.usable_until = 3.0.0
 
 # Optional
-DOWNLOAD_URL="https://github.com/user/repo"
-VALIDATE_PYTHON="yes"
+download_url = https://github.com/user/repo
+validate_python = true
 ```
 
 ## Required Directory Structure
@@ -161,7 +165,7 @@ repository/
 │   │       └── your_plugin.py
 │   └── share/check_mk/agents/plugins/
 │       └── your_plugin
-├── .mkp-builderrc            # Optional config file
+├── .mkp-builder.ini          # Optional config file
 └── .github/workflows/
     └── build.yml
 ```
@@ -295,11 +299,11 @@ The action automatically maps files from your local directory structure:
 
 **"No MKP file found after build"**
 - Ensure your `local/` directory structure is correct
-- Check that your `.mkp-builderrc` file has valid syntax
+- Check that your `.mkp-builder.ini` file has valid syntax
 - Verify Python files pass validation
 
 **"Package name could not be determined"**
-- Add `package-name` input or set `PACKAGE_NAME` in `.mkp-builderrc`
+- Add `package-name` input or set `name` in the `[package]` section of `.mkp-builder.ini`
 - Ensure your agent plugin files exist in the correct location
 
 **"Python syntax error"**

README.md

@@ -18,10 +18,10 @@ inputs:
   description:
     description: 'Package description (default: from config file)'
     required: false
-  cmk-min-version:
+  version-min-required:
     description: 'Minimum CheckMK version (default: from config file)'
     required: false
-  cmk-packaged-version:
+  version-packaged:
     description: 'CheckMK version used for packaging (default: from config file)'
     required: false
   download-url:
@@ -143,8 +143,8 @@ runs:
         [[ -n "${{ inputs.title }}" ]] && BUILD_ARGS+=("--title" "${{ inputs.title }}")
         [[ -n "${{ inputs.author }}" ]] && BUILD_ARGS+=("--author" "${{ inputs.author }}")
         [[ -n "${{ inputs.description }}" ]] && BUILD_ARGS+=("--description" "${{ inputs.description }}")
-        [[ -n "${{ inputs.cmk-min-version }}" ]] && BUILD_ARGS+=("--cmk-min" "${{ inputs.cmk-min-version }}")
-        [[ -n "${{ inputs.cmk-packaged-version }}" ]] && BUILD_ARGS+=("--cmk-packaged" "${{ inputs.cmk-packaged-version }}")
+        [[ -n "${{ inputs.version-min-required }}" ]] && BUILD_ARGS+=("--version-min-required" "${{ inputs.version-min-required }}")
+        [[ -n "${{ inputs.version-packaged }}" ]] && BUILD_ARGS+=("--version-packaged" "${{ inputs.version-packaged }}")
         [[ -n "${{ inputs.download-url }}" ]] && BUILD_ARGS+=("--download-url" "${{ inputs.download-url }}")
         [[ -n "${{ inputs.version-usable-until }}" ]] && BUILD_ARGS+=("--version-usable-until" "${{ inputs.version-usable-until }}")
         [[ -n "${{ inputs.output-dir }}" ]] && BUILD_ARGS+=("--output-dir" "${{ inputs.output-dir }}")
@@ -162,7 +162,7 @@ runs:
         echo "::notice::Running MKP build with arguments: ${BUILD_ARGS[*]}"
         
         # Run the versioned build script directly
-        "$MKP_SCRIPT" "${BUILD_ARGS[@]}"
+        "$MKP_SCRIPT" --github-action-mode "${BUILD_ARGS[@]}"
         
         # Find the generated MKP file
         MKP_FILE=$(find "${{ inputs.output-dir }}" -name "*.mkp" -type f | head -1)