dtlpy 1.114.17__py3-none-any.whl → 1.116.6__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (238) hide show
  1. dtlpy/__init__.py +491 -491
  2. dtlpy/__version__.py +1 -1
  3. dtlpy/assets/__init__.py +26 -26
  4. dtlpy/assets/code_server/config.yaml +2 -2
  5. dtlpy/assets/code_server/installation.sh +24 -24
  6. dtlpy/assets/code_server/launch.json +13 -13
  7. dtlpy/assets/code_server/settings.json +2 -2
  8. dtlpy/assets/main.py +53 -53
  9. dtlpy/assets/main_partial.py +18 -18
  10. dtlpy/assets/mock.json +11 -11
  11. dtlpy/assets/model_adapter.py +83 -83
  12. dtlpy/assets/package.json +61 -61
  13. dtlpy/assets/package_catalog.json +29 -29
  14. dtlpy/assets/package_gitignore +307 -307
  15. dtlpy/assets/service_runners/__init__.py +33 -33
  16. dtlpy/assets/service_runners/converter.py +96 -96
  17. dtlpy/assets/service_runners/multi_method.py +49 -49
  18. dtlpy/assets/service_runners/multi_method_annotation.py +54 -54
  19. dtlpy/assets/service_runners/multi_method_dataset.py +55 -55
  20. dtlpy/assets/service_runners/multi_method_item.py +52 -52
  21. dtlpy/assets/service_runners/multi_method_json.py +52 -52
  22. dtlpy/assets/service_runners/single_method.py +37 -37
  23. dtlpy/assets/service_runners/single_method_annotation.py +43 -43
  24. dtlpy/assets/service_runners/single_method_dataset.py +43 -43
  25. dtlpy/assets/service_runners/single_method_item.py +41 -41
  26. dtlpy/assets/service_runners/single_method_json.py +42 -42
  27. dtlpy/assets/service_runners/single_method_multi_input.py +45 -45
  28. dtlpy/assets/voc_annotation_template.xml +23 -23
  29. dtlpy/caches/base_cache.py +32 -32
  30. dtlpy/caches/cache.py +473 -473
  31. dtlpy/caches/dl_cache.py +201 -201
  32. dtlpy/caches/filesystem_cache.py +89 -89
  33. dtlpy/caches/redis_cache.py +84 -84
  34. dtlpy/dlp/__init__.py +20 -20
  35. dtlpy/dlp/cli_utilities.py +367 -367
  36. dtlpy/dlp/command_executor.py +764 -764
  37. dtlpy/dlp/dlp +1 -1
  38. dtlpy/dlp/dlp.bat +1 -1
  39. dtlpy/dlp/dlp.py +128 -128
  40. dtlpy/dlp/parser.py +651 -651
  41. dtlpy/entities/__init__.py +83 -83
  42. dtlpy/entities/analytic.py +347 -311
  43. dtlpy/entities/annotation.py +1879 -1879
  44. dtlpy/entities/annotation_collection.py +699 -699
  45. dtlpy/entities/annotation_definitions/__init__.py +20 -20
  46. dtlpy/entities/annotation_definitions/base_annotation_definition.py +100 -100
  47. dtlpy/entities/annotation_definitions/box.py +195 -195
  48. dtlpy/entities/annotation_definitions/classification.py +67 -67
  49. dtlpy/entities/annotation_definitions/comparison.py +72 -72
  50. dtlpy/entities/annotation_definitions/cube.py +204 -204
  51. dtlpy/entities/annotation_definitions/cube_3d.py +149 -149
  52. dtlpy/entities/annotation_definitions/description.py +32 -32
  53. dtlpy/entities/annotation_definitions/ellipse.py +124 -124
  54. dtlpy/entities/annotation_definitions/free_text.py +62 -62
  55. dtlpy/entities/annotation_definitions/gis.py +69 -69
  56. dtlpy/entities/annotation_definitions/note.py +139 -139
  57. dtlpy/entities/annotation_definitions/point.py +117 -117
  58. dtlpy/entities/annotation_definitions/polygon.py +182 -182
  59. dtlpy/entities/annotation_definitions/polyline.py +111 -111
  60. dtlpy/entities/annotation_definitions/pose.py +92 -92
  61. dtlpy/entities/annotation_definitions/ref_image.py +86 -86
  62. dtlpy/entities/annotation_definitions/segmentation.py +240 -240
  63. dtlpy/entities/annotation_definitions/subtitle.py +34 -34
  64. dtlpy/entities/annotation_definitions/text.py +85 -85
  65. dtlpy/entities/annotation_definitions/undefined_annotation.py +74 -74
  66. dtlpy/entities/app.py +220 -220
  67. dtlpy/entities/app_module.py +107 -107
  68. dtlpy/entities/artifact.py +174 -174
  69. dtlpy/entities/assignment.py +399 -399
  70. dtlpy/entities/base_entity.py +214 -214
  71. dtlpy/entities/bot.py +113 -113
  72. dtlpy/entities/codebase.py +292 -296
  73. dtlpy/entities/collection.py +38 -38
  74. dtlpy/entities/command.py +169 -169
  75. dtlpy/entities/compute.py +449 -442
  76. dtlpy/entities/dataset.py +1299 -1285
  77. dtlpy/entities/directory_tree.py +44 -44
  78. dtlpy/entities/dpk.py +470 -470
  79. dtlpy/entities/driver.py +235 -223
  80. dtlpy/entities/execution.py +397 -397
  81. dtlpy/entities/feature.py +124 -124
  82. dtlpy/entities/feature_set.py +145 -145
  83. dtlpy/entities/filters.py +798 -645
  84. dtlpy/entities/gis_item.py +107 -107
  85. dtlpy/entities/integration.py +184 -184
  86. dtlpy/entities/item.py +959 -953
  87. dtlpy/entities/label.py +123 -123
  88. dtlpy/entities/links.py +85 -85
  89. dtlpy/entities/message.py +175 -175
  90. dtlpy/entities/model.py +684 -684
  91. dtlpy/entities/node.py +1005 -1005
  92. dtlpy/entities/ontology.py +810 -803
  93. dtlpy/entities/organization.py +287 -287
  94. dtlpy/entities/package.py +657 -657
  95. dtlpy/entities/package_defaults.py +5 -5
  96. dtlpy/entities/package_function.py +185 -185
  97. dtlpy/entities/package_module.py +113 -113
  98. dtlpy/entities/package_slot.py +118 -118
  99. dtlpy/entities/paged_entities.py +299 -299
  100. dtlpy/entities/pipeline.py +624 -624
  101. dtlpy/entities/pipeline_execution.py +279 -279
  102. dtlpy/entities/project.py +394 -394
  103. dtlpy/entities/prompt_item.py +505 -499
  104. dtlpy/entities/recipe.py +301 -301
  105. dtlpy/entities/reflect_dict.py +102 -102
  106. dtlpy/entities/resource_execution.py +138 -138
  107. dtlpy/entities/service.py +963 -958
  108. dtlpy/entities/service_driver.py +117 -117
  109. dtlpy/entities/setting.py +294 -294
  110. dtlpy/entities/task.py +495 -495
  111. dtlpy/entities/time_series.py +143 -143
  112. dtlpy/entities/trigger.py +426 -426
  113. dtlpy/entities/user.py +118 -118
  114. dtlpy/entities/webhook.py +124 -124
  115. dtlpy/examples/__init__.py +19 -19
  116. dtlpy/examples/add_labels.py +135 -135
  117. dtlpy/examples/add_metadata_to_item.py +21 -21
  118. dtlpy/examples/annotate_items_using_model.py +65 -65
  119. dtlpy/examples/annotate_video_using_model_and_tracker.py +75 -75
  120. dtlpy/examples/annotations_convert_to_voc.py +9 -9
  121. dtlpy/examples/annotations_convert_to_yolo.py +9 -9
  122. dtlpy/examples/convert_annotation_types.py +51 -51
  123. dtlpy/examples/converter.py +143 -143
  124. dtlpy/examples/copy_annotations.py +22 -22
  125. dtlpy/examples/copy_folder.py +31 -31
  126. dtlpy/examples/create_annotations.py +51 -51
  127. dtlpy/examples/create_video_annotations.py +83 -83
  128. dtlpy/examples/delete_annotations.py +26 -26
  129. dtlpy/examples/filters.py +113 -113
  130. dtlpy/examples/move_item.py +23 -23
  131. dtlpy/examples/play_video_annotation.py +13 -13
  132. dtlpy/examples/show_item_and_mask.py +53 -53
  133. dtlpy/examples/triggers.py +49 -49
  134. dtlpy/examples/upload_batch_of_items.py +20 -20
  135. dtlpy/examples/upload_items_and_custom_format_annotations.py +55 -55
  136. dtlpy/examples/upload_items_with_modalities.py +43 -43
  137. dtlpy/examples/upload_segmentation_annotations_from_mask_image.py +44 -44
  138. dtlpy/examples/upload_yolo_format_annotations.py +70 -70
  139. dtlpy/exceptions.py +125 -125
  140. dtlpy/miscellaneous/__init__.py +20 -20
  141. dtlpy/miscellaneous/dict_differ.py +95 -95
  142. dtlpy/miscellaneous/git_utils.py +217 -217
  143. dtlpy/miscellaneous/json_utils.py +14 -14
  144. dtlpy/miscellaneous/list_print.py +105 -105
  145. dtlpy/miscellaneous/zipping.py +130 -130
  146. dtlpy/ml/__init__.py +20 -20
  147. dtlpy/ml/base_feature_extractor_adapter.py +27 -27
  148. dtlpy/ml/base_model_adapter.py +1257 -1086
  149. dtlpy/ml/metrics.py +461 -461
  150. dtlpy/ml/predictions_utils.py +274 -274
  151. dtlpy/ml/summary_writer.py +57 -57
  152. dtlpy/ml/train_utils.py +60 -60
  153. dtlpy/new_instance.py +252 -252
  154. dtlpy/repositories/__init__.py +56 -56
  155. dtlpy/repositories/analytics.py +85 -85
  156. dtlpy/repositories/annotations.py +916 -916
  157. dtlpy/repositories/apps.py +383 -383
  158. dtlpy/repositories/artifacts.py +452 -452
  159. dtlpy/repositories/assignments.py +599 -599
  160. dtlpy/repositories/bots.py +213 -213
  161. dtlpy/repositories/codebases.py +559 -559
  162. dtlpy/repositories/collections.py +332 -332
  163. dtlpy/repositories/commands.py +152 -158
  164. dtlpy/repositories/compositions.py +61 -61
  165. dtlpy/repositories/computes.py +439 -435
  166. dtlpy/repositories/datasets.py +1504 -1291
  167. dtlpy/repositories/downloader.py +976 -903
  168. dtlpy/repositories/dpks.py +433 -433
  169. dtlpy/repositories/drivers.py +482 -470
  170. dtlpy/repositories/executions.py +815 -817
  171. dtlpy/repositories/feature_sets.py +226 -226
  172. dtlpy/repositories/features.py +255 -238
  173. dtlpy/repositories/integrations.py +484 -484
  174. dtlpy/repositories/items.py +912 -909
  175. dtlpy/repositories/messages.py +94 -94
  176. dtlpy/repositories/models.py +1000 -988
  177. dtlpy/repositories/nodes.py +80 -80
  178. dtlpy/repositories/ontologies.py +511 -511
  179. dtlpy/repositories/organizations.py +525 -525
  180. dtlpy/repositories/packages.py +1941 -1941
  181. dtlpy/repositories/pipeline_executions.py +451 -451
  182. dtlpy/repositories/pipelines.py +640 -640
  183. dtlpy/repositories/projects.py +539 -539
  184. dtlpy/repositories/recipes.py +419 -399
  185. dtlpy/repositories/resource_executions.py +137 -137
  186. dtlpy/repositories/schema.py +120 -120
  187. dtlpy/repositories/service_drivers.py +213 -213
  188. dtlpy/repositories/services.py +1704 -1704
  189. dtlpy/repositories/settings.py +339 -339
  190. dtlpy/repositories/tasks.py +1477 -1477
  191. dtlpy/repositories/times_series.py +278 -278
  192. dtlpy/repositories/triggers.py +536 -536
  193. dtlpy/repositories/upload_element.py +257 -257
  194. dtlpy/repositories/uploader.py +661 -651
  195. dtlpy/repositories/webhooks.py +249 -249
  196. dtlpy/services/__init__.py +22 -22
  197. dtlpy/services/aihttp_retry.py +131 -131
  198. dtlpy/services/api_client.py +1785 -1782
  199. dtlpy/services/api_reference.py +40 -40
  200. dtlpy/services/async_utils.py +133 -133
  201. dtlpy/services/calls_counter.py +44 -44
  202. dtlpy/services/check_sdk.py +68 -68
  203. dtlpy/services/cookie.py +115 -115
  204. dtlpy/services/create_logger.py +156 -156
  205. dtlpy/services/events.py +84 -84
  206. dtlpy/services/logins.py +235 -235
  207. dtlpy/services/reporter.py +256 -256
  208. dtlpy/services/service_defaults.py +91 -91
  209. dtlpy/utilities/__init__.py +20 -20
  210. dtlpy/utilities/annotations/__init__.py +16 -16
  211. dtlpy/utilities/annotations/annotation_converters.py +269 -269
  212. dtlpy/utilities/base_package_runner.py +285 -264
  213. dtlpy/utilities/converter.py +1650 -1650
  214. dtlpy/utilities/dataset_generators/__init__.py +1 -1
  215. dtlpy/utilities/dataset_generators/dataset_generator.py +670 -670
  216. dtlpy/utilities/dataset_generators/dataset_generator_tensorflow.py +23 -23
  217. dtlpy/utilities/dataset_generators/dataset_generator_torch.py +21 -21
  218. dtlpy/utilities/local_development/__init__.py +1 -1
  219. dtlpy/utilities/local_development/local_session.py +179 -179
  220. dtlpy/utilities/reports/__init__.py +2 -2
  221. dtlpy/utilities/reports/figures.py +343 -343
  222. dtlpy/utilities/reports/report.py +71 -71
  223. dtlpy/utilities/videos/__init__.py +17 -17
  224. dtlpy/utilities/videos/video_player.py +598 -598
  225. dtlpy/utilities/videos/videos.py +470 -470
  226. {dtlpy-1.114.17.data → dtlpy-1.116.6.data}/scripts/dlp +1 -1
  227. dtlpy-1.116.6.data/scripts/dlp.bat +2 -0
  228. {dtlpy-1.114.17.data → dtlpy-1.116.6.data}/scripts/dlp.py +128 -128
  229. {dtlpy-1.114.17.dist-info → dtlpy-1.116.6.dist-info}/METADATA +186 -183
  230. dtlpy-1.116.6.dist-info/RECORD +239 -0
  231. {dtlpy-1.114.17.dist-info → dtlpy-1.116.6.dist-info}/WHEEL +1 -1
  232. {dtlpy-1.114.17.dist-info → dtlpy-1.116.6.dist-info}/licenses/LICENSE +200 -200
  233. tests/features/environment.py +551 -551
  234. dtlpy/assets/__pycache__/__init__.cpython-310.pyc +0 -0
  235. dtlpy-1.114.17.data/scripts/dlp.bat +0 -2
  236. dtlpy-1.114.17.dist-info/RECORD +0 -240
  237. {dtlpy-1.114.17.dist-info → dtlpy-1.116.6.dist-info}/entry_points.txt +0 -0
  238. {dtlpy-1.114.17.dist-info → dtlpy-1.116.6.dist-info}/top_level.txt +0 -0
