fetch_util 0.5.2 → 0.6.0

data/lib/fetch_util/browser/site_stabilization/gerrit_file_resource_validation_state_script.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module FetchUtil
+  class Browser
+    module SiteStabilization
+      module GerritFileResourceValidationStateScript
+        private
+
+        def gerrit_file_resource_validation_state_script
+          <<~'JS'
+            const objectRecord = (value) => value && typeof value === "object" && !Array.isArray(value);
+            const validTextLines = (value) => value == null ||
+              (Array.isArray(value) && value.every((line) => typeof line === "string"));
+            const validIntralineEdits = (value) => value == null || (Array.isArray(value) && value.every(
+              (edit) => Array.isArray(edit) && edit.length === 2 && edit.every(
+                (number) => Number.isInteger(number) && number >= 0
+              )
+            ));
+            const validDiffBlock = (block) => objectRecord(block) && ["ab", "a", "b"].every(
+              (field) => validTextLines(block[field])
+            ) && ["edit_a", "edit_b"].every(
+              (field) => validIntralineEdits(block[field])
+            ) && (block.skip == null || typeof block.skip === "number" || objectRecord(block.skip));
+            const validateDiff = (diff, filePath) => {
+              if (diff.content != null &&
+                  (!Array.isArray(diff.content) || !diff.content.every(validDiffBlock))) {
+                throw new Error("invalid Gerrit diff content payload");
+              }
+              if (diff.diff_header != null && typeof diff.diff_header !== "string" &&
+                  (!Array.isArray(diff.diff_header) ||
+                    !diff.diff_header.every((line) => typeof line === "string"))) {
+                throw new Error("invalid Gerrit diff header payload");
+              }
+              if (diff.meta_a != null && !objectRecord(diff.meta_a)) {
+                throw new Error("invalid Gerrit base metadata payload");
+              }
+              if (diff.meta_b != null && !objectRecord(diff.meta_b)) {
+                throw new Error("invalid Gerrit target metadata payload");
+              }
+              if (diff.meta_b && diff.meta_b.name && diff.meta_b.name !== filePath) {
+                throw new Error("Gerrit API diff target identity mismatch");
+              }
+            };
+          JS
+        end
+      end
+    end
+  end
+end

