Skip to content

Commit fc4a498

Browse files
jtroejtroe
authored
Merge pull request #2387 from Esri/jy-dep-notices-242
update deprecations and removals for 2.4.2
2 parents 39a8708 + 7a42f14 commit fc4a498

File tree

1 file changed

+69
-55
lines changed

1 file changed

+69
-55
lines changed

‎guide/02-api-overview/deprecation-notices.ipynb‎

Lines changed: 69 additions & 55 deletions
Original file line numberDiff line numberDiff line change
@@ -13,17 +13,25 @@
1313
"\n",
1414
"These classes, functions, and modules in the ArcGIS API for Python are deprecated and may cause compatibility issues in future versions:\n",
1515
"\n",
16+
"### `arcgis.gis` Module\n",
17+
"\n",
18+
"- `ContentManager.add` - deprecated in **2.3.0** will be removed in a future major release (example: 2.x to 3.x). Use `Folder.add` instead.\n",
19+
"- `ContentManager.create_folder` - deprecated in **2.3.0** will be removed in a future major release (example: 2.x to 3.x). Use `gis.content.folders.create` instead.\n",
20+
"- `ContentManager.delete_folder` - deprecated in **2.3.0** will be removed in a future major release (example: 2.x to 3.x). Use `Folder.delete()` instead.\n",
21+
"- `ContentManager.rename_folder` - deprecated in **2.3.0** will be removed in a future major release (example: 2.x to 3.x). Use `Folder.rename()` instead.\n",
22+
"- `ContentManager.dependency_manager` - deprecated in **2.4.0** will be removed in a future release.\n",
23+
"- `Item.share` - deprecated in **2.3.0** will be removed in a future major release (example: 2.x to 3.x). Use `Item.sharing` instead.\n",
24+
"- `Item.shared_with` - deprecated in **2.3.0** will be removed in a future major release (example: 2.x to 3.x). Use `Item.sharing` instead.\n",
25+
"- `Item.unshare` - deprecated in **2.3.0** will be removed in a future major release (example: 2.x to 3.x). Use `Item.sharing` instead.\n",
26+
"- `arcgis.gis.UserManager.create` - the `level` parameter is deprecated at **2.4.0** and will be removed from the method signature in a future release.\n",
27+
"- `UserManager.create` - the `level` parameter is depreacted at **2.4.0** and will be removed from the method signature in a future release. \n",
28+
"\n",
1629
"### `arcgis.apps` Module \n",
1730
"\n",
18-
"- `arcgis.apps.dashboard` - entire module deprecated at version **2.1.0**. This sub-module may be removed at a future major release\n",
19-
"- `WebExperience.clone` - deprecated in **2.3.0** will be removed in **2.4.2**. Pass in the Web Experience item to `gis.content.clone_items()` instead.\n",
31+
"- `arcgis.apps.dashboard` - entire module deprecated at version **2.1.0**. This sub-module will be removed at **2.4.3**.\n",
2032
"- `StoryMap.get` - deprecated in **2.2.0** will be removed in **2.4.2**. `get` method has been deprecated, use `content_list` property instead.\n",
2133
"- `StoryMap.nodes` - deprecated in **2.2.0** removed in **2.4.0**. The `nodes` property has been deprecated, use `content_list` property instead.\n",
2234
"- `StoryMap.cover_date` - deprecated in **2.4.0** removed in future major release. Use the `date` property in the Cover class.\n",
23-
"- `StoryMap.cover` - deprecated in **2.4.0** removed in future major release. Use the Cover class.\n",
24-
"- `StoryMap.navigation` - deprecated in **2.4.0** removed in future major release. Use the Navigation class.\n",
25-
"- `Briefing.cover` - deprecated in **2.4.0** removed in future major release. Use the Cover class.\n",
26-
"- `Collection.cover` - deprecated in **2.4.0** removed in future major release. Use the Cover class.\n",
2735
"- `Swipe.properties` - deprecated in **2.4.0** removed in future major release. Use the `content` property instead.\n",
2836
"- `Swipe.edit` - deprecated in **2.4.0** removed in future major release. Use the `content` property setter instead.\n",
2937
"- `MapAction` - deprecated in **2.4.0** removed in future major release. Use the `MediaAction` class instead.\n",
@@ -35,34 +43,48 @@
3543
"- `UtilityNetworkManager.trace` - deprecated the \"result_type\" parameter at **2.4.1**. Please use \"result_types\" instead.\n",
3644
"\n",
3745
"### `arcgis.learn` Module\n",
38-
"\n",
3946
"- `categorize_features` - deprecated in **1.7.1** and will be removed in a future major release (For example: 2.x to 3.x). Please use `arcgis.learn.classify_objects` instead.\n",
40-
"- `tensorflow` - deprecated in **2.4.1** and will be removed from a future release of the *arcgis* package\n",
41-
"\n",
42-
"### `arcgis.gis.agonb` Module \n",
4347
"\n",
48+
"### `arcgis.gis.nb` Module \n",
4449
"- `Container.terminate` - deprecated in **2.3.0** will be removed in **2.4.0**. Use `Container.shutdown` instead.\n",
50+
"- `NotebookDataAccess.create_folder` - deprecated in **2.4.2**. Removed in future release. Use `NotebookFolder.create_folder()` instead.\n",
51+
"- `NotebookDataAccess.files` - deprecated in **2.4.2**. Removed in future release. Use `NotebookFolder.files` instead.\n",
52+
"- `NotebookDataAccess.upload` - deprecated in **2.4.2**. Removed in future release. Use `NotebookFile.upload()` instead.\n",
53+
"- `NotebookFile.erase` - deprecated in **2.4.2**. Removed in future release. Use `NotebookFile.delete()` instead.\n",
4554
"\n",
46-
"### `arcgis.gis.nb` Module \n",
55+
"### `arcgis.layers` Module\n",
56+
"- `BasemapServices` - deprecated in **2.4.2**, removed in future release. Use `arcgis.map.BasemapStylesService` instead\n",
57+
"- `BasemapService` - deprecated in **2.4.2**, removed in future release. Use `arcgis.map.BasemapStyle` instead.\n",
4758
"\n",
48-
"- `Container.terminate` - deprecated in **2.3.0** will be removed in **2.4.0**. Use `Container.shutdown` instead.\n",
59+
"## Deprecation Removals\n",
4960
"\n",
50-
"### `arcgis.gis` Module\n",
61+
"Several classes, functions, and methods have been completely removed from the ArcGIS API for Python. This means your code relying on them will no longer function properly. For a smooth transition, consult the API documentation to find alternative approaches and update your code accordingly.\n",
5162
"\n",
52-
"- `ContentManager.add` - deprecated in **2.3.0** will be removed in a future major release (example: 2.x to 3.x). Use `Folder.add` instead.\n",
53-
"- `ContentManager.create_folder` - deprecated in **2.3.0** will be removed in a future major release (example: 2.x to 3.x). Use `gis.content.folders.create` instead.\n",
54-
"- `ContentManager.delete_folder` - deprecated in **2.3.0** will be removed in a future major release (example: 2.x to 3.x). Use `Folder.delete()` instead.\n",
55-
"- `ContentManager.rename_folder` - deprecated in **2.3.0** will be removed in a future major release (example: 2.x to 3.x). Use `Folder.rename()` instead.\n",
56-
"- `ContentManager.dependency_manager` - deprecated in **2.4.0** will be removed in a future release.\n",
57-
"- `Item.share` - deprecated in **2.3.0** will be removed in a future major release (example: 2.x to 3.x). Use `Item.sharing` instead.\n",
58-
"- `Item.shared_with` - deprecated in **2.3.0** will be removed in a future major release (example: 2.x to 3.x). Use `Item.sharing` instead.\n",
59-
"- `Item.unshare` - deprecated in **2.3.0** will be removed in a future major release (example: 2.x to 3.x). Use `Item.sharing` instead.\n",
60-
"- `arcgis.gis.UserManager.create` - the `level` parameter is deprecated at **2.4.0** and will be removed from the method signature in a future release.\n",
61-
"- `overwrite` item_property on `Folder.add` is deprecated and will be removed at **2.4.2**. Use `item.update` to update the source file for an `Item` instead.\n",
63+
"### `arcgis.geoanalytics` Module \n",
64+
"\n",
65+
"**The entire geoanalytics module has been deprecated on ArcGIS Enterprise and removed at ArcGIS Enterprise 11.4. If you need the geoanalytics modules, please use version 2.3.x or prior.**\n",
66+
"\n",
67+
"See [ArcGIS GeoAnalytics for Server Deprecation Notice](https://www.esri.com/arcgis-blog/products/geoanalytics-server/announcements/deprecation-notice-for-arcgis-geoanalytics-server/) for further details. Support for the arcgis.geoanalytics module will continue to be provided through the built-in Python API included with ArcGIS Enterprise 11.3 and earlier installations.\n",
6268
" \n",
69+
"- `analyze_patterns` module removed in **2.4.0**. All functions within this module have been removed. Use version 2.3.x if this functionality is still needed.\n",
70+
"- `data_enrichment` module removed in **2.4.0**. All functions within this module have been removed. Use version 2.3.x if this functionality is still needed.\n",
71+
"- `find_locations` module removed in **2.4.0**. All functions within this module have been removed. Use version 2.3.x if this functionality is still needed.\n",
72+
"- `manage_data` module removed in **2.4.0**. All functions within this module have been removed. Use version 2.3.x if this functionality is still needed.\n",
73+
"- `summarize_data` module removed in **2.4.0**. All functions within this module have been removed. Use version 2.3.x if this functionality is still needed.\n",
74+
"- `use_proximity` module removed in **2.4.0**. All functions within this module have been removed. Use version 2.3.x if this functionality is still needed.\n",
75+
"- `arcgis.geoanalytics.get_datastores` was removed in **2.4.0**. Use version 2.3.x if this functionality is still needed.\n",
76+
"- `arcgis.geoanalytics.define_output_datastore` was removed in **2.4.0**. Use version 2.3.x if this functionality is still needed.\n",
77+
"- `arcgis.geoanalytics.is_supported` was removed in **2.4.0**. Use version 2.3.x if this functionality is still needed.\n",
78+
"\n",
6379
"\n",
6480
"### `arcgis.mapping` Module\n",
81+
"The entire module was deprecated in **2.4.0** and has been removed in **2.4.2**. Install the `arcgis-mapping` package and use the `arcgis.map` module instead.\n",
6582
"\n",
83+
"- `WebMap` - removed in **2.4.0**. Use `arcgis.map.Map` instead.\n",
84+
"- `WebScene` - removed in **2.4.0**. Use `arcgis.map.Scene` instead.\n",
85+
"- `forms` - removed in **2.4.0**. Use dataclasses found in `arcgis.map.forms` module instead.\n",
86+
"- `renderer` - removed in **2.4.0**. Use dataclasses found in `arcgis.map.renderers` and methods in `arcgis.map.SmartMappingManager`.\n",
87+
"- `OfflineMapAreaManager` - removed in **2.4.0**. Use the `arcgis.map.OfflineMapAreaManager`.\n",
6688
"- `MapImageLayer` - deprecated in **2.4.0** removed in **2.4.2**. Use the `arcgis.layers.MapImageLayer` class instead.\n",
6789
"- `MapImageLayerManager` - deprecated in **2.4.0** removed in **2.4.2**. Use the `arcgis.layers.MapImageLayerManager` class instead.\n",
6890
"- `EnterpriseMapImageLayerManager` - deprecated in **2.4.0** removed in **2.4.2**. Use the `arcgis.layers.EnterpriseMapImageLayerManager` class instead.\n",
@@ -91,43 +113,13 @@
91113
"- `OGCCollection` - deprecated in **2.4.0** removed in **2.4.2**. Use the `arcgis.layers.OGCCollection` class instead.\n",
92114
"- `OGCFeatureService` - deprecated in **2.4.0** removed in **2.4.2**. Use the `arcgis.layers.OGCFeatureService` class instead.\n",
93115
"\n",
94-
"## Deprecation Removals\n",
95-
"\n",
96-
"Several classes, functions, and methods have been completely removed from the ArcGIS API for Python. This means your code relying on them will no longer function properly. For a smooth transition, consult the API documentation to find alternative approaches and update your code accordingly.\n",
97-
"\n",
98-
"### `arcgis.geoanalytics` Module \n",
99-
"\n",
100-
"**The entire geoanalytics module has been deprecated on ArcGIS Enterprise and removed at ArcGIS Enterprise 11.4. If you need the geoanalytics modules, please use version 2.3.x or prior.**\n",
101-
"\n",
102-
"See [ArcGIS GeoAnalytics for Server Deprecation Notice](https://www.esri.com/arcgis-blog/products/geoanalytics-server/announcements/deprecation-notice-for-arcgis-geoanalytics-server/) for further details. Support for the arcgis.geoanalytics module will continue to be provided through the built-in Python API included with ArcGIS Enterprise 11.3 and earlier installations.\n",
103-
" \n",
104-
"- `analyze_patterns` module removed in **2.4.0**. All functions within this module have been removed. Use version 2.3.x if this functionality is still needed.\n",
105-
"- `data_enrichment` module removed in **2.4.0**. All functions within this module have been removed. Use version 2.3.x if this functionality is still needed.\n",
106-
"- `find_locations` module removed in **2.4.0**. All functions within this module have been removed. Use version 2.3.x if this functionality is still needed.\n",
107-
"- `manage_data` module removed in **2.4.0**. All functions within this module have been removed. Use version 2.3.x if this functionality is still needed.\n",
108-
"- `summarize_data` module removed in **2.4.0**. All functions within this module have been removed. Use version 2.3.x if this functionality is still needed.\n",
109-
"- `use_proximity` module removed in **2.4.0**. All functions within this module have been removed. Use version 2.3.x if this functionality is still needed.\n",
110-
"- `arcgis.geoanalytics.get_datastores` was removed in **2.4.0**. Use version 2.3.x if this functionality is still needed.\n",
111-
"- `arcgis.geoanalytics.define_output_datastore` was removed in **2.4.0**. Use version 2.3.x if this functionality is still needed.\n",
112-
"- `arcgis.geoanalytics.is_supported` was removed in **2.4.0**. Use version 2.3.x if this functionality is still needed.\n",
113-
"\n",
114-
"\n",
115-
"### `arcgis.mapping` Module\n",
116-
"- `WebMap` - removed in **2.4.0**. Use `arcgis.map.Map` instead.\n",
117-
"- `WebScene` - removed in **2.4.0**. Use `arcgis.map.Scene` instead.\n",
118-
"- `forms` - removed in **2.4.0**. Use dataclasses found in `arcgis.map.forms` module instead.\n",
119-
"- `renderer` - removed in **2.4.0**. Use dataclasses found in `arcgis.map.renderers` and methods in `arcgis.map.SmartMappingManager`.\n",
120-
"- `OfflineMapAreaManager` - removed in **2.4.0**. Use the `arcgis.map.OfflineMapAreaManager`.\n",
121-
"\n",
122-
"\n",
123116
"### `arcgis.geocoding` Module\n",
124117
"- `suggest` - The **distance** parameter is deprecated and removed at **2.4.0**. The parameter is no longer supported. Please use the `search_extent` parameter instead to control the search area.\n",
125118
"\n",
126119
"### `arcgis.widgets` Module\n",
127120
"- `MapView` - removed in **2.4.0**. Use either `arcgis.map.Map` or `arcgis.map.Scene` instead.\n",
128121
"\n",
129122
"### `arcgis.gis.server` Module\n",
130-
"\n",
131123
"- `Mode.update` - deprecated in **1.7.1** removed in **2.4.0**. Use `Mode.update_mode` instead.\n",
132124
"\n",
133125
"### `arcgis.gis.admin` Module\n",
@@ -140,9 +132,11 @@
140132
"- `UX.default_basemap` - deprecated in **2.1.0** removed in **2.4.0**. This applies to the getter and setter of the property. \n",
141133
"- `UX.vector_basemap` - deprecated in **2.1.0** removed in **2.4.0**. This applies to the getter and setter of the property. \n",
142134
"\n",
135+
"### `arcgis.gis.agonb` Module \n",
136+
"- `Container.terminate` - deprecated in **2.3.0**. Removed in **2.4.0**. Use `Container.shutdown` instead.\n",
137+
"\n",
143138
"### `arcgis.raster` Module\n",
144139
"\n",
145-
"- `calculate_distance` - deprecated in **1.8.1** removed in **2.4.0**. Please use arcgis.raster.functions.gbl.distance_accumulation (or arcgis.raster.functions.gbl.distance_allocation for allocation output) instead.\n",
146140
"- `calculate_travel_cost` - deprecated in **1.8.1** removed in **2.4.0**. Please use arcgis.raster.functions.gbl.distance_accumulation (or arcgis.raster.functions.gbl.distance_allocation for allocation output), instead.\n",
147141
"- `cost_allocation` - deprecated in **1.8.1** removed in **2.4.0**. Please use arcgis.raster.functions.gbl.distance_accumulation instead.\n",
148142
"- `cost_backlink` - deprecated in **1.8.1** removed in **2.4.0**. Please use arcgis.raster.functions.gbl.distance_accumulation with value specified for output_back_direction_raster_name, instead.\n",
@@ -172,7 +166,27 @@
172166
"\n",
173167
"### `arcgis.gis` Module\n",
174168
"\n",
175-
"- `Group.invite_by_email` - deprecated in **1.5.1** removed in **2.4.0**. Use `Group.invite` instead."
169+
"- `Group.invite_by_email` - deprecated in **1.5.1** removed in **2.4.0**. Use `Group.invite` instead.\n",
170+
"- `Folder.add()` - `overwrite` item_property is removed at **2.4.2**. Use `item.update` to update the source file for an `Item` instead.\n",
171+
"- `ContentManager.dependency_manager` - removed in **2.4.2**.\n",
172+
"- `arcgis.gis.sharing` Submodule\n",
173+
" - `DependencyManager` removed in **2.4.2**. \n",
174+
"\n",
175+
"### `arcgis.apps` Module\n",
176+
"- `arcgis.apps.storymap` Submodule\n",
177+
" - `StoryMap.get()` removed at **2.4.2.**\n",
178+
" - `StoryMap.cover` - deprecated in **2.4.0** removed in **2.4.2**. Use the Cover class.\n",
179+
" - `StoryMap.navigation` - deprecated in **2.4.0** removed in **2.4.2**. Use the Navigation class.\n",
180+
" - `Briefing.cover` - deprecated in **2.4.0** removed in **2.4.2**. Use the Cover class.\n",
181+
" - `Collection.cover` - deprecated in **2.4.0** removed in **2.4.2**. Use the Cover class.\n",
182+
"- `arcgis.apps.expbuilder` Submodule\n",
183+
" - - `WebExperience.clone` - Removed in **2.4.2**. Pass in the Web Experience item to `gis.content.clone_items()` instead. \n",
184+
"\n",
185+
"### `arcgis.learn` Module\n",
186+
"- `TensorFlow` - removed as dependency in **2.4.2**.\n",
187+
"\n",
188+
"## Dependencies\n",
189+
"- `fiona` removed as a dependency in **2.4.2**."
176190
]
177191
}
178192
],

0 commit comments

Comments
 (0)