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,296 +1,292 @@
1
- import logging
2
- import os
3
-
4
- from .. import entities, repositories, services
5
-
6
- logger = logging.getLogger(name='dtlpy')
7
-
8
-
9
- class PackageCodebaseType:
10
- ITEM = 'item'
11
- GIT = 'git'
12
- FILESYSTEM = 'filesystem'
13
- LOCAL = 'local'
14
-
15
-
16
- def Codebase(**kwargs):
17
- """
18
- Factory function to init all codebases types
19
- """
20
- client_api = kwargs.pop('client_api', None)
21
- # take it out because we dont need it from the factory method
22
- _dict = kwargs.pop('_dict', None)
23
-
24
- if kwargs['type'] == PackageCodebaseType.GIT:
25
- cls = GitCodebase.from_json(_json=kwargs,
26
- client_api=client_api)
27
- elif kwargs['type'] == PackageCodebaseType.ITEM:
28
- cls = ItemCodebase.from_json(_json=kwargs,
29
- client_api=client_api)
30
- elif kwargs['type'] == PackageCodebaseType.FILESYSTEM:
31
- cls = FilesystemCodebase.from_json(_json=kwargs,
32
- client_api=client_api)
33
- elif kwargs['type'] == PackageCodebaseType.LOCAL:
34
- cls = LocalCodebase.from_json(_json=kwargs,
35
- client_api=client_api)
36
- else:
37
- raise ValueError('[Codebase constructor] Unknown codebase type: {}'.format(kwargs['type']))
38
- return cls
39
-
40
-
41
- class GitCodebase(entities.DlEntity):
42
- type = entities.DlProperty(location=['type'], _type=str, default='git')
43
- git_url = entities.DlProperty(location=['gitUrl'], _type=str)
44
- git_tag = entities.DlProperty(location=['gitTag'], _type=str)
45
- credentials = entities.DlProperty(location=['credentials'], _type=dict)
46
- _codebases = None
47
- client_api: 'services.ClientApi'
48
-
49
- @property
50
- def is_remote(self):
51
- """ Return whether the codebase is managed remotely and supports upload-download"""
52
- return True
53
-
54
- @property
55
- def is_local(self):
56
- """ Return whether the codebase is locally and has no management implementations"""
57
- return not self.is_remote
58
-
59
- @property
60
- def codebases(self):
61
- if self._codebases is None:
62
- if self._item is not None:
63
- dataset = self.item.dataset
64
- else:
65
- dataset = None
66
- self._codebases = repositories.Codebases(client_api=self.client_api,
67
- dataset=dataset)
68
- assert isinstance(self._codebases, repositories.Codebases)
69
- return self._codebases
70
-
71
- def to_json(self) -> dict:
72
- _dict = self._dict.copy()
73
- return _dict
74
-
75
- @classmethod
76
- def from_json(cls, _json: dict, client_api):
77
- """
78
- :param _json: platform json
79
- :param client_api: ApiClient entity
80
- """
81
- return cls(_dict=_json.copy(),
82
- client_api=client_api)
83
-
84
- @property
85
- def git_user_name(self):
86
- return self.git_url.split('/')[-2]
87
-
88
- @property
89
- def git_repo_name(self):
90
- last = self.git_url.split('/')[-1]
91
- return os.path.splitext(last)[0]
92
-
93
- @property
94
- def git_username(self):
95
- if self.credentials is not None:
96
- return os.environ.get(
97
- self.credentials.get('username', {}).get('key', ''),
98
- None
99
- )
100
- return None
101
-
102
- @property
103
- def git_password(self):
104
- if self.credentials is not None:
105
- return os.environ.get(
106
- self.credentials.get('password', {}).get('key', ''),
107
- None
108
- )
109
- return None
110
-
111
- @staticmethod
112
- def is_git_repo(path):
113
- """
114
- :param path: `str` TODO: Currently only for local folder
115
- :return: `bool` testing if the path is valid git repo
116
- """
117
- return os.path.isdir(os.path.join(path, '.git'))
118
-
119
- def unpack(self, local_path):
120
- """
121
- Clones the git codebase
122
- :param local_path:
123
- """
124
- return self.codebases.clone_git(
125
- codebase=self,
126
- local_path=local_path
127
- )
128
-
129
-
130
- class LocalCodebase(entities.DlEntity):
131
- type: str
132
- local_path: str
133
- _client_api: 'services.ClientApi'
134
-
135
- @property
136
- def is_remote(self):
137
- """ Return whether the codebase is managed remotely and supports upload-download"""
138
- return False
139
-
140
- @property
141
- def is_local(self):
142
- """ Return whether the codebase is locally and has no management implementations"""
143
- return not self.is_remote
144
-
145
- def to_json(self):
146
- _json = {'type': self.type,
147
- 'localPath': self._local_path}
148
- return _json
149
-
150
- @classmethod
151
- def from_json(cls, _json: dict, client_api):
152
- """
153
- :param _json: platform json
154
- :param client_api: ApiClient entity
155
- """
156
- return cls(
157
- client_api=client_api,
158
- local_path=_json.get('localPath', None),
159
- type=_json.get('type', None)
160
- )
161
-
162
-
163
- class FilesystemCodebase(entities.DlEntity):
164
- type: str
165
- host_path: str
166
- container_path: str
167
- _client_api: 'services.ClientApi'
168
-
169
- @property
170
- def is_remote(self):
171
- """ Return whether the codebase is managed remotely and supports upload-download"""
172
- return False
173
-
174
- @property
175
- def is_local(self):
176
- """ Return whether the codebase is locally and has no management implementations"""
177
- return not self.is_remote
178
-
179
- def to_json(self):
180
- _json = super().to_json()
181
- if self.host_path is not None:
182
- _json['hostPath'] = self.host_path
183
- if self.container_path is not None:
184
- _json['containerPath'] = self.container_path
185
- return _json
186
-
187
- @classmethod
188
- def from_json(cls, _json: dict, client_api):
189
- """
190
- :param _json: platform json
191
- :param client_api: ApiClient entity
192
- """
193
- return cls(
194
- client_api=client_api,
195
- container_path=_json.get('containerPath', None),
196
- host_path=_json.get('hostPath', None),
197
- type=_json.get('type', None)
198
- )
199
-
200
-
201
- class ItemCodebase(entities.DlEntity):
202
- type = entities.DlProperty(location=['type'], _type=str)
203
- item_id = entities.DlProperty(location=['itemId'], _type=str)
204
- _item = entities.DlProperty(location=['item'], _type=str, default=None)
205
- _codebases = None
206
- client_api: 'services.ClientApi'
207
-
208
- @property
209
- def item(self):
210
- if self._item is None:
211
- self._item = self.codebases.items_repository.get(item_id=self.item_id)
212
- return self._item
213
-
214
- @property
215
- def is_remote(self):
216
- """ Return whether the codebase is managed remotely and supports upload-download"""
217
- return True
218
-
219
- @property
220
- def is_local(self):
221
- """ Return whether the codebase is locally and has no management implementations"""
222
- return not self.is_remote
223
-
224
- @property
225
- def codebases(self):
226
- if self._codebases is None:
227
- if self._item is not None:
228
- dataset = self.item.dataset
229
- else:
230
- dataset = None
231
- self._codebases = repositories.Codebases(client_api=self.client_api,
232
- dataset=dataset)
233
- assert isinstance(self._codebases, repositories.Codebases)
234
- return self._codebases
235
-
236
- def to_json(self) -> dict:
237
- _dict = self._dict.copy()
238
- _dict.pop('item', None)
239
- return _dict
240
-
241
- @classmethod
242
- def from_json(cls, _json: dict, client_api):
243
- """
244
- :param _json: platform json
245
- :param client_api: ApiClient entity
246
- """
247
- return cls(_dict=_json.copy(),
248
- client_api=client_api)
249
-
250
- def unpack(self, local_path):
251
- """
252
- Clones the git codebase
253
- :param local_path:
254
- """
255
- return self.codebases.unpack(
256
- codebase_id=self.item_id,
257
- local_path=local_path
258
- )
259
-
260
- @property
261
- def version(self):
262
- return str(self.item.name.split('.')[0])
263
-
264
- @property
265
- def md5(self):
266
- md5 = None
267
- if 'system' in self.item.metadata:
268
- md5 = self.item.metadata['system'].get('md5', None)
269
- return md5
270
-
271
- @md5.setter
272
- def md5(self, md5):
273
- if 'system' not in self.item.metadata:
274
- self.item.metadata['system'] = dict()
275
- self.item.metadata['system']['md5'] = md5
276
-
277
- @property
278
- def description(self):
279
- description = None
280
- if 'system' in self.item.metadata:
281
- description = self.item.metadata['system'].get('description', None)
282
- return description
283
-
284
- @description.setter
285
- def description(self, description):
286
- if 'system' not in self.item.metadata:
287
- self.item.metadata['system'] = dict()
288
- self.item.metadata['system']['description'] = description
289
-
290
- def list_versions(self):
291
- """
292
- List Codebase versions
293
- """
294
- # get codebase name
295
- codebase_name = self.item.filename.split('/')[len(self.item.filename.split('/')) - 2]
296
- return self.codebases.list_versions(codebase_name=codebase_name)
1
+ import logging
2
+ import os
3
+
4
+ from .. import entities, repositories, services
5
+
6
+ logger = logging.getLogger(name='dtlpy')
7
+
8
+
9
+ class PackageCodebaseType:
10
+ ITEM = 'item'
11
+ GIT = 'git'
12
+ FILESYSTEM = 'filesystem'
13
+ LOCAL = 'local'
14
+
15
+
16
+ def Codebase(**kwargs):
17
+ """
18
+ Factory function to init all codebases types
19
+ """
20
+ client_api = kwargs.pop('client_api', None)
21
+ # take it out because we dont need it from the factory method
22
+ _dict = kwargs.pop('_dict', None)
23
+
24
+ if kwargs['type'] == PackageCodebaseType.GIT:
25
+ cls = GitCodebase.from_json(_json=kwargs,
26
+ client_api=client_api)
27
+ elif kwargs['type'] == PackageCodebaseType.ITEM:
28
+ cls = ItemCodebase.from_json(_json=kwargs,
29
+ client_api=client_api)
30
+ elif kwargs['type'] == PackageCodebaseType.FILESYSTEM:
31
+ cls = FilesystemCodebase.from_json(_json=kwargs,
32
+ client_api=client_api)
33
+ elif kwargs['type'] == PackageCodebaseType.LOCAL:
34
+ cls = LocalCodebase.from_json(_json=kwargs,
35
+ client_api=client_api)
36
+ else:
37
+ raise ValueError('[Codebase constructor] Unknown codebase type: {}'.format(kwargs['type']))
38
+ return cls
39
+
40
+
41
+ class GitCodebase(entities.DlEntity):
42
+ type = entities.DlProperty(location=['type'], _type=str, default='git')
43
+ git_url = entities.DlProperty(location=['gitUrl'], _type=str)
44
+ git_tag = entities.DlProperty(location=['gitTag'], _type=str)
45
+ credentials = entities.DlProperty(location=['credentials'], _type=dict)
46
+ _codebases = None
47
+ client_api: 'services.ClientApi'
48
+
49
+ @property
50
+ def is_remote(self):
51
+ """ Return whether the codebase is managed remotely and supports upload-download"""
52
+ return True
53
+
54
+ @property
55
+ def is_local(self):
56
+ """ Return whether the codebase is locally and has no management implementations"""
57
+ return not self.is_remote
58
+
59
+ @property
60
+ def codebases(self):
61
+ if self._codebases is None:
62
+ self._codebases = repositories.Codebases(client_api=self.client_api,
63
+ dataset=None)
64
+ assert isinstance(self._codebases, repositories.Codebases)
65
+ return self._codebases
66
+
67
+ def to_json(self) -> dict:
68
+ _dict = self._dict.copy()
69
+ return _dict
70
+
71
+ @classmethod
72
+ def from_json(cls, _json: dict, client_api):
73
+ """
74
+ :param _json: platform json
75
+ :param client_api: ApiClient entity
76
+ """
77
+ return cls(_dict=_json.copy(),
78
+ client_api=client_api)
79
+
80
+ @property
81
+ def git_user_name(self):
82
+ return self.git_url.split('/')[-2]
83
+
84
+ @property
85
+ def git_repo_name(self):
86
+ last = self.git_url.split('/')[-1]
87
+ return os.path.splitext(last)[0]
88
+
89
+ @property
90
+ def git_username(self):
91
+ if self.credentials is not None:
92
+ return os.environ.get(
93
+ self.credentials.get('username', {}).get('key', ''),
94
+ None
95
+ )
96
+ return None
97
+
98
+ @property
99
+ def git_password(self):
100
+ if self.credentials is not None:
101
+ return os.environ.get(
102
+ self.credentials.get('password', {}).get('key', ''),
103
+ None
104
+ )
105
+ return None
106
+
107
+ @staticmethod
108
+ def is_git_repo(path):
109
+ """
110
+ :param path: `str` TODO: Currently only for local folder
111
+ :return: `bool` testing if the path is valid git repo
112
+ """
113
+ return os.path.isdir(os.path.join(path, '.git'))
114
+
115
+ def unpack(self, local_path):
116
+ """
117
+ Clones the git codebase
118
+ :param local_path:
119
+ """
120
+ return self.codebases.clone_git(
121
+ codebase=self,
122
+ local_path=local_path
123
+ )
124
+
125
+
126
+ class LocalCodebase(entities.DlEntity):
127
+ type: str
128
+ local_path: str
129
+ _client_api: 'services.ClientApi'
130
+
131
+ @property
132
+ def is_remote(self):
133
+ """ Return whether the codebase is managed remotely and supports upload-download"""
134
+ return False
135
+
136
+ @property
137
+ def is_local(self):
138
+ """ Return whether the codebase is locally and has no management implementations"""
139
+ return not self.is_remote
140
+
141
+ def to_json(self):
142
+ _json = {'type': self.type,
143
+ 'localPath': self._local_path}
144
+ return _json
145
+
146
+ @classmethod
147
+ def from_json(cls, _json: dict, client_api):
148
+ """
149
+ :param _json: platform json
150
+ :param client_api: ApiClient entity
151
+ """
152
+ return cls(
153
+ client_api=client_api,
154
+ local_path=_json.get('localPath', None),
155
+ type=_json.get('type', None)
156
+ )
157
+
158
+
159
+ class FilesystemCodebase(entities.DlEntity):
160
+ type: str
161
+ host_path: str
162
+ container_path: str
163
+ _client_api: 'services.ClientApi'
164
+
165
+ @property
166
+ def is_remote(self):
167
+ """ Return whether the codebase is managed remotely and supports upload-download"""
168
+ return False
169
+
170
+ @property
171
+ def is_local(self):
172
+ """ Return whether the codebase is locally and has no management implementations"""
173
+ return not self.is_remote
174
+
175
+ def to_json(self):
176
+ _json = super().to_json()
177
+ if self.host_path is not None:
178
+ _json['hostPath'] = self.host_path
179
+ if self.container_path is not None:
180
+ _json['containerPath'] = self.container_path
181
+ return _json
182
+
183
+ @classmethod
184
+ def from_json(cls, _json: dict, client_api):
185
+ """
186
+ :param _json: platform json
187
+ :param client_api: ApiClient entity
188
+ """
189
+ return cls(
190
+ client_api=client_api,
191
+ container_path=_json.get('containerPath', None),
192
+ host_path=_json.get('hostPath', None),
193
+ type=_json.get('type', None)
194
+ )
195
+
196
+
197
+ class ItemCodebase(entities.DlEntity):
198
+ type = entities.DlProperty(location=['type'], _type=str)
199
+ item_id = entities.DlProperty(location=['itemId'], _type=str)
200
+ _item = entities.DlProperty(location=['item'], _type=str, default=None)
201
+ _codebases = None
202
+ client_api: 'services.ClientApi'
203
+
204
+ @property
205
+ def item(self):
206
+ if self._item is None:
207
+ self._item = self.codebases.items_repository.get(item_id=self.item_id)
208
+ return self._item
209
+
210
+ @property
211
+ def is_remote(self):
212
+ """ Return whether the codebase is managed remotely and supports upload-download"""
213
+ return True
214
+
215
+ @property
216
+ def is_local(self):
217
+ """ Return whether the codebase is locally and has no management implementations"""
218
+ return not self.is_remote
219
+
220
+ @property
221
+ def codebases(self):
222
+ if self._codebases is None:
223
+ if self._item is not None:
224
+ dataset = self.item.dataset
225
+ else:
226
+ dataset = None
227
+ self._codebases = repositories.Codebases(client_api=self.client_api,
228
+ dataset=dataset)
229
+ assert isinstance(self._codebases, repositories.Codebases)
230
+ return self._codebases
231
+
232
+ def to_json(self) -> dict:
233
+ _dict = self._dict.copy()
234
+ _dict.pop('item', None)
235
+ return _dict
236
+
237
+ @classmethod
238
+ def from_json(cls, _json: dict, client_api):
239
+ """
240
+ :param _json: platform json
241
+ :param client_api: ApiClient entity
242
+ """
243
+ return cls(_dict=_json.copy(),
244
+ client_api=client_api)
245
+
246
+ def unpack(self, local_path):
247
+ """
248
+ Clones the git codebase
249
+ :param local_path:
250
+ """
251
+ return self.codebases.unpack(
252
+ codebase_id=self.item_id,
253
+ local_path=local_path
254
+ )
255
+
256
+ @property
257
+ def version(self):
258
+ return str(self.item.name.split('.')[0])
259
+
260
+ @property
261
+ def md5(self):
262
+ md5 = None
263
+ if 'system' in self.item.metadata:
264
+ md5 = self.item.metadata['system'].get('md5', None)
265
+ return md5
266
+
267
+ @md5.setter
268
+ def md5(self, md5):
269
+ if 'system' not in self.item.metadata:
270
+ self.item.metadata['system'] = dict()
271
+ self.item.metadata['system']['md5'] = md5
272
+
273
+ @property
274
+ def description(self):
275
+ description = None
276
+ if 'system' in self.item.metadata:
277
+ description = self.item.metadata['system'].get('description', None)
278
+ return description
279
+
280
+ @description.setter
281
+ def description(self, description):
282
+ if 'system' not in self.item.metadata:
283
+ self.item.metadata['system'] = dict()
284
+ self.item.metadata['system']['description'] = description
285
+
286
+ def list_versions(self):
287
+ """
288
+ List Codebase versions
289
+ """
290
+ # get codebase name
291
+ codebase_name = self.item.filename.split('/')[len(self.item.filename.split('/')) - 2]
292
+ return self.codebases.list_versions(codebase_name=codebase_name)