From b728832ac51f5cbc93c6ca1417574ade00665d6d Mon Sep 17 00:00:00 2001
From: Pete Gadomski <pete.gadomski@gmail.com>
Date: Tue, 19 Sep 2023 13:38:48 -0600
Subject: [PATCH] Add simple example notebook (#87)

* docs: add simple example notebook

* Update docs/example.ipynb

Co-authored-by: Julia Signell <jsignell@gmail.com>

---------

Co-authored-by: Julia Signell <jsignell@gmail.com>
---
 README-template.md |    1 +
 docs/example.ipynb | 1627 ++++++++++++++++++++++++++++++++++++++++++++
 pyproject.toml     |    1 +
 3 files changed, 1629 insertions(+)
 create mode 100644 docs/example.ipynb

diff --git a/README-template.md b/README-template.md
index c3c1f31..13459f4 100644
--- a/README-template.md
+++ b/README-template.md
@@ -13,6 +13,7 @@
 - Extra fields:
   - `ephemeral:custom`: A custom attribute
 - [Browse the example in human-readable form](https://radiantearth.github.io/stac-browser/#/external/raw.githubusercontent.com/stactools-packages/ephemeral/main/examples/collection.json)
+- [Browse a notebook demonstrating the example item and collection](https://github.com/stactools-packages/ephemeral/tree/main/docs/example.ipynb)
 
 A short description of the package and its usage.
 
diff --git a/docs/example.ipynb b/docs/example.ipynb
new file mode 100644
index 0000000..1b3024b
--- /dev/null
+++ b/docs/example.ipynb
@@ -0,0 +1,1627 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# stactools-ephemeral\n",
+    "\n",
+    "This is a small notebook demonstrating use of this package and its generated items and collections.\n",
+    "It is intended to be executed from the root of this repository, since it relies on files that have been checked into this repo."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Example items and collections\n",
+    "\n",
+    "This package provides some example data, in the `examples/` directory.\n",
+    "You can load them with [pystac](https://github.com/stac-utils/pystac).\n",
+    "The item includes a custom attribute that is specific to this package."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "\n",
+       "\n",
+       "<style>\n",
+       ".pystac-summary {\n",
+       "    cursor: pointer;\n",
+       "    display:list-item;\n",
+       "}\n",
+       ".pystac-key {\n",
+       "    color: rgb(0, 128, 0);\n",
+       "    font-weight: 700;\n",
+       "}\n",
+       ".pystac-key-value {\n",
+       "    display: inline-block;\n",
+       "    margin: 0px 0.5em 0px 0px;\n",
+       "}\n",
+       "</style>\n",
+       "<div class=\"jp-RenderedJSON jp-mod-trusted jp-OutputArea-output\">\n",
+       "    <div class=\"container\" style=\"line-height: normal;\">\n",
+       "        <ul style=\"padding: 0px; margin: 0px; list-style: none; display: block;\">\n",
+       "            \n",
+       "                \n",
+       "                    \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">type</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">\"Collection\"</span>\n",
+       "        </li>\n",
+       "    \n",
+       "                \n",
+       "            \n",
+       "                \n",
+       "                    \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">id</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">\"example-collection\"</span>\n",
+       "        </li>\n",
+       "    \n",
+       "                \n",
+       "            \n",
+       "                \n",
+       "                    \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">stac_version</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">\"1.0.0\"</span>\n",
+       "        </li>\n",
+       "    \n",
+       "                \n",
+       "            \n",
+       "                \n",
+       "                    \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">description</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">\"An example collection\"</span>\n",
+       "        </li>\n",
+       "    \n",
+       "                \n",
+       "            \n",
+       "                \n",
+       "                    <li><details>\n",
+       "        <summary class=\"pystac-summary\">\n",
+       "            <span class=\"pystac-key\">links</span>\n",
+       "            <span style=\"padding-left: 0.5em; color: rgb(64, 128, 128); font-style: italic;\">[] 3 items</span>\n",
+       "        </summary>\n",
+       "        \n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li><details>\n",
+       "            <summary class=\"pystac-summary\"><span class=\"pystac-key\">0</span></summary>\n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">rel</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">\"self\"</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">href</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">\"/Users/gadomski/Code/stactools-packages/template/examples/collection.json\"</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">type</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">\"application/json\"</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        </details></li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        \n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li><details>\n",
+       "            <summary class=\"pystac-summary\"><span class=\"pystac-key\">1</span></summary>\n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">rel</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">\"root\"</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">href</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">\"/Users/gadomski/Code/stactools-packages/template/examples/collection.json\"</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">type</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">\"application/json\"</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">title</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">\"Example collection\"</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        </details></li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        \n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li><details>\n",
+       "            <summary class=\"pystac-summary\"><span class=\"pystac-key\">2</span></summary>\n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">rel</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">\"item\"</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">href</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">\"./example-item/example-item.json\"</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">type</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">\"application/json\"</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        </details></li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        \n",
+       "    </details></li>\n",
+       "                \n",
+       "            \n",
+       "                \n",
+       "                    \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">custom_attribute</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">\"foo\"</span>\n",
+       "        </li>\n",
+       "    \n",
+       "                \n",
+       "            \n",
+       "                \n",
+       "                    \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">title</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">\"Example collection\"</span>\n",
+       "        </li>\n",
+       "    \n",
+       "                \n",
+       "            \n",
+       "                \n",
+       "                    \n",
+       "        <li><details>\n",
+       "            <summary class=\"pystac-summary\"><span class=\"pystac-key\">extent</span></summary>\n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li><details>\n",
+       "            <summary class=\"pystac-summary\"><span class=\"pystac-key\">spatial</span></summary>\n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                <li><details>\n",
+       "        <summary class=\"pystac-summary\">\n",
+       "            <span class=\"pystac-key\">bbox</span>\n",
+       "            <span style=\"padding-left: 0.5em; color: rgb(64, 128, 128); font-style: italic;\">[] 1 items</span>\n",
+       "        </summary>\n",
+       "        \n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                <li><details>\n",
+       "        <summary class=\"pystac-summary\">\n",
+       "            <span class=\"pystac-key\">0</span>\n",
+       "            <span style=\"padding-left: 0.5em; color: rgb(64, 128, 128); font-style: italic;\">[] 4 items</span>\n",
+       "        </summary>\n",
+       "        \n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">0</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">-61.287624</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        \n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">1</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">72.229798</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        \n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">2</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">-52.301599</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        \n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">3</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">74.622043</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        \n",
+       "    </details></li>\n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        \n",
+       "    </details></li>\n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        </details></li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li><details>\n",
+       "            <summary class=\"pystac-summary\"><span class=\"pystac-key\">temporal</span></summary>\n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                <li><details>\n",
+       "        <summary class=\"pystac-summary\">\n",
+       "            <span class=\"pystac-key\">interval</span>\n",
+       "            <span style=\"padding-left: 0.5em; color: rgb(64, 128, 128); font-style: italic;\">[] 1 items</span>\n",
+       "        </summary>\n",
+       "        \n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                <li><details>\n",
+       "        <summary class=\"pystac-summary\">\n",
+       "            <span class=\"pystac-key\">0</span>\n",
+       "            <span style=\"padding-left: 0.5em; color: rgb(64, 128, 128); font-style: italic;\">[] 2 items</span>\n",
+       "        </summary>\n",
+       "        \n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">0</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">\"2023-09-12T11:48:03.199913Z\"</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        \n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">1</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">\"2023-09-12T11:48:03.199913Z\"</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        \n",
+       "    </details></li>\n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        \n",
+       "    </details></li>\n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        </details></li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        </details></li>\n",
+       "    \n",
+       "                \n",
+       "            \n",
+       "                \n",
+       "                    \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">license</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">\"proprietary\"</span>\n",
+       "        </li>\n",
+       "    \n",
+       "                \n",
+       "            \n",
+       "        </ul>\n",
+       "    </div>\n",
+       "</div>"
+      ],
+      "text/plain": [
+       "<Collection id=example-collection>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "\n",
+       "\n",
+       "<style>\n",
+       ".pystac-summary {\n",
+       "    cursor: pointer;\n",
+       "    display:list-item;\n",
+       "}\n",
+       ".pystac-key {\n",
+       "    color: rgb(0, 128, 0);\n",
+       "    font-weight: 700;\n",
+       "}\n",
+       ".pystac-key-value {\n",
+       "    display: inline-block;\n",
+       "    margin: 0px 0.5em 0px 0px;\n",
+       "}\n",
+       "</style>\n",
+       "<div class=\"jp-RenderedJSON jp-mod-trusted jp-OutputArea-output\">\n",
+       "    <div class=\"container\" style=\"line-height: normal;\">\n",
+       "        <ul style=\"padding: 0px; margin: 0px; list-style: none; display: block;\">\n",
+       "            \n",
+       "                \n",
+       "                    \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">type</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">\"Feature\"</span>\n",
+       "        </li>\n",
+       "    \n",
+       "                \n",
+       "            \n",
+       "                \n",
+       "                    \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">stac_version</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">\"1.0.0\"</span>\n",
+       "        </li>\n",
+       "    \n",
+       "                \n",
+       "            \n",
+       "                \n",
+       "                    \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">id</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">\"example-item\"</span>\n",
+       "        </li>\n",
+       "    \n",
+       "                \n",
+       "            \n",
+       "                \n",
+       "                    \n",
+       "        <li><details>\n",
+       "            <summary class=\"pystac-summary\"><span class=\"pystac-key\">properties</span></summary>\n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">proj:epsg</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">32621</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "            \n",
+       "                <li><details>\n",
+       "        <summary class=\"pystac-summary\">\n",
+       "            <span class=\"pystac-key\">proj:transform</span>\n",
+       "            <span style=\"padding-left: 0.5em; color: rgb(64, 128, 128); font-style: italic;\">[] 6 items</span>\n",
+       "        </summary>\n",
+       "        \n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">0</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">100.01126757344893</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        \n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">1</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">0.0</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        \n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">2</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">373185.0</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        \n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">3</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">0.0</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        \n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">4</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">-100.01126757344893</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        \n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">5</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">8286015.0</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        \n",
+       "    </details></li>\n",
+       "            \n",
+       "        \n",
+       "            \n",
+       "                <li><details>\n",
+       "        <summary class=\"pystac-summary\">\n",
+       "            <span class=\"pystac-key\">proj:shape</span>\n",
+       "            <span style=\"padding-left: 0.5em; color: rgb(64, 128, 128); font-style: italic;\">[] 2 items</span>\n",
+       "        </summary>\n",
+       "        \n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">0</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">2667</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        \n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">1</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">2658</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        \n",
+       "    </details></li>\n",
+       "            \n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">custom_attribute</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">\"foo\"</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">datetime</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">\"2023-09-12T11:48:03.199913Z\"</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        </details></li>\n",
+       "    \n",
+       "                \n",
+       "            \n",
+       "                \n",
+       "                    \n",
+       "        <li><details>\n",
+       "            <summary class=\"pystac-summary\"><span class=\"pystac-key\">geometry</span></summary>\n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">type</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">\"Polygon\"</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "            \n",
+       "                <li><details>\n",
+       "        <summary class=\"pystac-summary\">\n",
+       "            <span class=\"pystac-key\">coordinates</span>\n",
+       "            <span style=\"padding-left: 0.5em; color: rgb(64, 128, 128); font-style: italic;\">[] 1 items</span>\n",
+       "        </summary>\n",
+       "        \n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                <li><details>\n",
+       "        <summary class=\"pystac-summary\">\n",
+       "            <span class=\"pystac-key\">0</span>\n",
+       "            <span style=\"padding-left: 0.5em; color: rgb(64, 128, 128); font-style: italic;\">[] 5 items</span>\n",
+       "        </summary>\n",
+       "        \n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                <li><details>\n",
+       "        <summary class=\"pystac-summary\">\n",
+       "            <span class=\"pystac-key\">0</span>\n",
+       "            <span style=\"padding-left: 0.5em; color: rgb(64, 128, 128); font-style: italic;\">[] 2 items</span>\n",
+       "        </summary>\n",
+       "        \n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">0</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">-52.916275</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        \n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">1</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">72.229798</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        \n",
+       "    </details></li>\n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        \n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                <li><details>\n",
+       "        <summary class=\"pystac-summary\">\n",
+       "            <span class=\"pystac-key\">1</span>\n",
+       "            <span style=\"padding-left: 0.5em; color: rgb(64, 128, 128); font-style: italic;\">[] 2 items</span>\n",
+       "        </summary>\n",
+       "        \n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">0</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">-52.301599</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        \n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">1</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">74.613784</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        \n",
+       "    </details></li>\n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        \n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                <li><details>\n",
+       "        <summary class=\"pystac-summary\">\n",
+       "            <span class=\"pystac-key\">2</span>\n",
+       "            <span style=\"padding-left: 0.5em; color: rgb(64, 128, 128); font-style: italic;\">[] 2 items</span>\n",
+       "        </summary>\n",
+       "        \n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">0</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">-61.287624</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        \n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">1</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">74.622043</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        \n",
+       "    </details></li>\n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        \n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                <li><details>\n",
+       "        <summary class=\"pystac-summary\">\n",
+       "            <span class=\"pystac-key\">3</span>\n",
+       "            <span style=\"padding-left: 0.5em; color: rgb(64, 128, 128); font-style: italic;\">[] 2 items</span>\n",
+       "        </summary>\n",
+       "        \n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">0</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">-60.726346</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        \n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">1</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">72.236891</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        \n",
+       "    </details></li>\n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        \n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                <li><details>\n",
+       "        <summary class=\"pystac-summary\">\n",
+       "            <span class=\"pystac-key\">4</span>\n",
+       "            <span style=\"padding-left: 0.5em; color: rgb(64, 128, 128); font-style: italic;\">[] 2 items</span>\n",
+       "        </summary>\n",
+       "        \n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">0</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">-52.916275</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        \n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">1</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">72.229798</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        \n",
+       "    </details></li>\n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        \n",
+       "    </details></li>\n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        \n",
+       "    </details></li>\n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        </details></li>\n",
+       "    \n",
+       "                \n",
+       "            \n",
+       "                \n",
+       "                    <li><details>\n",
+       "        <summary class=\"pystac-summary\">\n",
+       "            <span class=\"pystac-key\">links</span>\n",
+       "            <span style=\"padding-left: 0.5em; color: rgb(64, 128, 128); font-style: italic;\">[] 4 items</span>\n",
+       "        </summary>\n",
+       "        \n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li><details>\n",
+       "            <summary class=\"pystac-summary\"><span class=\"pystac-key\">0</span></summary>\n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">rel</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">\"root\"</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">href</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">\"/Users/gadomski/Code/stactools-packages/template/examples/collection.json\"</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">type</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">\"application/json\"</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">title</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">\"Example collection\"</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        </details></li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        \n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li><details>\n",
+       "            <summary class=\"pystac-summary\"><span class=\"pystac-key\">1</span></summary>\n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">rel</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">\"collection\"</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">href</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">\"../collection.json\"</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">type</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">\"application/json\"</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">title</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">\"Example collection\"</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        </details></li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        \n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li><details>\n",
+       "            <summary class=\"pystac-summary\"><span class=\"pystac-key\">2</span></summary>\n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">rel</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">\"self\"</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">href</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">\"/Users/gadomski/Code/stactools-packages/template/examples/example-item/example-item.json\"</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">type</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">\"application/json\"</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        </details></li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        \n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li><details>\n",
+       "            <summary class=\"pystac-summary\"><span class=\"pystac-key\">3</span></summary>\n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">rel</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">\"parent\"</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">href</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">\"/Users/gadomski/Code/stactools-packages/template/examples/collection.json\"</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">type</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">\"application/json\"</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">title</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">\"Example collection\"</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        </details></li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        \n",
+       "    </details></li>\n",
+       "                \n",
+       "            \n",
+       "                \n",
+       "                    \n",
+       "        <li><details>\n",
+       "            <summary class=\"pystac-summary\"><span class=\"pystac-key\">assets</span></summary>\n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li><details>\n",
+       "            <summary class=\"pystac-summary\"><span class=\"pystac-key\">data</span></summary>\n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">href</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">\"../../tests/data/asset.tif\"</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "            \n",
+       "                <li><details>\n",
+       "        <summary class=\"pystac-summary\">\n",
+       "            <span class=\"pystac-key\">roles</span>\n",
+       "            <span style=\"padding-left: 0.5em; color: rgb(64, 128, 128); font-style: italic;\">[] 1 items</span>\n",
+       "        </summary>\n",
+       "        \n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">0</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">\"data\"</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        \n",
+       "    </details></li>\n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        </details></li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        </details></li>\n",
+       "    \n",
+       "                \n",
+       "            \n",
+       "                \n",
+       "                    <li><details>\n",
+       "        <summary class=\"pystac-summary\">\n",
+       "            <span class=\"pystac-key\">bbox</span>\n",
+       "            <span style=\"padding-left: 0.5em; color: rgb(64, 128, 128); font-style: italic;\">[] 4 items</span>\n",
+       "        </summary>\n",
+       "        \n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">0</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">-61.287624</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        \n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">1</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">72.229798</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        \n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">2</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">-52.301599</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        \n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">3</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">74.622043</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        \n",
+       "    </details></li>\n",
+       "                \n",
+       "            \n",
+       "                \n",
+       "                    <li><details>\n",
+       "        <summary class=\"pystac-summary\">\n",
+       "            <span class=\"pystac-key\">stac_extensions</span>\n",
+       "            <span style=\"padding-left: 0.5em; color: rgb(64, 128, 128); font-style: italic;\">[] 1 items</span>\n",
+       "        </summary>\n",
+       "        \n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">0</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">\"https://stac-extensions.github.io/projection/v1.1.0/schema.json\"</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        \n",
+       "    </details></li>\n",
+       "                \n",
+       "            \n",
+       "                \n",
+       "                    \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">collection</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">\"example-collection\"</span>\n",
+       "        </li>\n",
+       "    \n",
+       "                \n",
+       "            \n",
+       "        </ul>\n",
+       "    </div>\n",
+       "</div>"
+      ],
+      "text/plain": [
+       "<Item id=example-item>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "This is the custom attribute: foo\n"
+     ]
+    }
+   ],
+   "source": [
+    "from pathlib import Path\n",
+    "from pystac import Collection, Item\n",
+    "from IPython.display import display\n",
+    "import stactools.ephemeral.stac\n",
+    "\n",
+    "root = Path().cwd().parent\n",
+    "collection = Collection.from_file(str(root / \"examples\" / \"collection.json\"))\n",
+    "display(collection)\n",
+    "item = next(collection.get_items())\n",
+    "display(item)\n",
+    "print(f\"This is the custom attribute: {item.properties['custom_attribute']}\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Creating items and collections\n",
+    "\n",
+    "Items can be created from an href to a single tif file.\n",
+    "Items are added to collections using the standard pystac interface."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "\n",
+       "\n",
+       "<style>\n",
+       ".pystac-summary {\n",
+       "    cursor: pointer;\n",
+       "    display:list-item;\n",
+       "}\n",
+       ".pystac-key {\n",
+       "    color: rgb(0, 128, 0);\n",
+       "    font-weight: 700;\n",
+       "}\n",
+       ".pystac-key-value {\n",
+       "    display: inline-block;\n",
+       "    margin: 0px 0.5em 0px 0px;\n",
+       "}\n",
+       "</style>\n",
+       "<div class=\"jp-RenderedJSON jp-mod-trusted jp-OutputArea-output\">\n",
+       "    <div class=\"container\" style=\"line-height: normal;\">\n",
+       "        <ul style=\"padding: 0px; margin: 0px; list-style: none; display: block;\">\n",
+       "            \n",
+       "                \n",
+       "                    \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">type</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">\"Collection\"</span>\n",
+       "        </li>\n",
+       "    \n",
+       "                \n",
+       "            \n",
+       "                \n",
+       "                    \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">id</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">\"example-collection\"</span>\n",
+       "        </li>\n",
+       "    \n",
+       "                \n",
+       "            \n",
+       "                \n",
+       "                    \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">stac_version</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">\"1.0.0\"</span>\n",
+       "        </li>\n",
+       "    \n",
+       "                \n",
+       "            \n",
+       "                \n",
+       "                    \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">description</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">\"An example collection\"</span>\n",
+       "        </li>\n",
+       "    \n",
+       "                \n",
+       "            \n",
+       "                \n",
+       "                    <li><details>\n",
+       "        <summary class=\"pystac-summary\">\n",
+       "            <span class=\"pystac-key\">links</span>\n",
+       "            <span style=\"padding-left: 0.5em; color: rgb(64, 128, 128); font-style: italic;\">[] 1 items</span>\n",
+       "        </summary>\n",
+       "        \n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li><details>\n",
+       "            <summary class=\"pystac-summary\"><span class=\"pystac-key\">0</span></summary>\n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">rel</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">\"item\"</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">href</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">None</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">type</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">\"application/json\"</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        </details></li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        \n",
+       "    </details></li>\n",
+       "                \n",
+       "            \n",
+       "                \n",
+       "                    \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">custom_attribute</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">\"foo\"</span>\n",
+       "        </li>\n",
+       "    \n",
+       "                \n",
+       "            \n",
+       "                \n",
+       "                    \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">title</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">\"Example collection\"</span>\n",
+       "        </li>\n",
+       "    \n",
+       "                \n",
+       "            \n",
+       "                \n",
+       "                    \n",
+       "        <li><details>\n",
+       "            <summary class=\"pystac-summary\"><span class=\"pystac-key\">extent</span></summary>\n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li><details>\n",
+       "            <summary class=\"pystac-summary\"><span class=\"pystac-key\">spatial</span></summary>\n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                <li><details>\n",
+       "        <summary class=\"pystac-summary\">\n",
+       "            <span class=\"pystac-key\">bbox</span>\n",
+       "            <span style=\"padding-left: 0.5em; color: rgb(64, 128, 128); font-style: italic;\">[] 1 items</span>\n",
+       "        </summary>\n",
+       "        \n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                <li><details>\n",
+       "        <summary class=\"pystac-summary\">\n",
+       "            <span class=\"pystac-key\">0</span>\n",
+       "            <span style=\"padding-left: 0.5em; color: rgb(64, 128, 128); font-style: italic;\">[] 4 items</span>\n",
+       "        </summary>\n",
+       "        \n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">0</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">-180.0</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        \n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">1</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">90.0</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        \n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">2</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">180.0</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        \n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">3</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">-90.0</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        \n",
+       "    </details></li>\n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        \n",
+       "    </details></li>\n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        </details></li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li><details>\n",
+       "            <summary class=\"pystac-summary\"><span class=\"pystac-key\">temporal</span></summary>\n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                <li><details>\n",
+       "        <summary class=\"pystac-summary\">\n",
+       "            <span class=\"pystac-key\">interval</span>\n",
+       "            <span style=\"padding-left: 0.5em; color: rgb(64, 128, 128); font-style: italic;\">[] 1 items</span>\n",
+       "        </summary>\n",
+       "        \n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                <li><details>\n",
+       "        <summary class=\"pystac-summary\">\n",
+       "            <span class=\"pystac-key\">0</span>\n",
+       "            <span style=\"padding-left: 0.5em; color: rgb(64, 128, 128); font-style: italic;\">[] 2 items</span>\n",
+       "        </summary>\n",
+       "        \n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">0</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">\"2023-09-18T21:35:51.039996Z\"</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        \n",
+       "            <ul style=\"margin: 0px; padding: 0px 0px 0px 1.75em; list-style: none; display: block;\">\n",
+       "        \n",
+       "            \n",
+       "                \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">1</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">None</span>\n",
+       "        </li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        \n",
+       "    </details></li>\n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        \n",
+       "    </details></li>\n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        </details></li>\n",
+       "    \n",
+       "            \n",
+       "        \n",
+       "    </ul>\n",
+       "        </details></li>\n",
+       "    \n",
+       "                \n",
+       "            \n",
+       "                \n",
+       "                    \n",
+       "        <li style=\"overflow-wrap: break-word; padding-left: 2.125em; text-indent: -0.5em;\">\n",
+       "            <span class=\"pystac-key pystac-key-value\">license</span>\n",
+       "            <span style=\"color: rgb(186, 33, 33);\">\"proprietary\"</span>\n",
+       "        </li>\n",
+       "    \n",
+       "                \n",
+       "            \n",
+       "        </ul>\n",
+       "    </div>\n",
+       "</div>"
+      ],
+      "text/plain": [
+       "<Collection id=example-collection>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "tif_path = root / \"tests\" / \"data\" / \"asset.tif\"\n",
+    "item = stactools.ephemeral.stac.create_item(str(tif_path))\n",
+    "collection = stactools.ephemeral.stac.create_collection()\n",
+    "collection.add_item(item)\n",
+    "display(collection)"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": ".venv",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.11.2"
+  },
+  "orig_nbformat": 4
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}
diff --git a/pyproject.toml b/pyproject.toml
index eaf2f0d..b71978d 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -31,6 +31,7 @@ dev = [
     "pytest~=7.4",
     "ruff==0.0.288",
 ]
+docs = ["pystac~=1.8", "ipykernel~=6.25", "jinja2~=3.1"]
 
 [project.urls]
 Github = "https://github.com/stactools-packges/ephemeral"