Merge pull request #2020 from Esri/jy-rvw-gis-guides1

Remove output warnings and update group sharing

Author: jyaistMap

guide/03-the-gis/accessing-and-creating-content.ipynb

@@ -28,7 +28,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 2,
    "metadata": {},
    "outputs": [],
    "source": [
@@ -51,9 +51,9 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "As mentioned in the [`gis module`](https://developers.arcgis.com/python/guide/the-gis-module/) guide, the Python API uses [Resource Manager classes](https://developers.arcgis.com/python/guide/the-gis-module/) to manage Web GIS users, groups, datastores, and content. You access the [`UserManager`](https://developers.arcgis.com/python/api-reference/arcgis.gis.toc.html#arcgis.gis.UserManager), [`GroupManager`](https://developers.arcgis.com/python/api-reference/arcgis.gis.toc.html#groupmanager) and [`ContentManager`](https://developers.arcgis.com/python/api-reference/arcgis.gis.toc.html#arcgis.gis.ContentManager) classes as the `users`, `groups`, and `content` properties of the [`GIS`](https://developers.arcgis.com/python/api-reference/arcgis.gis.toc.html#gis), respectively. (See [`Helper objects`](https://developers.arcgis.com/python/api-reference/arcgis.gis.toc.html#gis) for details.)\n",
+    "As mentioned in the [`gis module`](/python/guide/the-gis-module/) guide, the Python API uses [Resource Manager classes](/python/guide/the-gis-module/) to manage Web GIS users, groups, datastores, and content. You access the [`UserManager`](/python/api-reference/arcgis.gis.toc.html#arcgis.gis.UserManager), [`GroupManager`](/python/api-reference/arcgis.gis.toc.html#groupmanager) and [`ContentManager`](/python/api-reference/arcgis.gis.toc.html#arcgis.gis.ContentManager) classes as the `users`, `groups`, and `content` properties of the [`GIS`](/python/api-reference/arcgis.gis.toc.html#gis), respectively.\n",
     "\n",
-    "Each resource manager implements the [ArcGIS REST API](https://developers.arcgis.com/rest/users-groups-and-items/search.htm) `search` operation as a method. For example, `gis.content.search()`. It's important to understand that the `search` mechanism uses many different inputs to find possible matches, ranks them and returns appropriate results. The `search` becomes ideal for human interaction, but `fuzzy` when looking for specific records programmatically. The search results are non-deterministic. Using `search` may not necessarily be the best approach for finding specific items, but more a group of items from which to further filter. \n",
+    "Each searchj resource manager, for example _gis.content.search(), implements the [ArcGIS REST API](/rest/users-groups-and-items/search.htm) `search` operation. It's important to understand that the `search` mechanism uses many different inputs to find possible matches, ranks them and returns appropriate results. The `search` becomes ideal for human interaction, but `fuzzy` when looking for specific records programmatically. The search results are non-deterministic. Using `search` may not necessarily be the best approach for finding specific items, but more a group of items from which to further filter. \n",
     "\n",
     "It's also important to know that using `search` programmatically, like with the Python API, does not correspond identically to searching with an application written in a different language.  The various `search` options in the ArcGIS Online or Portal for ArcGIS Enterprise interfaces work differently than the Python API resource managers' `search`. Different applications may use different inputs. The relationship between a content `search` in one application, like a Portal or ArcGIS Online viewer, is not one-to-one with a content search using the Python API even when logged in as the same user.\n",
     "\n",
@@ -62,7 +62,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 2,
+   "execution_count": 3,
    "metadata": {},
    "outputs": [],
    "source": [
@@ -190,12 +190,12 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 4,
+   "execution_count": 37,
    "metadata": {},
    "outputs": [],
    "source": [
-    "day_start = dt.datetime(2019, 5, 30, 0, 0, 0, 0)\n",
-    "day_end = dt.datetime(2019, 5, 30, 23, 59, 59, 999999)\n",
+    "day_start = dt.datetime(2023, 9, 21, 0, 0, 0, 0)\n",
+    "day_end = dt.datetime(2023, 9, 21, 23, 59, 59, 999999)\n",
     "\n",
     "start_timestamp = int(day_start.timestamp() * 1000)\n",
     "end_timestamp = int(day_end.timestamp() * 1000)"
@@ -210,16 +210,17 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 5,
+   "execution_count": 40,
    "metadata": {},
    "outputs": [],
    "source": [
-    "content_published_53019 = [item\n",
-    "                        for item in gis.content.search(query=\"* AND \\\n",
-    "                                                owner:\" + gis.users.me.username,\n",
-    "                                                max_items=50)\n",
-    "                        if item.created > start_timestamp \n",
-    "                        and item.created < end_timestamp]"
+    "content_published_92123 = [\n",
+    "    item\n",
+    "    for item in gis.content.search(\n",
+    "        query=f\"owner:{gis.users.me.username}\",\n",
+    "        max_items=100) \n",
+    "    if item.created > start_timestamp\n",
+    "    and item.created < end_timestamp]"
    ]
   },
   {
@@ -231,7 +232,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 6,
+   "execution_count": 41,
    "metadata": {},
    "outputs": [],
    "source": [
@@ -241,14 +242,16 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 7,
+   "execution_count": 45,
    "metadata": {},
    "outputs": [
     {
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "Item Title                              Item Type                Published                               \n"
+      "Item Title                              Item Type                Published                               \n",
+      "425e9ee3dd774bbe8d472b73e9cadbd2        File Geodatabase         September 21 2023 at 10:45.47 AM        \n",
+      "ad37530ecc3744e8b3a9db52adde6408        File Geodatabase         September 21 2023 at 10:43.44 AM        \n"
      ]
     }
    ],
@@ -258,8 +261,8 @@
     "publish = \"Published\"\n",
     "print(f\"{title:40}{item_type:25}{publish:40}\")\n",
     "\n",
-    "for content in content_published_53019:\n",
-    "    print(f\" {content.title:<40} {content.type:25} {readable_date(content.created):40}\")"
+    "for content in content_published_92123:\n",
+    "    print(f\"{content.title:<40}{content.type:25}{readable_date(content.created):40}\")"
    ]
   },
   {
@@ -1480,8 +1483,11 @@
     "thumbnail_path = os.path.join(data_path, \"earthquake.png\")\n",
     "\n",
     "root_folder = gis.content.folders.get()\n",
-    "earthquake_csv_item = root_folder.add(item_properties=csv_properties, data=csv_path,\n",
-    "                                     thumbnail = thumbnail_path).result()"
+    "earthquake_csv_item = root_folder.add(\n",
+    "    item_properties=csv_properties, \n",
+    "    data=csv_path,\n",
+    "    thumbnail = thumbnail_path\n",
+    ").result()"
    ]
   },
   {
@@ -1605,7 +1611,10 @@
   {
    "cell_type": "markdown",
    "metadata": {
-    "collapsed": true
+    "collapsed": true,
+    "jupyter": {
+     "outputs_hidden": true
+    }
    },
    "source": [
     "<a id=\"importing-data-from-a-pandas-data-frame\"></a>\n",
@@ -2454,14 +2463,6 @@
    "execution_count": 38,
    "metadata": {},
    "outputs": [
-    {
-     "name": "stderr",
-     "output_type": "stream",
-     "text": [
-      "C:\\Users\\tar12555\\AppData\\Local\\ESRI\\conda\\envs\\pyapi-dev\\lib\\site-packages\\IPython\\core\\interactiveshell.py:3553: DeprecatedWarning: create_folder is deprecated as of 2.3.0 and has be removed in 3.0.0. Use `gis.content.folders.create` instead.\n",
-      "  exec(code_obj, self.user_global_ns, self.user_ns)\n"
-     ]
-    },
     {
      "data": {
       "text/plain": [
@@ -2540,14 +2541,6 @@
    "execution_count": 41,
    "metadata": {},
    "outputs": [
-    {
-     "name": "stderr",
-     "output_type": "stream",
-     "text": [
-      "C:\\Users\\tar12555\\AppData\\Local\\ESRI\\conda\\envs\\pyapi-dev\\lib\\site-packages\\IPython\\core\\interactiveshell.py:3553: DeprecatedWarning: delete_folder is deprecated as of 2.3.0 and has be removed in 3.0.0. Use `Folder.delete()` instead.\n",
-      "  exec(code_obj, self.user_global_ns, self.user_ns)\n"
-     ]
-    },
     {
      "data": {
       "text/plain": [
@@ -2589,7 +2582,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.9.16"
+   "version": "3.11.0"
   },
   "toc": {
    "base_numbering": 1,
@@ -2635,5 +2628,5 @@
   }
  },
  "nbformat": 4,
- "nbformat_minor": 1
+ "nbformat_minor": 4
 }

guide/03-the-gis/accessing-and-managing-groups.ipynb

@@ -71,7 +71,10 @@
   {
    "cell_type": "markdown",
    "metadata": {
-    "collapsed": true
+    "collapsed": true,
+    "jupyter": {
+     "outputs_hidden": true
+    }
    },
    "source": [
     "The `search()` method returns a list of objects of type `arcgis.gis.Group`. When using the Jupyter notebook environment, `Group` objects can be represented in rich HTML with their thumbnail and metadata information."
@@ -433,7 +436,10 @@
     "                  'tags':['geocaching', 'searching', 'hikes', 'POI'],\n",
     "                  'snippet':'Points containing treasures for geocaching activity'}\n",
     "root_folder = gis.content.folders.get()\n",
-    "fc_item = root_folder.add(item_properties, data='../../samples/05_content_publishers/data/hidden_treasures_geocaching.csv').result()"
+    "fc_item = root_folder.add(\n",
+    "    item_properties, \n",
+    "    data='../../samples/05_content_publishers/data/hidden_treasures_geocaching.csv'\n",
+    ").result()"
    ]
   },
   {
@@ -471,7 +477,7 @@
     {
      "data": {
       "text/plain": [
-       "{'notSharedWith': [], 'itemId': '538a4c39061043828f5d7a4d2a09c30b'}"
+       "True"
       ]
      },
      "execution_count": 162,
@@ -481,7 +487,7 @@
    ],
    "source": [
     "# let us share it to the group so other enthusiasts can enjoy this map\n",
-    "fc_item.share(groups=[geocaching_group])"
+    "fc_item.sharing.groups.add(group=geocaching_group)"
    ]
   },
   {
@@ -941,7 +947,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.9.16"
+   "version": "3.11.0"
   },
   "toc": {
    "base_numbering": 1,
@@ -958,5 +964,5 @@
   }
  },
  "nbformat": 4,
- "nbformat_minor": 1
+ "nbformat_minor": 4
 }