mirror of https://github.com/ivuorinen/actions.git synced 2026-01-26 03:23:59 +00:00

Files

Ismo Vuorinen 7061aafd35 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

2025-10-18 13:09:19 +03:00

2.3 KiB

Raw Blame History

Validation System Architecture

Status: PRODUCTION READY ✅

769 tests passing (100%)
Zero linting issues
Modular architecture complete

Architecture

Core Components

BaseValidator: Abstract interface for all validators
ValidatorRegistry: Dynamic discovery, loads custom validators from <action>/CustomValidator.py
ConventionMapper: Auto-detection via 100+ naming patterns (priority-based matching)

Specialized Validators (9)

token.py, version.py (SemVer/CalVer), boolean.py, numeric.py, docker.py, file.py, network.py, security.py, codeql.py

Custom Validators (20+)

Actions with complex validation have CustomValidator.py in their directory. Registry auto-discovers them.

Examples: docker-build/CustomValidator.py, sync-labels/CustomValidator.py, codeql-analysis/CustomValidator.py

Convention-Based Detection

Automatic validator selection from input names:

Priority 100: Exact (dry-run → boolean)
Priority 95: Language-specific (-python-version → python_version)
Priority 90: Suffixes (-token → token)
Priority 85: Contains (email → email)
Priority 80: Prefixes (is- → boolean)

Test Generation

validate-inputs/scripts/generate-tests.py:

Non-destructive (preserves existing tests)
Intelligent pattern detection for input types
Template-based scaffolding for validators
ShellSpec + pytest generation

Usage

from validators.registry import ValidatorRegistry
validator = ValidatorRegistry().get_validator("docker-build")
result = validator.validate_inputs({"context": ".", "platforms": "linux/amd64"})

File Structure

validate-inputs/
├── validator.py              # Main entry
├── validators/               # 9 specialized + base + registry + conventions
├── scripts/
│   ├── update-validators.py  # Rule generator
│   └── generate-tests.py     # Test generator
└── tests/                    # 769 pytest tests

<action>/CustomValidator.py   # Action-specific validators

Key Features

Convention-based auto-detection
GitHub expression support (${{ }})
Error propagation between validators
Security validation (injection, secrets)
CalVer, SemVer, flexible versioning
Docker platforms, registries
Token formats (GitHub, NPM, PyPI)

2.3 KiB Raw Blame History