discourse/migrations
Gerhard Schlager 4141d4e0a6 DEV: Restructure importer files
This is similar to converters: We allow directories to structure files within the importer directory, but try to keep the namespace the same.

Currently the restructured namespaces look like this:

* `Migrations::Converters::Discourse`
  * migrations/lib/converters/discourse/steps
  * migrations/lib/converters/discourse/utilities

* `Migrations::Importer`
  * migrations/lib/importer/name_finder

* `Migrations::Importer::Steps`
  * migrations/lib/importer/steps/badges
  * migrations/lib/importer/steps/categories
  * migrations/lib/importer/steps/groups
  * migrations/lib/importer/steps/settings
  * migrations/lib/importer/steps/tags
  * migrations/lib/importer/steps/topics
  * migrations/lib/importer/steps/users
2025-11-03 11:23:53 +01:00
..
bin DEV: Set Regex timeout for migrations (#35190) 2025-10-06 16:29:34 +02:00
config Update translations (#35700) 2025-10-31 11:33:08 +01:00
db DEV: Add support for converting and importing site settings 2025-10-31 11:21:40 +01:00
docs DEV: Add initial structure for migrations-tooling 2023-10-13 16:03:55 +02:00
lib DEV: Restructure importer files 2025-11-03 11:23:53 +01:00
scripts/benchmarks REFACTOR: Code generator for migrations IntemerdiateDB 2025-04-07 17:22:36 +02:00
spec DEV: Restructure importer files 2025-11-03 11:23:53 +01:00
.gitignore DEV: Adds a new converter for migrating from Discourse 2025-04-07 17:22:36 +02:00
.rubocop.yml DEV: Refactor migrations-tooling 2025-04-07 17:22:36 +02:00
migrations.rb DEV: Restructure importer files 2025-11-03 11:23:53 +01: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