ciocore 9.1.0rc2__py2.py3-none-any.whl → 9.1.1b1__py2.py3-none-any.whl

ciocore/VERSION

@@ -1 +1 @@
-9.1.0-rc.2
+9.1.1-beta.1

ciocore/cli.py

@@ -8,12 +8,12 @@ import socketserver
 from ciocore import loggeria, config, api_client, package_query
 
 from ciocore import version as VERSION
- 
+
 from ciocore.uploader import Uploader
 from ciocore.downloader.legacy_downloader import Downloader
 from ciocore.downloader.logging_download_runner import LoggingDownloadRunner
 from ciocore.downloader.log import LOGGER_NAME, LEVEL_MAP
-
+from cioseq.sequence import Sequence
 
 LOG_LEVEL_HELP = """The logging level to display"""
 
@@ -117,17 +117,19 @@ def _set_logging(log_level, log_to_console=True, log_dir=None, log_filename=None
         log_dirpath=log_dir,
         log_filename=log_filename,
         console_formatter=loggeria.FORMATTER_VERBOSE,
-        disable_console_logging= not log_to_console,
+        disable_console_logging=not log_to_console,
         use_system_log=True,
     )
 
     print("Logging to %s" % loggeria.LOG_PATH)
 
+
 def _register(client):
     api_client.ApiClient.register_client(
         client_name=client.CLIENT_NAME, client_version=VERSION
     )
 
+
 ########################### MAIN #################################
 @click.group(invoke_without_command=True)
 @click.pass_context
@@ -135,12 +137,12 @@ def _register(client):
 def main(ctx, version):
     """
     Conductor Command-line interface.
-    
+
     To get help on subcommands, use the --help flag after the subcommand.
-    
+
     Example:
     conductor download --help
-    
+
     """
     if not ctx.invoked_subcommand:
         if version:
@@ -149,6 +151,7 @@ def main(ctx, version):
         click.echo(ctx.get_help())
         ctx.exit()
 
+
 ############################# UPLOAD #############################
 @main.command()
 @click.option("-db", "--database_filepath", help=UPLOADER_DATABASE_FILEPATH_HELP)
@@ -168,7 +171,9 @@ def main(ctx, version):
     default=DEFAULT_CONFIG_LOG_LEVEL,
 )
 @click.option("-ld", "--log_dir", help=LOG_DIR_HELP)
