PyPI - ciocore - Versions diffs - 5.1.1__py2.py3-none-any.whl → 10.0.0b3__py2.py3-none-any.whl - Mend

ciocore 5.1.1py2.py3-none-any.whl → 10.0.0b3py2.py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (126) hide show

ciocore/VERSION +1 -1
ciocore/__init__.py +23 -1
ciocore/api_client.py +655 -160
ciocore/auth/__init__.py +5 -3
ciocore/cli.py +501 -0
ciocore/common.py +15 -13
ciocore/conductor_submit.py +77 -60
ciocore/config.py +127 -13
ciocore/data.py +162 -77
ciocore/docsite/404.html +746 -0
ciocore/docsite/apidoc/api_client/index.html +3605 -0
ciocore/docsite/apidoc/apidoc/index.html +909 -0
ciocore/docsite/apidoc/config/index.html +1652 -0
ciocore/docsite/apidoc/data/index.html +1553 -0
ciocore/docsite/apidoc/hardware_set/index.html +2460 -0
ciocore/docsite/apidoc/package_environment/index.html +1507 -0
ciocore/docsite/apidoc/package_tree/index.html +2386 -0
ciocore/docsite/assets/_mkdocstrings.css +16 -0
ciocore/docsite/assets/images/favicon.png +0 -0
ciocore/docsite/assets/javascripts/bundle.471ce7a9.min.js +29 -0
ciocore/docsite/assets/javascripts/bundle.471ce7a9.min.js.map +7 -0
ciocore/docsite/assets/javascripts/lunr/min/lunr.ar.min.js +1 -0
ciocore/docsite/assets/javascripts/lunr/min/lunr.da.min.js +18 -0
ciocore/docsite/assets/javascripts/lunr/min/lunr.de.min.js +18 -0
ciocore/docsite/assets/javascripts/lunr/min/lunr.du.min.js +18 -0
ciocore/docsite/assets/javascripts/lunr/min/lunr.el.min.js +1 -0
ciocore/docsite/assets/javascripts/lunr/min/lunr.es.min.js +18 -0
ciocore/docsite/assets/javascripts/lunr/min/lunr.fi.min.js +18 -0
ciocore/docsite/assets/javascripts/lunr/min/lunr.fr.min.js +18 -0
ciocore/docsite/assets/javascripts/lunr/min/lunr.he.min.js +1 -0
ciocore/docsite/assets/javascripts/lunr/min/lunr.hi.min.js +1 -0
ciocore/docsite/assets/javascripts/lunr/min/lunr.hu.min.js +18 -0
ciocore/docsite/assets/javascripts/lunr/min/lunr.hy.min.js +1 -0
ciocore/docsite/assets/javascripts/lunr/min/lunr.it.min.js +18 -0
ciocore/docsite/assets/javascripts/lunr/min/lunr.ja.min.js +1 -0
ciocore/docsite/assets/javascripts/lunr/min/lunr.jp.min.js +1 -0
ciocore/docsite/assets/javascripts/lunr/min/lunr.kn.min.js +1 -0
ciocore/docsite/assets/javascripts/lunr/min/lunr.ko.min.js +1 -0
ciocore/docsite/assets/javascripts/lunr/min/lunr.multi.min.js +1 -0
ciocore/docsite/assets/javascripts/lunr/min/lunr.nl.min.js +18 -0
ciocore/docsite/assets/javascripts/lunr/min/lunr.no.min.js +18 -0
ciocore/docsite/assets/javascripts/lunr/min/lunr.pt.min.js +18 -0
ciocore/docsite/assets/javascripts/lunr/min/lunr.ro.min.js +18 -0
ciocore/docsite/assets/javascripts/lunr/min/lunr.ru.min.js +18 -0
ciocore/docsite/assets/javascripts/lunr/min/lunr.sa.min.js +1 -0
ciocore/docsite/assets/javascripts/lunr/min/lunr.stemmer.support.min.js +1 -0
ciocore/docsite/assets/javascripts/lunr/min/lunr.sv.min.js +18 -0
ciocore/docsite/assets/javascripts/lunr/min/lunr.ta.min.js +1 -0
ciocore/docsite/assets/javascripts/lunr/min/lunr.te.min.js +1 -0
ciocore/docsite/assets/javascripts/lunr/min/lunr.th.min.js +1 -0
ciocore/docsite/assets/javascripts/lunr/min/lunr.tr.min.js +18 -0
ciocore/docsite/assets/javascripts/lunr/min/lunr.vi.min.js +1 -0
ciocore/docsite/assets/javascripts/lunr/min/lunr.zh.min.js +1 -0
ciocore/docsite/assets/javascripts/lunr/tinyseg.js +206 -0
ciocore/docsite/assets/javascripts/lunr/wordcut.js +6708 -0
ciocore/docsite/assets/javascripts/workers/search.b8dbb3d2.min.js +42 -0
ciocore/docsite/assets/javascripts/workers/search.b8dbb3d2.min.js.map +7 -0
ciocore/docsite/assets/stylesheets/main.3cba04c6.min.css +1 -0
ciocore/docsite/assets/stylesheets/main.3cba04c6.min.css.map +1 -0
ciocore/docsite/assets/stylesheets/palette.06af60db.min.css +1 -0
ciocore/docsite/assets/stylesheets/palette.06af60db.min.css.map +1 -0
ciocore/docsite/cmdline/docs/index.html +871 -0
ciocore/docsite/cmdline/downloader/index.html +934 -0
ciocore/docsite/cmdline/packages/index.html +878 -0
ciocore/docsite/cmdline/uploader/index.html +995 -0
ciocore/docsite/how-to-guides/index.html +869 -0
ciocore/docsite/index.html +895 -0
ciocore/docsite/logo.png +0 -0
ciocore/docsite/objects.inv +0 -0
ciocore/docsite/search/search_index.json +1 -0
ciocore/docsite/sitemap.xml +3 -0
ciocore/docsite/sitemap.xml.gz +0 -0
ciocore/docsite/stylesheets/extra.css +26 -0
ciocore/docsite/stylesheets/tables.css +167 -0
ciocore/downloader/base_downloader.py +644 -0
ciocore/downloader/download_runner_base.py +47 -0
ciocore/downloader/job_downloader.py +119 -0
ciocore/{downloader.py → downloader/legacy_downloader.py} +12 -9
ciocore/downloader/log.py +73 -0
ciocore/downloader/logging_download_runner.py +87 -0
ciocore/downloader/perpetual_downloader.py +63 -0
ciocore/downloader/registry.py +97 -0
ciocore/downloader/reporter.py +135 -0
ciocore/exceptions.py +8 -2
ciocore/file_utils.py +51 -50
ciocore/hardware_set.py +449 -0
ciocore/loggeria.py +89 -20
ciocore/package_environment.py +110 -48
ciocore/package_query.py +182 -0
ciocore/package_tree.py +319 -258
ciocore/retry.py +0 -0
ciocore/uploader/_uploader.py +547 -364
ciocore/uploader/thread_queue_job.py +176 -0
ciocore/uploader/upload_stats/__init__.py +3 -4
ciocore/uploader/upload_stats/stats_formats.py +10 -4
ciocore/validator.py +34 -2
ciocore/worker.py +174 -151
ciocore-10.0.0b3.dist-info/METADATA +928 -0
ciocore-10.0.0b3.dist-info/RECORD +128 -0
{ciocore-5.1.1.dist-info → ciocore-10.0.0b3.dist-info}/WHEEL +1 -1
ciocore-10.0.0b3.dist-info/entry_points.txt +2 -0
tests/instance_type_fixtures.py +175 -0
tests/package_fixtures.py +205 -0
tests/test_api_client.py +297 -12
tests/test_base_downloader.py +104 -0
tests/test_cli.py +149 -0
tests/test_common.py +1 -7
tests/test_config.py +40 -18
tests/test_data.py +162 -173
tests/test_downloader.py +118 -0
tests/test_hardware_set.py +139 -0
tests/test_job_downloader.py +213 -0
tests/test_package_query.py +38 -0
tests/test_package_tree.py +91 -291
tests/test_submit.py +44 -18
tests/test_uploader.py +1 -4
ciocore/__about__.py +0 -10
ciocore/cli/conductor.py +0 -191
ciocore/compat.py +0 -15
ciocore-5.1.1.data/scripts/conductor +0 -19
ciocore-5.1.1.data/scripts/conductor.bat +0 -13
ciocore-5.1.1.dist-info/METADATA +0 -408
ciocore-5.1.1.dist-info/RECORD +0 -47
tests/mocks/api_client_mock.py +0 -51
/ciocore/{cli → downloader}/__init__.py +0 -0
{ciocore-5.1.1.dist-info → ciocore-10.0.0b3.dist-info}/top_level.txt +0 -0

ciocore/docsite/apidoc/hardware_set/index.html ADDED Viewed