data/lib/fetch_util/browser/site_stabilization/gitea_family_pull_resource_product_state.rb

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+module FetchUtil
+  class Browser
+    module SiteStabilization
+      module GiteaFamilyPullResourceProductState
+        private
+
+        def gitea_family_pull_resource_product_state_script
+          gitea_family_visibility_script + <<~'JS'
+            const visibleNodes = (node) => [node, ...node.querySelectorAll('*')].filter(visible);
+            const ownText = (node) => Array.from(node.childNodes)
+              .filter((child) => child.nodeType === Node.TEXT_NODE)
+              .map((child) => child.textContent || '').join(' ').trim();
+            const visibleText = (node) => visibleNodes(node).map(ownText).filter(Boolean).join(' ');
+            const visibleMaterial = (node, excluded) => !!node && visibleNodes(node).some((candidate) => {
+              if (excluded && candidate.closest(excluded)) return false;
+              return !!ownText(candidate) || candidate.matches('table, pre, code, img, ins, del, .diff-line');
+            });
+            const runtime = window.config || {};
+            const prefix = String(runtime.appSubUrl || '').replace(/^\/+|\/+$/g, '');
+            const routePrefix = prefix ? `/${prefix}` : '';
+            const escaped = routePrefix.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+            const match = location.pathname.match(new RegExp(
+              `^${escaped}/([^/]+)/([^/]+)/pulls/(\\d+)/(commits|files)(?:/([^/]+))?\\/?$`
+            ));
+            if (!match) return null;
+            const routeSurface = match[4];
+            const detail = match[5] || '';
+            const validDetail = routeSurface === 'commits'
+              ? (!detail || detail === 'list' || /^[a-f0-9]{4,64}$/i.test(detail))
+              : (!detail || /^[a-f0-9]{4,64}$/i.test(detail) ||
+                /^[a-f0-9]{7,64}\.\.?\.[a-f0-9]{7,64}$/i.test(detail));
+            if (!validDetail) return null;
+            const surface = routeSurface === 'commits' && detail && detail !== 'list' ? 'files' : routeSurface;
+            let runtimeMatch = false;
+            try {
+              const app = new URL(runtime.appUrl || '', location.href);
+              runtimeMatch = !!runtime.appUrl && app.origin === location.origin &&
+                app.pathname.replace(/\/$/, '') === routePrefix;
+            } catch (_error) { runtimeMatch = false; }
+            const brandValues = Array.from(document.querySelectorAll(
+              'meta[name="author"], meta[name="generator"], meta[property="og:site_name"]'
+            )).map((node) => (node.content || '').trim());
+            Array.from(document.querySelectorAll('footer a[href]')).forEach((node) => {
+              const text = (node.textContent || '').trim();
+              const href = node.getAttribute('href') || '';
+              if (/powered by.*\b(?:forgejo|gitea)\b/i.test(text) || /\b(?:forgejo|gitea)\b/i.test(href)) {
+                brandValues.push(`${text} ${href}`);
+              }
+            });
+            brandValues.push((runtime.assetVersionEncoded || '').trim());
+            const branded = /\b(?:forgejo|gitea)\b/i.test(brandValues.join(' '));
+            let runtimeAsset = false;
+            try {
+              const assetUrl = new URL(runtime.assetUrlPrefix || '', location.href);
+              const expectedPath = `${routePrefix}/assets`;
+              runtimeAsset = !!runtime.assetUrlPrefix && assetUrl.origin === location.origin &&
+                assetUrl.pathname.replace(/\/$/, '') === expectedPath &&
+                Array.from(document.querySelectorAll('script[src], link[href]')).some((node) => {
+                  const value = node.getAttribute('src') || node.getAttribute('href') || '';
+                  const url = new URL(value, location.href);
+                  return url.origin === location.origin && url.pathname.startsWith(`${expectedPath}/`);
+                });
+            } catch (_error) { runtimeAsset = false; }
+            const rootSelectors = surface === 'commits'
+              ? ['.page-content.repository.view.issue.pull.commits', '.repository.view.issue.pull.commits',
+                '.page-content.repository.view.issue.pull']
+              : ['.page-content.repository.view.issue.pull.files.diff', '.repository.view.issue.pull.files.diff',
+                '.page-content.repository.view.issue.pull'];
+            let root = null;
+            rootSelectors.some((selector) => { root = document.querySelector(selector); return !!root; });
+            const empty = root && Array.from(root.querySelectorAll(
+              '.ui.message.empty, .empty-state, .nothing-here, .no-results, [data-testid="empty-state"]'
+            )).find((node) => visible(node) && (node.textContent || '').trim());
+            const structure = surface === 'commits'
+              ? !!(root && (root.querySelector(
+                '#commits-table > tbody.commit-list, .commit-group .commits .commit'
+              ) || empty))
+              : !!(root && (root.querySelector('#diff-container, #diff-file-boxes, #diff-file-tree') || empty));
+            const product = runtimeMatch && structure && (branded || runtimeAsset);
+            if (!product) return { product: false, ready: false, signature: '' };
+          JS
+        end
+      end
+    end
+  end
+end

data/lib/fetch_util/browser/site_stabilization/gitea_family_pull_resource_state.rb

