Skip to content

Commit 4d498fd

Browse files
committed
update deprecations and removals for 2.4.2
1 parent 524aeaa commit 4d498fd

File tree

1 file changed

+70
-55
lines changed

1 file changed

+70
-55
lines changed

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

Lines changed: 70 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,33 +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",
4047
"\n",
41-
"### `arcgis.gis.agonb` Module \n",
42-
"\n",
48+
"### `arcgis.gis.nb` Module \n",
4349
"- `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",
4454
"\n",
45-
"### `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",
4658
"\n",
47-
"- `Container.terminate` - deprecated in **2.3.0** will be removed in **2.4.0**. Use `Container.shutdown` instead.\n",
59+
"## Deprecation Removals\n",
4860
"\n",
49-
"### `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",
5062
"\n",
51-
"- `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",
52-
"- `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",
53-
"- `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",
54-
"- `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",
55-
"- `ContentManager.dependency_manager` - deprecated in **2.4.0** will be removed in a future release.\n",
56-
"- `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",
57-
"- `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",
58-
"- `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",
59-
"- `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",
60-
"- `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",
6168
" \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",
6279
"\n",
6380
"### `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",
6482
"\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",
6588
"- `MapImageLayer` - deprecated in **2.4.0** removed in **2.4.2**. Use the `arcgis.layers.MapImageLayer` class instead.\n",
6689
"- `MapImageLayerManager` - deprecated in **2.4.0** removed in **2.4.2**. Use the `arcgis.layers.MapImageLayerManager` class instead.\n",
6790
"- `EnterpriseMapImageLayerManager` - deprecated in **2.4.0** removed in **2.4.2**. Use the `arcgis.layers.EnterpriseMapImageLayerManager` class instead.\n",
@@ -90,43 +113,13 @@
90113
"- `OGCCollection` - deprecated in **2.4.0** removed in **2.4.2**. Use the `arcgis.layers.OGCCollection` class instead.\n",
91114
"- `OGCFeatureService` - deprecated in **2.4.0** removed in **2.4.2**. Use the `arcgis.layers.OGCFeatureService` class instead.\n",
92115
"\n",
93-
"## Deprecation Removals\n",
94-
"\n",
95-
"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",
96-
"\n",
97-
"### `arcgis.geoanalytics` Module \n",
98-
"\n",
99-
"**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",
100-
"\n",
101-
"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",
102-
" \n",
103-
"- `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",
104-
"- `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",
105-
"- `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",
106-
"- `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",
107-
"- `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",
108-
"- `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",
109-
"- `arcgis.geoanalytics.get_datastores` was removed in **2.4.0**. Use version 2.3.x if this functionality is still needed.\n",
110-
"- `arcgis.geoanalytics.define_output_datastore` was removed in **2.4.0**. Use version 2.3.x if this functionality is still needed.\n",
111-
"- `arcgis.geoanalytics.is_supported` was removed in **2.4.0**. Use version 2.3.x if this functionality is still needed.\n",
112-
"\n",
113-
"\n",
114-
"### `arcgis.mapping` Module\n",
115-
"- `WebMap` - removed in **2.4.0**. Use `arcgis.map.Map` instead.\n",
116-
"- `WebScene` - removed in **2.4.0**. Use `arcgis.map.Scene` instead.\n",
117-
"- `forms` - removed in **2.4.0**. Use dataclasses found in `arcgis.map.forms` module instead.\n",
118-
"- `renderer` - removed in **2.4.0**. Use dataclasses found in `arcgis.map.renderers` and methods in `arcgis.map.SmartMappingManager`.\n",
119-
"- `OfflineMapAreaManager` - removed in **2.4.0**. Use the `arcgis.map.OfflineMapAreaManager`.\n",
120-
"\n",
121-
"\n",
122116
"### `arcgis.geocoding` Module\n",
123117
"- `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",
124118
"\n",
125119
"### `arcgis.widgets` Module\n",
126120
"- `MapView` - removed in **2.4.0**. Use either `arcgis.map.Map` or `arcgis.map.Scene` instead.\n",
127121
"\n",
128122
"### `arcgis.gis.server` Module\n",
129-
"\n",
130123
"- `Mode.update` - deprecated in **1.7.1** removed in **2.4.0**. Use `Mode.update_mode` instead.\n",
131124
"\n",
132125
"### `arcgis.gis.admin` Module\n",
@@ -139,9 +132,11 @@
139132
"- `UX.default_basemap` - deprecated in **2.1.0** removed in **2.4.0**. This applies to the getter and setter of the property. \n",
140133
"- `UX.vector_basemap` - deprecated in **2.1.0** removed in **2.4.0**. This applies to the getter and setter of the property. \n",
141134
"\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",
142138
"### `arcgis.raster` Module\n",
143139
"\n",
144-
"- `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",
145140
"- `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",
146141
"- `cost_allocation` - deprecated in **1.8.1** removed in **2.4.0**. Please use arcgis.raster.functions.gbl.distance_accumulation instead.\n",
147142
"- `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",
@@ -171,7 +166,27 @@
171166
"\n",
172167
"### `arcgis.gis` Module\n",
173168
"\n",
174-
"- `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**."
175190
]
176191
}
177192
],
@@ -191,7 +206,7 @@
191206
"name": "python",
192207
"nbconvert_exporter": "python",
193208
"pygments_lexer": "ipython3",
194-
"version": "3.11.11"
209+
"version": "3.13.2"
195210
}
196211
},
197212
"nbformat": 4,

0 commit comments

Comments
 (0)