ccc_client

This package provides a simple, modular SDK for the CCC REST API.

Features

• Automatically handles authentication and renewal
• Graceful error management
• Logically organized modules
• Easily maintained

Installation

Requirements:

• Python 3.8 or higher
• Required packages: requests>=2.26.0, jsonschema>=4.23.0

Install using pip:

pip install cccAPI 

Install from source:

git clone https://github.hpe.com/hpe/cccAPI.git
cd cccAPI
pip install -e .

Quick Start

Initialize the Client

import json
from cccAPI import cccAPIClient
client = cccAPIClient("https://localhost:8000/cmu/v1", "root", "your-password")

Example Usage

Get Nodes

nodes = client.nodes.show_nodes()
print(json.dumps(nodes, indent=4))

Get specific Node

#Specific node named Node1
node = client.nodes.show_node("Node1")
print(json.dumps(node, indent=4))

Get specific Node/fields

• Allowed fields are:

query_params = {"fields": "name,id,uuid,network.name,network.ipAddress,network.macAddress"}
specific_nodes=client.nodes.show_nodes(query_params)
print(json.dumps(specific_nodes, indent=4))

See examples/test.py for other test cases as implemented

API Modules

Building and Publishing

Local Development

There are several ways to install the package for local development:

1. Direct pip install:

pip install .

2. Using pip-tools (recommended for development):

pip install pip-tools
pip-compile pyproject.toml  # Produces requirements.txt
pip install -r requirements.txt

3. Using uv (faster installation):

curl -LsSf https://astral.sh/uv/install.sh | sh
uv pip install -e . --system

4. Building distribution packages:

pip install build
python -m build  # Creates dist/ with tar.gz and .whl

Publishing to PyPI

1. Ensure you have the required tools:

pip install setuptools wheel twine

2. Build the distribution:

python -m build
# Or alternatively:
# python3 setup.py sdist bdist_wheel

3. Upload to PyPI (requires ~/.pypirc with PyPI token):

twine upload dist/*

You can verify the installation by downloading the published package:

pip install cccAPI=={version}  # Replace {version} with desired version

License

This project is license under the MIT license.