Skip to main content

A lightweight Redfish API command-line tool

Reason this release was yanked:

Cannot use --version

Project description

🔧 redfishLiteApi

A lightweight command-line tool to interact with Redfish APIs using GET, POST, and PATCH methods. Designed for quick testing, debugging, and field extraction.


📦 Features

  • ✅ Support for GET, POST, and PATCH

  • 🔐 Basic Authentication (-U / -P)

  • 📁 JSON body input via file (--json_file)

  • 🔍 Recursive field value search with --find (supports multiple fields)

  • 💾 Save response to file (--save)

  • 🧾 Custom HTTP headers (--header)

  • ⏱️ 10-second request timeout to prevent hanging

  • 🧯 Disable SSL verification warnings

  • 📡 HTTP Status display

  • ⚠️ JSON parse error handling with fallback to raw text

  • 🔢 --version support


🚀 Usage

python redfishLiteApi.py --url <API_URL> --method <get|post|patch> [OPTIONS]

✅ Example: Basic GET request

python redfishLiteApi.py --url https://<host>/redfish/v1/Systems --method get

🔐 Example: Authenticated GET with header and find field

python redfishLiteApi.py --url https://<host>/redfish/v1/Systems --method get \ -U admin -P password \ --header "If-Match:W/\"etag-value\"" \ --find Id Name PowerState

📝 Example: PATCH with body file

python redfishLiteApi.py --url https://<host>/redfish/v1/Managers/1/EthernetInterfaces/1 \ --method patch -U admin -P password --json_file update.json

💾 Example: Save output to file

python redfishLiteApi.py --url https://<host>/redfish/v1/Systems --method get --save output.json

📌 Check version

python redfishLiteApi.py --version


🧠 Argument Summary

Argument

Description

--url

Redfish API endpoint URL (required)

--method

HTTP method: get, post, or patch (required)

-U / --username

Basic auth username

-P / --password

Basic auth password

--json_file

Path to JSON file for POST or PATCH body

--find

One or more JSON field names to recursively extract (GET only)

--save

Save the response body to a file

--header

Custom headers in Key:Value format (can be repeated)

--version

Show current version and exit


⚠️ Notes

  • SSL certificate verification is disabled (verify=False).

  • Timeout is hardcoded to 10 seconds.

  • HTTP error handling is basic — be sure to inspect the response if you encounter unexpected results.


🛠 Dependencies

  • Python 3.x

  • requests

Install dependencies via:

pip install -r requirements.txt

requirements.txt content:

requests


📜 License

MIT License

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

redfishliteapi-1.0.0.tar.gz (4.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

redfishliteapi-1.0.0-py3-none-any.whl (4.4 kB view details)

Uploaded Python 3

File details

Details for the file redfishliteapi-1.0.0.tar.gz.

File metadata

  • Download URL: redfishliteapi-1.0.0.tar.gz
  • Upload date:
  • Size: 4.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.10

File hashes

Hashes for redfishliteapi-1.0.0.tar.gz
Algorithm Hash digest
SHA256 f1d9437a701fd7b25092eda0022b8e51e6bd065ec7c4df8bdea432d672c8b293
MD5 429222c19457aa5dc24fcf040318eb03
BLAKE2b-256 faf085e4f11f78821e9bb341f8b8cbdaf26c07314774a7e728c396a42465edb3

See more details on using hashes here.

File details

Details for the file redfishliteapi-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: redfishliteapi-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 4.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.10

File hashes

Hashes for redfishliteapi-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 5c9a4f2864cefb20a62bce734f2ed4a9efce74746d656d5dae032489eadc495a
MD5 fe0eada9ea3cbc2b572c99ea2c737f4d
BLAKE2b-256 52fa1d613923fc2021d8db47b557393de30118c940b31ab352afd241defd665a

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page