@@ -1,39 +1,39 @@
1
- from .. import entities
2
- from ..services.api_client import ApiClient
3
- import attr
4
-
5
- @attr.s
6
- class Collection(entities.BaseEntity):
7
- """
8
- Represents a collection in the dataset.
9
- """
10
-
11
- # sdk
12
- _client_api = attr.ib(type=ApiClient, repr=False)
13
-
14
- key = attr.ib(type=str)
15
- name = attr.ib(type=str)
16
-
17
- @classmethod
18
- def from_json(cls, _json, client_api, is_fetched=True):
19
- """
20
- Create a single Collection entity from the dataset JSON.
21
-
22
- :param _json: A dictionary containing collection data in the format:
23
- { "metadata.system.collections.c0": {"name": "Justice League"} }
24
- :param client_api: The client API instance.
25
- :param is_fetched: Whether the entity was fetched from the platform.
26
- :return: A single Collection entity.
27
- """
28
- full_key, value = next(iter(_json.items()))
29
- # Strip the prefix
30
- key = full_key.replace("metadata.system.collections.", "")
31
- name = value.get("name")
32
-
33
- inst = cls(
34
- key=key,
35
- name=name,
36
- client_api=client_api,
37
- )
38
- inst.is_fetched = is_fetched
1
+ from .. import entities
2
+ from ..services.api_client import ApiClient
3
+ import attr
4
+
5
+ @attr.s
6
+ class Collection(entities.BaseEntity):
7
+ """
8
+ Represents a collection in the dataset.
9
+ """
10
+
11
+ # sdk
12
+ _client_api = attr.ib(type=ApiClient, repr=False)
13
+
14
+ key = attr.ib(type=str)
15
+ name = attr.ib(type=str)
16
+
17
+ @classmethod
18
+ def from_json(cls, _json, client_api, is_fetched=True):
19
+ """
20
+ Create a single Collection entity from the dataset JSON.
21
+
22
+ :param _json: A dictionary containing collection data in the format:
23
+ { "metadata.system.collections.c0": {"name": "Justice League"} }
24
+ :param client_api: The client API instance.
25
+ :param is_fetched: Whether the entity was fetched from the platform.
26
+ :return: A single Collection entity.
27
+ """
28
+ full_key, value = next(iter(_json.items()))
29
+ # Strip the prefix
30
+ key = full_key.replace("metadata.system.collections.", "")
31
+ name = value.get("name")
32
+
33
+ inst = cls(
34
+ key=key,
35
+ name=name,
36
+ client_api=client_api,
37
+ )
38
+ inst.is_fetched = is_fetched
39
39
  return inst