-@click.option("-lcl", "--log_to_console", is_flag=True, help=LOG_TO_CONSOLE_HELP, default=False)
+@click.option(
+    "-lcl", "--log_to_console", is_flag=True, help=LOG_TO_CONSOLE_HELP, default=False
+)
 @click.option(
     "-tc",
     "--thread_count",
@@ -179,7 +184,14 @@ def main(ctx, version):
 @click.option("-lc", "--location", help=LOCATION_HELP)
 @click.argument("paths", nargs=-1, type=click.Path(exists=True, resolve_path=True))
 def upload(
-    database_filepath, location, md5_caching, log_level, log_to_console, log_dir, thread_count, paths
+    database_filepath,
+    location,
+    md5_caching,
+    log_level,
+    log_to_console,
+    log_dir,
+    thread_count,
+    paths,
 ):
     """Upload files to Conductor.
 
@@ -192,7 +204,12 @@ def upload(
     conductor upload file1 file2 file3
     """
 
-    _set_logging(log_level, log_to_console=log_to_console,  log_dir=log_dir, log_filename="conductor_uploader.log")
+    _set_logging(
+        log_level,
+        log_to_console=log_to_console,
+        log_dir=log_dir,
+        log_filename="conductor_uploader.log",
+    )
 
     args_dict = {
         "database_filepath": database_filepath,
@@ -284,7 +301,9 @@ DEPRECATED_PATHS_HELP = "Specify a list of paths to upload."
     help=THREADS_HELP,
     default=DEFAULT_CONFIG_THREAD_COUNT,
 )
-@click.option("-lcl", "--log_to_console", is_flag=True, help=LOG_TO_CONSOLE_HELP, default=False)
+@click.option(
+    "-lcl", "--log_to_console", is_flag=True, help=LOG_TO_CONSOLE_HELP, default=False
+)
 @click.option("-lc", "--location", help=LOCATION_HELP)
 @click.option(
     "-p",
@@ -294,7 +313,14 @@ DEPRECATED_PATHS_HELP = "Specify a list of paths to upload."
     type=click.Path(exists=True, resolve_path=True),
 )
 def uploader(
-    database_filepath, location, md5_caching, log_level, log_dir, log_to_console, thread_count, paths
+    database_filepath,
+    location,
+    md5_caching,
+    log_level,
+    log_dir,
+    log_to_console,
+    thread_count,
+    paths,
 ):
     """Upload files to Conductor.
 
@@ -306,7 +332,12 @@ def uploader(
     Example:
     conductor upload file1 file2 file3
     """
-    _set_logging(log_level, log_to_console=log_to_console,  log_dir=log_dir, log_filename="conductor_uploader.log")
+    _set_logging(
+        log_level,
+        log_to_console=log_to_console,
+        log_dir=log_dir,
+        log_filename="conductor_uploader.log",
+    )
 
     args_dict = {
         "database_filepath": database_filepath,
@@ -369,7 +400,10 @@ def downloader(
     conductor downloader --job_id --task_id 01234
     conductor downloader --task_id --task_id 123
     """
-    click.secho("This command has been deprecated. Please use conductor download instead.", fg='red')
+    click.secho(
+        "This command has been deprecated. Please use conductor download instead.",
+        fg="red",
+    )
     logfile = log_dir and os.path.join(log_dir, "conductor_dl.log")
     _set_logging(log_level, logfile)
     _register(Downloader)
@@ -389,6 +423,62 @@ def downloader(
 
 
 ########################### PAGED DOWNLOAD #############################
+def validate_jobids(jobids):
+    """Validate job IDs and task ranges.
+
+    Args:
+        jobids: List of job ID strings, optionally with task ranges (e.g. "1234" or "1234:1-10")
+
+    Raises:
+        click.BadParameter: If any job ID or task range is invalid
+    """
+    if not jobids:
+        return
+
+    for jobid in jobids:
+        # Split job id and task range if present
+        parts = jobid.split(":")
+        job_id = parts[0]
+
+        # Validate job id is numeric
+        if not job_id.isdigit():
+            raise click.BadParameter(f"Job ID '{job_id}' must be numeric")
+
+        # If task range specified, validate it
+        if len(parts) > 1:
+            try:
+                # Try to create sequence to validate task range
+                Sequence.create(parts[1])
+            except (ValueError, TypeError) as exc:
+                raise click.BadParameter(
+                    f"Invalid task range '{parts[1]}' for job {job_id}. "
+                    "Task range must be in format like: 1-10, 1-5x2, or 1,3,5-10"
+                ) from exc
+        elif len(parts) > 2:
+            raise click.BadParameter(
+                f"Invalid job ID format '{jobid}'. Should be 'jobid' or 'jobid:task_range'"
+            )
+
+def validate_output_path(output_path):
+    """Validate the output path.
+
+    Args:
+        output_path: The output path to validate
+    """
+    if not output_path:
+        return
+    
+    if os.path.exists(output_path) and not os.path.isdir(output_path):
+        raise click.BadParameter(
+            f"Output path '{output_path}' exists and is not a directory."
+        )
+    try:
+        os.makedirs(output_path, exist_ok=True)
+    except OSError as exc:
+        raise click.BadParameter(
+            f"Output path '{output_path}' is not writable: {exc}"
+        )
+    
 @main.command()
 @click.option("-f", "--force", is_flag=True, help=DOWNLOADER_FORCE_DOWNLOAD_HELP)
 @click.option(
@@ -399,8 +489,9 @@ def downloader(
     default=DEFAULT_DOWNLOADER_PAGE_SIZE,
 )
 @click.option(
-    "-o", "--output-path",
-    type=click.Path(exists=True, file_okay=False, dir_okay=True, resolve_path=True),
+    "-o",
+    "--output-path",
+    type=click.Path(exists=False, file_okay=True, dir_okay=True, resolve_path=True),
     help=DOWNLOADER_OUTPUT_PATH_HELP,
 )
 @click.option(
@@ -426,7 +517,7 @@ def downloader(
     default=DEFAULT_CONFIG_THREAD_COUNT,
 )
 @click.option(
-    "-dr", 
+    "-dr",
     "--disable-reporting",
     help=DOWNLOAD_DISABLE_REPORTING_HELP,
     is_flag=True,
@@ -444,10 +535,9 @@ def download(
     log_level,
     thread_count,
     force,
-    regex, 
+    regex,
     disable_reporting,
 ):
-
     """
     Download renders and other output files from Conductor. You can give a list of job ids to
     download, or you can omit jobids and the downloader will run in daemon mode.
@@ -474,10 +564,12 @@ def download(
     conductor download 1234:1-5 1235:5-10
 
     """
- 
+    validate_jobids(jobids)
+    validate_output_path(output_path)
+
     _register(LoggingDownloadRunner)
 
-    # No longer uses Loggeria. 
+    # No longer uses Loggeria.
     # Instead, it gets the logger with broken-pipe handling from the downloader.log module.
     logging.getLogger(LOGGER_NAME).setLevel(LEVEL_MAP[log_level])
 
@@ -491,11 +583,6 @@ def download(
         "disable_reporting": disable_reporting,
     }
 
-    dl = LoggingDownloadRunner(
-        jobids,
-        location,
-        **kwargs
-    )
+    dl = LoggingDownloadRunner(jobids, location, **kwargs)
 
     dl.run()
-

ciocore/docsite/apidoc/api_client/index.html

@@ -1107,7 +1107,7 @@ ApiClient        </code>
 
         <details class="quote">
           <summary>Source code in <code>ciocore/api_client.py</code></summary>
-          <div class="highlight"><pre><span></span><code><span class="k">class</span> <span class="nc">ApiClient</span><span class="p">:</span>
+          <div class="highlight"><pre><span></span><code><span class="k">class</span><span class="w"> </span><span class="nc">ApiClient</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    The ApiClient class is a wrapper around the requests library that handles authentication and retries.</span>
 <span class="sd">    &quot;&quot;&quot;</span>
@@ -1119,10 +1119,10 @@ ApiClient        </code>
 
     <span class="n">user_agent_header</span> <span class="o">=</span> <span class="kc">None</span>
 
-    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</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">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;&quot;</span><span class="p">)</span>
 
-    <span class="k">def</span> <span class="nf">_make_request</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">verb</span><span class="p">,</span> <span class="n">conductor_url</span><span class="p">,</span> <span class="n">headers</span><span class="p">,</span> <span class="n">params</span><span class="p">,</span> <span class="n">data</span><span class="p">,</span> <span class="n">raise_on_error</span><span class="o">=</span><span class="kc">True</span><span class="p">):</span>
+    <span class="k">def</span><span class="w"> </span><span class="nf">_make_request</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">verb</span><span class="p">,</span> <span class="n">conductor_url</span><span class="p">,</span> <span class="n">headers</span><span class="p">,</span> <span class="n">params</span><span class="p">,</span> <span class="n">data</span><span class="p">,</span> <span class="n">raise_on_error</span><span class="o">=</span><span class="kc">True</span><span class="p">):</span>
         <span class="n">response</span> <span class="o">=</span> <span class="n">requests</span><span class="o">.</span><span class="n">request</span><span class="p">(</span>
             <span class="n">method</span><span class="o">=</span><span class="n">verb</span><span class="p">,</span> <span class="n">url</span><span class="o">=</span><span class="n">conductor_url</span><span class="p">,</span> <span class="n">headers</span><span class="o">=</span><span class="n">headers</span><span class="p">,</span> <span class="n">params</span><span class="o">=</span><span class="n">params</span><span class="p">,</span> <span class="n">data</span><span class="o">=</span><span class="n">data</span>
         <span class="p">)</span>
@@ -1145,7 +1145,7 @@ ApiClient        </code>
 
         <span class="k">return</span> <span class="n">response</span>
 
-    <span class="k">def</span> <span class="nf">make_prepared_request</span><span class="p">(</span>
+    <span class="k">def</span><span class="w"> </span><span class="nf">make_prepared_request</span><span class="p">(</span>
         <span class="bp">self</span><span class="p">,</span>
         <span class="n">verb</span><span class="p">,</span>
         <span class="n">url</span><span class="p">,</span>
@@ -1228,7 +1228,7 @@ ApiClient        </code>
 
         <span class="k">return</span> <span class="n">response</span>
 
-    <span class="k">def</span> <span class="nf">make_request</span><span class="p">(</span>
+    <span class="k">def</span><span class="w"> </span><span class="nf">make_request</span><span class="p">(</span>
         <span class="bp">self</span><span class="p">,</span>
         <span class="n">uri_path</span><span class="o">=</span><span class="s2">&quot;/&quot;</span><span class="p">,</span>
         <span class="n">headers</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
@@ -1302,7 +1302,7 @@ ApiClient        </code>
         <span class="k">return</span> <span class="n">response</span><span class="o">.</span><span class="n">text</span><span class="p">,</span> <span class="n">response</span><span class="o">.</span><span class="n">status_code</span>
 
     <span class="nd">@classmethod</span>
-    <span class="k">def</span> <span class="nf">register_client</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="n">client_name</span><span class="p">,</span> <span class="n">client_version</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
+    <span class="k">def</span><span class="w"> </span><span class="nf">register_client</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="n">client_name</span><span class="p">,</span> <span class="n">client_version</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
 <span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">        Generates the http User Agent header that includes helpful debug info.</span>
 <span class="sd">        &quot;&quot;&quot;</span>
@@ -1454,7 +1454,7 @@ client is built to use Requests 3.x this function can be removed.</p>
 </table>
         <details class="quote">
           <summary>Source code in <code>ciocore/api_client.py</code></summary>
-          <div class="highlight"><pre><span></span><code><span class="k">def</span> <span class="nf">make_prepared_request</span><span class="p">(</span>
+          <div class="highlight"><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">make_prepared_request</span><span class="p">(</span>
     <span class="bp">self</span><span class="p">,</span>
     <span class="n">verb</span><span class="p">,</span>
     <span class="n">url</span><span class="p">,</span>
@@ -1642,7 +1642,7 @@ client is built to use Requests 3.x this function can be removed.</p>
 </table>
         <details class="quote">
           <summary>Source code in <code>ciocore/api_client.py</code></summary>
-          <div class="highlight"><pre><span></span><code><span class="k">def</span> <span class="nf">make_request</span><span class="p">(</span>
+          <div class="highlight"><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">make_request</span><span class="p">(</span>
     <span class="bp">self</span><span class="p">,</span>
     <span class="n">uri_path</span><span class="o">=</span><span class="s2">&quot;/&quot;</span><span class="p">,</span>
     <span class="n">headers</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
@@ -1742,7 +1742,7 @@ client is built to use Requests 3.x this function can be removed.</p>
         <details class="quote">
           <summary>Source code in <code>ciocore/api_client.py</code></summary>
           <div class="highlight"><pre><span></span><code><span class="nd">@classmethod</span>
-<span class="k">def</span> <span class="nf">register_client</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="n">client_name</span><span class="p">,</span> <span class="n">client_version</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
+<span class="k">def</span><span class="w"> </span><span class="nf">register_client</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="n">client_name</span><span class="p">,</span> <span class="n">client_version</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Generates the http User Agent header that includes helpful debug info.</span>
 <span class="sd">    &quot;&quot;&quot;</span>
@@ -1808,7 +1808,7 @@ client is built to use Requests 3.x this function can be removed.</p>
 
         <details class="quote">
           <summary>Source code in <code>ciocore/api_client.py</code></summary>
-          <div class="highlight"><pre><span></span><code><span class="k">def</span> <span class="nf">truncate_middle</span><span class="p">(</span><span class="n">s</span><span class="p">,</span> <span class="n">max_length</span><span class="p">):</span>
+          <div class="highlight"><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">truncate_middle</span><span class="p">(</span><span class="n">s</span><span class="p">,</span> <span class="n">max_length</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Truncate the string `s` to `max_length` by removing characters from the middle.</span>
 
@@ -1863,7 +1863,7 @@ prompt the user to log in. </p>
 
         <details class="quote">
           <summary>Source code in <code>ciocore/api_client.py</code></summary>
-          <div class="highlight"><pre><span></span><code><span class="k">def</span> <span class="nf">read_conductor_credentials</span><span class="p">(</span><span class="n">use_api_key</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
+          <div class="highlight"><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">read_conductor_credentials</span><span class="p">(</span><span class="n">use_api_key</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Read the conductor credentials file.</span>
 
@@ -1986,7 +1986,7 @@ prompt the user to log in. </p>
 </table>
         <details class="quote">
           <summary>Source code in <code>ciocore/api_client.py</code></summary>
-          <div class="highlight"><pre><span></span><code><span class="k">def</span> <span class="nf">get_api_key_bearer_token</span><span class="p">(</span><span class="n">creds_file</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
+          <div class="highlight"><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_api_key_bearer_token</span><span class="p">(</span><span class="n">creds_file</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Get a bearer token from the API key.</span>
 
@@ -2083,7 +2083,7 @@ prompt the user to log in. </p>
 </table>
         <details class="quote">
           <summary>Source code in <code>ciocore/api_client.py</code></summary>
-          <div class="highlight"><pre><span></span><code><span class="k">def</span> <span class="nf">get_creds_path</span><span class="p">(</span><span class="n">api_key</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
+          <div class="highlight"><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_creds_path</span><span class="p">(</span><span class="n">api_key</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Get the path to the credentials file.</span>
 
@@ -2143,7 +2143,7 @@ prompt the user to log in. </p>
 
         <details class="quote">
           <summary>Source code in <code>ciocore/api_client.py</code></summary>
-          <div class="highlight"><pre><span></span><code><span class="k">def</span> <span class="nf">get_bearer_token</span><span class="p">(</span><span class="n">refresh</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
+          <div class="highlight"><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_bearer_token</span><span class="p">(</span><span class="n">refresh</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Return the bearer token.</span>
 
@@ -2211,7 +2211,7 @@ prompt the user to log in. </p>
 </table>
         <details class="quote">
           <summary>Source code in <code>ciocore/api_client.py</code></summary>
-          <div class="highlight"><pre><span></span><code><span class="k">def</span> <span class="nf">creds_same_domain</span><span class="p">(</span><span class="n">creds</span><span class="p">):</span>
+          <div class="highlight"><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">creds_same_domain</span><span class="p">(</span><span class="n">creds</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Check if the creds are for the same domain as the config.</span>
 
@@ -2291,7 +2291,7 @@ prompt the user to log in. </p>
 </table>
         <details class="quote">
           <summary>Source code in <code>ciocore/api_client.py</code></summary>
-          <div class="highlight"><pre><span></span><code><span class="k">def</span> <span class="nf">account_id_from_jwt</span><span class="p">(</span><span class="n">token</span><span class="p">):</span>
+          <div class="highlight"><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">account_id_from_jwt</span><span class="p">(</span><span class="n">token</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Fetch the accounts id from a jwt token value.</span>
 
@@ -2362,7 +2362,7 @@ prompt the user to log in. </p>
 </table>
         <details class="quote">
           <summary>Source code in <code>ciocore/api_client.py</code></summary>
-          <div class="highlight"><pre><span></span><code><span class="k">def</span> <span class="nf">account_name_from_jwt</span><span class="p">(</span><span class="n">token</span><span class="p">):</span>
+          <div class="highlight"><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">account_name_from_jwt</span><span class="p">(</span><span class="n">token</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Fetch the accounts name from a jwt token value.</span>
 
@@ -2446,7 +2446,7 @@ prompt the user to log in. </p>
 </table>
         <details class="quote">
           <summary>Source code in <code>ciocore/api_client.py</code></summary>
-          <div class="highlight"><pre><span></span><code><span class="k">def</span> <span class="nf">request_instance_types</span><span class="p">(</span><span class="n">as_dict</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">filter_param</span><span class="o">=</span><span class="s2">&quot;&quot;</span><span class="p">):</span>
+          <div class="highlight"><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">request_instance_types</span><span class="p">(</span><span class="n">as_dict</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">filter_param</span><span class="o">=</span><span class="s2">&quot;&quot;</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Get the list of available instances types.</span>
 
@@ -2534,7 +2534,7 @@ prompt the user to log in. </p>
 </table>
         <details class="quote">
           <summary>Source code in <code>ciocore/api_client.py</code></summary>
-          <div class="highlight"><pre><span></span><code><span class="k">def</span> <span class="nf">request_projects</span><span class="p">(</span><span class="n">statuses</span><span class="o">=</span><span class="p">(</span><span class="s2">&quot;active&quot;</span><span class="p">,)):</span>
+          <div class="highlight"><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">request_projects</span><span class="p">(</span><span class="n">statuses</span><span class="o">=</span><span class="p">(</span><span class="s2">&quot;active&quot;</span><span class="p">,)):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Query Conductor for all client Projects that are in the given status(es).</span>
 
@@ -2605,7 +2605,7 @@ prompt the user to log in. </p>
 </table>
         <details class="quote">
           <summary>Source code in <code>ciocore/api_client.py</code></summary>
-          <div class="highlight"><pre><span></span><code><span class="k">def</span> <span class="nf">request_software_packages</span><span class="p">():</span>
+          <div class="highlight"><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">request_software_packages</span><span class="p">():</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Query Conductor for all software packages for the currently available sidecar.</span>
 
@@ -2651,7 +2651,7 @@ prompt the user to log in. </p>
 
         <details class="quote">
           <summary>Source code in <code>ciocore/api_client.py</code></summary>
-          <div class="highlight"><pre><span></span><code><span class="k">def</span> <span class="nf">request_extra_environment</span><span class="p">():</span>
+          <div class="highlight"><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">request_extra_environment</span><span class="p">():</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Query Conductor for extra environment.</span>
 <span class="sd">    &quot;&quot;&quot;</span>
@@ -2733,7 +2733,7 @@ prompt the user to log in. </p>
   </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="nn">ciocore</span> <span class="kn">import</span> <span class="n">api_client</span>
+    <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="n">jobs</span> <span class="o">=</span> <span class="n">api_client</span><span class="o">.</span><span class="n">get_jobs</span><span class="p">(</span><span class="mi">1959</span><span class="p">)</span>
 <span class="o">&gt;&gt;&gt;</span> <span class="nb">len</span><span class="p">(</span><span class="n">jobs</span><span class="p">)</span>
 <span class="mi">1</span>
@@ -2746,7 +2746,7 @@ prompt the user to log in. </p>
 
         <details class="quote">
           <summary>Source code in <code>ciocore/api_client.py</code></summary>
-          <div class="highlight"><pre><span></span><code><span class="k">def</span> <span class="nf">get_jobs</span><span class="p">(</span><span class="n">first_jid</span><span class="p">,</span> <span class="n">last_jid</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
+          <div class="highlight"><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_jobs</span><span class="p">(</span><span class="n">first_jid</span><span class="p">,</span> <span class="n">last_jid</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Query Conductor for all jobs between the given job ids.</span>
 
@@ -2866,7 +2866,7 @@ prompt the user to log in. </p>
   </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="nn">ciocore</span> <span class="kn">import</span> <span class="n">api_client</span>
+    <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="n">logs</span> <span class="o">=</span> <span class="n">api_client</span><span class="o">.</span><span class="n">get_log</span><span class="p">(</span><span class="mi">1959</span><span class="p">,</span> <span class="mi">0</span><span class="p">)</span>
 <span class="p">{</span>
     <span class="s2">&quot;logs&quot;</span><span class="p">:</span> <span class="p">[</span>
@@ -2896,7 +2896,7 @@ prompt the user to log in. </p>
 
         <details class="quote">
           <summary>Source code in <code>ciocore/api_client.py</code></summary>
-          <div class="highlight"><pre><span></span><code><span class="k">def</span> <span class="nf">get_log</span><span class="p">(</span><span class="n">job_id</span><span class="p">,</span> <span class="n">task_id</span><span class="p">):</span>
+          <div class="highlight"><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_log</span><span class="p">(</span><span class="n">job_id</span><span class="p">,</span> <span class="n">task_id</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Get the log for the given job and task.</span>
 
@@ -3011,14 +3011,14 @@ prompt the user to log in. </p>
   </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="nn">ciocore</span> <span class="kn">import</span> <span class="n">api_client</span>
+    <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="n">api_client</span><span class="o">.</span><span class="n">kill_jobs</span><span class="p">(</span><span class="s2">&quot;03095&quot;</span><span class="p">,</span><span class="s2">&quot;03094&quot;</span><span class="p">)</span>
 <span class="p">{</span><span class="s1">&#39;body&#39;</span><span class="p">:</span> <span class="s1">&#39;success&#39;</span><span class="p">,</span> <span class="s1">&#39;message&#39;</span><span class="p">:</span> <span class="s2">&quot;Jobs [u&#39;03095&#39;, u&#39;03094&#39;] have been kill.&quot;</span><span class="p">}</span>
 </code></pre></div>
 
         <details class="quote">
           <summary>Source code in <code>ciocore/api_client.py</code></summary>
-          <div class="highlight"><pre><span></span><code><span class="k">def</span> <span class="nf">kill_jobs</span><span class="p">(</span><span class="o">*</span><span class="n">job_ids</span><span class="p">):</span>
+          <div class="highlight"><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">kill_jobs</span><span class="p">(</span><span class="o">*</span><span class="n">job_ids</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Kill the given jobs.</span>
 
@@ -3117,7 +3117,7 @@ prompt the user to log in. </p>
   </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="nn">ciocore</span> <span class="kn">import</span> <span class="n">api_client</span>
+    <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="n">api_client</span><span class="o">.</span><span class="n">kill_tasks</span><span class="p">(</span><span class="s2">&quot;03096&quot;</span><span class="p">,</span> <span class="o">*</span><span class="nb">range</span><span class="p">(</span><span class="mi">50</span><span class="p">,</span><span class="mi">56</span><span class="p">))</span>
 <span class="p">{</span><span class="s1">&#39;body&#39;</span><span class="p">:</span> <span class="s1">&#39;success&#39;</span><span class="p">,</span> <span class="s1">&#39;message&#39;</span><span class="p">:</span> <span class="s1">&#39; 6 Tasks set to &quot;kill&quot;</span>
 <span class="mi">050</span>
@@ -3130,7 +3130,7 @@ prompt the user to log in. </p>
 
         <details class="quote">
           <summary>Source code in <code>ciocore/api_client.py</code></summary>
-          <div class="highlight"><pre><span></span><code><span class="k">def</span> <span class="nf">kill_tasks</span><span class="p">(</span><span class="n">job_id</span><span class="p">,</span> <span class="o">*</span><span class="n">task_ids</span><span class="p">):</span>
+          <div class="highlight"><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">kill_tasks</span><span class="p">(</span><span class="n">job_id</span><span class="p">,</span> <span class="o">*</span><span class="n">task_ids</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Kill the given tasks.</span>
 
@@ -3237,7 +3237,7 @@ with running a job.    </p>
   </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="nn">ciocore</span> <span class="kn">import</span> <span class="n">api_client</span>
+    <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="n">api_client</span><span class="o">.</span><span class="n">get_compute_usage</span><span class="p">(</span><span class="n">start_time</span><span class="p">,</span> <span class="n">end_time</span><span class="p">)</span>
 <span class="p">{</span>  <span class="s1">&#39;2024-01-09&#39;</span><span class="p">:</span> <span class="p">{</span>  <span class="s1">&#39;cost&#39;</span><span class="p">:</span> <span class="mf">0.08</span><span class="p">,</span>
                     <span class="s1">&#39;corehours&#39;</span><span class="p">:</span> <span class="mf">0.9</span><span class="p">,</span> 
@@ -3249,7 +3249,7 @@ with running a job.    </p>
 
         <details class="quote">
           <summary>Source code in <code>ciocore/api_client.py</code></summary>
-          <div class="highlight"><pre><span></span><code><span class="k">def</span> <span class="nf">get_compute_usage</span><span class="p">(</span><span class="n">start_time</span><span class="p">,</span> <span class="n">end_time</span><span class="p">):</span>
+          <div class="highlight"><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_compute_usage</span><span class="p">(</span><span class="n">start_time</span><span class="p">,</span> <span class="n">end_time</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&#39;&#39;&#39;</span>
 <span class="sd">    Query the compute usage for an account.</span>
 
@@ -3361,7 +3361,7 @@ with running a job.    </p>
   </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="nn">ciocore</span> <span class="kn">import</span> <span class="n">api_client</span>
+    <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="n">api_client</span><span class="o">.</span><span class="n">get_storage_usage</span><span class="p">(</span><span class="n">start_time</span><span class="p">,</span> <span class="n">end_time</span><span class="p">)</span>
 <span class="p">{</span> <span class="s1">&#39;2024-01-01&#39;</span><span class="p">:</span> <span class="p">{</span><span class="s1">&#39;cost&#39;</span><span class="p">:</span> <span class="mf">4.022</span><span class="p">,</span> <span class="s1">&#39;GiB&#39;</span><span class="p">:</span> <span class="mf">679.714</span><span class="p">},</span>
   <span class="s1">&#39;2024-01-02&#39;</span><span class="p">:</span> <span class="p">{</span><span class="s1">&#39;cost&#39;</span><span class="p">:</span> <span class="mf">4.502</span><span class="p">,</span> <span class="s1">&#39;GiB&#39;</span><span class="p">:</span> <span class="mf">750.34</span><span class="p">},</span>
@@ -3370,7 +3370,7 @@ with running a job.    </p>
 
         <details class="quote">
           <summary>Source code in <code>ciocore/api_client.py</code></summary>
-          <div class="highlight"><pre><span></span><code><span class="k">def</span> <span class="nf">get_storage_usage</span><span class="p">(</span><span class="n">start_time</span><span class="p">,</span> <span class="n">end_time</span><span class="p">):</span>
+          <div class="highlight"><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">get_storage_usage</span><span class="p">(</span><span class="n">start_time</span><span class="p">,</span> <span class="n">end_time</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&#39;&#39;&#39;</span>
 <span class="sd">    Query the storage usage for an account.</span>