first commit

Author: masterkain

.github/workflows/release.yml

@@ -0,0 +1,28 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - v*
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '3.4'
+          bundler-cache: true
+      - name: Build gem
+        run: |
+          gem build *.gemspec
+      - name: Publish to RubyGems
+        uses: cadwallion/publish-rubygems-action@master
+        env:
+          RUBYGEMS_API_KEY: ${{ secrets.RUBYGEMS_API_KEY }}

.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@v4
+      - 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@v4
+      - 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

.gitignore

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

.ruby-version

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

.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

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

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

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.

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`.

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