Issue #3382598: Deprecate farmOS v1 migrations

2023-08-22 10:39:39 -04:00 · 2023-08-22 10:39:39 -04:00 · f6d195d9c8
parent b3c4d0e550
commit f6d195d9c8
15 changed files with 61 additions and 0 deletions
--- a/CHANGELOG.md
+++ b/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

--- a/modules/core/migrate/src/Commands/FarmMigrateCommands.php
+++ b/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 {

--- a/modules/core/migrate/src/EventSubscriber/FarmMigrationSubscriber.php
+++ b/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 {

--- a/modules/core/migrate/src/Plugin/migrate/process/FarmMigrateGetLab.php
+++ b/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 {

--- a/modules/core/migrate/src/Plugin/migrate/process/FarmMigrationGroupLookup.php
+++ b/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 {

--- a/modules/core/migrate/src/Plugin/migrate/process/SkipMapOnEmpty.php
+++ b/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 {

--- a/modules/core/migrate/src/Plugin/migrate/source/d7/AnimalAsset.php
+++ b/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 {

--- a/modules/core/migrate/src/Plugin/migrate/source/d7/FarmArea.php
+++ b/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 {

--- a/modules/core/migrate/src/Plugin/migrate/source/d7/FarmAsset.php
+++ b/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 {

--- a/modules/core/migrate/src/Plugin/migrate/source/d7/FarmLog.php
+++ b/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 {

--- a/modules/core/migrate/src/Plugin/migrate/source/d7/Inventory.php
+++ b/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 {

--- a/modules/core/migrate/src/Plugin/migrate/source/d7/Quantity.php
+++ b/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 {

--- a/modules/core/migrate/src/Plugin/migrate/source/d7/SensorAsset.php
+++ b/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 {

--- a/modules/core/migrate/src/Plugin/migrate/source/d7/SensorListenerDataNames.php
+++ b/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 {

--- a/modules/core/migrate/src/Traits/FarmQuickEntity.php
+++ b/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 {