gzbddlZddlZddlZddlZddlZddlmZddlm Z ddl Z ddl m Z ddl m Z mZmZmZddlmZmZmZmZmZmZmZdZdZd Zd Zd Zd Zd ZdZ dZ!dZ"dQdZ#dZ$dZ%dRdZ&dZ'dZ(dZ)dZ*dZ+dZ,dZ-dZ.dZ/ dSdZ0dTdZ1d Z2dTd!Z3d"Z4d#Z5d$Z6d%Z7d&Z8d'Z9d(Z:d)Z;d*Zd-Z?d.Z@d/ZAd0ZBd1ZCd2ZDd3ZEd4ZFd5ZGd6ZHd7ZId8ZJd9ZKd:ZLd;ZMd<ZNd=ZOd>ZPd?ZQd@ZRdAZSdBZTdCZUdDZVdEZWdFZXdGZYdHZZdIZ[dJZ\dKZ]dLZ^dMZ_dQdNZ`dQdOZadQdPZby)UN) string_types) HTTPError)utils)call_apicall_metadata_api call_json_api _call_v2_api) BadRequestAuthorizationRequired NotAllowedNotFound AlreadyExists RateLimited GeneralErrorc tddgifi|S)Ngetpingroptionss #/opt/Tautulli/lib/cloudinary/api.pyrrs EF8R 37 33c |jdd}dg}|r@t|tjrt j |}|j |td|ifi|S)aGet account usage details. Get a report on the status of your Cloudinary account usage details, including storage, credits, bandwidth, requests, number of resources, and add-on usage. Note that numbers are updated periodically. See: `Get account usage details `_ :param options: Additional options :type options: dict, optional :return: Detailed usage information :rtype: Response dateNusager)pop isinstancedatetimerrencode_date_to_usage_api_formatappendr)rruris rrr#s\ ;;vt $D )C dHMM *88>D 4 E3 .g ..rc 8t|d}tddg|fi|S)z Get account config details. :param options: Additional options. :type options: dict, optional :return: Detailed config information. :rtype: Response settingsrconfigonlyrrparamss rr$r$:s&': &F EH:v 9 99rc tddgifi|S)Nr resourcesrrs rresource_typesr+Gs EK=" 8 88rc |jdd}|jdd}d|g}|r|j|tdi|}|jt |ddt d||fi|S) N resource_typeimagetyper*prefixstart_atr)rr __list_resources_paramsupdater&rrr- upload_typer!r(s rr*r*KsqKK9M++fd+K  &C ; $ /w /F MM$w*56 E3 2' 22rc d|jdd}d|d|g}tdi|}td||fi|S)Nr-r.r*tagsrr2rr3rtagrr-r!r(s rresources_by_tagr<VsAKK9M  vs 3C $ /w /F E3 2' 22rc f|jdd}d|d||g}tdi|}td||fi|S)Nr-r.r* moderationsrr2r9)kindstatusrr-r!r(s rresources_by_moderationrA]sCKK9M  }dF CC $ /w /F E3 2' 22rc |jdd}|jdd}d||g}ttdi||}td||fi|S) Nr-r.r/uploadr* public_idsrr2)rdict__resources_paramsrrErr-r6r!r(s rresources_by_idsrIdsWKK9M++fh/K  { 3C $/w/J GF E3 2' 22rc Fddg}tdi|}||d<td||fi|S)an Returns the details of the resources (assets) under a specified asset_folder. :param asset_folder: The Asset Folder of the asset :type asset_folder: string :param options: Additional options :type options: dict, optional :return: Resources (assets) of a specific asset_folder :rtype: Response r*by_asset_folder asset_folderrr2)r3r)rLrr!r(s rresources_by_asset_folderrMls: ) *C $ /w /F)F> E3 2' 22rc Rddg}ttdi||}td||fi|S)aRetrieves the resources (assets) indicated in the asset IDs. This method does not return deleted assets even if they have been backed up. See: `Get resources by context API reference `_ :param asset_ids: The requested asset IDs. :type asset_ids: list[str] :param options: Additional options :type options: dict, optional :return: Resources (assets) as indicated in the asset IDs :rtype: Response r* by_asset_ids) asset_idsrr2)rFrGr)rPrr!r(s rresources_by_asset_idsrQ}s7  'C $/w/9 EF E3 2' 22rc z|jdd}d|dg}tdi|}||d<|||d<td||fi|S) aRetrieves resources (assets) with a specified context key. This method does not return deleted assets even if they have been backed up. See: `Get resources by context API reference `_ :param key: Only assets with this context key are returned :type key: str :param value: Only assets with this value for the context key are returned :type value: str, optional :param options: Additional options :type options: dict, optional :return: Resources (assets) with a specified context key :rtype: Response r-r.r*contextkeyvaluerr2r9)rTrUrr-r!r(s rresources_by_contextrVsY KK9M  y 1C $ /w /FF5M w E3 2' 22rc t|dddd}|jdxr+tjtj|d|d<|S) Prepares optional parameters for resources_* API calls. :param options: Additional options :return: Optional parameters :internal r8rSmetadatar>fields)r&rr encode_list build_arrayr's rrGrGsP'69j- HF{{8,h1B1B5CTCTU\]eUfCg1hF8 Mrc Vtdi|}|jt|ddd|S)rX next_cursor max_results directionr2)rGr4r&)rresources_paramss rr3r3s1*4G4D- TU rc \ddg}|||tj|dd}td||fi|S)ai Find images based on their visual content. :param image_url: The URL of an image. :type image_url: str :param image_asset_id: The asset_id of an image in your account. :type image_asset_id: str :param text: A textual description, e.g., "cat" :type text: str :param image_file: The image file. :type image_file: str|callable|Path|bytes :param options: Additional options :type options: dict, optional :return: Resources (assets) that were found :rtype: Response r* visual_searchfile) image_urlimage_asset_idtext image_filepost)rhandle_file_parameterr)rerfrgrhrr!r(s rrcrcsB"  (C$PT!77 FKMF FC 37 33rc |jdd}|jdd}d|||g}tdi|}td||fi|S)Nr-r.r/rCr*rr2)r_prepare_asset_details_paramsr public_idrr-r6r!r(s rresourcerosQKK9M++fh/K  {I >C * 5W 5F E3 2' 22rc <d|g}tdi|}td||fi|S)aa Returns the details of the specified asset and all its derived assets by asset id. :param asset_id: The Asset ID of the asset :type asset_id: string :param options: Additional options :type options: dict, optional :return: Resource (asset) of a specific asset_id :rtype: Response r*rr2)rlr)asset_idrr!r(s rresource_by_asset_idrrs/  !C * 5W 5F E3 2' 22rc 8t|ddddddddd d d d d dddS)z Prepares optional parameters for resource_by_asset_id API calls. :param options: Additional options :return: Optional parameters :internal exiffacescolorsimage_metadatamedia_metadatacinemagraph_analysispagesphash coordinatesr_quality_analysisderived_next_cursoraccessibility_analysisversionsrelatedrelated_next_cursorr&rs rrlrls= (4DFVXn-@RTi(*iAV XXrc "|jdd}|jdd}d|||g}t|dddd d d d d d }d|vr*djtj|d|d<d|vr'tj |j d|d<d|vr'tj |j d|d<d|vr'tj|j d|d<d|vr'tj|j d|d<d|vr'tj|j d|d<d|vrt|j d|d<d|vr:tjtj|j d|d<d|vr|j d|d<d|vr|j d|d<d|vr|j d|d<d|vr|j d|d<td||fi|S)Nr-r.r/rCr*moderation_status raw_convertquality_overrideocrcategorization detectionsimilarity_searchbackground_removalnotification_urlr8,face_coordinatescustom_coordinatesregionsrSrY auto_taggingaccess_controlrL display_nameunique_display_name clear_invalidri) rr&joinrr\encode_double_arrayr json_encodeencode_contextstrbuild_list_of_dictsrrms rr4r4sKK9M++fh/K  {I >C '. $e"K1D&(:%>w{{K]?^%_!"w&','@'@MaAb'c#$G!--gkk).DEyG!00Y1GHyW"11'++j2IJz !$W[[%@!A~7"#(#4#4U5N5Nw{{[kOl5m#n  !(^!<~ !(^!<~'(/ 4I(J$%'!")++o"> FC 37 33rc |jdd}|jdd}d||g}t||}td||fi|S)Nr-r.r/rCr*rDdeleter__delete_resource_paramsrrHs rdelete_resourcesr'sNKK9M++fh/K  { 3C %g* EF Hc6 5W 55rc |jdd}|jdd}d||g}t||}td||fi|S)Nr-r.r/rCr*r0rr)r0rr-r6r!r(s rdelete_resources_by_prefixr/sNKK9M++fh/K  { 3C %gf =F Hc6 5W 55rc |jdd}|jdd}d||g}t|d}td||fi|S) Nr-r.r/rCr*T)allrrr5s rdelete_all_resourcesr7sNKK9M++fh/K  { 3C %g4 8F Hc6 5W 55rc d|jdd}d|d|g}t|}td||fi|S)Nr-r.r*r8rrr:s rdelete_resources_by_tagr?s>KK9M  vs 3C %g .F Hc6 5W 55rc ,dg}d|i}td||fi|S)Nderived_resourcesderived_resource_idsrr)rrr!r(s rdelete_derived_resourcesrFs)  C$&: ;F Hc6 5W 55rc d||g}t|ts|g}|tj|dd}|||d<t d||fi|S)aDelete derived resources of public ids, identified by transformations :param public_ids: the base resources :type public_ids: list of str :param transformations: the transformation of derived resources, optionally including the format :type transformations: list of (dict or str) :param type: The upload type :type type: str :param resource_type: The type of the resource: defaults to "image" :type resource_type: str :param invalidate: (optional) True to invalidate the resources after deletion :type invalidate: bool :return: a list of the public ids for which derived resources were deleted :rtype: dict r*T)rEtransformations keep_original invalidater)rlistr build_eagerr)rErr-r/rrr!r(s r delete_derived_by_transformationrLsb$  t ,C j$ ' \ &!&!2!2?!C#%F)| Hc6 5W 55rc Zdd|||g}dtj|i}td||fi|S)a_ Relates an asset to other assets by public IDs. :param public_id: The public ID of the asset to update. :type public_id: str :param assets_to_relate: The array of up to 10 fully_qualified_public_ids given as resource_type/type/public_id. :type assets_to_relate: list[str] :param type: The upload type. Defaults to "upload". :type type: str :param resource_type: The type of the resource. Defaults to "image". :type resource_type: str :param options: Additional options. :type options: dict, optional :return: The result of the command. :rtype: dict r*related_assetsassets_to_relaterirr\r)rnrr-r/rr!r(s radd_related_assetsris?" (-y IC %"3"34D"E FF f 8 88rc Vdd|g}dtj|i}td||fi|S)ar Relates an asset to other assets by asset IDs. :param asset_id: The asset ID of the asset to update. :type asset_id: str :param assets_to_relate: The array of up to 10 asset IDs. :type assets_to_relate: list[str] :param options: Additional options. :type options: dict, optional :return: The result of the command. :rtype: dict r*rrrir)rqrrr!r(s radd_related_assets_by_asset_idsrs; (( 3C %"3"34D"E FF f 8 88rc Zdd|||g}dtj|i}td||fi|S)aQ Unrelates an asset from other assets by public IDs. :param public_id: The public ID of the asset to update. :type public_id: str :param assets_to_unrelate: The array of up to 10 fully_qualified_public_ids given as resource_type/type/public_id. :type assets_to_unrelate: list[str] :param type: The upload type. :type type: str :param resource_type: The type of the resource: defaults to "image". :type resource_type: str :param options: Additional options. :type options: dict, optional :return: The result of the command. :rtype: dict r*rassets_to_unrelaterr)rnrr-r/rr!r(s rdelete_related_assetsrs?" (-y IC"E$5$56H$I JF 3 :' ::rc Vdd|g}dtj|i}td||fi|S)az Unrelates an asset from other assets by asset IDs. :param asset_id: The asset ID of the asset to update. :type asset_id: str :param assets_to_unrelate: The array of up to 10 asset IDs. :type assets_to_unrelate: list[str] :param options: Additional options. :type options: dict, optional :return: The result of the command. :rtype: dict r*rrrr)rqrrr!r(s r"delete_related_assets_by_asset_idsrs; (( 3C"E$5$56H$I JF 3 :' ::rc b|jdd}d|g}td|t|dddfi|S)Nr-r.r8rr^r_r0)rrr&)rr-r!s rr8r8s<KK9M = !C E3Wm]H U aY` aarc @dg}t|ddd}td||fi|S)Nrnamedr^r_rr%rr!r(s rrrs.  C '7M= AF E3 2' 22rc ndg}t|dd}tj||d<td||fi|S)Nrr^r_transformationr)r&rbuild_single_eagerrrrr!r(s rrrsB  C '=- 8F$77GF  E3 2' 22rc Rdg}dtj|i}td||fi|S)Nrrrrrrrs rdelete_transformationrs3  C 8 8 H IF Hc6 5W 55rc dg}t|d}d|vrt|jd|d<tj||d<t d||fi|S)Nrallowed_for_strict unsafe_updaterput)r&transformation_stringrrrr)rrr!updatess rupdate_transformationrsa  C701G'!#8_9U#V % 8 8 HG  E3 37 33rc Tdg}|tj|d}td||fi|S)Nr)namerrir)r definitionrr!r(s rcreate_transformationrs3  Ce.F.Fz.R SF FC 37 33rc ~|jdd}d|dg}tt|ddd|}td ||fi|S) Nr-r.r*publish_resourcesr/ overwriterrDrirrFr&r)rErr-r!r(s rpublish_by_idsrsJKK9M  ': ;C $w \Bz ZF FC 37 33rc ~|jdd}d|dg}tt|ddd|}td ||fi|S) Nr-r.r*rr/rrrrir)r0rr-r!r(s rpublish_by_prefixrsJKK9M  ': ;C $w \B6 RF FC 37 33rc ~|jdd}d|dg}tt|ddd|}td ||fi|S) Nr-r.r*rr/rr)r;rirr:s rpublish_by_tagrsJKK9M  ': ;C $w \B LF FC 37 33rc :dg}td|t|ddfi|S)Nupload_presetsrr^r_rr&rr!s rrrs'  C E3Wm] K Ww WWrc :d|g}td|t|dfi|S)Nrrr_rrrr!s r upload_presetrs' T "C E3Wm < H HHrc &d|g}td|ifi|S)Nrrrrs rdelete_upload_presetr s T "C Hc2 1 11rc d|g}tjdi|}tj|}|jt |dddt d||fi|S)Nrunsigneddisallow_public_idliverr2rbuild_upload_paramscleanup_paramsr4r&rrrr!r(s rupdate_upload_presetrs[ T "C  & & 1 1F  ! !& )F MM$w ,@&IJ E3 2' 22rc dg}tjdi|}tj|}|jt |ddddt d||fi|S)Nrrrrrrir2rrs rcreate_upload_presetrs[  C  & & 1 1F  ! !& )F MM$w ,@&&QR FC 37 33rc 6tddgt|ddfi|SNrfoldersr^r_rrs r root_foldersr"s" EI;Wm](S _W^ __rc 8tdd|gt|ddfi|Srr)of_folder_pathrs r subfoldersr&s& EI~6WmUb8c ogn oorc "tdd|gifi|S)Nrirr)pathrs r create_folderr*s FY-r =W ==rc *d|i}tdd|g|fi|S)z Renames folder :param from_path: The full path of an existing asset folder. :param to_path: The full path of the new asset folder. :param options: Additional options :rtype: Response to_folderrrr) from_pathto_pathrr(s r rename_folderr.s'7 #F EIy16 EW EErc :t|d}tdd|g|fi|S)zDeletes folder Deleted folder must be empty, but can have descendant empty sub folders :param path: The folder to delete :param options: Additional options :rtype: Response skip_backuprrr%)rrr(s r delete_folderr<s)'= )F Hy$/ C7 CCrc |jdd}|jdd}d||dg}td d|it|d}td ||fi|S) Nr-r.r/rCr*restorerErrir2)rrFr&rrHs rrrKs]KK9M++fh/K  {I >C  EZ E4+D EF f 8 88rc :dg}td|t|ddfi|S)Nupload_mappingsrr^r_rrs rr r Ss'  C E3Wm] K Ww WWrc <dg}t|}td||fi|S)Nr folderrrFrrs rupload_mappingrXs(  C  F E3 2' 22rc <dg}t|}td||fi|S)Nr r rr rs rdelete_upload_mappingr^s(  C  F Hc6 5W 55rc rdg}t|}|jt|dtd||fi|S)Nr r templaterrFr4r&rrs rupdate_upload_mappingrds;  C  F MM$w +, E3 2' 22rc rdg}t|}|jt|dtd||fi|S)Nr r rrirrs rcreate_upload_mappingrks;  C  F MM$w +, FC 37 33rc $dg}td|ifi|SNstreaming_profilesGETrrs rlist_streaming_profilesrrs  C E3 .g ..rc &d|g}td|ifi|Srrrs rget_streaming_profilerws  &C E3 .g ..rc &d|g}td|ifi|S)NrDELETErrs rdelete_streaming_profiler |s  &C Hc2 1 11rc Ddg}tdi|}||d<td||fi|S)NrrPOSTr2"__prepare_streaming_profile_paramsrrs rcreate_streaming_profiler%s4  C / :' :FF6N FC 37 33rc <d|g}tdi|}td||fi|S)NrPUTr2r#rs rupdate_streaming_profiler(s-  &C / :' :F E3 2' 22rc>|Dcic] }||vs|||c}Scc}wNr2)sourcekeysrTs rr&r&s%(, >v C  >> >s cjt|tr|Stjjdi|dS)Nrr2)rr cloudinaryrgenerate_transformation_string)rs rrrs2.,/>>PPQRSSrc t|d}d|vr5|dDcgc]}dt|i}}tj||d<|Scc}w)Nrrepresentationsr)r&rjsondumps)rr(transr1s rr$r$sf '> *FG#(/0A(BD$-.CE.JKDD$(JJ$? ! MDsAc tddtj|jdit |ddd}|j ||S)Nrrr^rr2)rFrrrr&r4)rr(ps rrrsO  LU..w{{;L/MN LG_m\J LAHHV Hrc tdgifi|S)zReturns a list of all metadata field definitions See: `Get metadata fields API reference `_ :param options: Additional options :rtype: Response rrrs rlist_metadata_fieldsr9s UB 6g 66rc $|g}td|ifi|S)aDGets a metadata field by external id See: `Get metadata field by external ID API reference `_ :param field_external_id: The ID of the metadata field to retrieve :param options: Additional options :rtype: Response rr8field_external_idrr!s rmetadata_field_by_field_idr=s   C UC 7w 77rc 0tdgt|fi|S)aCreates a new metadata field definition See: `Create metadata field API reference `_ :param field: The field to add :param options: Additional options :rtype: Response rir__metadata_field_params)fieldrs radd_metadata_fieldrBs VR)@)G S7 SSrc 6|g}td|t|fi|S)aUpdates a metadata field by external id Updates a metadata field definition (partially, no need to pass the entire object) passed as JSON data. See `Generic structure of a metadata field `_ for details. :param field_external_id: The id of the metadata field to update :param field: The field definition :param options: Additional options :rtype: Response rr?)r<rArr!s rupdate_metadata_fieldrDs&  C UC)@)G S7 SSrc *t|ddddddddd S) Nr/ external_idlabel mandatory restrictions default_valuedefault_disabled validation datasourcer)rAs rr@r@s' v}g{N!3\< QQrc $|g}td|ifi|S)aDeletes a metadata field definition. The field should no longer be considered a valid candidate for all other endpoints See: `Delete metadata field API reference `_ :param field_external_id: The external id of the field to delete :param options: Additional options :return: An array with a "message" key. "ok" value indicates a successful deletion. :rtype: Response rr8r;s rdelete_metadata_fieldrOs   C XsB :' ::rc .|dg}d|i}td||fi|S)aDeletes entries in a metadata field datasource Deletes (blocks) the datasource entries for a specified metadata field definition. Sets the state of the entries to inactive. This is a soft delete, the entries still exist under the hood and can be activated again with the restore datasource entries method. See: `Delete entries in a metadata field datasource API reference `_ :param field_external_id: The id of the field to update :param entries_external_id: The ids of all the entries to delete from the datasource :param options: Additional options :rtype: Response rM external_idsrr8)r<entries_external_idrr!r(s rdelete_datasource_entriesrSs-$ l +C1 2F XsF >g >>rc g}|D]#}t|dd}|s|j|%|dg}d|i}td||fi|S)a~Updates a metadata field datasource Updates the datasource of a supported field type (currently only enum and set), passed as JSON data. The update is partial: datasource entries with an existing external_id will be updated and entries with new external_id's (or without external_id's) will be appended. See: `Update a metadata field datasource API reference `_ :param field_external_id: The external id of the field to update :param entries_external_id: :param options: Additional options :rtype: Response rFrUrMvaluesr)r&r r)r<rRrrUitemexternalr!r(s r update_metadata_field_datasourcerXs_"F#$mW5  MM( #$ l +C F UC ;7 ;;rc .|dg}d|i}td||fi|S)awRestores entries in a metadata field datasource Restores (unblocks) any previously deleted datasource entries for a specified metadata field definition. Sets the state of the entries to active. See: `Restore entries in a metadata field datasource API reference `_ :param field_external_id: The ID of the metadata field :param entries_external_ids: An array of IDs of datasource entries to restore (unblock) :param options: Additional options :rtype: Response datasource_restorerQrir8)r<entries_external_idsrr!r(s r!restore_metadata_field_datasourcer\/s." 2 3C2 3F VS& rss ( 4/. :933333"3&32  4.3 3 X!4H66666W[6:9,9$;,;$b 336 44444X I 2 34`p> F D9X 3 6 34/ / 2 43 ?T  7 8 TT(Q ;"?.<8=, = <