Reference for hub_sdk/modules/users.py
Note
This file is available at https://github.com/ultralytics/hub-sdk/blob/main/hub_sdk/modules/users.py. If you spot a problem please help fix it by contributing a Pull Request 🛠️. Thank you 🙏!
hub_sdk.modules.users.Users
Bases: CRUDClient
A class representing a client for interacting with Users through CRUD operations. This class extends the CRUDClient class and provides specific methods for working with Users.
Attributes:
Name | Type | Description |
---|---|---|
id |
(str, None)
|
The unique identifier of the user, if available. |
data |
dict
|
A dictionary to store user data. |
Note
The 'id' attribute is set during initialization and can be used to uniquely identify a user. The 'data' attribute is used to store user data fetched from the API.
Source code in hub_sdk/modules/users.py
10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 |
|
__init__(user_id=None, headers=None)
Initialize a Users object for interacting with user data via CRUD operations.
Parameters:
Name | Type | Description | Default |
---|---|---|---|
user_id |
str
|
The unique identifier of the user. |
None
|
headers |
dict
|
A dictionary of HTTP headers to be included in API requests. |
None
|
Source code in hub_sdk/modules/users.py
create_user(user_data)
Creates a new user with the provided data and sets the user ID for the current instance.
Parameters:
Name | Type | Description | Default |
---|---|---|---|
user_data |
dict
|
A dictionary containing the data for creating the user. |
required |
Returns:
Type | Description |
---|---|
None
|
The method does not return a value. |
Source code in hub_sdk/modules/users.py
delete(hard=False)
Delete the user resource represented by this instance.
Parameters:
Name | Type | Description | Default |
---|---|---|---|
hard |
bool
|
If True, perform a hard delete. |
False
|
Note
The 'hard' parameter determines whether to perform a soft delete (default) or a hard delete. In a soft delete, the model might be marked as deleted but retained in the system. In a hard delete, the model is permanently removed from the system.
Returns:
Type | Description |
---|---|
Optional[Response]
|
Response object from the delete request, or None if delete fails |
Source code in hub_sdk/modules/users.py
get_data()
Retrieves data for the current user instance.
If a valid user ID has been set, it sends a request to fetch the user data and stores it in the instance. If no user ID has been set, it logs an error message.
Returns:
Type | Description |
---|---|
None
|
The method does not return a value. |
Source code in hub_sdk/modules/users.py
update(data)
Update the user resource represented by this instance.
Parameters:
Name | Type | Description | Default |
---|---|---|---|
data |
dict
|
The updated data for the user resource. |
required |
Returns:
Type | Description |
---|---|
Optional[Response]
|
Response object from the update request, or None if update fails |