igorkasyanchuk/active_storage_validations
Active Storage Validations
Active Storage Validations is a library for Ruby on Rails that provides model-level validation helpers for file attachments. It integrates directly into the standard validation lifecycle to ensure that uploaded content conforms to defined business requirements before it is persisted to storage.
The framework enforces constraints on file size, content type, dimensions, and the number of attachments. It includes security mechanisms to detect and block content-type spoofing by inspecting the binary signature of files to verify that their actual format matches the declared extension.
Beyond basic validation, the library supports media asset quality control by enforcing specific aspect ratios and dimensions. It also provides testing matchers to verify that these constraints are correctly configured within development workflows.
Features
- File Validation Plugins - Adds declarative validation rules to file attachments within web application models.
- File Upload Constraint Validation - Enforces configurable limits on file attachments to ensure database records remain valid.
- Binary Signature Verification - Analyzes binary signatures to verify that the actual file format matches the declared extension, preventing spoofing.
- Media File Validations - Provides comprehensive file validation to enforce limits on file size, content type, and dimensions.
- File Upload Security - Inspects the actual content of uploaded files to prevent security risks caused by misrepresentation.
- Attachment Validation Validators - Provides model-level validators to ensure uploaded files meet business requirements before storage.
- Model - Integrates validation logic directly into the model lifecycle to ensure data integrity before persistence.
- Metadata Constraint Rulesets - Evaluates file attributes against predefined rulesets to ensure compliance with size, aspect ratio, and quantity requirements.
- Model Constraint Test Matchers - Provides CLI tools and matchers to verify that file requirements are correctly applied to data models.
- Media Quality Constraints - Enforces strict constraints on image dimensions and aspect ratios to maintain consistent visual standards.
- Storage Lifecycle Hooks - Hooks into file storage operations to intercept and validate data before it reaches the storage backend.
- Ruby on Rails Integrations - Provides a collection of validation helpers for file attachments including size, type, and dimension constraints.
- Security Validation Frameworks - Prevents file spoofing by inspecting the actual content of uploaded files against declared MIME types.
- Web Security Hardening - Prevents malicious file uploads by verifying the actual content type and structure of user-provided files.