dtlpy/entities/command.py CHANGED
@@ -1,169 +1,169 @@
1
- import attr
2
- import traceback
3
- from enum import Enum
4
- from collections import namedtuple
5
-
6
- from .. import repositories, entities
7
- from ..services.api_client import ApiClient
8
-
9
-
10
- class CommandsStatus(str, Enum):
11
- CREATED = 'created'
12
- MAKING_CHILDREN = 'making-children'
13
- WAITING_CHILDREN = 'waiting-children'
14
- IN_PROGRESS = 'in-progress'
15
- ABORTED = 'aborted'
16
- CANCELED = 'canceled'
17
- FINALIZING = 'finalizing'
18
- SUCCESS = 'success'
19
- FAILED = 'failed'
20
- TIMEOUT = 'timeout'
21
- CLEANING_UP = 'cleaning-up'
22
- ON_ERROR = 'on-error'
23
-
24
-
25
- @attr.s
26
- class Command(entities.BaseEntity):
27
- """
28
- Com entity
29
- """
30
- # platform
31
- id = attr.ib()
32
- url = attr.ib(repr=False)
33
- status = attr.ib()
34
- created_at = attr.ib()
35
- updated_at = attr.ib()
36
- type = attr.ib()
37
- progress = attr.ib()
38
- spec = attr.ib()
39
- error = attr.ib()
40
-
41
- # sdk
42
- _client_api = attr.ib(type=ApiClient, repr=False)
43
- _repositories = attr.ib(repr=False)
44
-
45
- ################
46
- # repositories #
47
- ################
48
- @_repositories.default
49
- def set_repositories(self):
50
- reps = namedtuple('repositories',
51
- field_names=['commands'])
52
-
53
- commands_repo = repositories.Commands(client_api=self._client_api)
54
-
55
- r = reps(commands=commands_repo)
56
- return r
57
-
58
- @property
59
- def commands(self):
60
- assert isinstance(self._repositories.commands, repositories.Commands)
61
- return self._repositories.commands
62
-
63
- @staticmethod
64
- def _protected_from_json(_json, client_api, is_fetched=True):
65
- """
66
- Same as from_json but with try-except to catch if error
67
-
68
- :param _json: platform json
69
- :param client_api: ApiClient entity
70
- :param is_fetched: is Entity fetched from Platform
71
- :return:
72
- """
73
- try:
74
- command = Command.from_json(_json=_json,
75
- client_api=client_api,
76
- is_fetched=is_fetched)
77
- status = True
78
- except Exception:
79
- command = traceback.format_exc()
80
- status = False
81
- return status, command
82
-
83
- @classmethod
84
- def from_json(cls, _json, client_api, is_fetched=True):
85
- """
86
- Build a Command entity object from a json
87
-
88
- :param _json: _json response from host
89
- :param client_api: ApiClient entity
90
- :param is_fetched: is Entity fetched from Platform
91
- :return: Command object
92
- """
93
- inst = cls(
94
- id=_json.get('id', None),
95
- url=_json.get('url', None),
96
- status=_json.get('status', None),
97
- created_at=_json.get('createdAt', None),
98
- updated_at=_json.get('updatedAt', None),
99
- type=_json.get('type', None),
100
- progress=_json.get('progress', None),
101
- spec=_json.get('spec', None),
102
- error=_json.get('error', None),
103
- client_api=client_api
104
- )
105
- inst.is_fetched = is_fetched
106
- return inst
107
-
108
- def to_json(self):
109
- """
110
- Returns platform _json format of object
111
-
112
- :return: platform json format of object
113
- :rtype: dict
114
- """
115
- # get excluded
116
- _json = attr.asdict(self, filter=attr.filters.exclude(attr.fields(Command)._client_api,
117
- attr.fields(Command).created_at,
118
- attr.fields(Command).updated_at))
119
- # rename
120
- _json['createdAt'] = self.created_at
121
- _json['updatedAt'] = self.updated_at
122
-
123
- return _json
124
-
125
- def abort(self):
126
- """
127
- abort command
128
-
129
- :return:
130
- """
131
- return self.commands.abort(command_id=self.id)
132
-
133
- def in_progress(self):
134
- """
135
- Check if command is still in one of the in progress statuses
136
-
137
- :return: True if command still in progress
138
- :rtype: bool
139
- """
140
- if self.status not in {status for status in entities.CommandsStatus}:
141
- raise ValueError('status is not a valid CommandsStatus')
142
- return self.status not in [entities.CommandsStatus.SUCCESS,
143
- entities.CommandsStatus.FAILED,
144
- entities.CommandsStatus.TIMEOUT,
145
- entities.CommandsStatus.CANCELED,
146
- entities.CommandsStatus.ABORTED
147
- ]
148
-
149
- def wait(self, timeout=0, step=None, backoff_factor=1, iteration_callback=None):
150
- """
151
- Wait for Command to finish
152
-
153
- :param int timeout: int, seconds to wait until TimeoutError is raised. if 0 - wait until done
154
- :param int step: int, seconds between polling
155
- :param float backoff_factor: A backoff factor to apply between attempts after the second try
156
- :param function iteration_callback: function to call on each iteration
157
- :return: Command object
158
- """
159
- if not self.in_progress():
160
- return self
161
-
162
- return self.commands.wait(
163
- command_id=self.id,
164
- timeout=timeout,
165
- step=step,
166
- url=self.url,
167
- backoff_factor=backoff_factor,
168
- iteration_callback=iteration_callback
169
- )
1
+ import attr
2
+ import traceback
3
+ from enum import Enum
4
+ from collections import namedtuple
5
+
6
+ from .. import repositories, entities
7
+ from ..services.api_client import ApiClient
8
+
9
+
10
+ class CommandsStatus(str, Enum):
11
+ CREATED = 'created'
12
+ MAKING_CHILDREN = 'making-children'
13
+ WAITING_CHILDREN = 'waiting-children'
14
+ IN_PROGRESS = 'in-progress'
15
+ ABORTED = 'aborted'
16
+ CANCELED = 'canceled'
17
+ FINALIZING = 'finalizing'
18
+ SUCCESS = 'success'
19
+ FAILED = 'failed'
20
+ TIMEOUT = 'timeout'
21
+ CLEANING_UP = 'cleaning-up'
22
+ ON_ERROR = 'on-error'
23
+
24
+
25
+ @attr.s
26
+ class Command(entities.BaseEntity):
27
+ """
28
+ Com entity
29
+ """
30
+ # platform
31
+ id = attr.ib()
32
+ url = attr.ib(repr=False)
33
+ status = attr.ib()
34
+ created_at = attr.ib()
35
+ updated_at = attr.ib()
36
+ type = attr.ib()
37
+ progress = attr.ib()
38
+ spec = attr.ib()
39
+ error = attr.ib()
40
+
41
+ # sdk
42
+ _client_api = attr.ib(type=ApiClient, repr=False)
43
+ _repositories = attr.ib(repr=False)
44
+
45
+ ################
46
+ # repositories #
47
+ ################
48
+ @_repositories.default
49
+ def set_repositories(self):
50
+ reps = namedtuple('repositories',
51
+ field_names=['commands'])
52
+
53
+ commands_repo = repositories.Commands(client_api=self._client_api)
54
+
55
+ r = reps(commands=commands_repo)
56
+ return r
57
+
58
+ @property
59
+ def commands(self):
60
+ assert isinstance(self._repositories.commands, repositories.Commands)
61
+ return self._repositories.commands
62
+
63
+ @staticmethod
64
+ def _protected_from_json(_json, client_api, is_fetched=True):
65
+ """
66
+ Same as from_json but with try-except to catch if error
67
+
68
+ :param _json: platform json
69
+ :param client_api: ApiClient entity
70
+ :param is_fetched: is Entity fetched from Platform
71
+ :return:
72
+ """
73
+ try:
74
+ command = Command.from_json(_json=_json,
75
+ client_api=client_api,
76
+ is_fetched=is_fetched)
77
+ status = True
78
+ except Exception:
79
+ command = traceback.format_exc()
80
+ status = False
81
+ return status, command
82
+
83
+ @classmethod
84
+ def from_json(cls, _json, client_api, is_fetched=True):
85
+ """
86
+ Build a Command entity object from a json
87
+
88
+ :param _json: _json response from host
89
+ :param client_api: ApiClient entity
90
+ :param is_fetched: is Entity fetched from Platform
91
+ :return: Command object
92
+ """
93
+ inst = cls(
94
+ id=_json.get('id', None),
95
+ url=_json.get('url', None),
96
+ status=_json.get('status', None),
97
+ created_at=_json.get('createdAt', None),
98
+ updated_at=_json.get('updatedAt', None),
99
+ type=_json.get('type', None),
100
+ progress=_json.get('progress', None),
101
+ spec=_json.get('spec', None),
102
+ error=_json.get('error', None),
103
+ client_api=client_api
104
+ )
105
+ inst.is_fetched = is_fetched
106
+ return inst
107
+
108
+ def to_json(self):
109
+ """
110
+ Returns platform _json format of object
111
+
112
+ :return: platform json format of object
113
+ :rtype: dict
114
+ """
115
+ # get excluded
116
+ _json = attr.asdict(self, filter=attr.filters.exclude(attr.fields(Command)._client_api,
117
+ attr.fields(Command).created_at,
118
+ attr.fields(Command).updated_at))
119
+ # rename
120
+ _json['createdAt'] = self.created_at
121
+ _json['updatedAt'] = self.updated_at
122
+
123
+ return _json
124
+
125
+ def abort(self):
126
+ """
127
+ abort command
128
+
129
+ :return:
130
+ """
131
+ return self.commands.abort(command_id=self.id)
132
+
133
+ def in_progress(self):
134
+ """
135
+ Check if command is still in one of the in progress statuses
136
+
137
+ :return: True if command still in progress
138
+ :rtype: bool
139
+ """
140
+ if self.status not in {status for status in entities.CommandsStatus}:
141
+ raise ValueError('status is not a valid CommandsStatus')
142
+ return self.status not in [entities.CommandsStatus.SUCCESS,
143
+ entities.CommandsStatus.FAILED,
144
+ entities.CommandsStatus.TIMEOUT,
145
+ entities.CommandsStatus.CANCELED,
146
+ entities.CommandsStatus.ABORTED
147
+ ]
148
+
149
+ def wait(self, timeout=0, step=None, backoff_factor=1, iteration_callback=None):
150
+ """
151
+ Wait for Command to finish
152
+
153
+ :param int timeout: int, seconds to wait until TimeoutError is raised. if 0 - wait until done
154
+ :param int step: int, seconds between polling
155
+ :param float backoff_factor: A backoff factor to apply between attempts after the second try
156
+ :param function iteration_callback: function to call on each iteration
157
+ :return: Command object
158
+ """
159
+ if not self.in_progress():
160
+ return self
161
+
162
+ return self.commands.wait(
163
+ command_id=self.id,
164
+ timeout=timeout,
165
+ step=step,
166
+ url=self.url,
167
+ backoff_factor=backoff_factor,
168
+ iteration_callback=iteration_callback
169
+ )