@@ -0,0 +1,2460 @@
+<!doctype html>
+<html lang="en" class="no-js">
+  <head>
+      <meta charset="utf-8">
+      <meta name="viewport" content="width=device-width,initial-scale=1">
+        <meta name="author" content="Conductor Developers">
+        <link rel="prev" href="../data/">
+        <link rel="next" href="../package_tree/">
+      <link rel="icon" href="../../assets/images/favicon.png">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.32">
+        <title>ciocore.hardware_set - Conductor Core</title>
+      <link rel="stylesheet" href="../../assets/stylesheets/main.3cba04c6.min.css">
+        <link rel="stylesheet" href="../../assets/stylesheets/palette.06af60db.min.css">
+        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Raleway:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
+        <style>:root{--md-text-font:"Raleway";--md-code-font:"Roboto Mono"}</style>
+      <link rel="stylesheet" href="../../assets/_mkdocstrings.css">
+      <link rel="stylesheet" href="../../stylesheets/extra.css">
+      <link rel="stylesheet" href="../../stylesheets/tables.css">
+    <script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
+  </head>
+    <body dir="ltr" data-md-color-scheme="slate" data-md-color-primary="custom" data-md-color-accent="custom">
+    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
+    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
+    <label class="md-overlay" for="__drawer"></label>
+    <div data-md-component="skip">
+        <a href="#ciocorehardware_set" class="md-skip">
+          Skip to content
+        </a>
+    </div>
+    <div data-md-component="announce">
+    </div>
+<header class="md-header md-header--shadow md-header--lifted" data-md-component="header">
+  <nav class="md-header__inner md-grid" aria-label="Header">
+    <a href="https://www.conductortech.com" title="Conductor Core" class="md-header__button md-logo" aria-label="Conductor Core" data-md-component="logo">
+  <img src="../../logo.png" alt="logo">
+    </a>
+    <label class="md-header__button md-icon" for="__drawer">
+      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
+    </label>
+    <div class="md-header__title" data-md-component="header-title">
+      <div class="md-header__ellipsis">
+        <div class="md-header__topic">
+          <span class="md-ellipsis">
+            Conductor Core
+          </span>
+        </div>
+        <div class="md-header__topic" data-md-component="header-topic">
+          <span class="md-ellipsis">
+              ciocore.hardware_set
+          </span>
+        </div>
+      </div>
+    </div>
+        <form class="md-header__option" data-md-component="palette">
+    <input class="md-option" data-md-color-media="" data-md-color-scheme="slate" data-md-color-primary="custom" data-md-color-accent="custom"  aria-label="Switch to light mode"  type="radio" name="__palette" id="__palette_0">
+      <label class="md-header__button md-icon" title="Switch to light mode" for="__palette_1" hidden>
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m17.75 4.09-2.53 1.94.91 3.06-2.63-1.81-2.63 1.81.91-3.06-2.53-1.94L12.44 4l1.06-3 1.06 3 3.19.09m3.5 6.91-1.64 1.25.59 1.98-1.7-1.17-1.7 1.17.59-1.98L15.75 11l2.06-.05L18.5 9l.69 1.95 2.06.05m-2.28 4.95c.83-.08 1.72 1.1 1.19 1.85-.32.45-.66.87-1.08 1.27C15.17 23 8.84 23 4.94 19.07c-3.91-3.9-3.91-10.24 0-14.14.4-.4.82-.76 1.27-1.08.75-.53 1.93.36 1.85 1.19-.27 2.86.69 5.83 2.89 8.02a9.96 9.96 0 0 0 8.02 2.89m-1.64 2.02a12.08 12.08 0 0 1-7.8-3.47c-2.17-2.19-3.33-5-3.49-7.82-2.81 3.14-2.7 7.96.31 10.98 3.02 3.01 7.84 3.12 10.98.31Z"/></svg>
+      </label>
+    <input class="md-option" data-md-color-media="" data-md-color-scheme="default" data-md-color-primary="custom" data-md-color-accent="custom"  aria-label="Switch to dark mode"  type="radio" name="__palette" id="__palette_1">
+      <label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_0" hidden>
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 7a5 5 0 0 1 5 5 5 5 0 0 1-5 5 5 5 0 0 1-5-5 5 5 0 0 1 5-5m0 2a3 3 0 0 0-3 3 3 3 0 0 0 3 3 3 3 0 0 0 3-3 3 3 0 0 0-3-3m0-7 2.39 3.42C13.65 5.15 12.84 5 12 5c-.84 0-1.65.15-2.39.42L12 2M3.34 7l4.16-.35A7.2 7.2 0 0 0 5.94 8.5c-.44.74-.69 1.5-.83 2.29L3.34 7m.02 10 1.76-3.77a7.131 7.131 0 0 0 2.38 4.14L3.36 17M20.65 7l-1.77 3.79a7.023 7.023 0 0 0-2.38-4.15l4.15.36m-.01 10-4.14.36c.59-.51 1.12-1.14 1.54-1.86.42-.73.69-1.5.83-2.29L20.64 17M12 22l-2.41-3.44c.74.27 1.55.44 2.41.44.82 0 1.63-.17 2.37-.44L12 22Z"/></svg>
+      </label>
+</form>
+      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
+      <label class="md-header__button md-icon" for="__search">
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
+      </label>
+      <div class="md-search" data-md-component="search" role="dialog">
+  <label class="md-search__overlay" for="__search"></label>
+  <div class="md-search__inner" role="search">
+    <form class="md-search__form" name="search">
+      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
+      <label class="md-search__icon md-icon" for="__search">
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
+      </label>
+      <nav class="md-search__options" aria-label="Search">
+        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
+          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
+        </button>
+      </nav>
+    </form>
+    <div class="md-search__output">
+      <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
+        <div class="md-search-result" data-md-component="search-result">
+          <div class="md-search-result__meta">
+            Initializing search
+          </div>
+          <ol class="md-search-result__list" role="presentation"></ol>
+        </div>
+      </div>
+    </div>
+  </div>
+</div>
+  </nav>
+<nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">
+  <div class="md-grid">
+    <ul class="md-tabs__list">
+    <li class="md-tabs__item">
+      <a href="../.." class="md-tabs__link">
+  Overview
+      </a>
+    </li>
+      <li class="md-tabs__item">
+        <a href="../../cmdline/uploader/" class="md-tabs__link">
+  CLI
+        </a>
+      </li>
+      <li class="md-tabs__item md-tabs__item--active">
+        <a href="../apidoc/" class="md-tabs__link">
+  API
+        </a>
+      </li>
+    <li class="md-tabs__item">
+      <a href="../../how-to-guides/" class="md-tabs__link">
+  How to
+      </a>
+    </li>
+    </ul>
+  </div>
+</nav>
+</header>
+    <div class="md-container" data-md-component="container">
+      <main class="md-main" data-md-component="main">
+        <div class="md-main__inner md-grid">
+              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
+                <div class="md-sidebar__scrollwrap">
+                  <div class="md-sidebar__inner">
+<nav class="md-nav md-nav--primary md-nav--lifted" aria-label="Navigation" data-md-level="0">
+  <label class="md-nav__title" for="__drawer">
+    <a href="https://www.conductortech.com" title="Conductor Core" class="md-nav__button md-logo" aria-label="Conductor Core" data-md-component="logo">
+  <img src="../../logo.png" alt="logo">
+    </a>
+    Conductor Core
+  </label>
+  <ul class="md-nav__list" data-md-scrollfix>
+    <li class="md-nav__item">
+      <a href="../.." class="md-nav__link">
+  <span class="md-ellipsis">
+    Overview
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item md-nav__item--nested">
+        <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2" >
+          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
+  <span class="md-ellipsis">
+    CLI
+  </span>
+            <span class="md-nav__icon md-icon"></span>
+          </label>
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_2">
+            <span class="md-nav__icon md-icon"></span>
+            CLI
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+    <li class="md-nav__item">
+      <a href="../../cmdline/uploader/" class="md-nav__link">
+  <span class="md-ellipsis">
+    Uploader
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../cmdline/downloader/" class="md-nav__link">
+  <span class="md-ellipsis">
+    Downloader
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../cmdline/packages/" class="md-nav__link">
+  <span class="md-ellipsis">
+    Packages
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../cmdline/docs/" class="md-nav__link">
+  <span class="md-ellipsis">
+    Docs
+  </span>
+      </a>
+    </li>
+          </ul>
+        </nav>
+    </li>
+    <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" checked>
+          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="">
+  <span class="md-ellipsis">
+    API
+  </span>
+            <span class="md-nav__icon md-icon"></span>
+          </label>
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_3">
+            <span class="md-nav__icon md-icon"></span>
+            API
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+    <li class="md-nav__item">
+      <a href="../apidoc/" class="md-nav__link">
+  <span class="md-ellipsis">
+    Api Overview
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../api_client/" class="md-nav__link">
+  <span class="md-ellipsis">
+    ciocore.api_client
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../config/" class="md-nav__link">
+  <span class="md-ellipsis">
+    ciocore.config
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../data/" class="md-nav__link">
+  <span class="md-ellipsis">
+    ciocore.data
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item md-nav__item--active">
+      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
+        <label class="md-nav__link md-nav__link--active" for="__toc">
+  <span class="md-ellipsis">
+    ciocore.hardware_set
+  </span>
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      <a href="./" class="md-nav__link md-nav__link--active">
+  <span class="md-ellipsis">
+    ciocore.hardware_set
+  </span>
+      </a>
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      Table of contents
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+        <li class="md-nav__item">
+  <a href="#ciocore.hardware_set" class="md-nav__link">
+    <span class="md-ellipsis">
+      ciocore.hardware_set
+    </span>
+  </a>
+</li>
+        <li class="md-nav__item">
+  <a href="#ciocore.hardware_set.HardwareSet" class="md-nav__link">
+    <span class="md-ellipsis">
+      HardwareSet
+    </span>
+  </a>
+    <nav class="md-nav" aria-label="HardwareSet">
+      <ul class="md-nav__list">
+          <li class="md-nav__item">
+  <a href="#ciocore.hardware_set.HardwareSet.__init__" class="md-nav__link">
+    <span class="md-ellipsis">
+      __init__()
+    </span>
+  </a>
+    <nav class="md-nav" aria-label="__init__()">
+      <ul class="md-nav__list">
+          <li class="md-nav__item">
+  <a href="#ciocore.hardware_set.HardwareSet.__init__--initialize-with-a-list-of-instance-types" class="md-nav__link">
+    <span class="md-ellipsis">
+      Initialize with a list of instance types
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#ciocore.hardware_set.HardwareSet.__init__--initialize-implicitly-with-a-list-of-instance-types-from-ciocoredata-recommended" class="md-nav__link">
+    <span class="md-ellipsis">
+      Initialize implicitly with a list of instance types from ciocore.data (recommended).
+    </span>
+  </a>
+</li>
+      </ul>
+    </nav>
+</li>
+          <li class="md-nav__item">
+  <a href="#ciocore.hardware_set.HardwareSet.labels" class="md-nav__link">
+    <span class="md-ellipsis">
+      labels()
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#ciocore.hardware_set.HardwareSet.number_of_categories" class="md-nav__link">
+    <span class="md-ellipsis">
+      number_of_categories()
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#ciocore.hardware_set.HardwareSet.recategorize" class="md-nav__link">
+    <span class="md-ellipsis">
+      recategorize()
+    </span>
+  </a>
+    <nav class="md-nav" aria-label="recategorize()">
+      <ul class="md-nav__list">
+          <li class="md-nav__item">
+  <a href="#ciocore.hardware_set.HardwareSet.recategorize--confirm-current-categories" class="md-nav__link">
+    <span class="md-ellipsis">
+      Confirm current categories
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#ciocore.hardware_set.HardwareSet.recategorize--recategorize" class="md-nav__link">
+    <span class="md-ellipsis">
+      Recategorize
+    </span>
+  </a>
+</li>
+      </ul>
+    </nav>
+</li>
+          <li class="md-nav__item">
+  <a href="#ciocore.hardware_set.HardwareSet.find" class="md-nav__link">
+    <span class="md-ellipsis">
+      find()
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#ciocore.hardware_set.HardwareSet.find_category" class="md-nav__link">
+    <span class="md-ellipsis">
+      find_category()
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#ciocore.hardware_set.HardwareSet.find_all" class="md-nav__link">
+    <span class="md-ellipsis">
+      find_all()
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#ciocore.hardware_set.HardwareSet.find_first" class="md-nav__link">
+    <span class="md-ellipsis">
+      find_first()
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#ciocore.hardware_set.HardwareSet.get_model" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_model()
+    </span>
+  </a>
+</li>
+      </ul>
+    </nav>
+</li>
+    </ul>
+</nav>
+    </li>
+    <li class="md-nav__item">
+      <a href="../package_tree/" class="md-nav__link">
+  <span class="md-ellipsis">
+    ciocore.package_tree
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../package_environment/" class="md-nav__link">
+  <span class="md-ellipsis">
+    ciocore.package_environment
+  </span>
+      </a>
+    </li>
+          </ul>
+        </nav>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../how-to-guides/" class="md-nav__link">
+  <span class="md-ellipsis">
+    How to
+  </span>
+      </a>
+    </li>
+  </ul>
+</nav>
+                  </div>
+                </div>
+              </div>
+              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
+                <div class="md-sidebar__scrollwrap">
+                  <div class="md-sidebar__inner">
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      Table of contents
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+        <li class="md-nav__item">
+  <a href="#ciocore.hardware_set" class="md-nav__link">
+    <span class="md-ellipsis">
+      ciocore.hardware_set
+    </span>
+  </a>
+</li>
+        <li class="md-nav__item">
+  <a href="#ciocore.hardware_set.HardwareSet" class="md-nav__link">
+    <span class="md-ellipsis">
+      HardwareSet
+    </span>
+  </a>
+    <nav class="md-nav" aria-label="HardwareSet">
+      <ul class="md-nav__list">
+          <li class="md-nav__item">
+  <a href="#ciocore.hardware_set.HardwareSet.__init__" class="md-nav__link">
+    <span class="md-ellipsis">
+      __init__()
+    </span>
+  </a>
+    <nav class="md-nav" aria-label="__init__()">
+      <ul class="md-nav__list">
+          <li class="md-nav__item">
+  <a href="#ciocore.hardware_set.HardwareSet.__init__--initialize-with-a-list-of-instance-types" class="md-nav__link">
+    <span class="md-ellipsis">
+      Initialize with a list of instance types
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#ciocore.hardware_set.HardwareSet.__init__--initialize-implicitly-with-a-list-of-instance-types-from-ciocoredata-recommended" class="md-nav__link">
+    <span class="md-ellipsis">
+      Initialize implicitly with a list of instance types from ciocore.data (recommended).
+    </span>
+  </a>
+</li>
+      </ul>
+    </nav>
+</li>
+          <li class="md-nav__item">
+  <a href="#ciocore.hardware_set.HardwareSet.labels" class="md-nav__link">
+    <span class="md-ellipsis">
+      labels()
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#ciocore.hardware_set.HardwareSet.number_of_categories" class="md-nav__link">
+    <span class="md-ellipsis">
+      number_of_categories()
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#ciocore.hardware_set.HardwareSet.recategorize" class="md-nav__link">
+    <span class="md-ellipsis">
+      recategorize()
+    </span>
+  </a>
+    <nav class="md-nav" aria-label="recategorize()">
+      <ul class="md-nav__list">
+          <li class="md-nav__item">
+  <a href="#ciocore.hardware_set.HardwareSet.recategorize--confirm-current-categories" class="md-nav__link">
+    <span class="md-ellipsis">
+      Confirm current categories
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#ciocore.hardware_set.HardwareSet.recategorize--recategorize" class="md-nav__link">
+    <span class="md-ellipsis">
+      Recategorize
+    </span>
+  </a>
+</li>
+      </ul>
+    </nav>
+</li>
+          <li class="md-nav__item">
+  <a href="#ciocore.hardware_set.HardwareSet.find" class="md-nav__link">
+    <span class="md-ellipsis">
+      find()
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#ciocore.hardware_set.HardwareSet.find_category" class="md-nav__link">
+    <span class="md-ellipsis">
+      find_category()
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#ciocore.hardware_set.HardwareSet.find_all" class="md-nav__link">
+    <span class="md-ellipsis">
+      find_all()
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#ciocore.hardware_set.HardwareSet.find_first" class="md-nav__link">
+    <span class="md-ellipsis">
+      find_first()
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#ciocore.hardware_set.HardwareSet.get_model" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_model()
+    </span>
+  </a>
+</li>
+      </ul>
+    </nav>
+</li>
+    </ul>
+</nav>
+                  </div>
+                </div>
+              </div>
+            <div class="md-content" data-md-component="content">
+              <article class="md-content__inner md-typeset">
+<h1 id="ciocorehardware_set">ciocore.hardware_set</h1>
+  <div class="doc doc-object doc-module">
+<a id="ciocore.hardware_set"></a>
+    <div class="doc doc-contents first">
+      <p>This module contains the <strong>HardwareSet</strong> class. </p>
+<p>It is designed to allow submission tools and other clients that consume instance types to be able to display them in categories. This is particularly useful for UIs that utilize combo-boxes, since they can be orgnaized into a nested structure and displayed in a tree-like fashion.</p>
+  <div class="doc doc-children">
+  <div class="doc doc-object doc-class">
+<h2 id="ciocore.hardware_set.HardwareSet" class="doc doc-heading">
+        <code>
+HardwareSet        </code>
+</h2>
+    <div class="doc doc-contents ">
+      <p>A class to manage categorized instance types.</p>
+<p>A HardwareSet encapsulates the instance types available to an account. It accepts a flat list of instance types and builds a nested structure where those instance types exist in categories.</p>
+<p>It keeps a dictionary of instance types (<code>instance_types</code>) with the name field as key. This allows easy lookup by name.</p>
+<p>In addition, it keeps the nested structure of categories (<code>categories</code>) that contain the instance types. Each category is a dictionary with keys: <code>label</code>, <code>content</code>, and <code>order</code>.</p>
+<p><code>content</code> is a list of instance types in the category. The order is used to sort the categories. The order of the instance types within a category is determined by the number of cores and memory.</p>
+<p>If all instance_types have not been assigned any categories, then the structure is built with two default categories: CPU and GPU.</p>
+        <details class="quote">
+          <summary>Source code in <code>ciocore/hardware_set.py</code></summary>
+          <div class="highlight"><pre><span></span><code><span class="k">class</span><span class="w"> </span><span class="nc">HardwareSet</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;A class to manage categorized instance types.</span>
+<span class="sd">    A HardwareSet encapsulates the instance types available to an account. It accepts a flat list of instance types and builds a nested structure where those instance types exist in categories.</span>
+<span class="sd">    It keeps a dictionary of instance types (`instance_types`) with the name field as key. This allows easy lookup by name.</span>
+<span class="sd">    In addition, it keeps the nested structure of categories (`categories`) that contain the instance types. Each category is a dictionary with keys: `label`, `content`, and `order`.</span>
+<span class="sd">    `content` is a list of instance types in the category. The order is used to sort the categories. The order of the instance types within a category is determined by the number of cores and memory.</span>
+<span class="sd">    If all instance_types have not been assigned any categories, then the structure is built with two default categories: CPU and GPU.</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+    <span class="k">def</span><span class="w"> </span><span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">instance_types</span><span class="p">):</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Initialize the HardwareSet with a list of instance types.</span>
+<span class="sd">        Typically, you would access the HardwareSet through the ciocore.data.data() function, which initializes it for you. However, you can also initialize it directly with a list of instance types straight from ciocore.api_client. The difference being that the latter contains all instance types, whereas the former contains only the instance types compatible with the products you have specified, as well as being cached.</span>
+<span class="sd">        Args:</span>
+<span class="sd">            instance_types (list): A list of instance types.</span>
+<span class="sd">        Returns:</span>
+<span class="sd">            HardwareSet: The initialized HardwareSet.</span>
+<span class="sd">        Examples:</span>
+<span class="sd">            ### Initialize with a list of instance types</span>
+<span class="sd">            &gt;&gt;&gt; from ciocore import api_client</span>
+<span class="sd">            &gt;&gt;&gt; from ciocore.hardware_set import HardwareSet</span>
+<span class="sd">            &gt;&gt;&gt; instance_types = api_client.request_instance_types()</span>
+<span class="sd">            &gt;&gt;&gt; hardware_set = HardwareSet(instance_types)</span>
+<span class="sd">            &lt;ciocore.hardware_set.HardwareSet object at 0x104c43d30&gt;</span>
+<span class="sd">            ### Initialize implicitly with a list of instance types from ciocore.data (recommended).</span>
+<span class="sd">            &gt;&gt;&gt; from ciocore import data as coredata</span>
+<span class="sd">            &gt;&gt;&gt; coredata.init(&quot;cinema4d&quot;)</span>
+<span class="sd">            &gt;&gt;&gt; hardware_set = coredata.data()[&quot;instance_types&quot;]</span>
+<span class="sd">            &lt;ciocore.hardware_set.HardwareSet object at 0x104c43ee0&gt;</span>
+<span class="sd">            !!! note</span>
+<span class="sd">                To avoid repetition, we use the implicit initialization for the examples below.</span>
+<span class="sd">        &quot;&quot;&quot;</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">instance_types</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_build_unique</span><span class="p">(</span><span class="n">instance_types</span><span class="p">)</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">categories</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_build_categories</span><span class="p">()</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">provider</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_get_provider</span><span class="p">()</span>
+    <span class="k">def</span><span class="w"> </span><span class="nf">labels</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Get the list of category labels.</span>
+<span class="sd">        Returns:</span>
+<span class="sd">            list: A list of category labels.</span>
+<span class="sd">        Example:</span>
+<span class="sd">            &gt;&gt;&gt; from ciocore import data as coredata</span>
+<span class="sd">            &gt;&gt;&gt; coredata.init()</span>
+<span class="sd">            &gt;&gt;&gt; hardware_set = coredata.data()[&quot;instance_types&quot;]</span>
+<span class="sd">            &gt;&gt;&gt; hardware_set.labels()</span>
+<span class="sd">            [&#39;CPU&#39;, &#39;GPU&#39;]</span>
+<span class="sd">        &quot;&quot;&quot;</span>
+        <span class="k">return</span> <span class="p">[</span><span class="n">c</span><span class="p">[</span><span class="s2">&quot;label&quot;</span><span class="p">]</span> <span class="k">for</span> <span class="n">c</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">categories</span><span class="p">]</span>
+    <span class="k">def</span><span class="w"> </span><span class="nf">number_of_categories</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Get the number of categories in the data.</span>
+<span class="sd">        Returns:</span>
+<span class="sd">            int: The number of categories.</span>
+<span class="sd">        Example:</span>
+<span class="sd">            &gt;&gt;&gt; from ciocore import data as coredata</span>
+<span class="sd">            &gt;&gt;&gt; coredata.init()</span>
+<span class="sd">            &gt;&gt;&gt; hardware_set = coredata.data()[&quot;instance_types&quot;]</span>
+<span class="sd">            &gt;&gt;&gt; hardware_set.number_of_categories()</span>
+<span class="sd">            2</span>
+<span class="sd">        &quot;&quot;&quot;</span>
+        <span class="k">return</span> <span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">categories</span><span class="p">)</span>
+    <span class="k">def</span><span class="w"> </span><span class="nf">recategorize</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">partitioner</span><span class="p">):</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Recategorize the instance types.</span>
+<span class="sd">        Args:</span>
+<span class="sd">            partitioner (function): A function that takes an instance type and returns a list of categories to assign to it. The function should return an empty list if the instance type should not be categorized.</span>
+<span class="sd">        Example:</span>
+<span class="sd">            # Confirm current categories</span>
+<span class="sd">            &gt;&gt;&gt; from ciocore import data as coredata</span>
+<span class="sd">            &gt;&gt;&gt; coredata.init()</span>
+<span class="sd">            &gt;&gt;&gt; hardware_set = coredata.data()[&quot;instance_types&quot;]</span>
+<span class="sd">            &gt;&gt;&gt; print(hardware_set.labels()</span>
+<span class="sd">            [&#39;CPU&#39;, &#39;GPU&#39;]</span>
+<span class="sd">            # Recategorize</span>
+<span class="sd">            &gt;&gt;&gt; hardware_set.recategorize(lambda x: [{&#39;label&#39;: &#39;Low cores&#39;, &#39;order&#39;: 10}] if  x[&quot;cores&quot;] &lt; 16 else [{&#39;label&#39;: &#39;High cores&#39;, &#39;order&#39;: 20}])</span>
+<span class="sd">            &gt;&gt;&gt; print(hardware_set.labels()</span>
+<span class="sd">            [&#39;Low cores&#39;, &#39;High cores&#39;]</span>
+<span class="sd">        &quot;&quot;&quot;</span>
+        <span class="k">for</span> <span class="n">key</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">instance_types</span><span class="p">:</span>
+            <span class="bp">self</span><span class="o">.</span><span class="n">instance_types</span><span class="p">[</span><span class="n">key</span><span class="p">][</span><span class="s2">&quot;categories&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">partitioner</span><span class="p">(</span>
+                <span class="bp">self</span><span class="o">.</span><span class="n">instance_types</span><span class="p">[</span><span class="n">key</span><span class="p">]</span>
+            <span class="p">)</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">categories</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_build_categories</span><span class="p">()</span>
+    <span class="k">def</span><span class="w"> </span><span class="nf">find</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">,</span> <span class="n">category</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Find an instance type by its name (sku).</span>
+<span class="sd">        Args:</span>
+<span class="sd">            name (str): The name of the instance type.</span>
+<span class="sd">        Returns:</span>
+<span class="sd">            dict: The instance type or None if not found.</span>
+<span class="sd">        Example:</span>
+<span class="sd">            &gt;&gt;&gt; from ciocore import data as coredata</span>
+<span class="sd">            &gt;&gt;&gt; coredata.init()</span>
+<span class="sd">            &gt;&gt;&gt; hardware_set = coredata.data()[&quot;instance_types&quot;]</span>
+<span class="sd">            &gt;&gt;&gt; hardware_set.find(&quot;n2-highmem-80&quot;)</span>
+<span class="sd">            {</span>
+<span class="sd">                &#39;cores&#39;: 80,</span>
+<span class="sd">                &#39;description&#39;: &#39;80 core, 640GB Mem&#39;,</span>
+<span class="sd">                &#39;gpu&#39;: None,</span>
+<span class="sd">                &#39;memory&#39;: &#39;640&#39;,</span>
+<span class="sd">                &#39;name&#39;: &#39;n2-highmem-80&#39;,</span>
+<span class="sd">                &#39;operating_system&#39;: &#39;linux&#39;,</span>
+<span class="sd">                &#39;categories&#39;: [</span>
+<span class="sd">                    {&#39;label&#39;: &#39;High cores&#39;, &#39;order&#39;: 20}</span>
+<span class="sd">                ]</span>
+<span class="sd">            }</span>
+<span class="sd">        &quot;&quot;&quot;</span>
+        <span class="k">if</span> <span class="ow">not</span> <span class="n">category</span><span class="p">:</span>
+            <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">instance_types</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">name</span><span class="p">)</span>
+        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">find_first</span><span class="p">(</span>
+            <span class="k">lambda</span> <span class="n">x</span><span class="p">:</span> <span class="n">x</span><span class="p">[</span><span class="s2">&quot;name&quot;</span><span class="p">]</span> <span class="o">==</span> <span class="n">name</span>
+            <span class="ow">and</span> <span class="n">category</span> <span class="ow">in</span> <span class="p">[</span><span class="n">c</span><span class="p">[</span><span class="s2">&quot;label&quot;</span><span class="p">]</span> <span class="k">for</span> <span class="n">c</span> <span class="ow">in</span> <span class="n">x</span><span class="p">[</span><span class="s2">&quot;categories&quot;</span><span class="p">]]</span>
+        <span class="p">)</span>
+    <span class="k">def</span><span class="w"> </span><span class="nf">find_category</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">label</span><span class="p">):</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Find a category by label.</span>
+<span class="sd">        Args:</span>
+<span class="sd">            label (str): The label of the category.</span>
+<span class="sd">        Returns:</span>
+<span class="sd">            dict: The category or None if not found.</span>
+<span class="sd">        Example:</span>
+<span class="sd">            &gt;&gt;&gt; from ciocore import data as coredata</span>
+<span class="sd">            &gt;&gt;&gt; coredata.init()</span>
+<span class="sd">            &gt;&gt;&gt; hardware_set = coredata.data()[&quot;instance_types&quot;]</span>
+<span class="sd">            &gt;&gt;&gt; hardware_set.find_category(&quot;High cores&quot;)</span>
+<span class="sd">            {</span>
+<span class="sd">                &quot;label&quot;: &quot;Low cores&quot;,</span>
+<span class="sd">                &quot;content&quot;: [</span>
+<span class="sd">                    {</span>
+<span class="sd">                        &quot;cores&quot;: 8,</span>
+<span class="sd">                        &quot;description&quot;: &quot;8 core, 52GB Mem&quot;,</span>
+<span class="sd">                        &quot;gpu&quot;: None,</span>
+<span class="sd">                        &quot;memory&quot;: &quot;52&quot;,</span>
+<span class="sd">                        &quot;name&quot;: &quot;n1-highmem-8&quot;,</span>
+<span class="sd">                        &quot;operating_system&quot;: &quot;linux&quot;,</span>
+<span class="sd">                        &quot;categories&quot;: [{&quot;label&quot;: &quot;Low cores&quot;, &quot;order&quot;: 10}],</span>
+<span class="sd">                    },</span>
+<span class="sd">                    {</span>
+<span class="sd">                        &quot;cores&quot;: 8,</span>
+<span class="sd">                        &quot;description&quot;: &quot;8 core, 7.2GB Mem&quot;,</span>
+<span class="sd">                        &quot;gpu&quot;: None,</span>
+<span class="sd">                        &quot;memory&quot;: &quot;7.2&quot;,</span>
+<span class="sd">                        &quot;name&quot;: &quot;n1-highcpu-8&quot;,</span>
+<span class="sd">                        &quot;operating_system&quot;: &quot;linux&quot;,</span>
+<span class="sd">                        &quot;categories&quot;: [{&quot;label&quot;: &quot;Low cores&quot;, &quot;order&quot;: 10}],</span>
+<span class="sd">                    },</span>
+<span class="sd">                    ...</span>
+<span class="sd">                ],</span>
+<span class="sd">                &quot;order&quot;: 10</span>
+<span class="sd">            }</span>
+<span class="sd">        &quot;&quot;&quot;</span>
+        <span class="k">return</span> <span class="nb">next</span><span class="p">((</span><span class="n">c</span> <span class="k">for</span> <span class="n">c</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">categories</span> <span class="k">if</span> <span class="n">c</span><span class="p">[</span><span class="s2">&quot;label&quot;</span><span class="p">]</span> <span class="o">==</span> <span class="n">label</span><span class="p">),</span> <span class="kc">None</span><span class="p">)</span>
+    <span class="k">def</span><span class="w"> </span><span class="nf">find_all</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">condition</span><span class="p">):</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Find all instance types that match a condition.</span>
+<span class="sd">        Args:</span>
+<span class="sd">            condition (function): A function that takes an instance type and returns True or False.</span>
+<span class="sd">        Returns:</span>
+<span class="sd">            list: A list of instance types that match the condition.</span>
+<span class="sd">        Example:</span>
+<span class="sd">            &gt;&gt;&gt; from ciocore import data as coredata</span>
+<span class="sd">            &gt;&gt;&gt; coredata.init()</span>
+<span class="sd">            &gt;&gt;&gt; hardware_set = coredata.data()[&quot;instance_types&quot;]</span>
+<span class="sd">            &gt;&gt;&gt; hardware_set.find_all(lambda x: x[&quot;gpu&quot;])</span>
+<span class="sd">            [</span>
+<span class="sd">                {</span>
+<span class="sd">                    &quot;cores&quot;: 4,</span>
+<span class="sd">                    &quot;description&quot;: &quot;4 core, 15GB Mem (1 T4 Tensor GPU with 16GB Mem)&quot;,</span>
+<span class="sd">                    &quot;gpu&quot;: {</span>
+<span class="sd">                        &quot;gpu_architecture&quot;: &quot;NVIDIA Turing&quot;,</span>
+<span class="sd">                        &quot;gpu_count&quot;: 1,</span>
+<span class="sd">                        &quot;gpu_cuda_cores&quot;: 2560,</span>
+<span class="sd">                        &quot;gpu_memory&quot;: &quot;16&quot;,</span>
+<span class="sd">                        &quot;gpu_model&quot;: &quot;T4 Tensor&quot;,</span>
+<span class="sd">                        &quot;gpu_rt_cores&quot;: 0,</span>
+<span class="sd">                        &quot;gpu_tensor_cores&quot;: 0,</span>
+<span class="sd">                        &quot;total_gpu_cuda_cores&quot;: 2560,</span>
+<span class="sd">                        &quot;total_gpu_memory&quot;: &quot;16&quot;,</span>
+<span class="sd">                        &quot;total_gpu_rt_cores&quot;: 0,</span>
+<span class="sd">                        &quot;total_gpu_tensor_cores&quot;: 0,</span>
+<span class="sd">                    },</span>
+<span class="sd">                    &quot;memory&quot;: &quot;15&quot;,</span>
+<span class="sd">                    &quot;name&quot;: &quot;n1-standard-4-t4-1&quot;,</span>
+<span class="sd">                    &quot;operating_system&quot;: &quot;linux&quot;,</span>
+<span class="sd">                    &quot;categories&quot;: [{&quot;label&quot;: &quot;Low cores&quot;, &quot;order&quot;: 10}],</span>
+<span class="sd">                },</span>
+<span class="sd">                {</span>
+<span class="sd">                    &quot;cores&quot;: 8,</span>
+<span class="sd">                    &quot;description&quot;: &quot;8 core, 30GB Mem (1 T4 Tensor GPU with 16GB Mem)&quot;,</span>
+<span class="sd">                    &quot;gpu&quot;: {</span>
+<span class="sd">                        &quot;gpu_architecture&quot;: &quot;NVIDIA Turing&quot;,</span>
+<span class="sd">                        &quot;gpu_count&quot;: 1,</span>
+<span class="sd">                        &quot;gpu_cuda_cores&quot;: 2560,</span>
+<span class="sd">                        &quot;gpu_memory&quot;: &quot;16&quot;,</span>
+<span class="sd">                        &quot;gpu_model&quot;: &quot;T4 Tensor&quot;,</span>
+<span class="sd">                        &quot;gpu_rt_cores&quot;: 0,</span>
+<span class="sd">                        &quot;gpu_tensor_cores&quot;: 0,</span>
+<span class="sd">                        &quot;total_gpu_cuda_cores&quot;: 2560,</span>
+<span class="sd">                        &quot;total_gpu_memory&quot;: &quot;16&quot;,</span>
+<span class="sd">                        &quot;total_gpu_rt_cores&quot;: 0,</span>
+<span class="sd">                        &quot;total_gpu_tensor_cores&quot;: 0,</span>
+<span class="sd">                    },</span>
+<span class="sd">                    &quot;memory&quot;: &quot;30&quot;,</span>
+<span class="sd">                    &quot;name&quot;: &quot;n1-standard-8-t4-1&quot;,</span>
+<span class="sd">                    &quot;operating_system&quot;: &quot;linux&quot;,</span>
+<span class="sd">                    &quot;categories&quot;: [{&quot;label&quot;: &quot;Low cores&quot;, &quot;order&quot;: 10}],</span>
+<span class="sd">                },</span>
+<span class="sd">                ...</span>
+<span class="sd">            ]</span>
+<span class="sd">        &quot;&quot;&quot;</span>
+        <span class="n">result</span> <span class="o">=</span> <span class="p">[]</span>
+        <span class="k">for</span> <span class="n">key</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">instance_types</span><span class="p">:</span>
+            <span class="k">if</span> <span class="n">condition</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">instance_types</span><span class="p">[</span><span class="n">key</span><span class="p">]):</span>
+                <span class="n">result</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">instance_types</span><span class="p">[</span><span class="n">key</span><span class="p">])</span>
+        <span class="k">return</span> <span class="n">result</span>
+    <span class="k">def</span><span class="w"> </span><span class="nf">find_first</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">condition</span><span class="p">):</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Find the first instance type that matches a condition.</span>
+<span class="sd">        Please see find_all() above for more details. This method is just a convenience wrapper around find_all() that returns the first result or None if not found.</span>
+<span class="sd">        Args:</span>
+<span class="sd">            condition (function): A function that takes an instance type and returns True or False.</span>
+<span class="sd">        Returns:</span>
+<span class="sd">            dict: The first instance type that matches the condition or None if not found.</span>
+<span class="sd">        &quot;&quot;&quot;</span>
+        <span class="k">return</span> <span class="nb">next</span><span class="p">(</span><span class="nb">iter</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">find_all</span><span class="p">(</span><span class="n">condition</span><span class="p">)),</span> <span class="kc">None</span><span class="p">)</span>
+    <span class="c1"># DEPRECATED</span>
+    <span class="k">def</span><span class="w"> </span><span class="nf">get_model</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">with_misc</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Get the categories structure with renaming ready for some specific widget, such as a Qt Combobox.</span>
+<span class="sd">        Deprecated:</span>
+<span class="sd">            The get_model() method is deprecated. The `with_misc` parameter is no longer used, which means that this function only serves to rename a few keys. What&#39;s more, the init function ensures that every instance type has a category. This function is no longer needed. Submitters that use it will work but should be updated to use the categories structure directly as it minimizes the levels of indirection necessary to work with it.</span>
+<span class="sd">        &quot;&quot;&quot;</span>
+        <span class="k">if</span> <span class="n">with_misc</span><span class="p">:</span>
+            <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span><span class="s2">&quot;with_misc is no longer used&quot;</span><span class="p">)</span>
+        <span class="n">result</span> <span class="o">=</span> <span class="p">[]</span>
+        <span class="k">for</span> <span class="n">category</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">categories</span><span class="p">:</span>
+            <span class="n">result</span><span class="o">.</span><span class="n">append</span><span class="p">(</span>
+                <span class="p">{</span>
+                    <span class="s2">&quot;label&quot;</span><span class="p">:</span> <span class="n">category</span><span class="p">[</span><span class="s2">&quot;label&quot;</span><span class="p">],</span>
+                    <span class="s2">&quot;content&quot;</span><span class="p">:</span> <span class="p">[</span>
+                        <span class="p">{</span><span class="s2">&quot;label&quot;</span><span class="p">:</span> <span class="n">k</span><span class="p">[</span><span class="s2">&quot;description&quot;</span><span class="p">],</span> <span class="s2">&quot;value&quot;</span><span class="p">:</span> <span class="n">k</span><span class="p">[</span><span class="s2">&quot;name&quot;</span><span class="p">]}</span>
+                        <span class="k">for</span> <span class="n">k</span> <span class="ow">in</span> <span class="n">category</span><span class="p">[</span><span class="s2">&quot;content&quot;</span><span class="p">]</span>
+                    <span class="p">],</span>
+                <span class="p">}</span>
+            <span class="p">)</span>
+        <span class="k">return</span> <span class="n">result</span>
+    <span class="c1"># PRIVATE METHODS</span>
+    <span class="nd">@classmethod</span>
+    <span class="k">def</span><span class="w"> </span><span class="nf">_build_unique</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="n">instance_types</span><span class="p">):</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Build a dictionary of instance types using the name field as key. This allows fast lookup by name.</span>
+<span class="sd">        Args:</span>
+<span class="sd">            instance_types (list): A list of instance types.</span>
+<span class="sd">        Returns:</span>
+<span class="sd">            dict: A dictionary of instance types with the name field as key.</span>
+<span class="sd">        &quot;&quot;&quot;</span>
+        <span class="n">instance_types</span> <span class="o">=</span> <span class="bp">cls</span><span class="o">.</span><span class="n">_rewrite_descriptions</span><span class="p">(</span><span class="n">instance_types</span><span class="p">)</span>
+        <span class="n">categories</span> <span class="o">=</span> <span class="p">[</span>
+            <span class="n">category</span>
+            <span class="k">for</span> <span class="n">it</span> <span class="ow">in</span> <span class="n">instance_types</span>
+            <span class="k">for</span> <span class="n">category</span> <span class="ow">in</span> <span class="p">(</span><span class="n">it</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;categories&quot;</span><span class="p">)</span> <span class="ow">or</span> <span class="p">[])</span>
+        <span class="p">]</span>
+        <span class="n">result</span> <span class="o">=</span> <span class="p">{}</span>
+        <span class="k">for</span> <span class="n">it</span> <span class="ow">in</span> <span class="n">instance_types</span><span class="p">:</span>
+            <span class="n">is_gpu</span> <span class="o">=</span> <span class="n">it</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;gpu&quot;</span><span class="p">,</span> <span class="kc">False</span><span class="p">)</span>
+            <span class="k">if</span> <span class="n">categories</span><span class="p">:</span>
+                <span class="k">if</span> <span class="n">it</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;categories&quot;</span><span class="p">)</span> <span class="ow">in</span> <span class="p">[[],</span> <span class="kc">None</span><span class="p">]:</span>
+                    <span class="k">continue</span>
+            <span class="k">else</span><span class="p">:</span>
+                <span class="c1"># make our own categories GPU/CPU</span>
+                <span class="n">it</span><span class="p">[</span><span class="s2">&quot;categories&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="p">(</span>
+                    <span class="p">[{</span><span class="s2">&quot;label&quot;</span><span class="p">:</span> <span class="s2">&quot;GPU&quot;</span><span class="p">,</span> <span class="s2">&quot;order&quot;</span><span class="p">:</span> <span class="mi">2</span><span class="p">}]</span>
+                    <span class="k">if</span> <span class="n">is_gpu</span>
+                    <span class="k">else</span> <span class="p">[{</span><span class="s2">&quot;label&quot;</span><span class="p">:</span> <span class="s2">&quot;CPU&quot;</span><span class="p">,</span> <span class="s2">&quot;order&quot;</span><span class="p">:</span> <span class="mi">1</span><span class="p">}]</span>
+                <span class="p">)</span>
+            <span class="n">result</span><span class="p">[</span><span class="n">it</span><span class="p">[</span><span class="s2">&quot;name&quot;</span><span class="p">]]</span> <span class="o">=</span> <span class="n">it</span>
+        <span class="k">return</span> <span class="n">result</span>
+    <span class="nd">@classmethod</span>
+    <span class="k">def</span><span class="w"> </span><span class="nf">_rewrite_descriptions</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="n">instance_types</span><span class="p">):</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Rewrite the descriptions of the instance types.</span>
+<span class="sd">        If there are both OS types, then the descriptions are prefixed with the OS type.</span>
+<span class="sd">        Args:</span>
+<span class="sd">            instance_types (list): A list of instance types.</span>
+<span class="sd">        Returns:</span>
+<span class="sd">            list: A list of instance types with rewritten descriptions.</span>
+<span class="sd">        &quot;&quot;&quot;</span>
+        <span class="k">if</span> <span class="ow">not</span> <span class="n">instance_types</span><span class="p">:</span>
+            <span class="k">return</span> <span class="n">instance_types</span>
+        <span class="n">first_os</span> <span class="o">=</span> <span class="n">instance_types</span><span class="p">[</span><span class="mi">0</span><span class="p">][</span><span class="s2">&quot;operating_system&quot;</span><span class="p">]</span>
+        <span class="n">dual_platforms</span> <span class="o">=</span> <span class="nb">next</span><span class="p">((</span><span class="n">it</span> <span class="k">for</span> <span class="n">it</span> <span class="ow">in</span> <span class="n">instance_types</span> <span class="k">if</span> <span class="n">it</span><span class="p">[</span><span class="s2">&quot;operating_system&quot;</span><span class="p">]</span> <span class="o">!=</span> <span class="n">first_os</span><span class="p">),</span> <span class="kc">False</span><span class="p">)</span>
+        <span class="k">if</span> <span class="n">dual_platforms</span><span class="p">:</span>
+            <span class="k">for</span> <span class="n">it</span> <span class="ow">in</span> <span class="n">instance_types</span><span class="p">:</span>
+                <span class="n">flat_dict</span> <span class="o">=</span> <span class="n">flatten_dict</span><span class="p">(</span><span class="n">it</span><span class="p">)</span>
+                <span class="n">is_gpu</span> <span class="o">=</span> <span class="s2">&quot;gpu_count&quot;</span> <span class="ow">in</span> <span class="n">flat_dict</span>
+                <span class="k">if</span> <span class="n">is_gpu</span><span class="p">:</span>
+                    <span class="n">it</span><span class="p">[</span><span class="s2">&quot;description&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">DESCRIPTION_TEMPLATE_OS</span><span class="p">[</span><span class="s2">&quot;gpu&quot;</span><span class="p">]</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="o">**</span><span class="n">flat_dict</span><span class="p">)</span>
+                <span class="k">else</span><span class="p">:</span>
+                    <span class="n">it</span><span class="p">[</span><span class="s2">&quot;description&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">DESCRIPTION_TEMPLATE_OS</span><span class="p">[</span><span class="s2">&quot;cpu&quot;</span><span class="p">]</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="o">**</span><span class="n">flat_dict</span><span class="p">)</span>
+        <span class="k">else</span><span class="p">:</span>
+            <span class="k">for</span> <span class="n">it</span> <span class="ow">in</span> <span class="n">instance_types</span><span class="p">:</span>
+                <span class="n">flat_dict</span> <span class="o">=</span> <span class="n">flatten_dict</span><span class="p">(</span><span class="n">it</span><span class="p">)</span>
+                <span class="n">is_gpu</span> <span class="o">=</span> <span class="s2">&quot;gpu_count&quot;</span> <span class="ow">in</span> <span class="n">flat_dict</span>
+                <span class="k">if</span> <span class="n">is_gpu</span><span class="p">:</span>
+                    <span class="n">it</span><span class="p">[</span><span class="s2">&quot;description&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">DESCRIPTION_TEMPLATE</span><span class="p">[</span><span class="s2">&quot;gpu&quot;</span><span class="p">]</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="o">**</span><span class="n">flat_dict</span><span class="p">)</span>
+                <span class="k">else</span><span class="p">:</span>
+                    <span class="n">it</span><span class="p">[</span><span class="s2">&quot;description&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">DESCRIPTION_TEMPLATE</span><span class="p">[</span><span class="s2">&quot;cpu&quot;</span><span class="p">]</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="o">**</span><span class="n">flat_dict</span><span class="p">)</span>
+        <span class="k">return</span> <span class="n">instance_types</span>
+    <span class="k">def</span><span class="w"> </span><span class="nf">_build_categories</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Build a sorted list of categories where each category contains a sorted list of machines.</span>
+<span class="sd">        Returns:</span>
+<span class="sd">            list: A list of categories where each category is a dictionary with keys: `label`, `content`, and `order`.</span>
+<span class="sd">        &quot;&quot;&quot;</span>
+        <span class="n">dikt</span> <span class="o">=</span> <span class="p">{}</span>
+        <span class="k">for</span> <span class="n">key</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">instance_types</span><span class="p">:</span>
+            <span class="n">it</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">instance_types</span><span class="p">[</span><span class="n">key</span><span class="p">]</span>
+            <span class="n">categories</span> <span class="o">=</span> <span class="n">it</span><span class="p">[</span><span class="s2">&quot;categories&quot;</span><span class="p">]</span>
+            <span class="k">for</span> <span class="n">category</span> <span class="ow">in</span> <span class="n">categories</span><span class="p">:</span>
+                <span class="n">label</span> <span class="o">=</span> <span class="n">category</span><span class="p">[</span><span class="s2">&quot;label&quot;</span><span class="p">]</span>
+                <span class="k">if</span> <span class="n">label</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">dikt</span><span class="p">:</span>
+                    <span class="n">dikt</span><span class="p">[</span><span class="n">label</span><span class="p">]</span> <span class="o">=</span> <span class="p">{</span>
+                        <span class="s2">&quot;label&quot;</span><span class="p">:</span> <span class="n">label</span><span class="p">,</span>
+                        <span class="s2">&quot;content&quot;</span><span class="p">:</span> <span class="p">[],</span>
+                        <span class="s2">&quot;order&quot;</span><span class="p">:</span> <span class="n">category</span><span class="p">[</span><span class="s2">&quot;order&quot;</span><span class="p">],</span>
+                    <span class="p">}</span>
+                <span class="n">dikt</span><span class="p">[</span><span class="n">label</span><span class="p">][</span><span class="s2">&quot;content&quot;</span><span class="p">]</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">it</span><span class="p">)</span>
+        <span class="n">result</span> <span class="o">=</span> <span class="p">[]</span>
+        <span class="k">for</span> <span class="n">label</span> <span class="ow">in</span> <span class="n">dikt</span><span class="p">:</span>
+            <span class="n">category</span> <span class="o">=</span> <span class="n">dikt</span><span class="p">[</span><span class="n">label</span><span class="p">]</span>
+            <span class="n">category</span><span class="p">[</span><span class="s2">&quot;content&quot;</span><span class="p">]</span><span class="o">.</span><span class="n">sort</span><span class="p">(</span><span class="n">key</span><span class="o">=</span><span class="k">lambda</span> <span class="n">k</span><span class="p">:</span> <span class="p">(</span><span class="n">k</span><span class="p">[</span><span class="s2">&quot;cores&quot;</span><span class="p">],</span> <span class="n">k</span><span class="p">[</span><span class="s2">&quot;memory&quot;</span><span class="p">]))</span>
+            <span class="n">result</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">category</span><span class="p">)</span>
+        <span class="k">return</span> <span class="nb">sorted</span><span class="p">(</span><span class="n">result</span><span class="p">,</span> <span class="n">key</span><span class="o">=</span><span class="k">lambda</span> <span class="n">k</span><span class="p">:</span> <span class="n">k</span><span class="p">[</span><span class="s2">&quot;order&quot;</span><span class="p">])</span>
+    <span class="k">def</span><span class="w"> </span><span class="nf">_get_provider</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Get the provider from the first instance type.</span>
+<span class="sd">        Returns:</span>
+<span class="sd">            str: The provider.</span>
+<span class="sd">        &quot;&quot;&quot;</span>
+        <span class="n">first_name</span> <span class="o">=</span> <span class="nb">next</span><span class="p">(</span><span class="nb">iter</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">instance_types</span><span class="p">))</span>
+        <span class="k">if</span> <span class="ow">not</span> <span class="n">first_name</span><span class="p">:</span>
+            <span class="k">return</span> <span class="kc">None</span>
+        <span class="k">if</span> <span class="n">first_name</span><span class="o">.</span><span class="n">startswith</span><span class="p">(</span><span class="s2">&quot;cw-&quot;</span><span class="p">):</span>
+            <span class="k">return</span> <span class="s2">&quot;cw&quot;</span>
+        <span class="k">if</span> <span class="s2">&quot;.&quot;</span> <span class="ow">in</span> <span class="n">first_name</span><span class="p">:</span>
+            <span class="k">return</span> <span class="s2">&quot;aws&quot;</span>
+        <span class="k">return</span> <span class="s2">&quot;gcp&quot;</span>
+</code></pre></div>
+        </details>
+  <div class="doc doc-children">
+  <div class="doc doc-object doc-method">
+<h3 id="ciocore.hardware_set.HardwareSet.__init__" class="doc doc-heading">
+<code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">instance_types</span><span class="p">)</span></code>
+  <span class="doc doc-properties">
+      <small class="doc doc-property doc-property-special"><code>special</code></small>
+  </span>
+</h3>
+    <div class="doc doc-contents ">
+      <p>Initialize the HardwareSet with a list of instance types.
+Typically, you would access the HardwareSet through the ciocore.data.data() function, which initializes it for you. However, you can also initialize it directly with a list of instance types straight from ciocore.api_client. The difference being that the latter contains all instance types, whereas the former contains only the instance types compatible with the products you have specified, as well as being cached.</p>
+<p><strong>Parameters:</strong></p>
+<table>
+  <thead>
+    <tr>
+      <th>Name</th>
+      <th>Type</th>
+      <th>Description</th>
+      <th>Default</th>
+    </tr>
+  </thead>
+  <tbody>
+      <tr>
+        <td><code>instance_types</code></td>
+        <td><code>list</code></td>
+        <td><p>A list of instance types.</p></td>
+        <td><em>required</em></td>
+      </tr>
+  </tbody>
+</table>
+<p><strong>Returns:</strong></p>
+<table>
+  <thead>
+    <tr>
+      <th>Type</th>
+      <th>Description</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td><code>HardwareSet</code></td>
+      <td><p>The initialized HardwareSet.</p></td>
+    </tr>
+  </tbody>
+</table>
+<p><strong>Examples:</strong></p>
+    <h6 id="ciocore.hardware_set.HardwareSet.__init__--initialize-with-a-list-of-instance-types">Initialize with a list of instance types</h6>
+    <div class="highlight"><pre><span></span><code><span class="o">&gt;&gt;&gt;</span> <span class="kn">from</span><span class="w"> </span><span class="nn">ciocore</span><span class="w"> </span><span class="kn">import</span> <span class="n">api_client</span>
+<span class="o">&gt;&gt;&gt;</span> <span class="kn">from</span><span class="w"> </span><span class="nn">ciocore.hardware_set</span><span class="w"> </span><span class="kn">import</span> <span class="n">HardwareSet</span>
+<span class="o">&gt;&gt;&gt;</span> <span class="n">instance_types</span> <span class="o">=</span> <span class="n">api_client</span><span class="o">.</span><span class="n">request_instance_types</span><span class="p">()</span>
+<span class="o">&gt;&gt;&gt;</span> <span class="n">hardware_set</span> <span class="o">=</span> <span class="n">HardwareSet</span><span class="p">(</span><span class="n">instance_types</span><span class="p">)</span>
+<span class="o">&lt;</span><span class="n">ciocore</span><span class="o">.</span><span class="n">hardware_set</span><span class="o">.</span><span class="n">HardwareSet</span> <span class="nb">object</span> <span class="n">at</span> <span class="mh">0x104c43d30</span><span class="o">&gt;</span>
+</code></pre></div>
+    <h6 id="ciocore.hardware_set.HardwareSet.__init__--initialize-implicitly-with-a-list-of-instance-types-from-ciocoredata-recommended">Initialize implicitly with a list of instance types from ciocore.data (recommended).</h6>
+    <div class="highlight"><pre><span></span><code><span class="o">&gt;&gt;&gt;</span> <span class="kn">from</span><span class="w"> </span><span class="nn">ciocore</span><span class="w"> </span><span class="kn">import</span> <span class="n">data</span> <span class="k">as</span> <span class="n">coredata</span>
+<span class="o">&gt;&gt;&gt;</span> <span class="n">coredata</span><span class="o">.</span><span class="n">init</span><span class="p">(</span><span class="s2">&quot;cinema4d&quot;</span><span class="p">)</span>
+<span class="o">&gt;&gt;&gt;</span> <span class="n">hardware_set</span> <span class="o">=</span> <span class="n">coredata</span><span class="o">.</span><span class="n">data</span><span class="p">()[</span><span class="s2">&quot;instance_types&quot;</span><span class="p">]</span>
+<span class="o">&lt;</span><span class="n">ciocore</span><span class="o">.</span><span class="n">hardware_set</span><span class="o">.</span><span class="n">HardwareSet</span> <span class="nb">object</span> <span class="n">at</span> <span class="mh">0x104c43ee0</span><span class="o">&gt;</span>
+</code></pre></div>
+    <div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>To avoid repetition, we use the implicit initialization for the examples below.</p>
+</div>
+        <details class="quote">
+          <summary>Source code in <code>ciocore/hardware_set.py</code></summary>
+          <div class="highlight"><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">instance_types</span><span class="p">):</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;Initialize the HardwareSet with a list of instance types.</span>
+<span class="sd">    Typically, you would access the HardwareSet through the ciocore.data.data() function, which initializes it for you. However, you can also initialize it directly with a list of instance types straight from ciocore.api_client. The difference being that the latter contains all instance types, whereas the former contains only the instance types compatible with the products you have specified, as well as being cached.</span>
+<span class="sd">    Args:</span>
+<span class="sd">        instance_types (list): A list of instance types.</span>
+<span class="sd">    Returns:</span>
+<span class="sd">        HardwareSet: The initialized HardwareSet.</span>
+<span class="sd">    Examples:</span>
+<span class="sd">        ### Initialize with a list of instance types</span>
+<span class="sd">        &gt;&gt;&gt; from ciocore import api_client</span>
+<span class="sd">        &gt;&gt;&gt; from ciocore.hardware_set import HardwareSet</span>
+<span class="sd">        &gt;&gt;&gt; instance_types = api_client.request_instance_types()</span>
+<span class="sd">        &gt;&gt;&gt; hardware_set = HardwareSet(instance_types)</span>
+<span class="sd">        &lt;ciocore.hardware_set.HardwareSet object at 0x104c43d30&gt;</span>
+<span class="sd">        ### Initialize implicitly with a list of instance types from ciocore.data (recommended).</span>
+<span class="sd">        &gt;&gt;&gt; from ciocore import data as coredata</span>
+<span class="sd">        &gt;&gt;&gt; coredata.init(&quot;cinema4d&quot;)</span>
+<span class="sd">        &gt;&gt;&gt; hardware_set = coredata.data()[&quot;instance_types&quot;]</span>
+<span class="sd">        &lt;ciocore.hardware_set.HardwareSet object at 0x104c43ee0&gt;</span>
+<span class="sd">        !!! note</span>
+<span class="sd">            To avoid repetition, we use the implicit initialization for the examples below.</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+    <span class="bp">self</span><span class="o">.</span><span class="n">instance_types</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_build_unique</span><span class="p">(</span><span class="n">instance_types</span><span class="p">)</span>
+    <span class="bp">self</span><span class="o">.</span><span class="n">categories</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_build_categories</span><span class="p">()</span>
+    <span class="bp">self</span><span class="o">.</span><span class="n">provider</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_get_provider</span><span class="p">()</span>
+</code></pre></div>
+        </details>
+    </div>
+  </div>
+  <div class="doc doc-object doc-method">
+<h3 id="ciocore.hardware_set.HardwareSet.labels" class="doc doc-heading">
+<code class="highlight language-python"><span class="n">labels</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span></code>
+</h3>
+    <div class="doc doc-contents ">
+      <p>Get the list of category labels.</p>
+<p><strong>Returns:</strong></p>
+<table>
+  <thead>
+    <tr>
+      <th>Type</th>
+      <th>Description</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td><code>list</code></td>
+      <td><p>A list of category labels.</p></td>
+    </tr>
+  </tbody>
+</table>
+<p><strong>Examples:</strong></p>
+    <div class="highlight"><pre><span></span><code><span class="o">&gt;&gt;&gt;</span> <span class="kn">from</span><span class="w"> </span><span class="nn">ciocore</span><span class="w"> </span><span class="kn">import</span> <span class="n">data</span> <span class="k">as</span> <span class="n">coredata</span>
+<span class="o">&gt;&gt;&gt;</span> <span class="n">coredata</span><span class="o">.</span><span class="n">init</span><span class="p">()</span>
+<span class="o">&gt;&gt;&gt;</span> <span class="n">hardware_set</span> <span class="o">=</span> <span class="n">coredata</span><span class="o">.</span><span class="n">data</span><span class="p">()[</span><span class="s2">&quot;instance_types&quot;</span><span class="p">]</span>
+<span class="o">&gt;&gt;&gt;</span> <span class="n">hardware_set</span><span class="o">.</span><span class="n">labels</span><span class="p">()</span>
+<span class="p">[</span><span class="s1">&#39;CPU&#39;</span><span class="p">,</span> <span class="s1">&#39;GPU&#39;</span><span class="p">]</span>
+</code></pre></div>
+        <details class="quote">
+          <summary>Source code in <code>ciocore/hardware_set.py</code></summary>
+          <div class="highlight"><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">labels</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;Get the list of category labels.</span>
+<span class="sd">    Returns:</span>
+<span class="sd">        list: A list of category labels.</span>
+<span class="sd">    Example:</span>
+<span class="sd">        &gt;&gt;&gt; from ciocore import data as coredata</span>
+<span class="sd">        &gt;&gt;&gt; coredata.init()</span>
+<span class="sd">        &gt;&gt;&gt; hardware_set = coredata.data()[&quot;instance_types&quot;]</span>
+<span class="sd">        &gt;&gt;&gt; hardware_set.labels()</span>
+<span class="sd">        [&#39;CPU&#39;, &#39;GPU&#39;]</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+    <span class="k">return</span> <span class="p">[</span><span class="n">c</span><span class="p">[</span><span class="s2">&quot;label&quot;</span><span class="p">]</span> <span class="k">for</span> <span class="n">c</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">categories</span><span class="p">]</span>
+</code></pre></div>
+        </details>
+    </div>
+  </div>
+  <div class="doc doc-object doc-method">
+<h3 id="ciocore.hardware_set.HardwareSet.number_of_categories" class="doc doc-heading">
+<code class="highlight language-python"><span class="n">number_of_categories</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span></code>
+</h3>
+    <div class="doc doc-contents ">
+      <p>Get the number of categories in the data.</p>
+<p><strong>Returns:</strong></p>
+<table>
+  <thead>
+    <tr>
+      <th>Type</th>
+      <th>Description</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td><code>int</code></td>
+      <td><p>The number of categories.</p></td>
+    </tr>
+  </tbody>
+</table>
+<p><strong>Examples:</strong></p>
+    <div class="highlight"><pre><span></span><code><span class="o">&gt;&gt;&gt;</span> <span class="kn">from</span><span class="w"> </span><span class="nn">ciocore</span><span class="w"> </span><span class="kn">import</span> <span class="n">data</span> <span class="k">as</span> <span class="n">coredata</span>
+<span class="o">&gt;&gt;&gt;</span> <span class="n">coredata</span><span class="o">.</span><span class="n">init</span><span class="p">()</span>
+<span class="o">&gt;&gt;&gt;</span> <span class="n">hardware_set</span> <span class="o">=</span> <span class="n">coredata</span><span class="o">.</span><span class="n">data</span><span class="p">()[</span><span class="s2">&quot;instance_types&quot;</span><span class="p">]</span>
+<span class="o">&gt;&gt;&gt;</span> <span class="n">hardware_set</span><span class="o">.</span><span class="n">number_of_categories</span><span class="p">()</span>
+<span class="mi">2</span>
+</code></pre></div>
+        <details class="quote">
+          <summary>Source code in <code>ciocore/hardware_set.py</code></summary>
+          <div class="highlight"><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">number_of_categories</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;Get the number of categories in the data.</span>
+<span class="sd">    Returns:</span>
+<span class="sd">        int: The number of categories.</span>
+<span class="sd">    Example:</span>
+<span class="sd">        &gt;&gt;&gt; from ciocore import data as coredata</span>
+<span class="sd">        &gt;&gt;&gt; coredata.init()</span>
+<span class="sd">        &gt;&gt;&gt; hardware_set = coredata.data()[&quot;instance_types&quot;]</span>
+<span class="sd">        &gt;&gt;&gt; hardware_set.number_of_categories()</span>
+<span class="sd">        2</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+    <span class="k">return</span> <span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">categories</span><span class="p">)</span>
+</code></pre></div>
+        </details>
+    </div>
+  </div>
+  <div class="doc doc-object doc-method">
+<h3 id="ciocore.hardware_set.HardwareSet.recategorize" class="doc doc-heading">
+<code class="highlight language-python"><span class="n">recategorize</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">partitioner</span><span class="p">)</span></code>
+</h3>
+    <div class="doc doc-contents ">
+      <p>Recategorize the instance types.</p>
+<p><strong>Parameters:</strong></p>
+<table>
+  <thead>
+    <tr>
+      <th>Name</th>
+      <th>Type</th>
+      <th>Description</th>
+      <th>Default</th>
+    </tr>
+  </thead>
+  <tbody>
+      <tr>
+        <td><code>partitioner</code></td>
+        <td><code>function</code></td>
+        <td><p>A function that takes an instance type and returns a list of categories to assign to it. The function should return an empty list if the instance type should not be categorized.</p></td>
+        <td><em>required</em></td>
+      </tr>
+  </tbody>
+</table>
+<p><strong>Examples:</strong></p>
+    <h4 id="ciocore.hardware_set.HardwareSet.recategorize--confirm-current-categories">Confirm current categories</h4>
+    <div class="highlight"><pre><span></span><code><span class="o">&gt;&gt;&gt;</span> <span class="kn">from</span><span class="w"> </span><span class="nn">ciocore</span><span class="w"> </span><span class="kn">import</span> <span class="n">data</span> <span class="k">as</span> <span class="n">coredata</span>
+<span class="o">&gt;&gt;&gt;</span> <span class="n">coredata</span><span class="o">.</span><span class="n">init</span><span class="p">()</span>
+<span class="o">&gt;&gt;&gt;</span> <span class="n">hardware_set</span> <span class="o">=</span> <span class="n">coredata</span><span class="o">.</span><span class="n">data</span><span class="p">()[</span><span class="s2">&quot;instance_types&quot;</span><span class="p">]</span>
+<span class="o">&gt;&gt;&gt;</span> <span class="nb">print</span><span class="p">(</span><span class="n">hardware_set</span><span class="o">.</span><span class="n">labels</span><span class="p">()</span>
+<span class="p">[</span><span class="s1">&#39;CPU&#39;</span><span class="p">,</span> <span class="s1">&#39;GPU&#39;</span><span class="p">]</span>
+</code></pre></div>
+    <h4 id="ciocore.hardware_set.HardwareSet.recategorize--recategorize">Recategorize</h4>
+    <div class="highlight"><pre><span></span><code><span class="o">&gt;&gt;&gt;</span> <span class="n">hardware_set</span><span class="o">.</span><span class="n">recategorize</span><span class="p">(</span><span class="k">lambda</span> <span class="n">x</span><span class="p">:</span> <span class="p">[{</span><span class="s1">&#39;label&#39;</span><span class="p">:</span> <span class="s1">&#39;Low cores&#39;</span><span class="p">,</span> <span class="s1">&#39;order&#39;</span><span class="p">:</span> <span class="mi">10</span><span class="p">}]</span> <span class="k">if</span>  <span class="n">x</span><span class="p">[</span><span class="s2">&quot;cores&quot;</span><span class="p">]</span> <span class="o">&lt;</span> <span class="mi">16</span> <span class="k">else</span> <span class="p">[{</span><span class="s1">&#39;label&#39;</span><span class="p">:</span> <span class="s1">&#39;High cores&#39;</span><span class="p">,</span> <span class="s1">&#39;order&#39;</span><span class="p">:</span> <span class="mi">20</span><span class="p">}])</span>
+<span class="o">&gt;&gt;&gt;</span> <span class="nb">print</span><span class="p">(</span><span class="n">hardware_set</span><span class="o">.</span><span class="n">labels</span><span class="p">()</span>
+<span class="p">[</span><span class="s1">&#39;Low cores&#39;</span><span class="p">,</span> <span class="s1">&#39;High cores&#39;</span><span class="p">]</span>
+</code></pre></div>
+        <details class="quote">
+          <summary>Source code in <code>ciocore/hardware_set.py</code></summary>
+          <div class="highlight"><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">recategorize</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">partitioner</span><span class="p">):</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;Recategorize the instance types.</span>
+<span class="sd">    Args:</span>
+<span class="sd">        partitioner (function): A function that takes an instance type and returns a list of categories to assign to it. The function should return an empty list if the instance type should not be categorized.</span>
+<span class="sd">    Example:</span>
+<span class="sd">        # Confirm current categories</span>
+<span class="sd">        &gt;&gt;&gt; from ciocore import data as coredata</span>
+<span class="sd">        &gt;&gt;&gt; coredata.init()</span>
+<span class="sd">        &gt;&gt;&gt; hardware_set = coredata.data()[&quot;instance_types&quot;]</span>
+<span class="sd">        &gt;&gt;&gt; print(hardware_set.labels()</span>
+<span class="sd">        [&#39;CPU&#39;, &#39;GPU&#39;]</span>
+<span class="sd">        # Recategorize</span>
+<span class="sd">        &gt;&gt;&gt; hardware_set.recategorize(lambda x: [{&#39;label&#39;: &#39;Low cores&#39;, &#39;order&#39;: 10}] if  x[&quot;cores&quot;] &lt; 16 else [{&#39;label&#39;: &#39;High cores&#39;, &#39;order&#39;: 20}])</span>
+<span class="sd">        &gt;&gt;&gt; print(hardware_set.labels()</span>
+<span class="sd">        [&#39;Low cores&#39;, &#39;High cores&#39;]</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+    <span class="k">for</span> <span class="n">key</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">instance_types</span><span class="p">:</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">instance_types</span><span class="p">[</span><span class="n">key</span><span class="p">][</span><span class="s2">&quot;categories&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">partitioner</span><span class="p">(</span>
+            <span class="bp">self</span><span class="o">.</span><span class="n">instance_types</span><span class="p">[</span><span class="n">key</span><span class="p">]</span>
+        <span class="p">)</span>
+    <span class="bp">self</span><span class="o">.</span><span class="n">categories</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_build_categories</span><span class="p">()</span>
+</code></pre></div>
+        </details>
+    </div>
+  </div>
+  <div class="doc doc-object doc-method">
+<h3 id="ciocore.hardware_set.HardwareSet.find" class="doc doc-heading">
+<code class="highlight language-python"><span class="n">find</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">,</span> <span class="n">category</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+</h3>
+    <div class="doc doc-contents ">
+      <p>Find an instance type by its name (sku).</p>
+<p><strong>Parameters:</strong></p>
+<table>
+  <thead>
+    <tr>
+      <th>Name</th>
+      <th>Type</th>
+      <th>Description</th>
+      <th>Default</th>
+    </tr>
+  </thead>
+  <tbody>
+      <tr>
+        <td><code>name</code></td>
+        <td><code>str</code></td>
+        <td><p>The name of the instance type.</p></td>
+        <td><em>required</em></td>
+      </tr>
+  </tbody>
+</table>
+<p><strong>Returns:</strong></p>
+<table>
+  <thead>
+    <tr>
+      <th>Type</th>
+      <th>Description</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td><code>dict</code></td>
+      <td><p>The instance type or None if not found.</p></td>
+    </tr>
+  </tbody>
+</table>
+<p><strong>Examples:</strong></p>
+    <div class="highlight"><pre><span></span><code><span class="o">&gt;&gt;&gt;</span> <span class="kn">from</span><span class="w"> </span><span class="nn">ciocore</span><span class="w"> </span><span class="kn">import</span> <span class="n">data</span> <span class="k">as</span> <span class="n">coredata</span>
+<span class="o">&gt;&gt;&gt;</span> <span class="n">coredata</span><span class="o">.</span><span class="n">init</span><span class="p">()</span>
+<span class="o">&gt;&gt;&gt;</span> <span class="n">hardware_set</span> <span class="o">=</span> <span class="n">coredata</span><span class="o">.</span><span class="n">data</span><span class="p">()[</span><span class="s2">&quot;instance_types&quot;</span><span class="p">]</span>
+<span class="o">&gt;&gt;&gt;</span> <span class="n">hardware_set</span><span class="o">.</span><span class="n">find</span><span class="p">(</span><span class="s2">&quot;n2-highmem-80&quot;</span><span class="p">)</span>
+<span class="p">{</span>
+    <span class="s1">&#39;cores&#39;</span><span class="p">:</span> <span class="mi">80</span><span class="p">,</span>
+    <span class="s1">&#39;description&#39;</span><span class="p">:</span> <span class="s1">&#39;80 core, 640GB Mem&#39;</span><span class="p">,</span>
+    <span class="s1">&#39;gpu&#39;</span><span class="p">:</span> <span class="kc">None</span><span class="p">,</span>
+    <span class="s1">&#39;memory&#39;</span><span class="p">:</span> <span class="s1">&#39;640&#39;</span><span class="p">,</span>
+    <span class="s1">&#39;name&#39;</span><span class="p">:</span> <span class="s1">&#39;n2-highmem-80&#39;</span><span class="p">,</span>
+    <span class="s1">&#39;operating_system&#39;</span><span class="p">:</span> <span class="s1">&#39;linux&#39;</span><span class="p">,</span>
+    <span class="s1">&#39;categories&#39;</span><span class="p">:</span> <span class="p">[</span>
+        <span class="p">{</span><span class="s1">&#39;label&#39;</span><span class="p">:</span> <span class="s1">&#39;High cores&#39;</span><span class="p">,</span> <span class="s1">&#39;order&#39;</span><span class="p">:</span> <span class="mi">20</span><span class="p">}</span>
+    <span class="p">]</span>
+<span class="p">}</span>
+</code></pre></div>
+        <details class="quote">
+          <summary>Source code in <code>ciocore/hardware_set.py</code></summary>
+          <div class="highlight"><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">find</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">,</span> <span class="n">category</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;Find an instance type by its name (sku).</span>
+<span class="sd">    Args:</span>
+<span class="sd">        name (str): The name of the instance type.</span>
+<span class="sd">    Returns:</span>
+<span class="sd">        dict: The instance type or None if not found.</span>
+<span class="sd">    Example:</span>
+<span class="sd">        &gt;&gt;&gt; from ciocore import data as coredata</span>
+<span class="sd">        &gt;&gt;&gt; coredata.init()</span>
+<span class="sd">        &gt;&gt;&gt; hardware_set = coredata.data()[&quot;instance_types&quot;]</span>
+<span class="sd">        &gt;&gt;&gt; hardware_set.find(&quot;n2-highmem-80&quot;)</span>
+<span class="sd">        {</span>
+<span class="sd">            &#39;cores&#39;: 80,</span>
+<span class="sd">            &#39;description&#39;: &#39;80 core, 640GB Mem&#39;,</span>
+<span class="sd">            &#39;gpu&#39;: None,</span>
+<span class="sd">            &#39;memory&#39;: &#39;640&#39;,</span>
+<span class="sd">            &#39;name&#39;: &#39;n2-highmem-80&#39;,</span>
+<span class="sd">            &#39;operating_system&#39;: &#39;linux&#39;,</span>
+<span class="sd">            &#39;categories&#39;: [</span>
+<span class="sd">                {&#39;label&#39;: &#39;High cores&#39;, &#39;order&#39;: 20}</span>
+<span class="sd">            ]</span>
+<span class="sd">        }</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+    <span class="k">if</span> <span class="ow">not</span> <span class="n">category</span><span class="p">:</span>
+        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">instance_types</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">name</span><span class="p">)</span>
+    <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">find_first</span><span class="p">(</span>
+        <span class="k">lambda</span> <span class="n">x</span><span class="p">:</span> <span class="n">x</span><span class="p">[</span><span class="s2">&quot;name&quot;</span><span class="p">]</span> <span class="o">==</span> <span class="n">name</span>
+        <span class="ow">and</span> <span class="n">category</span> <span class="ow">in</span> <span class="p">[</span><span class="n">c</span><span class="p">[</span><span class="s2">&quot;label&quot;</span><span class="p">]</span> <span class="k">for</span> <span class="n">c</span> <span class="ow">in</span> <span class="n">x</span><span class="p">[</span><span class="s2">&quot;categories&quot;</span><span class="p">]]</span>
+    <span class="p">)</span>
+</code></pre></div>
+        </details>
+    </div>
+  </div>
+  <div class="doc doc-object doc-method">
+<h3 id="ciocore.hardware_set.HardwareSet.find_category" class="doc doc-heading">
+<code class="highlight language-python"><span class="n">find_category</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">label</span><span class="p">)</span></code>
+</h3>
+    <div class="doc doc-contents ">
+      <p>Find a category by label.</p>
+<p><strong>Parameters:</strong></p>
+<table>
+  <thead>
+    <tr>
+      <th>Name</th>
+      <th>Type</th>
+      <th>Description</th>
+      <th>Default</th>
+    </tr>
+  </thead>
+  <tbody>
+      <tr>
+        <td><code>label</code></td>
+        <td><code>str</code></td>
+        <td><p>The label of the category.</p></td>
+        <td><em>required</em></td>
+      </tr>
+  </tbody>
+</table>
+<p><strong>Returns:</strong></p>
+<table>
+  <thead>
+    <tr>
+      <th>Type</th>
+      <th>Description</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td><code>dict</code></td>
+      <td><p>The category or None if not found.</p></td>
+    </tr>
+  </tbody>
+</table>
+<p><strong>Examples:</strong></p>
+    <div class="highlight"><pre><span></span><code><span class="o">&gt;&gt;&gt;</span> <span class="kn">from</span><span class="w"> </span><span class="nn">ciocore</span><span class="w"> </span><span class="kn">import</span> <span class="n">data</span> <span class="k">as</span> <span class="n">coredata</span>
+<span class="o">&gt;&gt;&gt;</span> <span class="n">coredata</span><span class="o">.</span><span class="n">init</span><span class="p">()</span>
+<span class="o">&gt;&gt;&gt;</span> <span class="n">hardware_set</span> <span class="o">=</span> <span class="n">coredata</span><span class="o">.</span><span class="n">data</span><span class="p">()[</span><span class="s2">&quot;instance_types&quot;</span><span class="p">]</span>
+<span class="o">&gt;&gt;&gt;</span> <span class="n">hardware_set</span><span class="o">.</span><span class="n">find_category</span><span class="p">(</span><span class="s2">&quot;High cores&quot;</span><span class="p">)</span>
+<span class="p">{</span>
+    <span class="s2">&quot;label&quot;</span><span class="p">:</span> <span class="s2">&quot;Low cores&quot;</span><span class="p">,</span>
+    <span class="s2">&quot;content&quot;</span><span class="p">:</span> <span class="p">[</span>
+        <span class="p">{</span>
+            <span class="s2">&quot;cores&quot;</span><span class="p">:</span> <span class="mi">8</span><span class="p">,</span>
+            <span class="s2">&quot;description&quot;</span><span class="p">:</span> <span class="s2">&quot;8 core, 52GB Mem&quot;</span><span class="p">,</span>
+            <span class="s2">&quot;gpu&quot;</span><span class="p">:</span> <span class="kc">None</span><span class="p">,</span>
+            <span class="s2">&quot;memory&quot;</span><span class="p">:</span> <span class="s2">&quot;52&quot;</span><span class="p">,</span>
+            <span class="s2">&quot;name&quot;</span><span class="p">:</span> <span class="s2">&quot;n1-highmem-8&quot;</span><span class="p">,</span>
+            <span class="s2">&quot;operating_system&quot;</span><span class="p">:</span> <span class="s2">&quot;linux&quot;</span><span class="p">,</span>
+            <span class="s2">&quot;categories&quot;</span><span class="p">:</span> <span class="p">[{</span><span class="s2">&quot;label&quot;</span><span class="p">:</span> <span class="s2">&quot;Low cores&quot;</span><span class="p">,</span> <span class="s2">&quot;order&quot;</span><span class="p">:</span> <span class="mi">10</span><span class="p">}],</span>
+        <span class="p">},</span>
+        <span class="p">{</span>
+            <span class="s2">&quot;cores&quot;</span><span class="p">:</span> <span class="mi">8</span><span class="p">,</span>
+            <span class="s2">&quot;description&quot;</span><span class="p">:</span> <span class="s2">&quot;8 core, 7.2GB Mem&quot;</span><span class="p">,</span>
+            <span class="s2">&quot;gpu&quot;</span><span class="p">:</span> <span class="kc">None</span><span class="p">,</span>
+            <span class="s2">&quot;memory&quot;</span><span class="p">:</span> <span class="s2">&quot;7.2&quot;</span><span class="p">,</span>
+            <span class="s2">&quot;name&quot;</span><span class="p">:</span> <span class="s2">&quot;n1-highcpu-8&quot;</span><span class="p">,</span>
+            <span class="s2">&quot;operating_system&quot;</span><span class="p">:</span> <span class="s2">&quot;linux&quot;</span><span class="p">,</span>
+            <span class="s2">&quot;categories&quot;</span><span class="p">:</span> <span class="p">[{</span><span class="s2">&quot;label&quot;</span><span class="p">:</span> <span class="s2">&quot;Low cores&quot;</span><span class="p">,</span> <span class="s2">&quot;order&quot;</span><span class="p">:</span> <span class="mi">10</span><span class="p">}],</span>
+        <span class="p">},</span>
+        <span class="o">...</span>
+    <span class="p">],</span>
+    <span class="s2">&quot;order&quot;</span><span class="p">:</span> <span class="mi">10</span>
+<span class="p">}</span>
+</code></pre></div>
+        <details class="quote">
+          <summary>Source code in <code>ciocore/hardware_set.py</code></summary>
+          <div class="highlight"><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">find_category</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">label</span><span class="p">):</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;Find a category by label.</span>
+<span class="sd">    Args:</span>
+<span class="sd">        label (str): The label of the category.</span>
+<span class="sd">    Returns:</span>
+<span class="sd">        dict: The category or None if not found.</span>
+<span class="sd">    Example:</span>
+<span class="sd">        &gt;&gt;&gt; from ciocore import data as coredata</span>
+<span class="sd">        &gt;&gt;&gt; coredata.init()</span>
+<span class="sd">        &gt;&gt;&gt; hardware_set = coredata.data()[&quot;instance_types&quot;]</span>
+<span class="sd">        &gt;&gt;&gt; hardware_set.find_category(&quot;High cores&quot;)</span>
+<span class="sd">        {</span>
+<span class="sd">            &quot;label&quot;: &quot;Low cores&quot;,</span>
+<span class="sd">            &quot;content&quot;: [</span>
+<span class="sd">                {</span>
+<span class="sd">                    &quot;cores&quot;: 8,</span>
+<span class="sd">                    &quot;description&quot;: &quot;8 core, 52GB Mem&quot;,</span>
+<span class="sd">                    &quot;gpu&quot;: None,</span>
+<span class="sd">                    &quot;memory&quot;: &quot;52&quot;,</span>
+<span class="sd">                    &quot;name&quot;: &quot;n1-highmem-8&quot;,</span>
+<span class="sd">                    &quot;operating_system&quot;: &quot;linux&quot;,</span>
+<span class="sd">                    &quot;categories&quot;: [{&quot;label&quot;: &quot;Low cores&quot;, &quot;order&quot;: 10}],</span>
+<span class="sd">                },</span>
+<span class="sd">                {</span>
+<span class="sd">                    &quot;cores&quot;: 8,</span>
+<span class="sd">                    &quot;description&quot;: &quot;8 core, 7.2GB Mem&quot;,</span>
+<span class="sd">                    &quot;gpu&quot;: None,</span>
+<span class="sd">                    &quot;memory&quot;: &quot;7.2&quot;,</span>
+<span class="sd">                    &quot;name&quot;: &quot;n1-highcpu-8&quot;,</span>
+<span class="sd">                    &quot;operating_system&quot;: &quot;linux&quot;,</span>
+<span class="sd">                    &quot;categories&quot;: [{&quot;label&quot;: &quot;Low cores&quot;, &quot;order&quot;: 10}],</span>
+<span class="sd">                },</span>
+<span class="sd">                ...</span>
+<span class="sd">            ],</span>
+<span class="sd">            &quot;order&quot;: 10</span>
+<span class="sd">        }</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+    <span class="k">return</span> <span class="nb">next</span><span class="p">((</span><span class="n">c</span> <span class="k">for</span> <span class="n">c</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">categories</span> <span class="k">if</span> <span class="n">c</span><span class="p">[</span><span class="s2">&quot;label&quot;</span><span class="p">]</span> <span class="o">==</span> <span class="n">label</span><span class="p">),</span> <span class="kc">None</span><span class="p">)</span>
+</code></pre></div>
+        </details>
+    </div>
+  </div>
+  <div class="doc doc-object doc-method">
+<h3 id="ciocore.hardware_set.HardwareSet.find_all" class="doc doc-heading">
+<code class="highlight language-python"><span class="n">find_all</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">condition</span><span class="p">)</span></code>
+</h3>
+    <div class="doc doc-contents ">
+      <p>Find all instance types that match a condition.</p>
+<p><strong>Parameters:</strong></p>
+<table>
+  <thead>
+    <tr>
+      <th>Name</th>
+      <th>Type</th>
+      <th>Description</th>
+      <th>Default</th>
+    </tr>
+  </thead>
+  <tbody>
+      <tr>
+        <td><code>condition</code></td>
+        <td><code>function</code></td>
+        <td><p>A function that takes an instance type and returns True or False.</p></td>
+        <td><em>required</em></td>
+      </tr>
+  </tbody>
+</table>
+<p><strong>Returns:</strong></p>
+<table>
+  <thead>
+    <tr>
+      <th>Type</th>
+      <th>Description</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td><code>list</code></td>
+      <td><p>A list of instance types that match the condition.</p></td>
+    </tr>
+  </tbody>
+</table>
+<p><strong>Examples:</strong></p>
+    <div class="highlight"><pre><span></span><code><span class="o">&gt;&gt;&gt;</span> <span class="kn">from</span><span class="w"> </span><span class="nn">ciocore</span><span class="w"> </span><span class="kn">import</span> <span class="n">data</span> <span class="k">as</span> <span class="n">coredata</span>
+<span class="o">&gt;&gt;&gt;</span> <span class="n">coredata</span><span class="o">.</span><span class="n">init</span><span class="p">()</span>
+<span class="o">&gt;&gt;&gt;</span> <span class="n">hardware_set</span> <span class="o">=</span> <span class="n">coredata</span><span class="o">.</span><span class="n">data</span><span class="p">()[</span><span class="s2">&quot;instance_types&quot;</span><span class="p">]</span>
+<span class="o">&gt;&gt;&gt;</span> <span class="n">hardware_set</span><span class="o">.</span><span class="n">find_all</span><span class="p">(</span><span class="k">lambda</span> <span class="n">x</span><span class="p">:</span> <span class="n">x</span><span class="p">[</span><span class="s2">&quot;gpu&quot;</span><span class="p">])</span>
+<span class="p">[</span>
+    <span class="p">{</span>
+        <span class="s2">&quot;cores&quot;</span><span class="p">:</span> <span class="mi">4</span><span class="p">,</span>
+        <span class="s2">&quot;description&quot;</span><span class="p">:</span> <span class="s2">&quot;4 core, 15GB Mem (1 T4 Tensor GPU with 16GB Mem)&quot;</span><span class="p">,</span>
+        <span class="s2">&quot;gpu&quot;</span><span class="p">:</span> <span class="p">{</span>
+            <span class="s2">&quot;gpu_architecture&quot;</span><span class="p">:</span> <span class="s2">&quot;NVIDIA Turing&quot;</span><span class="p">,</span>
+            <span class="s2">&quot;gpu_count&quot;</span><span class="p">:</span> <span class="mi">1</span><span class="p">,</span>
+            <span class="s2">&quot;gpu_cuda_cores&quot;</span><span class="p">:</span> <span class="mi">2560</span><span class="p">,</span>
+            <span class="s2">&quot;gpu_memory&quot;</span><span class="p">:</span> <span class="s2">&quot;16&quot;</span><span class="p">,</span>
+            <span class="s2">&quot;gpu_model&quot;</span><span class="p">:</span> <span class="s2">&quot;T4 Tensor&quot;</span><span class="p">,</span>
+            <span class="s2">&quot;gpu_rt_cores&quot;</span><span class="p">:</span> <span class="mi">0</span><span class="p">,</span>
+            <span class="s2">&quot;gpu_tensor_cores&quot;</span><span class="p">:</span> <span class="mi">0</span><span class="p">,</span>
+            <span class="s2">&quot;total_gpu_cuda_cores&quot;</span><span class="p">:</span> <span class="mi">2560</span><span class="p">,</span>
+            <span class="s2">&quot;total_gpu_memory&quot;</span><span class="p">:</span> <span class="s2">&quot;16&quot;</span><span class="p">,</span>
+            <span class="s2">&quot;total_gpu_rt_cores&quot;</span><span class="p">:</span> <span class="mi">0</span><span class="p">,</span>
+            <span class="s2">&quot;total_gpu_tensor_cores&quot;</span><span class="p">:</span> <span class="mi">0</span><span class="p">,</span>
+        <span class="p">},</span>
+        <span class="s2">&quot;memory&quot;</span><span class="p">:</span> <span class="s2">&quot;15&quot;</span><span class="p">,</span>
+        <span class="s2">&quot;name&quot;</span><span class="p">:</span> <span class="s2">&quot;n1-standard-4-t4-1&quot;</span><span class="p">,</span>
+        <span class="s2">&quot;operating_system&quot;</span><span class="p">:</span> <span class="s2">&quot;linux&quot;</span><span class="p">,</span>
+        <span class="s2">&quot;categories&quot;</span><span class="p">:</span> <span class="p">[{</span><span class="s2">&quot;label&quot;</span><span class="p">:</span> <span class="s2">&quot;Low cores&quot;</span><span class="p">,</span> <span class="s2">&quot;order&quot;</span><span class="p">:</span> <span class="mi">10</span><span class="p">}],</span>
+    <span class="p">},</span>
+    <span class="p">{</span>
+        <span class="s2">&quot;cores&quot;</span><span class="p">:</span> <span class="mi">8</span><span class="p">,</span>
+        <span class="s2">&quot;description&quot;</span><span class="p">:</span> <span class="s2">&quot;8 core, 30GB Mem (1 T4 Tensor GPU with 16GB Mem)&quot;</span><span class="p">,</span>
+        <span class="s2">&quot;gpu&quot;</span><span class="p">:</span> <span class="p">{</span>
+            <span class="s2">&quot;gpu_architecture&quot;</span><span class="p">:</span> <span class="s2">&quot;NVIDIA Turing&quot;</span><span class="p">,</span>
+            <span class="s2">&quot;gpu_count&quot;</span><span class="p">:</span> <span class="mi">1</span><span class="p">,</span>
+            <span class="s2">&quot;gpu_cuda_cores&quot;</span><span class="p">:</span> <span class="mi">2560</span><span class="p">,</span>
+            <span class="s2">&quot;gpu_memory&quot;</span><span class="p">:</span> <span class="s2">&quot;16&quot;</span><span class="p">,</span>
+            <span class="s2">&quot;gpu_model&quot;</span><span class="p">:</span> <span class="s2">&quot;T4 Tensor&quot;</span><span class="p">,</span>
+            <span class="s2">&quot;gpu_rt_cores&quot;</span><span class="p">:</span> <span class="mi">0</span><span class="p">,</span>
+            <span class="s2">&quot;gpu_tensor_cores&quot;</span><span class="p">:</span> <span class="mi">0</span><span class="p">,</span>
+            <span class="s2">&quot;total_gpu_cuda_cores&quot;</span><span class="p">:</span> <span class="mi">2560</span><span class="p">,</span>
+            <span class="s2">&quot;total_gpu_memory&quot;</span><span class="p">:</span> <span class="s2">&quot;16&quot;</span><span class="p">,</span>
+            <span class="s2">&quot;total_gpu_rt_cores&quot;</span><span class="p">:</span> <span class="mi">0</span><span class="p">,</span>
+            <span class="s2">&quot;total_gpu_tensor_cores&quot;</span><span class="p">:</span> <span class="mi">0</span><span class="p">,</span>
+        <span class="p">},</span>
+        <span class="s2">&quot;memory&quot;</span><span class="p">:</span> <span class="s2">&quot;30&quot;</span><span class="p">,</span>
+        <span class="s2">&quot;name&quot;</span><span class="p">:</span> <span class="s2">&quot;n1-standard-8-t4-1&quot;</span><span class="p">,</span>
+        <span class="s2">&quot;operating_system&quot;</span><span class="p">:</span> <span class="s2">&quot;linux&quot;</span><span class="p">,</span>
+        <span class="s2">&quot;categories&quot;</span><span class="p">:</span> <span class="p">[{</span><span class="s2">&quot;label&quot;</span><span class="p">:</span> <span class="s2">&quot;Low cores&quot;</span><span class="p">,</span> <span class="s2">&quot;order&quot;</span><span class="p">:</span> <span class="mi">10</span><span class="p">}],</span>
+    <span class="p">},</span>
+    <span class="o">...</span>
+<span class="p">]</span>
+</code></pre></div>
+        <details class="quote">
+          <summary>Source code in <code>ciocore/hardware_set.py</code></summary>
+          <div class="highlight"><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">find_all</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">condition</span><span class="p">):</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;Find all instance types that match a condition.</span>
+<span class="sd">    Args:</span>
+<span class="sd">        condition (function): A function that takes an instance type and returns True or False.</span>
+<span class="sd">    Returns:</span>
+<span class="sd">        list: A list of instance types that match the condition.</span>
+<span class="sd">    Example:</span>
+<span class="sd">        &gt;&gt;&gt; from ciocore import data as coredata</span>
+<span class="sd">        &gt;&gt;&gt; coredata.init()</span>
+<span class="sd">        &gt;&gt;&gt; hardware_set = coredata.data()[&quot;instance_types&quot;]</span>
+<span class="sd">        &gt;&gt;&gt; hardware_set.find_all(lambda x: x[&quot;gpu&quot;])</span>
+<span class="sd">        [</span>
+<span class="sd">            {</span>
+<span class="sd">                &quot;cores&quot;: 4,</span>
+<span class="sd">                &quot;description&quot;: &quot;4 core, 15GB Mem (1 T4 Tensor GPU with 16GB Mem)&quot;,</span>
+<span class="sd">                &quot;gpu&quot;: {</span>
+<span class="sd">                    &quot;gpu_architecture&quot;: &quot;NVIDIA Turing&quot;,</span>
+<span class="sd">                    &quot;gpu_count&quot;: 1,</span>
+<span class="sd">                    &quot;gpu_cuda_cores&quot;: 2560,</span>
+<span class="sd">                    &quot;gpu_memory&quot;: &quot;16&quot;,</span>
+<span class="sd">                    &quot;gpu_model&quot;: &quot;T4 Tensor&quot;,</span>
+<span class="sd">                    &quot;gpu_rt_cores&quot;: 0,</span>
+<span class="sd">                    &quot;gpu_tensor_cores&quot;: 0,</span>
+<span class="sd">                    &quot;total_gpu_cuda_cores&quot;: 2560,</span>
+<span class="sd">                    &quot;total_gpu_memory&quot;: &quot;16&quot;,</span>
+<span class="sd">                    &quot;total_gpu_rt_cores&quot;: 0,</span>
+<span class="sd">                    &quot;total_gpu_tensor_cores&quot;: 0,</span>
+<span class="sd">                },</span>
+<span class="sd">                &quot;memory&quot;: &quot;15&quot;,</span>
+<span class="sd">                &quot;name&quot;: &quot;n1-standard-4-t4-1&quot;,</span>
+<span class="sd">                &quot;operating_system&quot;: &quot;linux&quot;,</span>
+<span class="sd">                &quot;categories&quot;: [{&quot;label&quot;: &quot;Low cores&quot;, &quot;order&quot;: 10}],</span>
+<span class="sd">            },</span>
+<span class="sd">            {</span>
+<span class="sd">                &quot;cores&quot;: 8,</span>
+<span class="sd">                &quot;description&quot;: &quot;8 core, 30GB Mem (1 T4 Tensor GPU with 16GB Mem)&quot;,</span>
+<span class="sd">                &quot;gpu&quot;: {</span>
+<span class="sd">                    &quot;gpu_architecture&quot;: &quot;NVIDIA Turing&quot;,</span>
+<span class="sd">                    &quot;gpu_count&quot;: 1,</span>
+<span class="sd">                    &quot;gpu_cuda_cores&quot;: 2560,</span>
+<span class="sd">                    &quot;gpu_memory&quot;: &quot;16&quot;,</span>
+<span class="sd">                    &quot;gpu_model&quot;: &quot;T4 Tensor&quot;,</span>
+<span class="sd">                    &quot;gpu_rt_cores&quot;: 0,</span>
+<span class="sd">                    &quot;gpu_tensor_cores&quot;: 0,</span>
+<span class="sd">                    &quot;total_gpu_cuda_cores&quot;: 2560,</span>
+<span class="sd">                    &quot;total_gpu_memory&quot;: &quot;16&quot;,</span>
+<span class="sd">                    &quot;total_gpu_rt_cores&quot;: 0,</span>
+<span class="sd">                    &quot;total_gpu_tensor_cores&quot;: 0,</span>
+<span class="sd">                },</span>
+<span class="sd">                &quot;memory&quot;: &quot;30&quot;,</span>
+<span class="sd">                &quot;name&quot;: &quot;n1-standard-8-t4-1&quot;,</span>
+<span class="sd">                &quot;operating_system&quot;: &quot;linux&quot;,</span>
+<span class="sd">                &quot;categories&quot;: [{&quot;label&quot;: &quot;Low cores&quot;, &quot;order&quot;: 10}],</span>
+<span class="sd">            },</span>
+<span class="sd">            ...</span>
+<span class="sd">        ]</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+    <span class="n">result</span> <span class="o">=</span> <span class="p">[]</span>
+    <span class="k">for</span> <span class="n">key</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">instance_types</span><span class="p">:</span>
+        <span class="k">if</span> <span class="n">condition</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">instance_types</span><span class="p">[</span><span class="n">key</span><span class="p">]):</span>
+            <span class="n">result</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">instance_types</span><span class="p">[</span><span class="n">key</span><span class="p">])</span>
+    <span class="k">return</span> <span class="n">result</span>
+</code></pre></div>
+        </details>
+    </div>
+  </div>
+  <div class="doc doc-object doc-method">
+<h3 id="ciocore.hardware_set.HardwareSet.find_first" class="doc doc-heading">
+<code class="highlight language-python"><span class="n">find_first</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">condition</span><span class="p">)</span></code>
+</h3>
+    <div class="doc doc-contents ">
+      <p>Find the first instance type that matches a condition.</p>
+<p>Please see find_all() above for more details. This method is just a convenience wrapper around find_all() that returns the first result or None if not found.</p>
+<p><strong>Parameters:</strong></p>
+<table>
+  <thead>
+    <tr>
+      <th>Name</th>
+      <th>Type</th>
+      <th>Description</th>
+      <th>Default</th>
+    </tr>
+  </thead>
+  <tbody>
+      <tr>
+        <td><code>condition</code></td>
+        <td><code>function</code></td>
+        <td><p>A function that takes an instance type and returns True or False.</p></td>
+        <td><em>required</em></td>
+      </tr>
+  </tbody>
+</table>
+<p><strong>Returns:</strong></p>
+<table>
+  <thead>
+    <tr>
+      <th>Type</th>
+      <th>Description</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td><code>dict</code></td>
+      <td><p>The first instance type that matches the condition or None if not found.</p></td>
+    </tr>
+  </tbody>
+</table>
+        <details class="quote">
+          <summary>Source code in <code>ciocore/hardware_set.py</code></summary>
+          <div class="highlight"><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">find_first</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">condition</span><span class="p">):</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;Find the first instance type that matches a condition.</span>
+<span class="sd">    Please see find_all() above for more details. This method is just a convenience wrapper around find_all() that returns the first result or None if not found.</span>
+<span class="sd">    Args:</span>
+<span class="sd">        condition (function): A function that takes an instance type and returns True or False.</span>
+<span class="sd">    Returns:</span>
+<span class="sd">        dict: The first instance type that matches the condition or None if not found.</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+    <span class="k">return</span> <span class="nb">next</span><span class="p">(</span><span class="nb">iter</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">find_all</span><span class="p">(</span><span class="n">condition</span><span class="p">)),</span> <span class="kc">None</span><span class="p">)</span>
+</code></pre></div>
+        </details>
+    </div>
+  </div>
+  <div class="doc doc-object doc-method">
+<h3 id="ciocore.hardware_set.HardwareSet.get_model" class="doc doc-heading">
+<code class="highlight language-python"><span class="n">get_model</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">with_misc</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
+</h3>
+    <div class="doc doc-contents ">
+      <p>Get the categories structure with renaming ready for some specific widget, such as a Qt Combobox.</p>
+<div class="admonition deprecated">
+<p class="admonition-title">Deprecated</p>
+<p>The get_model() method is deprecated. The <code>with_misc</code> parameter is no longer used, which means that this function only serves to rename a few keys. What's more, the init function ensures that every instance type has a category. This function is no longer needed. Submitters that use it will work but should be updated to use the categories structure directly as it minimizes the levels of indirection necessary to work with it.</p>
+</div>
+        <details class="quote">
+          <summary>Source code in <code>ciocore/hardware_set.py</code></summary>
+          <div class="highlight"><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_model</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">with_misc</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;Get the categories structure with renaming ready for some specific widget, such as a Qt Combobox.</span>
+<span class="sd">    Deprecated:</span>
+<span class="sd">        The get_model() method is deprecated. The `with_misc` parameter is no longer used, which means that this function only serves to rename a few keys. What&#39;s more, the init function ensures that every instance type has a category. This function is no longer needed. Submitters that use it will work but should be updated to use the categories structure directly as it minimizes the levels of indirection necessary to work with it.</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+    <span class="k">if</span> <span class="n">with_misc</span><span class="p">:</span>
+        <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span><span class="s2">&quot;with_misc is no longer used&quot;</span><span class="p">)</span>
+    <span class="n">result</span> <span class="o">=</span> <span class="p">[]</span>
+    <span class="k">for</span> <span class="n">category</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">categories</span><span class="p">:</span>
+        <span class="n">result</span><span class="o">.</span><span class="n">append</span><span class="p">(</span>
+            <span class="p">{</span>
+                <span class="s2">&quot;label&quot;</span><span class="p">:</span> <span class="n">category</span><span class="p">[</span><span class="s2">&quot;label&quot;</span><span class="p">],</span>
+                <span class="s2">&quot;content&quot;</span><span class="p">:</span> <span class="p">[</span>
+                    <span class="p">{</span><span class="s2">&quot;label&quot;</span><span class="p">:</span> <span class="n">k</span><span class="p">[</span><span class="s2">&quot;description&quot;</span><span class="p">],</span> <span class="s2">&quot;value&quot;</span><span class="p">:</span> <span class="n">k</span><span class="p">[</span><span class="s2">&quot;name&quot;</span><span class="p">]}</span>
+                    <span class="k">for</span> <span class="n">k</span> <span class="ow">in</span> <span class="n">category</span><span class="p">[</span><span class="s2">&quot;content&quot;</span><span class="p">]</span>
+                <span class="p">],</span>
+            <span class="p">}</span>
+        <span class="p">)</span>
+    <span class="k">return</span> <span class="n">result</span>
+</code></pre></div>
+        </details>
+    </div>
+  </div>
+  </div>
+    </div>
+  </div>
+  </div>
+    </div>
+  </div>
+              </article>
+            </div>
+<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
+        </div>
+          <button type="button" class="md-top md-icon" data-md-component="top" hidden>
+  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8v12Z"/></svg>
+  Back to top
+</button>
+      </main>
+        <footer class="md-footer">
+  <div class="md-footer-meta md-typeset">
+    <div class="md-footer-meta__inner md-grid">
+      <div class="md-copyright">
+    <div class="md-copyright__highlight">
+      Copyright &copy; 2023, CoreWeave.
+    </div>
+    Made with
+    <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
+      Material for MkDocs
+    </a>
+</div>
+    </div>
+  </div>
+</footer>
+    </div>
+    <div class="md-dialog" data-md-component="dialog">
+      <div class="md-dialog__inner md-typeset"></div>
+    </div>
+    <script id="__config" type="application/json">{"base": "../..", "features": ["navigation.expand", "navigation.instant", "navigation.tabs", "navigation.tabs.sticky", "navigation.tracking", "navigation.top"], "search": "../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
+      <script src="../../assets/javascripts/bundle.471ce7a9.min.js"></script>
+  </body>
+</html>

ciocore 5.1.1__py2.py3-none-any.whl → 10.0.0b3__py2.py3-none-any.whl

ciocore 5.1.1py2.py3-none-any.whl → 10.0.0b3py2.py3-none-any.whl