@@ -0,0 +1,109 @@
+# frozen_string_literal: true
+
+module FetchUtil
+  class Browser
+    module SiteStabilization
+      module GiteaFamilyPullResourceState
+        private
+
+        def gitea_family_pull_resource_state_script
+          <<~'JS'
+              const loading = Array.from(root.querySelectorAll(
+                '[aria-busy="true"], .is-loading, .tw-loading, .ui.active.loader'
+              )).some(visible);
+              const rows = surface === 'commits'
+                ? Array.from(root.querySelectorAll(
+                  '#commits-table > tbody.commit-list > tr, .commit-group .commits .commit'
+                ))
+                  .filter((row) => visibleMaterial(row))
+                : [];
+              const rowSignatures = rows.map((row) => [
+                row.querySelector('.copy-commit-id[data-clipboard-text]')?.getAttribute('data-clipboard-text') || '',
+                row.querySelector('a[href*="/commit/"]')?.getAttribute('href') || '',
+                visibleText(row)
+              ].join('|'));
+              const pageData = runtime.pageData || {};
+              const treeData = pageData.DiffFileTree || pageData.diffFileTree || [];
+              const treeRoots = treeData.TreeRoot || treeData.treeRoot || treeData;
+              const treeIds = [];
+              const visit = (nodes) => (Array.isArray(nodes) ? nodes : [nodes]).filter(Boolean).forEach((node) => {
+                const children = node.Children || node.children || [];
+                if (children.length) return visit(children);
+                const identity = String(node.NameHash || node.nameHash || '');
+                if (identity) treeIds.push(identity.startsWith('diff-') ? identity : `diff-${identity}`);
+              });
+              const forgejoFiles = (pageData.diffFileInfo || {}).files || [];
+              if (forgejoFiles.length) {
+                forgejoFiles.forEach((file) => {
+                  const identity = String(file.NameHash || file.nameHash || '');
+                  if (identity) treeIds.push(identity.startsWith('diff-') ? identity : `diff-${identity}`);
+                });
+              } else {
+                visit(treeRoots);
+              }
+              const boxes = surface === 'files'
+                ? Array.from(root.querySelectorAll(
+                  '#diff-file-boxes > .diff-file-box, .diff-file-box.file-content[id^="diff-"]'
+                )).filter((box, index, all) => box.id !== 'diff-incomplete' && visibleMaterial(box) &&
+                  !all.some((other, otherIndex) => otherIndex < index && other.contains(box)))
+                : [];
+              const boxSignatures = boxes.map((box) => [
+                box.id || '',
+                box.getAttribute('data-new-filename') || '',
+                box.getAttribute('data-old-filename') || '',
+                visibleText(box)
+              ].join('|'));
+              const deferred = surface === 'files'
+                ? Array.from(root.querySelectorAll(
+                  '#diff-show-more-files[data-href], .diff-load-button[data-href], ' +
+                  '[data-global-click="diffLoadFileBody"][data-href]'
+                )).filter(visible).map((node) => node.getAttribute('data-href') || '')
+                : [];
+              let selectedId = '';
+              if (surface === 'files') {
+                try { selectedId = decodeURIComponent((location.hash || '').replace(/^#/, '')); }
+                catch (_error) { selectedId = ''; }
+              }
+              const selected = selectedId && boxes.find((box) => box.id === selectedId);
+              const selectedBody = selected && selected.querySelector(
+                '.diff-file-body, .file-body, .diff-rendered, .image-diff, .binary'
+              );
+              const excluded = 'button, [role="button"], .diff-load-button, [data-global-click="diffLoadFileBody"]';
+              const selectedDeferred = !!(selected && Array.from(selected.querySelectorAll(
+                '.diff-load-button[data-href], [data-global-click="diffLoadFileBody"][data-href]'
+              )).find(visible));
+              const selectedStructured = !!selectedBody && visibleNodes(selectedBody).some((candidate) => {
+                if (candidate.closest(excluded)) return false;
+                return candidate.matches('table, pre, code, img, ins, del, .diff-line');
+              });
+              const selectedLoaded = !!selectedBody && visibleMaterial(selectedBody, excluded) &&
+                (!selectedDeferred || selectedStructured);
+              const selectedIndexed = !!selectedId && treeIds.includes(selectedId);
+              const selectedTerminal = !selectedId || selectedLoaded || selectedDeferred || (!selected && selectedIndexed);
+              const material = surface === 'commits'
+                ? rows.length > 0 || !!empty
+                : treeIds.length > 0 || boxes.length > 0 || !!empty;
+              return {
+                product: true,
+                ready: !loading && material && selectedTerminal,
+                loading,
+                signature: [
+                  surface,
+                  rowSignatures.join('\u001e'),
+                  treeIds.join('\u001e'),
+                  boxSignatures.join('\u001e'),
+                  deferred.join('\u001e'),
+                  selectedId,
+                  selectedLoaded,
+                  selectedDeferred,
+                  !!empty,
+                  loading
+                ].join(':')
+              };
+            })()
+          JS
+        end
+      end
+    end
+  end
+end

data/lib/fetch_util/browser/site_stabilization/gitea_family_pull_resources.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module FetchUtil
+  class Browser
+    module SiteStabilization
+      module GiteaFamilyPullResources
+        GITEA_FAMILY_PULL_RESOURCE_STABILIZATION_PROFILE = {
+          host: true,
+          path_query: lambda { |uri|
+            uri.path.match?(%r{/(?:[^/]+/){2}pulls/\d+/(?:commits(?:/(?:list|[a-f\d]{4,64}))?|files(?:/(?:[a-f\d]{4,64}|[a-f\d]{7,64}\.\.?\.[a-f\d]{7,64}))?)/?\z}i)
+          },
+          strategy: :stabilize_gitea_family_pull_resource,
+          fallthrough: true,
+          notes: "Wait for host-agnostic Gitea and Forgejo pull-request resources.",
+          tests: "spec/fetch_util/browser_stabilization_spec.rb"
+        }.freeze
+
+        private
+
+        def stabilize_gitea_family_pull_resource(page, deadline: stabilization_deadline)
+          stabilize_gitea_family_state(
+            page,
+            gitea_family_pull_resource_product_state_script + gitea_family_pull_resource_state_script,
+            deadline: deadline
+          )
+        end
+      end
+    end
+  end
+end

data/lib/fetch_util/browser/site_stabilization/gitea_family_stabilization.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+module FetchUtil
+  class Browser
+    module SiteStabilization
+      module GiteaFamilyStabilization
+        private
+
+        def stabilize_gitea_family_state(page, state_script, deadline: stabilization_deadline)
+          last_signature = nil
+          stable_observations = 0
+          incomplete_signature = nil
+          incomplete_observations = 0
+          terminal_incomplete = false
+          observed = retry_until_timeout(
+            capped_timeout(6.0, deadline: deadline),
+            interval: 0.1,
+            deadline: deadline
+          ) do
+            state = safe_evaluate(page, state_script, default: nil)
+            return false if state.is_a?(Hash) && state["product"] == false
+            next false unless state.is_a?(Hash) && state["product"]
+
+            unless state["ready"]
+              if state["loading"]
+                incomplete_signature = nil
+                incomplete_observations = 0
+              elsif state["signature"] == incomplete_signature
+                incomplete_observations += 1
+              else
+                incomplete_signature = state["signature"]
+                incomplete_observations = 1
+              end
+              if incomplete_observations >= 10
+                terminal_incomplete = true
+                next true
+              end
+              next false
+            end
+
+            incomplete_signature = nil
+            incomplete_observations = 0
+            if state["signature"] == last_signature
+              stable_observations += 1
+            else
+              last_signature = state["signature"]
+              stable_observations = 1
+            end
+            stable_observations >= 3
+          end
+
+          return false if terminal_incomplete
+
+          settle_after_stabilization(0.5, deadline: deadline) if observed
+          !!observed
+        end
+      end
+    end
+  end
+end

data/lib/fetch_util/browser/site_stabilization/gitea_family_thread_product_state.rb

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+
+module FetchUtil
+  class Browser
+    module SiteStabilization
+      module GiteaFamilyThreadProductState
+        private
+
+        def gitea_family_thread_product_state_script
+          gitea_family_visibility_script + <<~'JS'
+            const runtime = window.config || {};
+            const prefix = String(runtime.appSubUrl || '').replace(/^\/+|\/+$/g, '');
+            const routePrefix = prefix ? `/${prefix}` : '';
+            const escaped = routePrefix.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+            const match = location.pathname.match(new RegExp(
+              `^${escaped}/([^/]+)/([^/]+)/(issues|pulls)/(\\d+)\\/?$`
+            ));
+            if (!match) return null;
+            let runtimeMatch = false;
+            try {
+              const app = new URL(runtime.appUrl || '', location.href);
+              runtimeMatch = !!runtime.appUrl && app.origin === location.origin &&
+                app.pathname.replace(/\/$/, '') === routePrefix;
+            } catch (_error) { runtimeMatch = false; }
+            const brandValues = Array.from(document.querySelectorAll(
+              'meta[name="author"], meta[name="generator"], meta[property="og:site_name"]'
+            )).map((node) => (node.content || '').trim());
+            Array.from(document.querySelectorAll('footer a[href]')).forEach((node) => {
+              const value = `${node.textContent || ''} ${node.getAttribute('href') || ''}`;
+              if (/\b(?:forgejo|gitea)\b/i.test(value)) brandValues.push(value);
+            });
+            brandValues.push((runtime.assetVersionEncoded || '').trim());
+            const branded = /\b(?:forgejo|gitea)\b/i.test(brandValues.join(' '));
+            let runtimeAsset = false;
+            try {
+              const assetUrl = new URL(runtime.assetUrlPrefix || '', location.href);
+              const expectedPath = `${routePrefix}/assets`;
+              runtimeAsset = !!runtime.assetUrlPrefix && assetUrl.origin === location.origin &&
+                assetUrl.pathname.replace(/\/$/, '') === expectedPath &&
+                Array.from(document.querySelectorAll('script[src], link[href]')).some((node) => {
+                  const value = node.getAttribute('src') || node.getAttribute('href') || '';
+                  const url = new URL(value, location.href);
+                  return url.origin === location.origin && url.pathname.startsWith(`${expectedPath}/`);
+                });
+            } catch (_error) { runtimeAsset = false; }
+            const root = document.querySelector(
+              '.page-content.repository.view.issue .issue-content, .repository.view.issue .issue-content, .page-content .issue-content'
+            );
+            const opening = root && root.querySelector(
+              '.issue-content-left .timeline-item.comment.issue-content-comment[id^="issue-"], ' +
+              '.issue-content-left .timeline-item.comment.issue-content-comment, ' +
+              '.issue-content-left .timeline-item.comment.first[id^="issue-"], ' +
+              '.issue-content-left .timeline-item.comment.first, ' +
+              '.comment-list .timeline-item.comment.issue-content-comment, ' +
+              '.comment-list .timeline-item.comment.first'
+            );
+            const openingBody = opening && opening.querySelector('.comment-body');
+            const rendered = openingBody && openingBody.querySelector('.render-content.markup');
+            const empty = openingBody && openingBody.querySelector('.no-content');
+            const attachment = openingBody && Array.from(openingBody.querySelectorAll(
+              '.dropzone-attachments a[href], .attachments a[href]'
+            )).some(visible);
+            const structure = !!(root && opening && openingBody &&
+              root.querySelector('.issue-content-left .comment-list, .issue-content-left.comment-list') &&
+              opening.querySelector('.content.comment-container, .comment-body') &&
+              ((visible(rendered) && (rendered.innerText || '').trim()) || visible(empty) || attachment));
+            const product = runtimeMatch && structure && (branded || runtimeAsset);
+            if (!product) return { product: false, ready: false, signature: '' };
+          JS
+        end
+      end
+    end
+  end
+end

data/lib/fetch_util/browser/site_stabilization/gitea_family_thread_timeline_state.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+module FetchUtil
+  class Browser
+    module SiteStabilization
+      module GiteaFamilyThreadTimelineState
+        private
+
+        def gitea_family_thread_timeline_state_script
+          <<~'JS'
+              const candidates = Array.from(root.querySelectorAll([
+                '.issue-content-left .timeline-item-group',
+                '.issue-content-left .timeline-item',
+                '.comment-list .timeline-item-group',
+                '.comment-list .timeline-item'
+              ].join(', ')));
+              const rows = [];
+              candidates.forEach((node) => {
+                const group = node.closest('.timeline-item-group');
+                const row = group && root.contains(group) ? group : node;
+                if (subtreeHidden(row) || row.matches(
+                  '.pull-merge-box, .timeline-item.comment.merge.box, .form, #timeline-comments-end'
+                )) return;
+                if (rows.some((existing) => existing === row || existing.contains(row))) return;
+                rows.push(row);
+              });
+              const author = opening.querySelector(
+                '.comment-header .author, .timeline-avatar + * .author, ' +
+                '.comment-header-left a.tw-font-semibold, .comment-header-left span.tw-font-semibold, ' +
+                '.comment-header a.tw-font-semibold, a.tw-font-semibold, .author'
+              );
+              const comments = rows.filter((row) => !!row.querySelector('.comment-body'));
+              const events = rows.length - comments.length;
+              const loading = Array.from(root.querySelectorAll(
+                '[aria-busy="true"], .is-loading, .tw-loading, .ui.active.loader'
+              )).some(visible);
+              const openingReady = visible(openingBody) && !!(
+                (rendered && (rendered.innerText || '').trim()) ||
+                (openingBody && openingBody.querySelector('.no-content')) ||
+                Array.from(openingBody.querySelectorAll('.dropzone-attachments, .attachments')).some(visible)
+              );
+              const rowSignatures = rows.map((row) => [
+                row.id || '',
+                row.className || '',
+                Array.from(row.querySelectorAll('relative-time[datetime], time[datetime]'))
+                  .map((time) => time.getAttribute('datetime') || '').join(','),
+                (row.innerText || '').trim()
+              ].join('|')).join('\u001e');
+              return {
+                product: true,
+                ready: !loading && openingReady,
+                loading,
+                signature: [
+                  rows.length,
+                  comments.length,
+                  events,
+                  visible(author) ? (author.textContent || '').trim() : '',
+                  openingReady,
+                  loading,
+                  rowSignatures
+                ].join(':')
+              };
+            })()
+          JS
+        end
+      end
+    end
+  end
+end

