activerecord-s3-bucket-name-validator 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 89b7cdcea9fd4f03a6d9435bf462f69d5fd2c9da5c75fb1c1742e54c520cc444
+  data.tar.gz: 1f3cc7c5692a601ef628e0e4bd3ce59c318d323fac52cc5c44fffc448cb6f503
+SHA512:
+  metadata.gz: 70654a96c3d0ef0169d6674b1a0e36a5e69969fae44386ea162c0a58c9f2389c68ff6dccfa17997b71ed7a29fafa1188be0bb615a569ceaea4f772bca4ac1222
+  data.tar.gz: 47736e485827ed67c73f8cbad6e163b37f7c1e8e665f5eca42daf698143de99adc24974e5849ef77d049299f3bfaca6ebb2051cfece0fe4a1a2ef9f94deb6ca8

data/.github/workflows/release.yaml

@@ -0,0 +1,24 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - v*
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '3.4'
+          bundler-cache: true
+      - name: Publish to RubyGems (trusted publishing)
+        uses: rubygems/release-gem@v1.1.1

data/.github/workflows/test.yml

@@ -0,0 +1,77 @@
+name: Test
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [ main, master ]
+  pull_request:
+    branches: [ main, master ]
+  schedule:
+    - cron: "0 0 * * 0"
+
+permissions:
+  contents: read
+
+concurrency:
+  group: test-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  test:
+    strategy:
+      matrix:
+        ruby: ["3.2", "3.3", "3.4"]
+        activemodel: ["~> 7.2", "~> 8.0"]
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v5
+      - name: Set up Environment Variables
+        run: |
+          echo "ACTIVEMODEL_VERSION=${{ matrix.activemodel }}" >> $GITHUB_ENV
+
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+          bundler-cache: false
+      - name: Prepare Gemfile for matrix
+        run: |
+          bundle config set frozen false
+          bundle lock --add-platform ruby --add-platform x86_64-linux || true
+          if [ -n "${{ matrix.activemodel }}" ]; then
+            bundle lock --update activemodel || true
+          fi
+      - name: Install dependencies
+        run: bundle install --jobs 4 --retry 1
+
+      - name: Run tests
+        run: bundle exec rake test
+
+  ar_integration:
+    strategy:
+      matrix:
+        ruby: ["3.2", "3.3", "3.4"]
+        activerecord: ["~> 7.2", "~> 8.0"]
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v5
+      - name: Set up Environment Variables
+        run: |
+          echo "AR_INTEGRATION=1" >> $GITHUB_ENV
+          echo "ACTIVERECORD_VERSION=${{ matrix.activerecord }}" >> $GITHUB_ENV
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+          bundler-cache: false
+      - name: Prepare Gemfile for AR matrix
+        run: |
+          bundle config set frozen false
+          bundle lock --add-platform ruby --add-platform x86_64-linux || true
+          bundle lock --update activerecord sqlite3 || true
+      - name: Install dependencies
+        run: bundle install --jobs 4 --retry 1
+      - name: Run integration tests
+        run: bundle exec rake test

data/.gitignore

@@ -0,0 +1,10 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+/vendor/

data/.ruby-version

@@ -0,0 +1 @@
+3.4.3

data/.travis.yml

@@ -0,0 +1,7 @@
+---
+sudo: false
+language: ruby
+cache: bundler
+rvm:
+  - 2.6.10
+before_install: gem install bundler -v 1.17.2

data/Gemfile

