alba_migration 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 5d0d4f72523fe8a34222de3cfe8a36d66aac6c5435f5efa1838899d0c70dec70
+  data.tar.gz: 1a1c8a0d42928db2f3bda02ad2f0202153f2706b95ef3c84d56348e47c575800
+SHA512:
+  metadata.gz: a6fb7aec6e909fdeeee455f04bf0a3fe8b4ae7596673d995f7288311fca94c19b5682260696d66b1b3a5b60ba2ca561d4b50eec30f6e59a01a0821a356629d79
+  data.tar.gz: 1157bfbcf57f3ef83d22aa2b1896c125c550b3744cab656312f1220d2083303ff16f84191b067afe310eda19182c874d20d1a9ed6e389965893976c3068f5780

data/.devcontainer/Dockerfile

@@ -0,0 +1,28 @@
+FROM ruby:3.3-slim
+
+# Install required packages
+RUN apt-get update -qq && apt-get install -y \
+  build-essential \
+  git \
+  libyaml-dev \
+  && apt-get clean \
+  && rm -rf /var/lib/apt/lists/*
+
+# Set working directory
+WORKDIR /app
+
+# Copy Gemfile and gemspec
+COPY Gemfile* ../alba_migration.gemspec ./
+COPY lib/alba_migration/version.rb ./lib/alba_migration/version.rb
+
+# Install gems
+RUN bundle install
+
+# Copy application code
+COPY . .
+
+# Set default directory for command execution
+WORKDIR /app
+
+# Default command
+CMD ["bash"] 

data/.devcontainer/devcontainer.json

@@ -0,0 +1,52 @@
+{
+  "name": "Alba Migration Development",
+  "build": {
+    "dockerfile": "Dockerfile",
+    "context": ".."
+  },
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        "Shopify.ruby-extensions-pack"
+      ],
+      "settings": {
+        "rubyLsp.rubyVersionManager": {
+          "identifier": "auto"
+        },
+        "ruby.interpreter.commandPath": "/usr/local/bin/ruby",
+        "ruby.useLanguageServer": true,
+        "[ruby]": {
+          "editor.defaultFormatter": "Shopify.ruby-lsp"
+        },
+        "rubyLsp.formatter": "standard",
+        "rubyLsp.linters": [
+          "standard"
+        ],
+        "editor.formatOnSave": true,
+        "editor.tabSize": 2,
+        "editor.insertSpaces": true,
+        "editor.semanticHighlighting.enabled": true,
+        "editor.formatOnType": true,
+        "rubyLsp.enabledFeatures": {
+          "codeActions": true,
+          "diagnostics": true,
+          "documentHighlights": true,
+          "documentLink": true,
+          "documentSymbols": true,
+          "foldingRanges": true,
+          "formatting": true,
+          "hover": true,
+          "inlayHint": true,
+          "onTypeFormatting": true,
+          "selectionRanges": true,
+          "semanticHighlighting": true,
+          "completion": true
+        }
+      }
+    }
+  },
+  "features": {
+    "ghcr.io/devcontainers/features/git:1": {},
+    "ghcr.io/devcontainers/features/github-cli:1": {}
+  }
+} 

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.standard.yml

@@ -0,0 +1,3 @@
+# For available configuration options, see:
+#   https://github.com/standardrb/standard
+ruby_version: 3.1

data/CHANGELOG.md

@@ -0,0 +1,7 @@
+# GHANGELOG
+
+## 0.0.1 (2025-05-19)
+
+- Initial release
+- Provides CLI tool to migrate Ruby code from ActiveModelSerializers (AMS) to Alba syntax
+- Supports conversion of class definitions and attributes from AMS to Alba

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,132 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, caste, color, religion, or sexual
+identity and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes,
+  and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the overall
+  community
+
+Examples of unacceptable behavior include:
+
+* The use of sexualized language or imagery, and sexual attention or advances of
+  any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or email address,
+  without their explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official email address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at
+[INSERT CONTACT METHOD].
+All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series of
+actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or permanent
+ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior, harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within the
+community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.1, available at
+[https://www.contributor-covenant.org/version/2/1/code_of_conduct.html][v2.1].
+
+Community Impact Guidelines were inspired by
+[Mozilla's code of conduct enforcement ladder][Mozilla CoC].
+
+For answers to common questions about this code of conduct, see the FAQ at
+[https://www.contributor-covenant.org/faq][FAQ]. Translations are available at
+[https://www.contributor-covenant.org/translations][translations].
+
+[homepage]: https://www.contributor-covenant.org
+[v2.1]: https://www.contributor-covenant.org/version/2/1/code_of_conduct.html
+[Mozilla CoC]: https://github.com/mozilla/diversity
+[FAQ]: https://www.contributor-covenant.org/faq
+[translations]: https://www.contributor-covenant.org/translations

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 ShoheiMitani
+
+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,88 @@
+# AlbaMigration
+
+## What is AlbaMigration?
+AlbaMigration is a Ruby gem that helps you migrate your Ruby code from [ActiveModelSerializers (AMS)](https://github.com/rails-api/active_model_serializers) to [Alba](https://github.com/okuramasafumi/alba) syntax automatically. It provides a command-line tool to convert AMS serializer classes to Alba resource classes, making your migration process easier and less error-prone.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem "alba_migration"
+```
+
+And then execute:
+
+```bash
+bundle install
+```
+
+## Usage
+
+### Command Line Tool
+
+After installing the gem, you can use the CLI to migrate your Ruby files:
+
+```bash
+alba_migration path/to/your/serializer.rb
+```
+
+You can also use glob patterns to migrate multiple files at once:
+
+```bash
+alba_migration app/serializers/**/*.rb
+```
+
+If you are using Bundler:
+
+```bash
+bundle exec alba_migration app/serializers/**/*.rb
+```
+
+#### Example
+
+**Before:**
+```ruby
+class AttributesResource < ActiveModel::Serializer
+  attributes :id, :name
+end
+```
+
+**After:**
+```ruby
+class AttributesResource
+  include Alba::Resource
+
+  attributes :id, :name
+end
+```
+
+### Error Handling
+- If no files match the given pattern, an error message will be shown and the process will exit with status 1.
+
+## Supported Syntax
+Currently, AlbaMigration supports the following AMS syntax:
+- `class ... < ActiveModel::Serializer` with `attributes ...` inside the class body
+- Only the conversion of the class definition and `attributes` is supported at this time
+- Other AMS features (e.g., associations, custom methods) are **not** yet supported
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at [https://github.com/ShoheiMitani/alba_migration](https://github.com/ShoheiMitani/alba_migration).
+
+To get started with development:
+
+1. Clone the repository
+2. Run `bin/setup` to install dependencies
+3. Run tests with `bin/rspec spec/`
+4. Check/fix code style with `bin/standardrb --fix`
+
+If you find a bug, please [open an issue](https://github.com/ShoheiMitani/alba_migration/issues) with detailed steps to reproduce it.
+
+## License
+
+This project is licensed under the MIT License. See [LICENSE.txt](LICENSE.txt) for details.
+
+## Code of Conduct
+
+Everyone interacting in the AlbaMigration project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [Code of Conduct](CODE_OF_CONDUCT.md).

data/Rakefile

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+require "standard/rake"
+
+task default: %i[spec standard]

data/Steepfile

@@ -0,0 +1,32 @@
+# D = Steep::Diagnostic
+#
+# target :lib do
+#   signature "sig"
+#   ignore_signature "sig/test"
+#
+#   check "lib"                       # Directory name
+#   check "path/to/source.rb"         # File name
+#   check "app/models/**/*.rb"        # Glob
+#   # ignore "lib/templates/*.rb"
+#
+#   # library "pathname"              # Standard libraries
+#   # library "strong_json"           # Gems
+#
+#   # configure_code_diagnostics(D::Ruby.default)      # `default` diagnostics setting (applies by default)
+#   # configure_code_diagnostics(D::Ruby.strict)       # `strict` diagnostics setting
+#   # configure_code_diagnostics(D::Ruby.lenient)      # `lenient` diagnostics setting
+#   # configure_code_diagnostics(D::Ruby.silent)       # `silent` diagnostics setting
+#   # configure_code_diagnostics do |hash|             # You can setup everything yourself
+#   #   hash[D::Ruby::NoMethod] = :information
+#   # end
+# end
+
+# target :test do
+#   unreferenced!                     # Skip type checking the `lib` code when types in `test` target is changed
+#   signature "sig/test"              # Put RBS files for tests under `sig/test`
+#   check "test"                      # Type check Ruby scripts under `test`
+#
+#   configure_code_diagnostics(D::Ruby.lenient)      # Weak type checking for test code
+#
+#   # library "pathname"              # Standard libraries
+# end

data/bin/console

@@ -0,0 +1,11 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "bundler/setup"
+require "alba_migration"
+
+# 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.
+
+require "irb"
+IRB.start(__FILE__)

data/bin/rspec

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "bundler/setup"
+load Gem.bin_path("rspec-core", "rspec") 

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/bin/standardrb

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "bundler/setup"
+load Gem.bin_path("standard", "standardrb") 

data/docs/synvert_usage_guide.md

@@ -0,0 +1,293 @@
+# Synvert Usage Guideline
+
+This document explains how to use the Synvert CLI to automate migration from ActiveModelSerializers to Alba, based on the actual implementation and DSL of synvert-core v2.2.2.
+
+---
+
+## 1. Overview
+
+Synvert is an automated Ruby code refactoring tool. You define code transformation rules, and Synvert rewrites code based on AST (Abstract Syntax Tree) analysis for syntactically correct transformations.
+
+Synvert consists of two main gems:
+- `synvert-core` (v2.2.2): Provides core features (AST analysis, code transformation engine)
+- `synvert` (v1.10.4): Provides the CLI interface and runs predefined or custom snippets
+
+This project uses the `synvert` CLI for code transformation.
+
+---
+
+## 2. Installation and Basic Usage
+
+### 2.1 Installation
+
+```bash
+gem install synvert
+```
+
+Or add to your Gemfile:
+
+```ruby
+gem 'synvert'
+```
+
+### 2.2 Basic Usage
+
+```bash
+# List available snippets
+synvert -l
+
+# Run a predefined snippet
+synvert -r snippet_name
+
+# Run a custom snippet file
+synvert -s path/to/snippet.rb
+
+# Run on a specific directory or file
+synvert -s path/to/snippet.rb --path app/serializers
+
+# Dry-run (no actual changes)
+synvert -s path/to/snippet.rb --path app/serializers --dry-run
+```
+
+---
+
+## 3. Writing Custom Snippets
+
+### 3.1 Parser Selection
+
+**Important:**
+- Specify the parser as a string: `'parser'` (default), `'prism'`, or `'syntax_tree'`.
+- Do **not** use constants like `Synvert::PRISM_PARSER` in the DSL.
+
+#### Example:
+```ruby
+configure(parser: 'prism')
+```
+
+### 3.2 Example: AMS to Alba Migration Snippet
+
+```ruby
+# ams_to_alba.rb
+Synvert::Rewriter.new 'ams_to_alba', 'Convert ActiveModelSerializers to Alba' do
+  configure(parser: 'prism')
+
+  within_files('app/serializers/**/*.rb') do
+    # Class name conversion (XXXSerializer → XXXResource)
+    with_node(type: 'class', name: /Serializer$/) do
+      replace_with node.to_source.gsub(/(\w+)Serializer/, '\1Resource').gsub(/ < ActiveModel::Serializer/, ' < Alba::Resource')
+    end
+
+    # include conversion
+    with_node(type: 'send', message: 'include', arguments: ['ActiveModel::Serializer']) do
+      replace_with 'include Alba::Resource'
+    end
+
+    # attributes conversion
+    with_node(type: 'send', message: 'attributes') do
+      args = node.arguments.map(&:to_source)
+      if args.length > 1
+        new_code = args.map { |arg| "attribute #{arg}" }.join("\n  ")
+        replace_with new_code
+      else
+        replace_with "attribute #{args.first}"
+      end
+    end
+
+    # Association conversion
+    with_node(type: 'send', message: ['has_many', 'has_one', 'belongs_to']) do
+      relation_type = node.message
+      name = node.arguments.first.to_source.delete(':')
+      options = node.arguments[1..-1].map(&:to_source).join(', ')
+
+      if %w[has_one belongs_to].include?(relation_type)
+        if options.empty?
+          replace_with "one :#{name}"
+        else
+          replace_with "one :#{name}, #{options}"
+        end
+      elsif relation_type == 'has_many'
+        if options.empty?
+          replace_with "many :#{name}"
+        else
+          replace_with "many :#{name}, #{options}"
+        end
+      end
+    end
+
+    # serialize method conversion
+    with_node(type: 'send', message: 'serialize', arguments: { size: 2 }) do
+      attribute_name = node.arguments[0].to_source
+      serializer_name = node.arguments[1].to_source.gsub(/Serializer/, 'Resource')
+      replace_with "attribute #{attribute_name}, resource: #{serializer_name}"
+    end
+
+    # Custom method conversion
+    with_node(type: 'def') do
+      method_name = node.name.to_s
+      method_body = node.body.to_source
+      if method_body.include?('object.')
+        new_body = method_body.gsub(/object\./, 'resource.')
+        replace_with <<~RUBY
+          attribute :#{method_name} do |resource|
+            #{new_body}
+          end
+        RUBY
+      end
+    end
+
+    # Add require statement at the top
+    goto_node(:root) do
+      prepend "require 'alba'\n\n"
+    end
+  end
+end
+```
+
+### 3.3 Indentation Helpers
+- `add_leading_spaces` is **removed** as of v2.1.0. Use `indent` and `dedent` helpers for indentation adjustment.
+
+---
+
+## 4. Advanced Usage
+
+### 4.1 Conditional Transformation
+```ruby
+with_node(type: 'send', message: 'attributes') do
+  if node.arguments.length > 1
+    args = node.arguments.map { |arg| "attribute #{arg.to_source}" }.join("\n  ")
+    replace_with args
+  else
+    replace_with "attribute #{node.arguments.first.to_source}"
+  end
+end
+```
+
+### 4.2 Nested Node Processing
+```ruby
+with_node(type: 'class') do
+  with_node(type: 'send', message: 'has_many') do
+    relation_name = node.arguments.first.to_source.delete(':')
+    replace_with "many :#{relation_name}"
+  end
+end
+```
+
+### 4.3 Adding and Removing Code
+```ruby
+with_node(type: 'class', name: /Resource$/) do
+  append <<~RUBY
+    def serializable_hash(options = nil)
+      to_h
+    end
+  RUBY
+end
+
+with_node(type: 'def', name: 'active_model_serializer') do
+  remove
+end
+```
+
+### 4.4 Import and Require Conversion
+```ruby
+with_node(type: 'class', name: /Resource$/) do
+  goto_node(:root) do
+    prepend "require 'alba'\n"
+  end
+end
+```
+
+### 4.5 Custom Method Conversion
+```ruby
+with_node(type: 'def') do
+  method_name = node.name.to_s
+  method_body = node.body.to_source
+  if method_body.include?('object.')
+    new_body = method_body.gsub(/object\./, 'resource.')
+    replace_with <<~RUBY
+      attribute :#{method_name} do |resource|
+        #{new_body}
+      end
+    RUBY
+  end
+end
+```
+
+---
+
+## 5. File Discovery and Exclusion
+
+- If you set `Configuration.respect_gitignore = true`, `.gitignore` will be respected when searching files.
+- You can use `Configuration.only_paths` and `Configuration.skip_paths` to fine-tune which files are included or excluded.
+
+---
+
+## 6. Loading Snippets
+
+- You can load snippets from local files, GitHub, or Gist using `Utils.eval_snippet`.
+- If the snippet name is a URL, it will be automatically converted to a raw URL if needed.
+
+---
+
+## 7. CLI Options
+
+```
+Usage: synvert [options]
+    -d, --dry-run                    Dry-run (no actual file changes)
+    -s, --snippet SNIPPET            Path to custom snippet file
+    -r, --run SNIPPET                Name of predefined snippet to run
+    -l, --list                       List available snippets
+    -o, --only ONLY                  Process only specific files (comma-separated)
+    -p, --path PATH                  Path to process (default: current directory)
+    -q, --query QUERY                Search for snippets by query
+    -v, --version                    Show version
+    -h, --help                       Show help message
+```
+
+---
+
+## 8. AMS → Alba Main Migration Patterns
+
+| ActiveModelSerializers | Alba |
+|------------------------|------|
+| `class UserSerializer < ActiveModel::Serializer` | `class UserResource` or `class UserResource < Alba::Resource` |
+| `include ActiveModel::Serializer` | `include Alba::Resource` |
+| `attributes :id, :name, :email` | `attribute :id` <br> `attribute :name` <br> `attribute :email` |
+| `has_many :posts` | `many :posts` |
+| `has_one :profile` | `one :profile` |
+| `belongs_to :organization` | `one :organization` |
+| `has_many :posts, serializer: PostSerializer` | `many :posts, resource: PostResource` |
+| `serialize :metadata, MetadataSerializer` | `attribute :metadata, resource: MetadataResource` |
+| `def full_name; "#{object.first_name} #{object.last_name}"; end` | `attribute :full_name do |resource|` <br> `  "#{resource.first_name} #{resource.last_name}"` <br> `end` |
+| `root :user` | `key :user` |
+
+---
+
+## 9. Deprecated or Removed DSLs
+
+- `add_leading_spaces` is **removed** as of v2.1.0. Use `indent`/`dedent` helpers instead.
+- `save_data` / `load_data` DSLs are **removed** as of v2.2.0.
+- `if_only_exist_node` DSL is **removed** as of v1.35.0.
+- `redo_until_no_change` DSL is **removed** as of v1.31.1.
+
+---
+
+## 10. Other Notes
+
+- Use `process_with_sandbox` to run a rewriter without changing files (for dry-run purposes).
+- Use the `test` method to test a rewriter's effect.
+- Always refer to the [official API reference](https://synvert-hq.github.io/synvert-core-ruby/Synvert/Core/Rewriter.html) and [CHANGELOG](https://github.com/synvert-hq/synvert-core-ruby/blob/main/CHANGELOG.md) for the latest information and breaking changes.
+- Not all edge cases can be covered by automated transformation. Always review and test your code after migration.
+
+---
+
+## 11. References
+
+- [Synvert Ruby Docs](https://synvert.net/ruby/docs/)
+- [Synvert Core Ruby GitHub](https://github.com/synvert-hq/synvert-core-ruby)
+- [Synvert Core Ruby Documentation](https://synvert-hq.github.io/synvert-core-ruby/Synvert/Core/Rewriter.html)
+- [Synvert Architecture](https://synvert.net/architecture/)
+- [Synvert Ruby Snippets](https://github.com/synvert-hq/synvert-snippets-ruby)
+- [Rewriting Ruby with Synvert](https://thomasleecopeland.com/2016/11/17/rewriting-ruby-with-synvert.html)
+- [Decimating Deprecated Finders with Synvert](https://thoughtbot.com/blog/decimating-deprecated-finders)
+- [Alba Documentation](https://github.com/okuramasafumi/alba)
+- [ActiveModelSerializers Documentation](https://github.com/rails-api/active_model_serializers)

data/exe/alba_migration

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "alba_migration"
+require "alba_migration/cli"
+
+AlbaMigration::CLI.start(ARGV)

data/lib/alba_migration/cli.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+# rbs_inline: enabled
+
+require "fileutils"
+require "alba_migration/snippet"
+
+module AlbaMigration
+  class CLI
+    # @rbs arg: Array[String]
+    # @rbs return: void
+    def self.start(args)
+      new.execute(args)
+    end
+
+    # @rbs file_patterns: Array[String]
+    # @rbs return: void
+    def execute(file_patterns = [])
+      matched_files = file_patterns.flat_map { |pattern| Dir.glob(pattern) }.uniq
+      if matched_files.empty?
+        puts "Error: No files matched the given pattern(s): #{file_patterns.join(", ")}"
+        exit(1)
+      end
+
+      missing_patterns = file_patterns.select { |pattern| Dir.glob(pattern).empty? }
+      unless missing_patterns.empty?
+        puts "Error: No files found for pattern(s): #{missing_patterns.join(", ")}"
+        exit(1)
+      end
+
+      rewriter = AlbaMigration::Snippet.create(migrate_file_path: matched_files)
+      rewriter.process
+    end
+  end
+end

data/lib/alba_migration/snippet.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+# rbs_inline: enabled
+
+require "synvert/core"
+
+module AlbaMigration
+  class Snippet
+    # @rbs file_patterns: Array[String]
+    # @rbs return: Synvert::Core::Rewriter
+    def self.create(migrate_file_path:)
+      Synvert::Core::Rewriter.new "alba", "convert_ams_to_alba" do
+        description <<~EOS
+          It migrates ActiveModelSerializers syntax to Alba syntax.
+      
+          Example:
+      
+          ```ruby
+          class AttributesResource < ActiveModel::Serializer
+            attributes :id, :name
+          end
+          ```
+      
+          =>
+      
+          ```ruby
+          class AttributesResource
+            include Alba::Resource
+      
+            attributes :id, :name
+          end
+          ```
+        EOS
+
+        configure(parser: "prism")
+
+        within_files migrate_file_path do
+          with_node node_type: "class_node", superclass: "ActiveModel::Serializer" do
+            body = node.body ? node.body.to_source : ""
+            if body.strip.empty?
+              indented_body = ""
+            else
+              min_indent = body.lines.reject { |l| l.strip.empty? }.map { |l| l[/^\s*/].size }.min || 0
+              indented_body = body.lines.map { |l| "  " + l[min_indent..] }.join
+            end
+            replace_with "class #{node.constant_path.to_source}\n  include Alba::Resource\n\n#{indented_body}\nend"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/alba_migration/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+# rbs_inline: enabled
+
+module AlbaMigration
+  VERSION = "0.0.1"
+end

data/lib/alba_migration.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+# rbs_inline: enabled
+
+require_relative "alba_migration/version"
+require_relative "alba_migration/cli"
+
+module AlbaMigration; end

data/sig/generated/alba_migration/cli.rbs

@@ -0,0 +1,13 @@
+# Generated from lib/alba_migration/cli.rb with RBS::Inline
+
+module AlbaMigration
+  class CLI
+    # @rbs arg: Array[String]
+    # @rbs return: void
+    def self.start: (untyped args) -> void
+
+    # @rbs file_patterns: Array[String]
+    # @rbs return: void
+    def execute: (?Array[String] file_patterns) -> void
+  end
+end

data/sig/generated/alba_migration/snippet.rbs

@@ -0,0 +1,9 @@
+# Generated from lib/alba_migration/snippet.rb with RBS::Inline
+
+module AlbaMigration
+  class Snippet
+    # @rbs file_patterns: Array[String]
+    # @rbs return: Synvert::Core::Rewriter
+    def self.create: (migrate_file_path: untyped) -> Synvert::Core::Rewriter
+  end
+end

data/sig/generated/alba_migration/version.rbs

@@ -0,0 +1,5 @@
+# Generated from lib/alba_migration/version.rb with RBS::Inline
+
+module AlbaMigration
+  VERSION: ::String
+end

data/sig/generated/alba_migration.rbs

@@ -0,0 +1,4 @@
+# Generated from lib/alba_migration.rb with RBS::Inline
+
+module AlbaMigration
+end

metadata

@@ -0,0 +1,88 @@
+--- !ruby/object:Gem::Specification
+name: alba_migration
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- ShoheiMitani
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2025-05-19 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: synvert-core
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: AlbaMigration is a CLI tool and library to help you convert your Ruby
+  code from ActiveModelSerializers (AMS) to Alba syntax. It rewrites AMS serializer
+  classes to Alba resource classes, supporting the migration of class definitions
+  and attributes.
+email:
+- mitani49@gmail.com
+executables:
+- alba_migration
+extensions: []
+extra_rdoc_files: []
+files:
+- ".devcontainer/Dockerfile"
+- ".devcontainer/devcontainer.json"
+- ".rspec"
+- ".standard.yml"
+- CHANGELOG.md
+- CODE_OF_CONDUCT.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- Steepfile
+- bin/console
+- bin/rspec
+- bin/setup
+- bin/standardrb
+- docs/synvert_usage_guide.md
+- exe/alba_migration
+- lib/alba_migration.rb
+- lib/alba_migration/cli.rb
+- lib/alba_migration/snippet.rb
+- lib/alba_migration/version.rb
+- sig/generated/alba_migration.rbs
+- sig/generated/alba_migration/cli.rbs
+- sig/generated/alba_migration/snippet.rbs
+- sig/generated/alba_migration/version.rbs
+homepage: https://github.com/ShoheiMitani/alba_migration
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/ShoheiMitani/alba_migration
+  source_code_uri: https://github.com/ShoheiMitani/alba_migration
+  changelog_uri: https://github.com/ShoheiMitani/alba_migration/blob/main/CHANGELOG.md
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: Migrate ActiveModelSerializers (AMS) code to Alba syntax automatically.
+test_files: []