data/lib/fetch_util/browser/site_stabilization/gitea_family_threads.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module FetchUtil
+  class Browser
+    module SiteStabilization
+      module GiteaFamilyThreads
+        GITEA_FAMILY_THREAD_STABILIZATION_PROFILE = {
+          host: true,
+          path_query: ->(uri) { uri.path.match?(%r{/(?:[^/]+/){2}(?:issues|pulls)/\d+/?\z}) },
+          strategy: :stabilize_gitea_family_thread,
+          fallthrough: true,
+          notes: "Wait for host-agnostic Gitea and Forgejo issue and pull-request conversations.",
+          tests: "spec/fetch_util/browser_stabilization_spec.rb"
+        }.freeze
+
+        private
+
+        def stabilize_gitea_family_thread(page, deadline: stabilization_deadline)
+          stabilize_gitea_family_state(
+            page,
+            gitea_family_thread_product_state_script + gitea_family_thread_timeline_state_script,
+            deadline: deadline
+          )
+        end
+      end
+    end
+  end
+end

data/lib/fetch_util/browser/site_stabilization/gitea_family_visibility_script.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module FetchUtil
+  class Browser
+    module SiteStabilization
+      module GiteaFamilyVisibilityScript
+        private
+
+        def gitea_family_visibility_script
+          <<~'JS'
+            (() => {
+              const subtreeHidden = (node) => {
+                let current = node;
+                while (current && current !== document) {
+                  const style = getComputedStyle(current);
+                  if (current.hidden || style.display === 'none') return true;
+                  current = current.parentElement;
+                }
+                return false;
+              };
+              const visible = (node) => !!node && !subtreeHidden(node) &&
+                !['hidden', 'collapse'].includes(getComputedStyle(node).visibility);
+          JS
+        end
+      end
+    end
+  end
+end

data/lib/fetch_util/browser/site_stabilization/github_pull_resource_stabilization.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module FetchUtil
+  class Browser
+    module SiteStabilization
+      module GithubPullResourceStabilization
+        private
+
+        def stabilize_github_pull_resource(page, deadline: stabilization_deadline)
+          last_signature = nil
+          stable_observations = 0
+          ready = retry_until_timeout(capped_timeout(8.0, deadline: deadline), interval: 0.1, deadline: deadline) do
+            state = safe_evaluate(page, github_pull_resource_state_script, default: nil)
+            next false unless state.is_a?(Hash) && state["ready"]
+
+            if state["signature"] == last_signature
+              stable_observations += 1
+              stable_observations >= 3
+            else
+              last_signature = state["signature"]
+              stable_observations = 1
+              false
+            end
+          end
+
+          settle_after_stabilization(0.5, deadline: deadline) if ready
+        end
+      end
+    end
+  end
+end