Issue #3382598: Deprecate farmOS v1 migrations

CHANGELOG.md

@@ -28,6 +28,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - [QuickFormInterface::getId() is replaced by QuickFormInterface::getQuickId()](https://www.drupal.org/node/3379686)
 - [Issue #3359452: Deprecate farm_log_asset_names_summary()](https://www.drupal.org/project/farm/issues/3359452)
+- [farmOS v1 migrations are deprecated and will be removed in farmOS 3.x](https://www.drupal.org/node/3382609)
 
 ### Fixed
 

modules/core/migrate/src/Commands/FarmMigrateCommands.php

@@ -8,6 +8,10 @@ use Drupal\migrate_tools\Drush\MigrateToolsCommands;
  * Farm Migrate Drush commands.
  *
  * @ingroup farm
+ *
+ * @deprecated in farm:2.2.0 and is removed from farm:3.0.0. Migrate from farmOS
+ *   v1 to v2 before upgrading to farmOS v3.
+ * @see https://www.drupal.org/node/3382609
  */
 class FarmMigrateCommands extends MigrateToolsCommands {
 

modules/core/migrate/src/EventSubscriber/FarmMigrationSubscriber.php

@@ -17,6 +17,10 @@ use Symfony\Component\EventDispatcher\EventSubscriberInterface;
 
 /**
  * Farm migration event subscriber.
+ *
+ * @deprecated in farm:2.2.0 and is removed from farm:3.0.0. Migrate from farmOS
+ *   v1 to v2 before upgrading to farmOS v3.
+ * @see https://www.drupal.org/node/3382609
  */
 class FarmMigrationSubscriber implements EventSubscriberInterface {
 

modules/core/migrate/src/Plugin/migrate/process/FarmMigrateGetLab.php

@@ -12,6 +12,10 @@ use Drupal\migrate\Row;
  * @MigrateProcessPlugin(
  *   id = "get_lab"
  * )
+ *
+ * @deprecated in farm:2.2.0 and is removed from farm:3.0.0. Migrate from farmOS
+ *   v1 to v2 before upgrading to farmOS v3.
+ * @see https://www.drupal.org/node/3382609
  */
 class FarmMigrateGetLab extends ProcessPluginBase {
 

modules/core/migrate/src/Plugin/migrate/process/FarmMigrationGroupLookup.php

@@ -34,6 +34,10 @@ use Symfony\Component\DependencyInjection\ContainerInterface;
  *
  * @todo Remove if migrate_plus incorporates this plugin upstream.
  * See: https://gitlab.com/drupalspoons/migrate_plus/-/issues/240
+ *
+ * @deprecated in farm:2.2.0 and is removed from farm:3.0.0. Migrate from farmOS
+ *   v1 to v2 before upgrading to farmOS v3.
+ * @see https://www.drupal.org/node/3382609
  */
 class FarmMigrationGroupLookup extends MigrationLookup {
 

modules/core/migrate/src/Plugin/migrate/process/SkipMapOnEmpty.php

@@ -19,6 +19,10 @@ use Drupal\migrate\Row;
  * @MigrateProcessPlugin(
  *   id = "skip_map_on_empty"
  * )
+ *
+ * @deprecated in farm:2.2.0 and is removed from farm:3.0.0. Migrate from farmOS
+ *   v1 to v2 before upgrading to farmOS v3.
+ * @see https://www.drupal.org/node/3382609
  */
 class SkipMapOnEmpty extends SkipOnEmpty {
 

modules/core/migrate/src/Plugin/migrate/source/d7/AnimalAsset.php

@@ -11,6 +11,12 @@ use Drupal\migrate\Row;
  *   id = "d7_animal_asset",
  *   source_module = "farm_asset"
  * )
+ *
+ * @deprecated in farm:2.2.0 and is removed from farm:3.0.0. Migrate from farmOS
+ *   v1 to v2 before upgrading to farmOS v3.
+ * @see https://www.drupal.org/node/3382609
+ *
+ * @phpstan-ignore-next-line
  */
 class AnimalAsset extends FarmAsset {
 

modules/core/migrate/src/Plugin/migrate/source/d7/FarmArea.php

@@ -11,6 +11,10 @@ use Drupal\taxonomy\Plugin\migrate\source\d7\Term;
  *   id = "d7_farm_area",
  *   source_module = "taxonomy"
  * )
+ *
+ * @deprecated in farm:2.2.0 and is removed from farm:3.0.0. Migrate from farmOS
+ *   v1 to v2 before upgrading to farmOS v3.
+ * @see https://www.drupal.org/node/3382609
  */
 class FarmArea extends Term {
 

modules/core/migrate/src/Plugin/migrate/source/d7/FarmAsset.php

@@ -16,6 +16,10 @@ use Drupal\migrate\Row;
  *   id = "d7_farm_asset",
  *   source_module = "farm_asset"
  * )
+ *
+ * @deprecated in farm:2.2.0 and is removed from farm:3.0.0. Migrate from farmOS
+ *   v1 to v2 before upgrading to farmOS v3.
+ * @see https://www.drupal.org/node/3382609
  */
 class FarmAsset extends Asset {
 

modules/core/migrate/src/Plugin/migrate/source/d7/FarmLog.php

@@ -19,6 +19,10 @@ use Drupal\migrate\Row;
  *   id = "d7_farm_log",
  *   source_module = "log"
  * )
+ *
+ * @deprecated in farm:2.2.0 and is removed from farm:3.0.0. Migrate from farmOS
+ *   v1 to v2 before upgrading to farmOS v3.
+ * @see https://www.drupal.org/node/3382609
  */
 class FarmLog extends Log {
 

modules/core/migrate/src/Plugin/migrate/source/d7/Inventory.php

@@ -11,6 +11,10 @@ use Drupal\migrate_drupal\Plugin\migrate\source\d7\FieldableEntity;
  *   id = "d7_farm_inventory",
  *   source_module = "farm_inventory"
  * )
+ *
+ * @deprecated in farm:2.2.0 and is removed from farm:3.0.0. Migrate from farmOS
+ *   v1 to v2 before upgrading to farmOS v3.
+ * @see https://www.drupal.org/node/3382609
  */
 class Inventory extends FieldableEntity {
 

modules/core/migrate/src/Plugin/migrate/source/d7/Quantity.php

@@ -11,6 +11,10 @@ use Drupal\migrate_drupal\Plugin\migrate\source\d7\FieldableEntity;
  *   id = "d7_farm_quantity",
  *   source_module = "farm_quantity"
  * )
+ *
+ * @deprecated in farm:2.2.0 and is removed from farm:3.0.0. Migrate from farmOS
+ *   v1 to v2 before upgrading to farmOS v3.
+ * @see https://www.drupal.org/node/3382609
  */
 class Quantity extends FieldableEntity {
 

modules/core/migrate/src/Plugin/migrate/source/d7/SensorAsset.php

@@ -14,6 +14,12 @@ use Drupal\migrate\Row;
  *   id = "d7_sensor_asset",
  *   source_module = "farm_sensor"
  * )
+ *
+ * @deprecated in farm:2.2.0 and is removed from farm:3.0.0. Migrate from farmOS
+ *   v1 to v2 before upgrading to farmOS v3.
+ * @see https://www.drupal.org/node/3382609
+ *
+ * @phpstan-ignore-next-line
  */
 class SensorAsset extends FarmAsset {
 

modules/core/migrate/src/Plugin/migrate/source/d7/SensorListenerDataNames.php

@@ -11,6 +11,10 @@ use Drupal\migrate\Plugin\migrate\source\SqlBase;
  *   id = "d7_sensor_listener_data_names",
  *   source_module = "farm_sensor_listener"
  * )
+ *
+ * @deprecated in farm:2.2.0 and is removed from farm:3.0.0. Migrate from farmOS
+ *   v1 to v2 before upgrading to farmOS v3.
+ * @see https://www.drupal.org/node/3382609
  */
 class SensorListenerDataNames extends SqlBase {
 

modules/core/migrate/src/Traits/FarmQuickEntity.php

@@ -6,6 +6,10 @@ use Drupal\migrate\Row;
 
 /**
  * Asset source from database.
+ *
+ * @deprecated in farm:2.2.0 and is removed from farm:3.0.0. Migrate from farmOS
+ *   v1 to v2 before upgrading to farmOS v3.
+ * @see https://www.drupal.org/node/3382609
  */
 trait FarmQuickEntity {