added containers docs, incl auto-generated examples from examples dir

also some minor improvements to docs

Author: tamirse

CHANGELOG.rst

@@ -2,6 +2,7 @@ Changelog
 =========
 
 v1.8.2 (2025-03-25)
+-------------------
 
 * Added missing packages to setup requirements
 

docs/source/api/services/containers.rst

@@ -0,0 +1,9 @@
+Containers
+==========
+
+.. autoclass:: datacrunch.containers.containers.ContainersService
+   :members:
+
+.. autoclass:: datacrunch.containers.containers.Container
+   :members:
+

docs/source/conf.py

@@ -12,16 +12,18 @@
 # add these directories to sys.path here. If the directory is relative to the
 # documentation root, use os.path.abspath to make it absolute, like shown here.
 #
+import datetime
+from recommonmark.parser import CommonMarkParser
+from datacrunch.__version__ import VERSION
 import os
 import sys
 sys.path.insert(0, os.path.abspath('../../'))
-from datacrunch.__version__ import VERSION
-from recommonmark.parser import CommonMarkParser
 
 # -- Project information -----------------------------------------------------
+current_year = datetime.datetime.now().year
 
 project = 'DataCrunch Python SDK'
-copyright = '2021, DataCrunch.io'
+copyright = f'{current_year}, DataCrunch.io'
 author = 'DataCrunch.io'
 
 # The short X.Y version
@@ -68,7 +70,7 @@
 #
 # This is also used if you do content translation via gettext catalogs.
 # Usually you set "language" from the command line for these cases.
-language = None
+language = 'en'
 
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
@@ -90,12 +92,15 @@
 # further.  For a list of options available for each theme, see the
 # documentation.
 #
-# html_theme_options = {}
+html_theme_options = {
+    'page_width': '1900px',
+    'body_min_width': '1400px',
+}
 
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
 # so a file named "default.css" will overwrite the builtin "default.css".
-html_static_path = ['_static']
+html_static_path = []
 
 # Custom sidebar templates, must be a dictionary that maps document names
 # to template names.

docs/source/examples.rst

@@ -13,6 +13,13 @@ All the examples code can be also found in the repository `Examples folder <http
 
 .. toctree::
    :maxdepth: 3
-   :glob:
+   :caption: Contents:
 
-   examples/*
+   examples/containers/index
+   examples/advanced_create_instance
+   examples/instances_and_volumes
+   examples/instance_actions
+   examples/simple_create_instance
+   examples/ssh_keys
+   examples/startup_scripts
+   examples/storage_volumes

docs/source/examples/containers/compute_resources.rst

@@ -0,0 +1,8 @@
+Compute Resources
+=================
+
+This example demonstrates how to list and manage compute resources for containers in DataCrunch.
+
+.. literalinclude:: ../../../../examples/containers/compute_resources_example.py
+   :language: python
+   :caption: Compute Resources 

docs/source/examples/containers/deployments.rst

@@ -0,0 +1,8 @@
+Container Deployments
+=====================
+
+This example demonstrates how to create, manage, and monitor container deployments in DataCrunch.
+
+.. literalinclude:: ../../../../examples/containers/container_deployments_example.py
+   :language: python
+   :caption: Container Deployments 

docs/source/examples/containers/environment_variables.rst

@@ -0,0 +1,8 @@
+Environment Variables
+=====================
+
+This example shows how to manage environment variables for container deployments in DataCrunch.
+
+.. literalinclude:: ../../../../examples/containers/environment_variables_example.py
+   :language: python
+   :caption: Environment Variables 

docs/source/examples/containers/index.rst

@@ -0,0 +1,16 @@
+Container Examples
+==================
+
+This section contains examples demonstrating how to work with containers in DataCrunch.
+
+.. toctree::
+   :maxdepth: 1
+   :caption: Contents:
+
+   compute_resources
+   deployments
+   environment_variables
+   registry_credentials
+   secrets
+   sglang
+   scaling 

docs/source/examples/containers/registry_credentials.rst

@@ -0,0 +1,8 @@
+Registry Credentials
+====================
+
+This example demonstrates how to manage container registry credentials in DataCrunch.
+
+.. literalinclude:: ../../../../examples/containers/registry_credentials_example.py
+   :language: python
+   :caption: Registry Credentials 

docs/source/examples/containers/scaling.rst

@@ -0,0 +1,8 @@
+Update Deployment Scaling
+=========================
+
+This example shows how to update and manage the scaling of container deployments in DataCrunch.
+
+.. literalinclude:: ../../../../examples/containers/update_deployment_scaling_example.py
+   :language: python
+   :caption: Update Deployment Scaling