rackfish 1.0.1__py3-none-any.whl → 1.0.3__py3-none-any.whl

rackfish/__init__.py

@@ -19,7 +19,7 @@ https://github.com/thefrolov/rackfish
 
 from .client import RedfishClient, RedfishError, RedfishResource
 
-__version__ = "1.0.1"
+__version__ = "1.0.3"
 __author__ = "Dmitrii Frolov"
 __email__ = "thefrolov@mts.ru"
 __license__ = "MIT"

rackfish/client.py

@@ -7,6 +7,7 @@ import threading
 from typing import Any, ClassVar, Iterable
 
 import requests
+import urllib3
 
 # HTTP status codes
 HTTP_OK = 200
@@ -74,11 +75,6 @@ class RedfishClient:
         default_headers: dict[str, str] | None = None,
     ):
         base = base_url.rstrip("/")
-        # if not base.endswith("/redfish/v1"):
-        #     if base.endswith("/redfish"):
-        #         base = base + "/v1"
-        #     else:
-        #         base = base + "/redfish/v1"
 
         self.base_url = base
         self.username = username
@@ -88,6 +84,11 @@ class RedfishClient:
 
         self._http = requests.Session()
         self._http.verify = verify_ssl
+
+        # Suppress SSL warnings when verify_ssl is disabled
+        if not verify_ssl:
+            urllib3.disable_warnings(urllib3.exceptions.InsecureRequestWarning)
+
         self._http.headers.update(default_headers or {"Accept": "application/json"})
         if username and password and not use_session:
             self._http.auth = (username, password)
@@ -156,9 +157,12 @@ class RedfishClient:
                 return None
         return None
 
-    def patch(self, path: str, data: dict[str, Any]) -> None:
+    def patch(self, path: str, data: dict[str, Any], etag: str | None = None) -> None:
         url = _safe_join(self.base_url, path) if not path.startswith("http") else path
-        resp = self._http.patch(url, json=data, timeout=self.timeout)
+        headers = {}
+        if etag:
+            headers["If-Match"] = etag
+        resp = self._http.patch(url, json=data, headers=headers, timeout=self.timeout)
         if resp.status_code not in (200, 204):
             raise RedfishError(f"PATCH {url} -> {resp.status_code} {resp.text}")
 
@@ -191,7 +195,27 @@ class RedfishClient:
 
     def __getattr__(self, name: str) -> Any:
         # Proxy unknown attributes to root (e.g., client.Systems)
-        return getattr(self.root, name)
+        # If attribute doesn't exist but plural form exists with single member,
+        # return that member directly (e.g., client.System -> client.Systems[0])
+        try:
+            return getattr(self.root, name)
+        except AttributeError as exc:
+            # Try plural form for singular access convenience
+            plural_name = name + "s"
+            try:
+                collection = getattr(self.root, plural_name)
+                if (
+                    hasattr(collection, "__len__")
+                    and hasattr(collection, "__iter__")
+                    and len(collection) == 1
+                ):
+                    return next(iter(collection))
+            except (AttributeError, TypeError):
+                pass
+            # Re-raise original error
+            raise AttributeError(
+                f"'{type(self).__name__}' object has no attribute '{name}'"
+            ) from exc
 
 
 # ---------------------------
@@ -383,11 +407,28 @@ class RedfishResource:
         self._ensure_fetched()
         try:
             return object.__getattribute__(self, name)
-        except AttributeError:
+        except AttributeError as exc:
             # Not an attribute; maybe a JSON property with non-identifier key
             if name in self._raw:
                 return self._raw[name]
-            raise
+
+            # Try plural form for singular access convenience
+            # e.g., resource.Chassis -> resource.Chassis[0] if len == 1
+            plural_name = name + "s"
+            try:
+                collection = object.__getattribute__(self, plural_name)
+                if (
+                    hasattr(collection, "__len__")
+                    and hasattr(collection, "__iter__")
+                    and len(collection) == 1
+                ):
+                    return next(iter(collection))
+            except (AttributeError, TypeError):
+                pass
+
+            raise AttributeError(
+                f"'{type(self).__name__}' object has no attribute '{name}'"
+            ) from exc
 
     def __setattr__(self, name: str, value: Any) -> None:
         # Allow setting simple existing properties via PATCH
@@ -400,7 +441,8 @@ class RedfishResource:
 
         if name in self._raw and not isinstance(self._raw[name], (dict, list)):
             # PATCH only simple properties by default; complex updates via .patch()
-            self._client.patch(self._path, {name: value})
+            etag = self._raw.get("@odata.etag")
+            self._client.patch(self._path, {name: value}, etag=etag)
             self._raw[name] = value
             object.__setattr__(self, name, value)
         else:
@@ -458,7 +500,9 @@ class RedfishResource:
     def patch(self, updates: dict[str, Any]) -> None:
         if not self._path:
             raise RedfishError("PATCH requires a resource path")
-        self._client.patch(self._path, updates)
+        self._ensure_fetched()
+        etag = self._raw.get("@odata.etag")
+        self._client.patch(self._path, updates, etag=etag)
         self.refresh()
 
     def delete(self) -> None:

{rackfish-1.0.1.dist-info → rackfish-1.0.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rackfish
-Version: 1.0.1
+Version: 1.0.3
 Summary: A lightweight, dynamic Python client for Redfish BMC APIs
 Author-email: Dmitrii Frolov <thefrolov@mts.ru>
 License: MIT
@@ -58,17 +58,6 @@ A lightweight, dynamic Python client for interacting with Redfish BMC (Baseboard
 - 📚 **Collection Support** - Iterate Redfish collections naturally
 - 🔐 **Flexible Auth** - Session tokens or Basic authentication
 
-## Features
-
-- **Zero Dependencies** (except `requests`) - Minimal footprint
-- **Lazy Loading** - Resources fetched on-demand for performance
-- **Dynamic Attributes** - JSON properties become Python attributes
-- **OEM Surfacing** - Vendor extensions automatically accessible
-- **Links Surfacing** - Related resources directly navigable
-- **Action Validation** - Parameter validation using ActionInfo schemas
-- **Collection Support** - Iterate Redfish collections naturally
-- **Session & Basic Auth** - Flexible authentication options
-
 ## Installation
 
 ### From PyPI (recommended)
@@ -101,8 +90,11 @@ client = RedfishClient("https://bmc.example.com", "admin", "password",
                        use_session=True, verify_ssl=False)
 root = client.connect()
 
-# Power control
-system = next(iter(client.Systems))
+# Power control - multiple ways to access systems
+system = next(iter(client.Systems))  # Traditional iteration
+system = client.Systems.Members[0]    # Direct member access
+system = client.System                # Singular form (if only one member!)
+
 system.Reset(ResetType="GracefulRestart")
 
 # Access OEM properties (auto-surfaced)
@@ -166,7 +158,8 @@ for temp in chassis.Thermal.Temperatures:
     print(f"{temp.Name}: {temp.ReadingCelsius}°C")
 ```
 
-See [EXAMPLES.md](EXAMPLES.md) for 100+ more examples covering:
+See [docs/EXAMPLES.md](docs/EXAMPLES.md) for 100+ more examples covering:
+
 - BIOS configuration
 - Certificate management
 - Virtual media (KVM)
@@ -175,24 +168,6 @@ See [EXAMPLES.md](EXAMPLES.md) for 100+ more examples covering:
 - SEL/log collection
 - And much more...
 
-## Testing
-
-Run the test suite:
-
-```bash
-# Install with dev dependencies
-pip install -e ".[dev]"
-
-# Run all tests
-pytest tests/
-
-# Run with coverage
-pytest --cov=rackfish tests/
-
-# Run specific test file
-pytest tests/test_common_usage.py
-```
-
 ## Project Structure
 
 ```
@@ -356,7 +331,7 @@ See LICENSE file.
 
 ## Version
 
-Current version: 1.0.0
+Current version: 1.0.3
 
 ## Requirements
 

rackfish-1.0.3.dist-info/RECORD

@@ -0,0 +1,7 @@
+rackfish/__init__.py,sha256=hYKyM58DkDSL2ReP0CI18RT-TuBcYTmDZp5gepUfUGk,866
+rackfish/client.py,sha256=aHtQikXEEsI_jjq24-LE8mR2sCasdAlhbB2zRP97200,25048
+rackfish-1.0.3.dist-info/licenses/LICENSE,sha256=RqhA3IjOD-4eEnG-vVcLLU1vdpVCUyCQpytsCP3P0Q0,1071
+rackfish-1.0.3.dist-info/METADATA,sha256=CnnyEOogYJYjOyRAnBpcGw21jnEO66EXhIihdDuRpeE,10645
+rackfish-1.0.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+rackfish-1.0.3.dist-info/top_level.txt,sha256=71o_wqNuMF4jtlGbXuI2-Epzd2a9oSizMmdcG3Sw_Mo,9
+rackfish-1.0.3.dist-info/RECORD,,

rackfish-1.0.1.dist-info/RECORD

@@ -1,7 +0,0 @@
-rackfish/__init__.py,sha256=gXLovtZSL_Od0gBj5huedVcJ30ufDLRwYJxTV7eE7Q0,866
-rackfish/client.py,sha256=4eOyfQtqo9kbvzxiV2DqyeM6t4fgAnKbj3odpiS9dmY,23225
-rackfish-1.0.1.dist-info/licenses/LICENSE,sha256=RqhA3IjOD-4eEnG-vVcLLU1vdpVCUyCQpytsCP3P0Q0,1071
-rackfish-1.0.1.dist-info/METADATA,sha256=55T2anIwPlDVEw1vnYT5fuAs-ZzVN4Vs6F4tEdwq9qA,11215
-rackfish-1.0.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-rackfish-1.0.1.dist-info/top_level.txt,sha256=71o_wqNuMF4jtlGbXuI2-Epzd2a9oSizMmdcG3Sw_Mo,9
-rackfish-1.0.1.dist-info/RECORD,,