1414 </ script >
1515
1616 < meta name ="viewport " content ="width=device-width, initial-scale=1.0 " />
17- < title > archivist.assets — DATATRAILS v0.34.1 documentation</ title >
17+ < title > archivist.assets — DATATRAILS v0.35.0 documentation</ title >
1818 < link rel ="stylesheet " type ="text/css " href ="../../_static/pygments.css?v=b86133f3 " />
1919 < link rel ="stylesheet " type ="text/css " href ="../../_static/css/theme.css?v=e59714d7 " />
2020 < link rel ="stylesheet " type ="text/css " href ="../../_static/sg_gallery.css?v=d2d258e8 " />
2424 < link rel ="shortcut icon " href ="../../_static/DataTrails_Favicon.png "/>
2525 < script src ="../../_static/jquery.js?v=5d32c60e "> </ script >
2626 < script src ="../../_static/_sphinx_javascript_frameworks_compat.js?v=2cd50e6c "> </ script >
27- < script src ="../../_static/documentation_options.js?v=b49c7ffd "> </ script >
27+ < script src ="../../_static/documentation_options.js?v=6131b1bd "> </ script >
2828 < script src ="../../_static/doctools.js?v=9bcbadda "> </ script >
2929 < script src ="../../_static/sphinx_highlight.js?v=dc90522c "> </ script >
3030 < script crossorigin ="anonymous " integrity ="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA= " src ="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js "> </ script >
@@ -278,7 +278,7 @@ <h1>Source code for archivist.assets</h1><div class="highlight"><pre>
278278 < span class ="bp "> self</ span > < span class ="p "> ,</ span > < span class ="n "> data</ span > < span class ="p "> :</ span > < span class ="s2 "> "dict[str, Any]"</ span > < span class ="p "> ,</ span > < span class ="o "> *</ span > < span class ="p "> ,</ span > < span class ="n "> confirm</ span > < span class ="p "> :</ span > < span class ="nb "> bool</ span > < span class ="o "> =</ span > < span class ="kc "> False</ span >
279279 < span class ="p "> )</ span > < span class ="o "> -></ span > < span class ="s2 "> "tuple[Asset, bool]"</ span > < span class ="p "> :</ span >
280280< span class ="w "> </ span > < span class ="sd "> """</ span >
281- < span class ="sd "> Creates an asset and associated locations and attachments if asset</ span >
281+ < span class ="sd "> Creates an asset and associated attachments if asset</ span >
282282< span class ="sd "> does not already exist.</ span >
283283
284284< span class ="sd "> Args:</ span >
@@ -300,18 +300,6 @@ <h1>Source code for archivist.assets</h1><div class="highlight"><pre>
300300< span class ="sd "> arc_serial_number: das-j1-01</ span >
301301< span class ="sd "> arc_description: Electronic door entry system to DataTrails France</ span >
302302< span class ="sd "> wavestone_asset_id: paris.france.datatrails.das</ span >
303- < span class ="sd "> location:</ span >
304- < span class ="sd "> identity: locations/xxxxxxxxxxxxxxxxxxxxxxxxxx</ span >
305- < span class ="sd "> location:</ span >
306- < span class ="sd "> selector:</ span >
307- < span class ="sd "> - display_name</ span >
308- < span class ="sd "> display_name: DataTrails Paris</ span >
309- < span class ="sd "> description: Sales and sales support for the French region</ span >
310- < span class ="sd "> latitude: 48.8339211,</ span >
311- < span class ="sd "> longitude: 2.371345,</ span >
312- < span class ="sd "> attributes:</ span >
313- < span class ="sd "> address: 5 Parvis Alan Turing, 75013 Paris, France</ span >
314- < span class ="sd "> wavestone_ext: managed</ span >
315303< span class ="sd "> attachments:</ span >
316304< span class ="sd "> - filename: functests/test_resources/doors/assets/entry-terminal.jpg</ span >
317305< span class ="sd "> content_type: image/jpg</ span >
@@ -320,12 +308,6 @@ <h1>Source code for archivist.assets</h1><div class="highlight"><pre>
320308< span class ="sd "> The 'selector' value is required and will usually specify the 'arc_display_name' as a</ span >
321309< span class ="sd "> secondary key. The keys in 'selector' must exist in the attributes of the asset.</ span >
322310
323- < span class ="sd "> If 'location' is specified then the 'selector' value is required and is used as a</ span >
324- < span class ="sd "> secondary key. Likewise the secondary key must exist in the attributes of the location.</ span >
325-
326- < span class ="sd "> Alternatively the identity of the location is specified - both</ span >
327- < span class ="sd "> are shown - choose one.</ span >
328-
329311< span class ="sd "> Returns:</ span >
330312< span class ="sd "> tuple of :class:`Asset` instance, Boolean is True if asset already existed</ span >
331313
@@ -335,7 +317,6 @@ <h1>Source code for archivist.assets</h1><div class="highlight"><pre>
335317 < span class ="n "> existed</ span > < span class ="o "> =</ span > < span class ="kc "> False</ span >
336318 < span class ="n "> data</ span > < span class ="o "> =</ span > < span class ="n "> deepcopy</ span > < span class ="p "> (</ span > < span class ="n "> data</ span > < span class ="p "> )</ span >
337319 < span class ="n "> attachments</ span > < span class ="o "> =</ span > < span class ="n "> data</ span > < span class ="o "> .</ span > < span class ="n "> pop</ span > < span class ="p "> (</ span > < span class ="s2 "> "attachments"</ span > < span class ="p "> ,</ span > < span class ="kc "> None</ span > < span class ="p "> )</ span >
338- < span class ="n "> location</ span > < span class ="o "> =</ span > < span class ="n "> data</ span > < span class ="o "> .</ span > < span class ="n "> pop</ span > < span class ="p "> (</ span > < span class ="s2 "> "location"</ span > < span class ="p "> ,</ span > < span class ="kc "> None</ span > < span class ="p "> )</ span >
339320 < span class ="n "> selector</ span > < span class ="o "> =</ span > < span class ="n "> data</ span > < span class ="o "> .</ span > < span class ="n "> pop</ span > < span class ="p "> (</ span > < span class ="s2 "> "selector"</ span > < span class ="p "> )</ span > < span class ="c1 "> # must exist</ span >
340321 < span class ="n "> props</ span > < span class ="p "> ,</ span > < span class ="n "> attrs</ span > < span class ="o "> =</ span > < span class ="n "> selector_signature</ span > < span class ="p "> (</ span > < span class ="n "> selector</ span > < span class ="p "> ,</ span > < span class ="n "> data</ span > < span class ="p "> )</ span >
341322 < span class ="k "> try</ span > < span class ="p "> :</ span >
@@ -350,16 +331,6 @@ <h1>Source code for archivist.assets</h1><div class="highlight"><pre>
350331 < span class ="n "> LOGGER</ span > < span class ="o "> .</ span > < span class ="n "> info</ span > < span class ="p "> (</ span > < span class ="s2 "> "asset with selector </ span > < span class ="si "> %s</ span > < span class ="s2 "> ,</ span > < span class ="si "> %s</ span > < span class ="s2 "> already exists"</ span > < span class ="p "> ,</ span > < span class ="n "> props</ span > < span class ="p "> ,</ span > < span class ="n "> attrs</ span > < span class ="p "> )</ span >
351332 < span class ="k "> return</ span > < span class ="n "> asset</ span > < span class ="p "> ,</ span > < span class ="kc "> True</ span >
352333
353- < span class ="c1 "> # is location present?</ span >
354- < span class ="k "> if</ span > < span class ="n "> location</ span > < span class ="ow "> is</ span > < span class ="ow "> not</ span > < span class ="kc "> None</ span > < span class ="p "> :</ span >
355- < span class ="k "> if</ span > < span class ="s2 "> "identity"</ span > < span class ="ow "> in</ span > < span class ="n "> location</ span > < span class ="p "> :</ span >
356- < span class ="n "> data</ span > < span class ="p "> [</ span > < span class ="s2 "> "attributes"</ span > < span class ="p "> ][</ span > < span class ="s2 "> "arc_home_location_identity"</ span > < span class ="p "> ]</ span > < span class ="o "> =</ span > < span class ="n "> location</ span > < span class ="p "> [</ span > < span class ="s2 "> "identity"</ span > < span class ="p "> ]</ span >
357- < span class ="k "> else</ span > < span class ="p "> :</ span >
358- < span class ="n "> loc</ span > < span class ="p "> ,</ span > < span class ="n "> _</ span > < span class ="o "> =</ span > < span class ="bp "> self</ span > < span class ="o "> .</ span > < span class ="n "> _archivist</ span > < span class ="o "> .</ span > < span class ="n "> locations</ span > < span class ="o "> .</ span > < span class ="n "> create_if_not_exists</ span > < span class ="p "> (</ span >
359- < span class ="n "> location</ span > < span class ="p "> ,</ span >
360- < span class ="p "> )</ span >
361- < span class ="n "> data</ span > < span class ="p "> [</ span > < span class ="s2 "> "attributes"</ span > < span class ="p "> ][</ span > < span class ="s2 "> "arc_home_location_identity"</ span > < span class ="p "> ]</ span > < span class ="o "> =</ span > < span class ="n "> loc</ span > < span class ="p "> [</ span > < span class ="s2 "> "identity"</ span > < span class ="p "> ]</ span >
362-
363334 < span class ="c1 "> # any attachments ?</ span >
364335 < span class ="k "> if</ span > < span class ="n "> attachments</ span > < span class ="ow "> is</ span > < span class ="ow "> not</ span > < span class ="kc "> None</ span > < span class ="p "> :</ span >
365336 < span class ="k "> for</ span > < span class ="n "> a</ span > < span class ="ow "> in</ span > < span class ="n "> attachments</ span > < span class ="p "> :</ span >
0 commit comments