discourse/migrations
Gerhard Schlager 7c3a29c9d6
DEV: Add converter framework for migrations-tooling (#28540)
* Updates GitHub Actions
* Switches from `bundler/inline` to an optional group in the `Gemfile` because the previous solution didn't work well with rspec
* Adds the converter framework and tests
* Allows loading private converters (see README)
* Switches from multiple CLI tools to a single CLI
* Makes DB connections reusable and adds a new abstraction for the `IntermediateDB`
* `IntermediateDB` acts as an interface for IPC calls when a converter steps runs in parallel (forks). Only the main process writes to the DB.
* Includes a simple example implementation of a converter for now.
2024-09-09 17:14:39 +02:00
..
bin DEV: Add converter framework for migrations-tooling (#28540) 2024-09-09 17:14:39 +02:00
config DEV: Add converter framework for migrations-tooling (#28540) 2024-09-09 17:14:39 +02:00
db DEV: Add converter framework for migrations-tooling (#28540) 2024-09-09 17:14:39 +02:00
docs DEV: Add initial structure for migrations-tooling 2023-10-13 16:03:55 +02:00
lib DEV: Add converter framework for migrations-tooling (#28540) 2024-09-09 17:14:39 +02:00
scripts DEV: Add converter framework for migrations-tooling (#28540) 2024-09-09 17:14:39 +02:00
spec DEV: Add converter framework for migrations-tooling (#28540) 2024-09-09 17:14:39 +02:00
.gitignore DEV: Add converter framework for migrations-tooling (#28540) 2024-09-09 17:14:39 +02:00
README.md DEV: Add converter framework for migrations-tooling (#28540) 2024-09-09 17:14:39 +02:00

Migrations Tooling

Command line interface

./bin/cli help

Converters

Public converters are stored in lib/converters/. If you need to run a private converter, put its code into a subdirectory of private/converters/

Development

Installing gems

bundle config set --local with migrations
bundle install

Updating gems

bundle update --group migrations

Running tests

You need to execute rspec in the root of the project.

bin/rspec --default-path migrations/spec