chore: add tests, update docs and actions (#299)

* docs: update documentation

* feat: validate-inputs has it's own pyproject

* security: mask DOCKERHUB_PASSWORD

* chore: add tokens, checkout, recrete docs, integration tests

* fix: add `statuses: write` permission to pr-lint

python-version-detect-v2/README.md

@@ -11,6 +11,7 @@ Detects Python version from project configuration files using enhanced detection
 | name              | description                                                     | required | default |
 |-------------------|-----------------------------------------------------------------|----------|---------|
 | `default-version` | <p>Default Python version to use if no version is detected.</p> | `false`  | `3.12`  |
+| `token`           | <p>GitHub token for authentication</p>                          | `false`  | `""`    |
 
 ### Outputs
 
@@ -33,4 +34,10 @@ This action is a `composite` action.
     #
     # Required: false
     # Default: 3.12
+
+    token:
+    # GitHub token for authentication
+    #
+    # Required: false
+    # Default: ""
 ```

python-version-detect-v2/action.yml

@@ -15,6 +15,10 @@ inputs:
     description: 'Default Python version to use if no version is detected.'
     required: false
     default: '3.12'
+  token:
+    description: 'GitHub token for authentication'
+    required: false
+    default: ''
 
 outputs:
   python-version:
@@ -57,6 +61,11 @@ runs:
 
         echo "Input validation completed successfully"
 
+    - name: Checkout Repository
+      uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+      with:
+        token: ${{ inputs.token || github.token }}
+
     - name: Parse Python Version
       id: parse-version
       uses: ./version-file-parser

python-version-detect-v2/rules.yml

@@ -2,7 +2,7 @@
 # Validation rules for python-version-detect-v2 action
 # Generated by update-validators.py v1.0.0 - DO NOT EDIT MANUALLY
 # Schema version: 1.0
-# Coverage: 100% (1/1 inputs)
+# Coverage: 100% (2/2 inputs)
 #
 # This file defines validation rules for the python-version-detect-v2 GitHub Action.
 # Rules are automatically applied by validate-inputs action when this
@@ -16,13 +16,15 @@ generator_version: 1.0.0
 required_inputs: []
 optional_inputs:
   - default-version
+  - token
 conventions:
   default-version: semantic_version
+  token: github_token
 overrides:
   default-version: python_version
 statistics:
-  total_inputs: 1
-  validated_inputs: 1
+  total_inputs: 2
+  validated_inputs: 2
   skipped_inputs: 0
   coverage_percentage: 100
 validation_coverage: 100
@@ -30,7 +32,7 @@ auto_detected: true
 manual_review_required: false
 quality_indicators:
   has_required_inputs: false
-  has_token_validation: false
+  has_token_validation: true
   has_version_validation: true
   has_file_validation: false
-  has_security_validation: false
+  has_security_validation: true