@@ -0,0 +1,18 @@
+source "https://rubygems.org"
+
+git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
+
+# Allow CI to pin a specific ActiveModel version via env var
+am_ver = ENV["ACTIVEMODEL_VERSION"]
+gem "activemodel", am_ver if am_ver
+
+# Optional: ActiveRecord integration testing
+if ENV["AR_INTEGRATION"] == "1"
+  ar_ver = ENV["ACTIVERECORD_VERSION"]
+  gem "activerecord", ar_ver || ">= 7.0", "< 9"
+  sqlite_req = (ar_ver && ar_ver.start_with?("~> 8")) ? ">= 2.1" : ">= 1.6"
+  gem "sqlite3", sqlite_req
+end
+
+# Specify your gem's dependencies in activerecord-s3-bucket-name-validator.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,53 @@
+PATH
+  remote: .
+  specs:
+    activerecord-s3-bucket-name-validator (0.1.0)
+      activemodel (>= 7.0, < 9)
+      i18n (>= 1.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    activemodel (8.0.3)
+      activesupport (= 8.0.3)
+    activesupport (8.0.3)
+      base64
+      benchmark (>= 0.3)
+      bigdecimal
+      concurrent-ruby (~> 1.0, >= 1.3.1)
+      connection_pool (>= 2.2.5)
+      drb
+      i18n (>= 1.6, < 2)
+      logger (>= 1.4.2)
+      minitest (>= 5.1)
+      securerandom (>= 0.3)
+      tzinfo (~> 2.0, >= 2.0.5)
+      uri (>= 0.13.1)
+    base64 (0.3.0)
+    benchmark (0.4.1)
+    bigdecimal (3.2.3)
+    concurrent-ruby (1.3.5)
+    connection_pool (2.5.4)
+    drb (2.2.3)
+    i18n (1.14.7)
+      concurrent-ruby (~> 1.0)
+    logger (1.7.0)
+    minitest (5.25.5)
+    rake (13.3.0)
+    securerandom (0.4.1)
+    tzinfo (2.0.6)
+      concurrent-ruby (~> 1.0)
+    uri (1.0.3)
+
+PLATFORMS
+  arm64-darwin-24
+  ruby
+
+DEPENDENCIES
+  activerecord-s3-bucket-name-validator!
+  bundler (>= 1.17)
+  minitest (>= 5.0)
+  rake (>= 10.0)
+
+BUNDLED WITH
+   2.6.7

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 Claudio Poli
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,118 @@
+# ActiveModel S3 Bucket Name Validator
+
+ActiveModel validator for Amazon S3 bucket names. It implements the official AWS naming rules for:
+- General purpose buckets (classic S3)
+- Directory buckets (S3 Express One Zone)
+- S3 Tables buckets
+
+Works in any class using ActiveModel::Validations and in Rails/ActiveRecord models. Ships with i18n messages in multiple locales.
+
+## Installation
+
+Add to your Gemfile:
+
+```ruby
+gem "activerecord-s3-bucket-name-validator"
+```
+
+Then bundle:
+
+```bash
+bundle install
+```
+
+## Compatibility
+
+- Ruby: 3.1, 3.2, 3.3, 3.4 (CI runs 3.2–3.4)
+- ActiveModel: 7.2, 8.0 (CI targets)
+- Rails/ActiveRecord: supported via ActiveModel::Validations (no Rails runtime dependency)
+
+## Quickstart
+
+Plain ActiveModel:
+
+```ruby
+class StorageConfig
+  include ActiveModel::Model
+  attr_accessor :bucket_name
+  validates :bucket_name, s3_bucket_name: true
+end
+```
+
+ActiveRecord model:
+
+```ruby
+class Storage < ApplicationRecord
+  validates :bucket_name, s3_bucket_name: true
+end
+```
+
+## Options
+
+- `type` — `:general_purpose` (default), `:directory`, or `:table`
+- `transfer_acceleration` — when `true`, periods are forbidden for general-purpose buckets
+
+Examples:
+
+```ruby
+validates :bucket_name, s3_bucket_name: { transfer_acceleration: true }
+validates :bucket_name, s3_bucket_name: { type: :directory }
+validates :bucket_name, s3_bucket_name: { type: :table }
+```
+
+## i18n
+
+Error keys provided:
+- `activemodel.errors.messages.s3_bucket_name_invalid_general`
+- `activemodel.errors.messages.s3_bucket_name_invalid_transfer_acceleration`
+- `activemodel.errors.messages.s3_bucket_name_invalid_directory`
+- `activemodel.errors.messages.s3_bucket_name_invalid_table`
+
+Locales shipped: en, es, it, fr, de, pt-BR, ja, ko, zh-CN, zh-TW, ru, nl.
+
+Rails loads locales via a Railtie; plain ActiveModel loads them at require-time. Override by adding your own YAML with the same keys.
+
+## What’s validated (high level)
+
+- Length 3–63, allowed characters, begin/end alphanumeric
+- No adjacent periods; not IP-like (general purpose)
+- Reserved prefixes/suffixes per AWS docs (for example `xn--`, `sthree-`, `amzn-s3-demo-`, `-s3alias`, `--ol-s3`, `.mrap`, `--x-s3`, `--table-s3`)
+- Directory buckets must end with `--<zone-id>--x-s3`
+- S3 Tables buckets disallow periods and underscores
+- Optional TA mode forbids periods
+
+Note: Global/partition uniqueness and immutability are service-side constraints and not enforced locally.
+
+## Examples
+
+Valid (general purpose):
+
+```text
+my-example-bucket
+example.com
+```
+
+Invalid (general purpose):
+
+```text
+ex..ample
+192.168.5.4
+xn--abc
+foo--x-s3
+```
+
+## Running tests (for contributors)
+
+```bash
+# ActiveModel-only
+bundle install
+bundle exec rake test
+
+# With ActiveRecord integration (in-memory sqlite)
+AR_INTEGRATION=1 ACTIVERECORD_VERSION="~> 8.0" bundle install
+AR_INTEGRATION=1 ACTIVERECORD_VERSION="~> 8.0" bundle exec rake test
+```
+
+## License
+
+MIT — see `LICENSE.txt`.

data/Rakefile

@@ -0,0 +1,10 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList["test/**/*_test.rb"]
+end
+
+task :default => :test

data/activerecord-s3-bucket-name-validator.gemspec

@@ -0,0 +1,49 @@
+
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "activerecord/s3/bucket/name/validator/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "activerecord-s3-bucket-name-validator"
+  spec.version       = Activerecord::S3::Bucket::Name::Validator::VERSION
+  spec.authors       = ["Claudio Poli"]
+  spec.email         = ["masterkain@gmail.com"]
+
+  spec.summary       = %q{ActiveModel/ActiveRecord validator for Amazon S3 bucket naming rules}
+  spec.description   = %q{Validate S3 bucket names on your models against the official AWS rules (general purpose, directory buckets, and S3 Tables).}
+  spec.homepage      = "https://example.com/activerecord-s3-bucket-name-validator"
+  spec.license       = "MIT"
+
+  # Prevent pushing this gem to RubyGems.org. To allow pushes either set the 'allowed_push_host'
+  # to allow pushing to a single host or delete this section to allow pushing to any host.
+  if spec.respond_to?(:metadata)
+    # spec.metadata["allowed_push_host"] = "https://rubygems.org"
+
+    spec.metadata["homepage_uri"] = spec.homepage
+    # spec.metadata["source_code_uri"] = "https://example.com/activerecord-s3-bucket-name-validator"
+    # spec.metadata["changelog_uri"] = "https://example.com/activerecord-s3-bucket-name-validator/CHANGELOG.md"
+  else
+    raise "RubyGems 2.0 or newer is required to protect against " \
+      "public gem pushes."
+  end
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files         = Dir.chdir(File.expand_path('..', __FILE__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.required_ruby_version = ">= 3.1"
+
+  # Runtime dependencies
+  spec.add_dependency "activemodel", ">= 7.0", "< 9"
+  spec.add_dependency "i18n", ">= 1.0"
+
+  # Development and test dependencies
+  spec.add_development_dependency "bundler", ">= 1.17"
+  spec.add_development_dependency "rake", ">= 10.0"
+  spec.add_development_dependency "minitest", ">= 5.0"
+end

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "activerecord/s3/bucket/name/validator"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/config/locales/de.yml

@@ -0,0 +1,9 @@
+de:
+  activemodel:
+    errors:
+      messages:
+        s3_bucket_name_invalid_general: "ist kein gültiger S3-Bucket-Name (3–63 Zeichen; Kleinbuchstaben, Ziffern, Punkte oder Bindestriche; beginnt/endet alphanumerisch; kein '..'; keine IP-ähnlichen Namen; keine reservierten Präfixe/Suffixe)"
+        s3_bucket_name_invalid_transfer_acceleration: "darf keine Punkte enthalten, wenn S3 Transfer Acceleration verwendet wird"
+        s3_bucket_name_invalid_directory: "ist kein gültiger S3-Verzeichnis-Bucket-Name (3–63 Zeichen; Kleinbuchstaben, Ziffern oder Bindestriche; muss mit --<zone-id>--x-s3 enden; reservierte Präfixe/Suffixe nicht erlaubt)"
+        s3_bucket_name_invalid_table: "ist kein gültiger S3-Tables-Bucket-Name (3–63 Zeichen; Kleinbuchstaben, Ziffern oder Bindestriche; keine Punkte oder Unterstriche; keine reservierten Präfixe/Suffixe)"
+        s3_bucket_name_invalid: "ist kein gültiger S3-Bucket-Name"

data/config/locales/en.yml

@@ -0,0 +1,9 @@
+en:
+  activemodel:
+    errors:
+      messages:
+        s3_bucket_name_invalid_general: "is not a valid S3 bucket name (3–63 chars; lowercase letters, numbers, periods or hyphens; start/end alphanumeric; no '..'; not IP-like; no reserved prefixes/suffixes)"
+        s3_bucket_name_invalid_transfer_acceleration: "cannot contain periods when using S3 Transfer Acceleration"
+        s3_bucket_name_invalid_directory: "is not a valid S3 directory bucket name (3–63 chars; lowercase letters, numbers or hyphens; must end with --<zone-id>--x-s3; reserved prefixes/suffixes not allowed)"
+        s3_bucket_name_invalid_table: "is not a valid S3 Tables bucket name (3–63 chars; lowercase letters, numbers or hyphens; no periods or underscores; reserved prefixes/suffixes not allowed)"
+        s3_bucket_name_invalid: "is not a valid S3 bucket name"

data/config/locales/es.yml

@@ -0,0 +1,9 @@
+es:
+  activemodel:
+    errors:
+      messages:
+        s3_bucket_name_invalid_general: "no es un nombre de bucket S3 válido (3–63 caracteres; letras minúsculas, números, puntos o guiones; empieza y termina alfanumérico; sin '..'; no con formato IP; sin prefijos/sufijos reservados)"
+        s3_bucket_name_invalid_transfer_acceleration: "no puede contener puntos cuando se usa S3 Transfer Acceleration"
+        s3_bucket_name_invalid_directory: "no es un nombre de bucket de directorio S3 válido (3–63 caracteres; letras minúsculas, números o guiones; debe terminar con --<zone-id>--x-s3; prefijos/sufijos reservados no permitidos)"
+        s3_bucket_name_invalid_table: "no es un nombre de bucket S3 Tables válido (3–63 caracteres; letras minúsculas, números o guiones; sin puntos ni guiones bajos; sin prefijos/sufijos reservados)"
+        s3_bucket_name_invalid: "no es un nombre de bucket S3 válido"

data/config/locales/fr.yml

@@ -0,0 +1,9 @@
+fr:
+  activemodel:
+    errors:
+      messages:
+        s3_bucket_name_invalid_general: "n’est pas un nom de bucket S3 valide (3–63 caractères ; lettres minuscules, chiffres, points ou tirets ; commence et se termine par un caractère alphanumérique ; pas de '..' ; ne doit pas ressembler à une adresse IP ; pas de préfixes/suffixes réservés)"
+        s3_bucket_name_invalid_transfer_acceleration: "ne peut pas contenir de points avec S3 Transfer Acceleration"
+        s3_bucket_name_invalid_directory: "n’est pas un nom de bucket de répertoire S3 valide (3–63 caractères ; lettres minuscules, chiffres ou tirets ; doit se terminer par --<zone-id>--x-s3 ; préfixes/suffixes réservés interdits)"
+        s3_bucket_name_invalid_table: "n’est pas un nom de bucket S3 Tables valide (3–63 caractères ; lettres minuscules, chiffres ou tirets ; sans points ni underscores ; pas de préfixes/suffixes réservés)"
+        s3_bucket_name_invalid: "n’est pas un nom de bucket S3 valide"

data/config/locales/it.yml

@@ -0,0 +1,9 @@
+it:
+  activemodel:
+    errors:
+      messages:
+        s3_bucket_name_invalid_general: "non è un nome bucket S3 valido (3–63 caratteri; lettere minuscole, numeri, punti o trattini; inizia/termina alfanumerico; senza '..'; non in formato IP; senza prefissi/suffissi riservati)"
+        s3_bucket_name_invalid_transfer_acceleration: "non può contenere punti quando si usa S3 Transfer Acceleration"
+        s3_bucket_name_invalid_directory: "non è un nome bucket directory S3 valido (3–63 caratteri; lettere minuscole, numeri o trattini; deve terminare con --<zone-id>--x-s3; prefissi/suffissi riservati non consentiti)"
+        s3_bucket_name_invalid_table: "non è un nome bucket S3 Tables valido (3–63 caratteri; lettere minuscole, numeri o trattini; senza punti o underscore; senza prefissi/suffissi riservati)"
+        s3_bucket_name_invalid: "non è un nome bucket S3 valido"

data/config/locales/ja.yml

@@ -0,0 +1,9 @@
+ja:
+  activemodel:
+    errors:
+      messages:
+        s3_bucket_name_invalid_general: "有効な S3 バケット名ではありません（3～63 文字、小文字の英字・数字・ピリオド・ハイフン、先頭/末尾は英数字、'..' 不可、IP 形式不可、予約済みの接頭/接尾辞不可）"
+        s3_bucket_name_invalid_transfer_acceleration: "S3 Transfer Acceleration を使用する場合、ピリオドは使用できません"
+        s3_bucket_name_invalid_directory: "有効な S3 ディレクトリバケット名ではありません（3～63 文字、小文字の英字・数字・ハイフン、末尾に --<zone-id>--x-s3 必須、予約済みの接頭/接尾辞不可）"
+        s3_bucket_name_invalid_table: "有効な S3 Tables バケット名ではありません（3～63 文字、小文字の英字・数字・ハイフン、ピリオドおよびアンダースコア不可、予約済みの接頭/接尾辞不可）"
+        s3_bucket_name_invalid: "有効な S3 バケット名ではありません"

data/config/locales/ko.yml

@@ -0,0 +1,9 @@
+ko:
+  activemodel:
+    errors:
+      messages:
+        s3_bucket_name_invalid_general: "유효한 S3 버킷 이름이 아닙니다(3–63자; 소문자, 숫자, 점 또는 하이픈; 시작/끝은 영숫자; '..' 금지; IP 형식 금지; 예약된 접두사/접미사 금지)"
+        s3_bucket_name_invalid_transfer_acceleration: "S3 Transfer Acceleration 사용 시 점(.)을 포함할 수 없습니다"
+        s3_bucket_name_invalid_directory: "유효한 S3 디렉터리 버킷 이름이 아닙니다(3–63자; 소문자, 숫자 또는 하이픈; '--<zone-id>--x-s3'로 끝나야 함; 예약된 접두사/접미사 금지)"
+        s3_bucket_name_invalid_table: "유효한 S3 Tables 버킷 이름이 아닙니다(3–63자; 소문자, 숫자 또는 하이픈; 점/밑줄 금지; 예약된 접두사/접미사 금지)"
+        s3_bucket_name_invalid: "유효한 S3 버킷 이름이 아닙니다"

data/config/locales/nl.yml

@@ -0,0 +1,9 @@
+nl:
+  activemodel:
+    errors:
+      messages:
+        s3_bucket_name_invalid_general: "is geen geldige S3-bucketnaam (3–63 tekens; kleine letters, cijfers, punten of koppeltekens; begint/eindigt alfanumerisch; geen '..'; geen IP-formaat; geen gereserveerde voor-/achtervoegsels)"
+        s3_bucket_name_invalid_transfer_acceleration: "mag geen punten bevatten wanneer S3 Transfer Acceleration wordt gebruikt"
+        s3_bucket_name_invalid_directory: "is geen geldige S3-directorybucketnaam (3–63 tekens; kleine letters, cijfers of koppeltekens; moet eindigen op --<zone-id>--x-s3; gereserveerde voor-/achtervoegsels niet toegestaan)"
+        s3_bucket_name_invalid_table: "is geen geldige S3 Tables-bucketnaam (3–63 tekens; kleine letters, cijfers of koppeltekens; geen punten of underscores; geen gereserveerde voor-/achtervoegsels)"
+        s3_bucket_name_invalid: "is geen geldige S3-bucketnaam"

data/config/locales/pt-BR.yml

@@ -0,0 +1,9 @@
+pt-BR:
+  activemodel:
+    errors:
+      messages:
+        s3_bucket_name_invalid_general: "não é um nome de bucket S3 válido (3–63 caracteres; letras minúsculas, números, pontos ou hífens; começa/termina alfanumérico; sem '..'; não no formato de IP; sem prefixos/sufixos reservados)"
+        s3_bucket_name_invalid_transfer_acceleration: "não pode conter pontos ao usar S3 Transfer Acceleration"
+        s3_bucket_name_invalid_directory: "não é um nome de bucket de diretório S3 válido (3–63 caracteres; letras minúsculas, números ou hífens; deve terminar com --<zone-id>--x-s3; prefixos/sufixos reservados não permitidos)"
+        s3_bucket_name_invalid_table: "não é um nome de bucket S3 Tables válido (3–63 caracteres; letras minúsculas, números ou hífens; sem pontos ou underscores; sem prefixos/sufixos reservados)"
+        s3_bucket_name_invalid: "não é um nome de bucket S3 válido"

data/config/locales/ru.yml

@@ -0,0 +1,9 @@
+ru:
+  activemodel:
+    errors:
+      messages:
+        s3_bucket_name_invalid_general: "недопустимое имя S3 бакета (3–63 символа; строчные буквы, цифры, точки или дефисы; начинается/заканчивается буквенно-цифровым символом; без '..'; не должно быть похоже на IP; без зарезервированных префиксов/суффиксов)"
+        s3_bucket_name_invalid_transfer_acceleration: "нельзя использовать точки при S3 Transfer Acceleration"
+        s3_bucket_name_invalid_directory: "недопустимое имя каталожного S3 бакета (3–63 символа; строчные буквы, цифры или дефисы; должно заканчиваться на --<zone-id>--x-s3; зарезервированные префиксы/суффиксы запрещены)"
+        s3_bucket_name_invalid_table: "недопустимое имя бакета S3 Tables (3–63 символа; строчные буквы, цифры или дефисы; без точек и нижних подчёркиваний; зарезервированные префиксы/суффиксы запрещены)"
+        s3_bucket_name_invalid: "недопустимое имя S3 бакета"

data/config/locales/zh-CN.yml

@@ -0,0 +1,9 @@
+zh-CN:
+  activemodel:
+    errors:
+      messages:
+        s3_bucket_name_invalid_general: "不是有效的 S3 存储桶名称（3–63 个字符；小写字母、数字、点或连字符；首尾必须为字母或数字；不允许 '..'；不得为 IP 格式；不得使用保留的前缀/后缀）"
+        s3_bucket_name_invalid_transfer_acceleration: "使用 S3 Transfer Acceleration 时，名称中不能包含点（.）"
+        s3_bucket_name_invalid_directory: "不是有效的 S3 目录存储桶名称（3–63 个字符；小写字母、数字或连字符；必须以 --<zone-id>--x-s3 结尾；不得使用保留的前缀/后缀）"
+        s3_bucket_name_invalid_table: "不是有效的 S3 Tables 存储桶名称（3–63 个字符；小写字母、数字或连字符；不允许点或下划线；不得使用保留的前缀/后缀）"
+        s3_bucket_name_invalid: "不是有效的 S3 存储桶名称"

data/config/locales/zh-TW.yml

@@ -0,0 +1,9 @@
+zh-TW:
+  activemodel:
+    errors:
+      messages:
+        s3_bucket_name_invalid_general: "不是有效的 S3 儲存貯體名稱（3–63 個字元；小寫字母、數字、點或連字號；開頭與結尾必須為英數字；不可含 '..'；不得為 IP 格式；不得使用保留的前/後綴）"
+        s3_bucket_name_invalid_transfer_acceleration: "使用 S3 Transfer Acceleration 時，名稱中不可包含點（.）"
+        s3_bucket_name_invalid_directory: "不是有效的 S3 目錄儲存貯體名稱（3–63 個字元；小寫字母、數字或連字號；必須以 --<zone-id>--x-s3 結尾；不得使用保留的前/後綴）"
+        s3_bucket_name_invalid_table: "不是有效的 S3 Tables 儲存貯體名稱（3–63 個字元；小寫字母、數字或連字號；不可有點或底線；不得使用保留的前/後綴）"
+        s3_bucket_name_invalid: "不是有效的 S3 儲存貯體名稱"

data/lib/activerecord/s3/bucket/name/validator/railtie.rb

@@ -0,0 +1,19 @@
+require "rails/railtie"
+
+module Activerecord
+  module S3
+    module Bucket
+      module Name
+        module Validator
+          class Railtie < ::Rails::Railtie
+            initializer "activerecord-s3-bucket-name-validator.i18n" do |app|
+              locales = Dir[File.expand_path("../../../../../config/locales/*.yml", __FILE__)]
+              app.config.i18n.load_path.concat(locales)
+            end
+          end
+        end
+      end
+    end
+  end
+end
+

data/lib/activerecord/s3/bucket/name/validator/version.rb

@@ -0,0 +1,11 @@
+module Activerecord
+  module S3
+    module Bucket
+      module Name
+        module Validator
+          VERSION = "0.1.0"
+        end
+      end
+    end
+  end
+end

data/lib/activerecord/s3/bucket/name/validator.rb

@@ -0,0 +1,125 @@
+require "activerecord/s3/bucket/name/validator/version"
+require "active_model"
+require "i18n"
+begin
+  require "activerecord/s3/bucket/name/validator/railtie"
+rescue LoadError
+  # Rails not present; ignore
+end
+
+module Activerecord
+  module S3
+    module Bucket
+      module Name
+        module Validator
+          # Validator implementation lives at top-level constant so Rails can autoload it
+        end
+      end
+    end
+  end
+end
+
+# Load embedded translations when not in Rails (Rails will pick them up via Railtie below)
+begin
+  locales_glob = File.expand_path("../../../../../config/locales/*.yml", __FILE__)
+  I18n.load_path += Dir[locales_glob] if Dir.exist?(File.dirname(locales_glob))
+rescue StandardError
+  # ignore i18n loading errors
+end
+
+# Usage in a model:
+#   validates :bucket_name, s3_bucket_name: { type: :general_purpose }
+# Options:
+#   :type => :general_purpose (default), :directory, or :table
+#   :transfer_acceleration => true to forbid periods for TA buckets
+class S3BucketNameValidator < ActiveModel::EachValidator
+  RESERVED_PREFIXES_GENERAL = %w[xn-- sthree- amzn-s3-demo-].freeze
+  RESERVED_SUFFIXES_GENERAL = %w[-s3alias --ol-s3 .mrap --x-s3 --table-s3].freeze
+
+  RESERVED_PREFIXES_TABLE = %w[xn-- sthree- amzn-s3-demo- aws].freeze
+  RESERVED_SUFFIXES_TABLE = %w[-s3alias --ol-s3 --x-s3 --table-s3].freeze
+
+  def validate_each(record, attribute, value)
+    type = (options[:type] || :general_purpose).to_sym
+    return if blank_ok?(value)
+
+    valid = case type
+            when :general_purpose then validate_general_purpose(value, transfer_acceleration: !!options[:transfer_acceleration])
+            when :directory then validate_directory_bucket(value)
+            when :table then validate_table_bucket(value)
+            else
+              record.errors.add(attribute, :invalid, message: "unknown bucket type: #{type}")
+              false
+            end
+
+    unless valid
+      error_key = if type == :general_purpose && options[:transfer_acceleration] && value.include?(".")
+                    :s3_bucket_name_invalid_transfer_acceleration
+                  else
+                    case type
+                    when :general_purpose then :s3_bucket_name_invalid_general
+                    when :directory then :s3_bucket_name_invalid_directory
+                    when :table then :s3_bucket_name_invalid_table
+                    else :s3_bucket_name_invalid
+                    end
+                  end
+      record.errors.add(attribute, error_key)
+    end
+  end
+
+  private
+
+  # I18n error messages are defined in config/locales/*.yml
+
+  def blank_ok?(value)
+    value.nil? || (value.respond_to?(:empty?) && value.empty?)
+  end
+
+  # Based on AWS docs: General purpose bucket naming rules
+  def validate_general_purpose(name, transfer_acceleration: false)
+    return false unless length_between?(name, 3, 63)
+    return false unless name =~ /\A[a-z0-9.-]+\z/
+    return false unless begins_and_ends_with_alnum?(name)
+    return false if name.include?("..")
+    return false if ip_like?(name)
+    return false unless RESERVED_PREFIXES_GENERAL.none? { |p| name.start_with?(p) }
+    return false unless RESERVED_SUFFIXES_GENERAL.none? { |s| name.end_with?(s) }
+    return false if transfer_acceleration && name.include?(".")
+    true
+  end
+
+  # Based on AWS docs: Directory bucket naming rules (S3 Express One Zone)
+  def validate_directory_bucket(name)
+    return false unless length_between?(name, 3, 63)
+    return false unless name =~ /\A[a-z0-9-]+\z/
+    return false unless begins_and_ends_with_alnum?(name)
+    # must contain --<zone-id>--x-s3 suffix
+    return false unless name =~ /--[a-z0-9-]+--x-s3\z/
+    # reserved prefixes/suffixes still apply
+    return false if name.start_with?("xn--", "sthree-", "sthree-configurator", "amzn-s3-demo-")
+    return false if name.end_with?("-s3alias", "--ol-s3", ".mrap", "--table-s3")
+    true
+  end
+
+  # Based on AWS docs: S3 Tables bucket naming rules
+  def validate_table_bucket(name)
+    return false unless length_between?(name, 3, 63)
+    return false unless name =~ /\A[a-z0-9-]+\z/
+    return false unless begins_and_ends_with_alnum?(name)
+    return false unless RESERVED_PREFIXES_TABLE.none? { |p| name.start_with?(p) }
+    return false unless RESERVED_SUFFIXES_TABLE.none? { |s| name.end_with?(s) }
+    true
+  end
+
+  def length_between?(str, min, max)
+    str.length.between?(min, max)
+  end
+
+  def begins_and_ends_with_alnum?(str)
+    str[0] =~ /[a-z0-9]/ && str[-1] =~ /[a-z0-9]/
+  end
+
+  def ip_like?(str)
+    str =~ /\A(?:\d{1,3}\.){3}\d{1,3}\z/
+  end
+end

metadata

@@ -0,0 +1,146 @@
+--- !ruby/object:Gem::Specification
+name: activerecord-s3-bucket-name-validator
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Claudio Poli
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activemodel
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
+- !ruby/object:Gem::Dependency
+  name: i18n
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.17'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.17'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '5.0'
+description: Validate S3 bucket names on your models against the official AWS rules
+  (general purpose, directory buckets, and S3 Tables).
+email:
+- masterkain@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".github/workflows/release.yaml"
+- ".github/workflows/test.yml"
+- ".gitignore"
+- ".ruby-version"
+- ".travis.yml"
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- activerecord-s3-bucket-name-validator.gemspec
+- bin/console
+- bin/setup
+- config/locales/de.yml
+- config/locales/en.yml
+- config/locales/es.yml
+- config/locales/fr.yml
+- config/locales/it.yml
+- config/locales/ja.yml
+- config/locales/ko.yml
+- config/locales/nl.yml
+- config/locales/pt-BR.yml
+- config/locales/ru.yml
+- config/locales/zh-CN.yml
+- config/locales/zh-TW.yml
+- lib/activerecord/s3/bucket/name/validator.rb
+- lib/activerecord/s3/bucket/name/validator/railtie.rb
+- lib/activerecord/s3/bucket/name/validator/version.rb
+homepage: https://example.com/activerecord-s3-bucket-name-validator
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://example.com/activerecord-s3-bucket-name-validator
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.1'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: ActiveModel/ActiveRecord validator for Amazon S3 bucket naming rules
+test_files: []