L^itddlZddlZddlmZddlZddlmZddlmZmZm Z m Z m Z ddl m Z mZmZmZmZmZmZdZdZdZd Zd Zd Zd Zd ZdZdZdZdZdZdZ d[dZ!dZ"dZ#dZ$dZ%dZ&dZ'dZ(dZ)dZ*dZ+ d\d Z,d!Z-d]d"Z.d#Z/d]d$Z0d%Z1d&Z2d'Z3d(Z4d)Z5d*Z6d+Z7d,Z8d-Z9d.Z:d/Z;d0Zd3Z?d4Z@d5ZAd6ZBd7ZCd8ZDd9ZEd:ZFd;ZGd<ZHd=ZId>ZJd?ZKd@ZLdAZMdBZNdCZOdDZPdEZQdFZRdGZSdHZTdIZUdJZVdKZWdLZXdMZYdNZZdOZ[dPZ\dQZ]dZdRZ^dZdSZ_dTZ`dUZadVZbdWZcdXZddZdYZedS)^N) string_types)utils)call_metadata_apicall_metadata_rules_apicall_api call_json_api _call_v2_api) BadRequestAuthorizationRequired NotAllowedNotFound AlreadyExists RateLimited GeneralErrorc "tddgifi|S)a& Tests the reachability of the Cloudinary API. See: https://cloudinary.com/documentation/admin_api#ping_cloudinary_servers :param options: Additional optional configuration parameters (none currently recognized). :return: The result of the API call. :rtype: Response getpingroptionss 1D:\Nbitz\venv\Lib\site-packages\cloudinary/api.pyrrs  " 8 8 8 88c |dd}dg}|rCt|tjrt j|}||td|ifi|S)a Get 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: https://cloudinary.com/documentation/admin_api#get_product_environment_usage_details :param options: Additional optional parameters. :keyword date: The date for usage details (string in "YYYY-MM" format or a datetime.date object). If omitted, returns usage for the current billing period. :type date: str or datetime.date :return: Detailed usage information :rtype: Response dateNusager)pop isinstancedatetimerrencode_date_to_usage_api_formatappendr)rruris rrr+sv" ;;vt $ $D )C  dHM * * ?8>>D 4 R 3 37 3 33rc Bt|d}tddg|fi|S)a Get account config details. Fetches the account's configuration details with optional settings. See: https://cloudinary.com/documentation/admin_api#get_product_environment_config_details :param options: The optional parameters for the API request. :keyword bool settings: When True, returns extended settings in the response (if available). :return: Detailed config information. :rtype: Response settingsrconfigonlyrrparamss rr$r$Es/': & &F  F > >g > >>rc "tddgifi|S)a" Retrieves the types of resources (assets) available. See: https://cloudinary.com/documentation/admin_api#get_resources :param options: Additional optional configuration parameters (none currently recognized). :return: The result of the API call. :rtype: Response r resourcesrrs rresource_typesr+Vs   r = =W = ==rc |dd}|dd}d|g}|r||td i|}|t |ddt d||fi|S) a Retrieves resources (assets) based on the provided options. See: https://cloudinary.com/documentation/admin_api#get_resources :param options: Additional options to filter the resources. :keyword str resource_type: The type of the resources. Defaults to "image". :keyword str type: The specific asset type. Defaults to None (not added to URI). :keyword str prefix: Return only resources with a public ID (or folder) that starts with this prefix. :keyword str start_at: Return resources updated since the specified timestamp (format: "yyyy-mm-dd hh:mm:ss"). :keyword str direction: Return resources sorted by "asc" or "desc" order of creation. :keyword str next_cursor: A string that is returned as part of the response when there are more results to retrieve. :keyword int max_results: Maximum number of resources to return. Default=10. :return: The result of the API call. :rtype: Response resource_typeimagetypeNr*prefixstart_atr)rr __list_resources_paramsupdater&rrr- upload_typer!r(s rr*r*cs"KK99M++fd++K  &C  ; $ / /w / /F MM$w*55666 V 7 7w 7 77rc p|dd}d|d|g}tdi|}td||fi|S)a Lists resources (assets) with the specified tag. This method does not return matching deleted assets, even if they have been backed up. See: https://cloudinary.com/documentation/admin_api#get_resources_by_tag :param tag: The tag value. :type tag: str :param options: Additional options to filter the resources. :keyword str resource_type: The type of the resources. Defaults to "image". :keyword str direction: Return resources in "asc" or "desc" order (by creation). :keyword int max_results: Maximum number of resources to return. Default=10. :keyword str next_cursor: A string returned when there are more results to fetch. :return: The result of the API call. :rtype: Response r-r.r*tagsrr2rr3rtagrr-r!r(s rresources_by_tagr<~sR$KK99M  vs 3C $ / /w / /F V 7 7w 7 77rc r|dd}d|d||g}tdi|}td||fi|S)a Lists resources (assets) currently in the specified moderation queue and status. See: https://cloudinary.com/documentation/admin_api#get_resources_in_moderation :param kind: Type of image moderation queue to list (e.g., "manual", "webpurify", "aws_rek", "metascan"). :type kind: str :param status: Only assets with this moderation status will be returned. Valid values: "pending", "approved", "rejected". :type status: str :param options: Additional options to filter the resources. :keyword str resource_type: The type of the resources. Defaults to "image". :keyword str direction: Return resources in "asc" or "desc" order (by creation). :keyword int max_results: Maximum number of resources to return. Default=10. :keyword str next_cursor: A string returned when there are more results to fetch. :return: The result of the API call. :rtype: Response r-r.r* moderationsrr2r9)kindstatusrr-r!r(s rresources_by_moderationrAsT&KK99M  }dF CC $ / /w / /F V 7 7w 7 77rc |dd}|dd}d||g}ttdi||}td||fi|S) a Lists resources (assets) with the specified public IDs. See: https://cloudinary.com/documentation/admin_api#get_resources :param public_ids: The requested public_ids (up to 100). :type public_ids: list[str] :param options: The optional parameters. :keyword str resource_type: The type of the resources. Defaults to "image". :keyword str type: The specific asset type. Defaults to "upload". :keyword str direction: Return resources in "asc" or "desc" order. :keyword int max_results: Maximum number of resources to return. :keyword str next_cursor: A string returned when there are more results to fetch. :return: The result of the API call. :rtype: Response r-r.r/uploadr* public_idsrr2)rdict__resources_paramsrrErr-r6r!r(s rresources_by_idsrIsq"KK99M++fh//K  { 3C $//w//J G G GF V 7 7w 7 77rc Jddg}tdi|}||d<td||fi|S)av Returns the details of the resources (assets) under a specified asset_folder. See: https://cloudinary.com/documentation/admin_api#get_resources_by_asset_folder :param asset_folder: The Asset Folder of the asset. :type asset_folder: str :param options: Additional options to filter the resources. :keyword str direction: Return resources in "asc" or "desc" order. :keyword int max_results: Maximum number of resources to return. :keyword str next_cursor: A string returned when there are more results to fetch. :return: Resources (assets) of a specific asset_folder. :rtype: Response r*by_asset_folder asset_folderrr2)r3r)rLrr!r(s rresources_by_asset_folderrMsF ) *C $ / /w / /F)F> V 7 7w 7 77rc ^ddg}ttdi||}td||fi|S)a Retrieves the resources (assets) indicated in the asset IDs. This method does not return deleted assets even if they have been backed up. See: https://cloudinary.com/documentation/admin_api#get_resources_by_asset_ids :param asset_ids: The requested asset IDs. :type asset_ids: list[str] :param options: Additional options to filter the resources. :keyword str direction: Return resources in "asc" or "desc" order. :keyword int max_results: Maximum number of resources to return. :keyword str next_cursor: A string returned when there are more results to fetch. :return: Resources (assets) as indicated in the asset IDs. :rtype: Response r* by_asset_ids asset_idsrr2)rFrGrrQrr!r(s rresources_by_asset_idsrSsI  'C $//w//9 E E EF V 7 7w 7 77rc |dd}d|dg}td i|}||d<|||d<td||fi|S) ao Retrieves resources (assets) with a specified context key. This method does not return deleted assets even if they have been backed up. See: https://cloudinary.com/documentation/admin_api#get_resources_by_context :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 to filter the resources. :keyword str resource_type: The type of the resources. Defaults to "image". :keyword str direction: Return resources in "asc" or "desc" order. :keyword int max_results: Maximum number of resources to return. :keyword str next_cursor: A string returned when there are more results to fetch. :return: Resources (assets) with a specified context key. :rtype: Response r-r.r*contextkeyNvaluerr2r9)rVrWrr-r!r(s rresources_by_contextrXsh&KK99M  y 1C $ / /w / /FF5M w V 7 7w 7 77rc t|dddd}|dr/tjtj|d|d<|S) Prepares optional parameters for resources_* API calls. :param options: Additional options :return: Optional parameters :rtype: dict :internal r8rUmetadatar>fields)r&rr encode_list build_arrayr's rrGrG sX'69j- H HF{{8S ,U->wx?P-Q-QRRx Mrc htdi|}|t|ddd|S)rZ next_cursor max_results directionr2)rGr4r&)rresources_paramss rr3r3s@*44G44D- TTUUU rc \ddg}|||tj|dd}td||fi|S)a Find images based on their visual content. See: https://cloudinary.com/documentation/admin_api#visual_search_for_resources :param image_url: The URL of an image. :type image_url: str, optional :param image_asset_id: The asset_id of an image in your account. :type image_asset_id: str, optional :param text: A textual description (e.g. "cat"). :type text: str, optional :param image_file: The image file. (str|callable|Path|bytes) :type image_file: str or callable or Path or bytes, optional :param options: Additional optional parameters to pass along. :return: Resources (assets) that were found :rtype: Response r* visual_searchfile) image_urlimage_asset_idtext image_filepost)rhandle_file_parameterr)rgrhrirjrr!r(s rrere+sO&  (C(1*fEE F FC 3 37 3 33rc |dd}|dd}d|||g}tdi|}td||fi|S)a Returns the details of the specified asset and all its derived assets (by public ID). See: https://cloudinary.com/documentation/admin_api#get_details_of_a_single_resource_by_public_id :param public_id: The public ID of the resource. :type public_id: str :param options: Additional optional parameters for retrieval. :keyword str resource_type: The resource type (e.g. "image", "raw"). :keyword str type: The asset's storage type (e.g. "upload"). :keyword bool exif: Whether to return Exif metadata. :keyword bool faces: Whether to return face coordinates. :keyword bool colors: Whether to return color information. :keyword bool image_metadata: Whether to return image metadata. :keyword bool media_metadata: Whether to return extended media metadata. :keyword bool cinemagraph_analysis: Whether to include cinemagraph analysis data. :keyword bool pages: Whether to include the page count of multi-page files. :keyword bool phash: Whether to include perceptual hash data. :keyword bool coordinates: Whether to return custom and face coordinates. :keyword int max_results: The maximum number of derived resources to return. :keyword bool quality_analysis: Whether to include quality analysis data. :keyword str derived_next_cursor: A pagination cursor for derived resources. :keyword bool accessibility_analysis: Whether to include accessibility analysis data. :keyword bool versions: Whether to include version information for the asset. :keyword bool related: Whether to include related assets. :keyword str related_next_cursor: A pagination cursor for related assets. :return: The result of the API call. :rtype: Response r-r.r/rCr*rr2)r_prepare_asset_details_paramsr public_idrr-r6r!r(s rresourcerqHse<KK99M++fh//K  {I >C * 5 5W 5 5F V 7 7w 7 77rc @d|g}tdi|}td||fi|S)a< Returns the details of the specified asset and all its derived assets (by asset ID). See: https://cloudinary.com/documentation/admin_api#get_details_of_a_single_resource_by_asset_id :param asset_id: The Asset ID of the asset :type asset_id: str :param options: Additional optional parameters for retrieval. :keyword bool exif: Whether to return Exif metadata. :keyword bool faces: Whether to return face coordinates. :keyword bool colors: Whether to return color information. :keyword bool image_metadata: Whether to return image metadata. :keyword bool media_metadata: Whether to return extended media metadata. :keyword bool cinemagraph_analysis: Whether to include cinemagraph analysis data. :keyword bool pages: Whether to include the page count of multi-page files. :keyword bool phash: Whether to include perceptual hash data. :keyword bool coordinates: Whether to return custom and face coordinates. :keyword int max_results: The maximum number of derived resources to return. :keyword bool quality_analysis: Whether to include quality analysis data. :keyword str derived_next_cursor: A pagination cursor for derived resources. :keyword bool accessibility_analysis: Whether to include accessibility analysis data. :keyword bool versions: Whether to include version information for the asset. :keyword bool related: Whether to include related assets. :keyword str related_next_cursor: A pagination cursor for related assets. :return: Resource (asset) of a specific asset_id :rtype: Response r*rr2)rnr)asset_idrr!r(s rresource_by_asset_idrtms;8  !C * 5 5W 5 5F V 7 7w 7 77rc @t|ddddddddd d d d d dddS)z Prepares optional parameters for resource_by_asset_id or resource_by_public_id API calls. :param options: Additional options :return: Optional parameters :rtype: dict :internal exiffacescolorsimage_metadatamedia_metadatacinemagraph_analysispagesphash coordinatesraquality_analysisderived_next_cursoraccessibility_analysisversionsrelatedrelated_next_cursorr&rs rrnrnsC (4DFVXn-@RTi(*iAV X XXrc |dd}|dd}d|||g}t|dddd d d d d d }d|vr0dtj|d|d<d|vr*tj|d|d<d|vr*tj|d|d<d|vr*tj|d|d<d|vr*tj|d|d<d|vr*tj|d|d<d|vr%t|d|d<d|vrC '. $e"K1D&(:<w{{K]?^?^%_%_!"w&&','@MaAbAb'c'c#$G!-gkk).D.DEEyG!0Y1G1GHHyW"1'++j2I2IJJz  !$W[[%@%@!A!A~7""#(#4U5Nw{{[kOlOl5m5m#n#n   !(^!"> f 8 8 8 88rc |dd}|dd}d||g}t||}td||fi|S)a1 Deletes resources (assets) given their public IDs. The resources must belong to the specified resource_type and type. See: https://cloudinary.com/documentation/admin_api#delete_resources :param public_ids: The public IDs of the resources to delete. :type public_ids: list[str] :param options: Additional options. :keyword str resource_type: Defaults to "image". :keyword str type: Defaults to "upload". :keyword list transformations: The derived transformations to delete (if any). :keyword bool keep_original: When True, keeps the original resource. :keyword str next_cursor: A string returned when more results are available. :keyword bool invalidate: When True, invalidates the assets on the CDN. :return: The result of the command. :rtype: Response r-r.r/rCr*rDdeleter__delete_resource_paramsrrHs rdelete_resourcesrsb(KK99M++fh//K  { 3C %g* E E EF 3 : :' : ::rc Hdg}t||}td||fi|S)a Deletes resources (assets) by asset IDs. See: https://cloudinary.com/documentation/admin_api#delete_resources_by_asset_id :param asset_ids: The asset IDs of the assets to delete. :type asset_ids: list[str] :param options: Additional options. :keyword list transformations: The derived transformations to delete (if any). :keyword bool keep_original: When True, keeps the original resource. :keyword str next_cursor: A string returned when more results are available. :keyword bool invalidate: When True, invalidates the assets on the CDN. :return: The result of the command. :rtype: dict r*rPr)rrrRs rdelete_resources_by_asset_idsrs7 -C %g C C CF 3 : :' : ::rc |dd}|dd}d||g}t||}td||fi|S)a Deletes resources (assets) that have a specified prefix for their Public IDs. See: https://cloudinary.com/documentation/admin_api#delete_resources :param prefix: The prefix of the Public IDs to delete. :type prefix: str :param options: Additional options. :keyword str resource_type: Defaults to "image". :keyword str type: Defaults to "upload". :keyword list transformations: The derived transformations to delete (if any). :keyword bool keep_original: When True, keeps the original resource. :keyword str next_cursor: A string returned when more results are available. :keyword bool invalidate: When True, invalidates the assets on the CDN. :return: The result of the command. :rtype: Response r-r.r/rCr*r0rr)r0rr-r6r!r(s rdelete_resources_by_prefixrsb$KK99M++fh//K  { 3C %gf = = =F 3 : :' : ::rc |dd}|dd}d||g}t|d}td||fi|S) aJ Deletes **all** resources (assets) of a specified resource_type and type. Use with caution: This removes all matching resources from your account. See: https://cloudinary.com/documentation/admin_api#delete_resources :param options: Additional options. :keyword str resource_type: Defaults to "image". :keyword str type: Defaults to "upload". :keyword list transformations: The derived transformations to delete (if any). :keyword bool keep_original: When True, keeps the original resource. :keyword str next_cursor: A string returned when more results are available. :keyword bool invalidate: When True, invalidates the assets on the CDN. :keyword bool all: (Added internally) If True, indicates all resources are to be deleted. :return: The result of the command. :rtype: Response r-r.r/rCr*T)allrrr5s rdelete_all_resourcesr+sb&KK99M++fh//K  { 3C %g4 8 8 8F 3 : :' : ::rc v|dd}d|d|g}t|}td||fi|S)a Deletes resources (assets) that contain a specified tag. See: https://cloudinary.com/documentation/admin_api#delete_resources_by_tags :param tag: The tag whose associated resources should be deleted. :type tag: str :param options: Additional options. :keyword str resource_type: Defaults to "image". :keyword list transformations: The derived transformations to delete (if any). :keyword bool keep_original: When True, keeps the original resource. :keyword str next_cursor: A string returned when more results are available. :keyword bool invalidate: When True, invalidates the assets on the CDN. :return: The result of the command. :rtype: Response r-r.r*r8rrr:s rdelete_resources_by_tagrEsL"KK99M  vs 3C %g . .F 3 : :' : ::rc .dg}d|i}td||fi|S)a Deletes derived resources by their derived resource IDs. See: https://cloudinary.com/documentation/admin_api#delete_derived_resources :param derived_resource_ids: A list of derived resource IDs. :type derived_resource_ids: list[str] :param options: Additional optional parameters (none currently recognized). :return: The result of the command. :rtype: Response derived_resourcesderived_resource_idsrr)rrr!r(s rdelete_derived_resourcesr\s1  C$&: ;F 3 : :' : ::rr.rCc d||g}t|ts|g}|tj|dd}|||d<t d||fi|S)a Deletes derived resources of public IDs, identified by transformations. See: https://cloudinary.com/documentation/admin_api#delete_derived_resources :param public_ids: The base resources (list of public IDs). :type public_ids: list[str] :param transformations: The transformations of derived resources, optionally including the format. :type transformations: list[dict or str] :param resource_type: The type of the resource. Defaults to "image". :type resource_type: str :param type: The upload type. Defaults to "upload". :type type: str :param invalidate: (optional) True to invalidate the resources after deletion. :type invalidate: bool, optional :param options: Additional optional parameters (none currently recognized). :return: The result of the command, including the public IDs for which derived resources were deleted. :rtype: dict r*T)rEtransformations keep_originalN invalidater)rlistr build_eagerr)rErr-r/rrr!r(s r delete_derived_by_transformationrmsu,  t ,C j$ ' '" \   ,_==F )| 3 : :' : ::rc Vdd|g}dtj|i}td||fi|S)a Deletes backed up versions of a resource by asset IDs. See: https://cloudinary.com/documentation/admin_api#delete_backed_up_versions_of_a_resource :param asset_id: The asset ID of the asset to update. :type asset_id: str :param version_ids: The array of version IDs. :type version_ids: list[str] :param options: Additional optional parameters (none currently recognized). :return: The result of the command. :rtype: dict r*backup version_idsrrr^r)rsrrr!r(s rdelete_backed_up_assetsrs? ( +CU.{;;   Ce.Fz.R.R S SF f 8 8 8 88rc |dd}d|dg}tt|ddd|}td ||fi|S) a Publishes specific assets by their public IDs. :param public_ids: The list of public IDs to publish. :type public_ids: list[str] :param options: Additional options. :keyword str resource_type: The resource type (e.g. "image"). :keyword str type: The asset type (e.g. "upload"). :keyword bool overwrite: Whether to overwrite existing published assets. :keyword bool invalidate: Whether to invalidate the CDN. :return: The result of the publish operation. :rtype: Response r-r.r*publish_resourcesr/ overwriterrDrkrrFr&r)rErr-r!r(s rpublish_by_idsrms^KK99M  ': ;C $w \BBz Z Z ZF f 8 8 8 88rc |dd}d|dg}tt|ddd|}td ||fi|S) a Publishes assets that have a specified prefix for their public IDs. :param prefix: The prefix of the public IDs to publish. :type prefix: str :param options: Additional options. :keyword str resource_type: The resource type (e.g. "image"). :keyword str type: The asset type (e.g. "upload"). :keyword bool overwrite: Whether to overwrite existing published assets. :keyword bool invalidate: Whether to invalidate the CDN. :return: The result of the publish operation. :rtype: Response r-r.r*rr/rrrrkr)r0rr-r!r(s rpublish_by_prefixrs^KK99M  ': ;C $w \BB6 R R RF f 8 8 8 88rc |dd}d|dg}tt|ddd|}td ||fi|S) a Publishes assets that contain a specified tag. :param tag: The tag whose associated resources should be published. :type tag: str :param options: Additional options. :keyword str resource_type: The resource type (e.g. "image"). :keyword str type: The asset type (e.g. "upload"). :keyword bool overwrite: Whether to overwrite existing published assets. :keyword bool invalidate: Whether to invalidate the CDN. :return: The result of the publish operation. :rtype: Response r-r.r*rr/rr)r;rkrr:s rpublish_by_tagrs^KK99M  ': ;C $w \BB L L LF f 8 8 8 88rc Ddg}td|t|ddfi|S)ah Lists all upload presets. See: https://cloudinary.com/documentation/admin_api#get_upload_presets :param options: Additional options. :keyword str next_cursor: A string returned when more results are available. :keyword int max_results: Maximum number of presets to return. :return: A list of upload presets. :rtype: Response upload_presetsrr`rarr&rr!s rrrs3  C T'=-%P%P \ \T[ \ \\rc Dd|g}td|t|dfi|S)a Retrieves the details of a single upload preset. See: https://cloudinary.com/documentation/admin_api#get_the_details_of_a_single_upload_preset :param name: The name of the upload preset. :type name: str :param options: Additional options. :keyword int max_results: Maximum number of details to return (if relevant). :return: The upload preset details. :rtype: Response rrrarrrr!s r upload_presetrs2 T "C T'=%A%A M MW M MMrc (d|g}td|ifi|S)aM Deletes an upload preset by name. See: https://cloudinary.com/documentation/admin_api#delete_an_upload_preset :param name: The name of the upload preset to delete. :type name: str :param options: Additional options (none currently recognized). :return: The result of the deletion. :rtype: Response rrrrs rdelete_upload_presetrs( T "C 3 6 6g 6 66rc d|g}tjdi|}tj|}|t |dddt d||fi|S)aK Updates an existing upload preset. See: https://cloudinary.com/documentation/admin_api#update_an_upload_preset :param name: The name of the upload preset to update. :type name: str :param options: The parameters to update for the preset (e.g., folder, tags). :keyword bool unsigned: Whether this preset is unsigned (public). :keyword bool disallow_public_id: When True, the public ID cannot be overridden during upload. :keyword bool live: Whether this preset is for live (video) usage. :return: The updated upload preset. :rtype: Response runsigneddisallow_public_idliverr2rbuild_upload_paramscleanup_paramsr4r&rrrr!r(s rupdate_upload_presetrso T "C  & 1 1 1 1F  !& ) )F MM$w ,@&IIJJJ V 7 7w 7 77rc dg}tjdi|}tj|}|t |ddddt d||fi|S)a+ Creates a new upload preset. See: https://cloudinary.com/documentation/admin_api#create_an_upload_preset :param options: The parameters for the new preset (e.g., folder, tags). :keyword bool unsigned: Whether this preset is unsigned (public). :keyword bool disallow_public_id: When True, the public ID cannot be overridden during upload. :keyword str name: The name of the new upload preset. :keyword bool live: Whether this preset is for live (video) usage. :return: The created upload preset. :rtype: Response rrrrrrkr2rrs rcreate_upload_presetrso  C  & 1 1 1 1F  !& ) )F MM$w ,@&&QQRRR f 8 8 8 88rc @tddgt|ddfi|S)a Lists the top-level folders in your Cloudinary account. See: https://cloudinary.com/documentation/admin_api#get_root_folders :param options: Additional options. :keyword str next_cursor: A string returned when more results are available. :keyword int max_results: Maximum number of folders to return. :return: The list of top-level folders. :rtype: Response rfoldersr`rarrs r root_foldersrs-  T'=--X-X d d\c d ddrc Btdd|gt|ddfi|S)a Lists the subfolders of a given folder path. See: https://cloudinary.com/documentation/admin_api#get_subfolders :param of_folder_path: The path of the parent folder. :type of_folder_path: str :param options: Additional options. :keyword str next_cursor: A string returned when more results are available. :keyword int max_results: Maximum number of folders to return. :return: The list of subfolders. :rtype: Response rrr`rar)of_folder_pathrs r subfoldersrs1 N ;T'=Zg=h=h t tls t ttrc $tdd|gifi|S)aD Creates a folder at the specified path. See: https://cloudinary.com/documentation/admin_api#create_folder :param path: The path for the new folder. :type path: str :param options: Additional options (none currently recognized). :return: The result of the folder creation. :rtype: Response rkrr)pathrs r create_folderr%s# )T!2B B B' B BBrc ,d|i}tdd|g|fi|S)a Renames a folder. See: https://cloudinary.com/documentation/admin_api#update_folder :param from_path: The full path of an existing asset folder. :type from_path: str :param to_path: The full path of the new asset folder. :type to_path: str :param options: Additional options (none currently recognized). :return: A response indicating the success or failure of the rename operation. :rtype: Response to_folderrrr) from_pathto_pathrr(s r rename_folderr 4s-7 #F I 6 J J' J JJrc Dt|d}tdd|g|fi|S)a Deletes a folder. The folder must be empty, but can have descendant empty subfolders. See: https://cloudinary.com/documentation/admin_api#delete_folder :param path: The folder to delete. :type path: str :param options: Additional options. :keyword bool skip_backup: Whether to skip backing up the folder before deletion. :return: A response indicating the success or failure of the delete operation. :rtype: Response skip_backuprrr%)rrr(s r delete_folderr Fs2'= ) )F It#4f H H H HHrc |dd}|dd}d||dg}td d|it|d}td ||fi|S) a' Restores deleted resources (assets) by public IDs, if backups are available. See: https://cloudinary.com/documentation/admin_api#restore_resources :param public_ids: The list of public IDs to restore. :type public_ids: list[str] :param options: Additional options, e.g., "versions". :keyword list[str] versions: A list of specific version IDs to restore. :keyword str resource_type: Defaults to "image". :keyword str type: Defaults to "upload". :return: The result of the restore operation. :rtype: dict r-r.r/rCr*restorerErrkr2rrHs rrrYstKK99M++fh//K  {I >C  E EZ E4+D+D E EF f 8 8 8 88rc `ddg}tdd|it|d}td||fi|S)a Restores deleted resources (assets) by their asset IDs, if backups are available. See: https://cloudinary.com/documentation/admin_api#restore_resources_by_asset_id :param asset_ids: The asset IDs of the assets to restore. :type asset_ids: list[str] :param options: Additional options (e.g., versions). :keyword list[str] versions: A list of specific version IDs to restore. :return: The result of the restore operation. :rtype: dict r*rrQrrkr2)rFr&rrRs rrestore_by_asset_idsrosJ  "C  C CI Cgz)B)B C CF f 8 8 8 88rc Ddg}td|t|ddfi|S)a| Lists all upload mappings in your account. See: https://cloudinary.com/documentation/admin_api#get_upload_mappings :param options: Additional options. :keyword str next_cursor: A string returned when more results are available. :keyword int max_results: Maximum number of mappings to return. :return: A list of upload mappings. :rtype: Response upload_mappingsrr`rarrs rrrs3  C T'=-%P%P \ \T[ \ \\rc Fdg}t|}td||fi|S)ae Retrieves a single upload mapping by folder name. See: https://cloudinary.com/documentation/admin_api#get_the_details_of_a_single_upload_mapping :param name: The folder name. :type name: str :param options: Additional options (none currently recognized). :return: Details of the specified upload mapping. :rtype: Response rfolderrrFrrs rupload_mappingrs6  C    F V 7 7w 7 77rc Fdg}t|}td||fi|S)a> Deletes an upload mapping by folder name. See: https://cloudinary.com/documentation/admin_api#delete_an_upload_mapping :param name: The folder name. :type name: str :param options: Additional options (none currently recognized). :return: The result of the deletion. :rtype: Response rrrrrs rdelete_upload_mappingrs6  C    F 3 : :' : ::rc dg}t|}|t|dtd||fi|S)a| Updates an upload mapping by folder name. See: https://cloudinary.com/documentation/admin_api#update_an_upload_mapping :param name: The folder name. :type name: str :param options: Additional parameters to update. :keyword str template: A URL template for the given folder name. :return: The result of the update operation. :rtype: Response rrtemplaterrFr4r&rrs rupdate_upload_mappingrsR  C    F MM$w ++,,, V 7 7w 7 77rc dg}t|}|t|dtd||fi|S)a^ Creates a new upload mapping. See: https://cloudinary.com/documentation/admin_api#create_an_upload_mapping :param name: The folder name. :type name: str :param options: Additional parameters. :keyword str template: A URL template for the given folder name. :return: The result of the creation. :rtype: Response rrrrkrrs rcreate_upload_mappingrsR  C    F MM$w ++,,, f 8 8 8 88rc &dg}td|ifi|S)a' Lists all custom and built-in streaming profiles. See: https://cloudinary.com/documentation/admin_api#get_adaptive_streaming_profiles :param options: Additional optional parameters (none currently recognized). :return: The list of streaming profiles. :rtype: Response streaming_profilesGETrrs rlist_streaming_profilesr#s& C R 3 37 3 33rc (d|g}td|ifi|S)a Retrieves details of a specific streaming profile by name. See: https://cloudinary.com/documentation/admin_api#get_details_of_a_single_streaming_profile :param name: The name of the streaming profile. :type name: str :param options: Additional optional parameters (none currently recognized). :return: The details of the streaming profile. :rtype: Response r!r"rrs rget_streaming_profiler%s(  &C R 3 37 3 33rc (d|g}td|ifi|S)a Deletes a specific streaming profile by name (or reverts a built-in). See: https://cloudinary.com/documentation/admin_api#delete_or_revert_the_specified_streaming_profile :param name: The name of the streaming profile to delete. :type name: str :param options: Additional optional parameters (none currently recognized). :return: The result of the deletion. :rtype: Response r!DELETErrs rdelete_streaming_profiler(s(  &C 3 6 6g 6 66rc Hdg}tdi|}||d<td||fi|S)a Creates a new custom streaming profile. See: https://cloudinary.com/documentation/admin_api#create_a_streaming_profile :param name: The name for the new streaming profile. :type name: str :param options: Additional options. :keyword str display_name: A display name for the streaming profile. :keyword list representations: A list of transformations (dict or str). :return: The created streaming profile. :rtype: Response r!rPOSTr2"__prepare_streaming_profile_paramsrrs rcreate_streaming_profiler-sB C / : :' : :FF6N f 8 8 8 88rc @d|g}tdi|}td||fi|S)a Updates an existing streaming profile. See: https://cloudinary.com/documentation/admin_api#update_an_existing_streaming_profile :param name: The name of the streaming profile to update. :type name: str :param options: Additional options. :keyword str display_name: A display name for the streaming profile. :keyword list representations: A list of transformations (dict or str). :return: The updated streaming profile. :rtype: Response r!PUTr2r+rs rupdate_streaming_profiler0s;  &C / : :' : :F V 7 7w 7 77rc fd|DS)a@ Returns a dictionary containing only the specified keys from the source. :param source: The source dictionary. :type source: dict :param keys: The keys to retain. :type keys: list or tuple of str or str :return: A new dictionary with only the specified keys. :rtype: dict :internal c*i|]}|v||Sr2r2).0rVsources r zonly..:s$ > > >v C rr2)r4keyss` rr&r&.s ? > > > > > >>rcht|tr|Stjjdi|dS)z Converts a transformation (dict or str) into the correct string format. :param transformation: The transformation to convert. :type transformation: dict or str :return: The transformation as a string. :rtype: str :internal rNr2)rr cloudinaryrgenerate_transformation_stringrs rrr=s=.,//T>PPPPQRSSrc t|d}d|vr)d|dD}tj||d<|S)a Prepares the parameters for creating or updating a streaming profile. :param options: Additional options, typically including "representations" and "display_name". :return: A dictionary of parameters for the streaming profile API call. :rtype: dict :internal rrepresentationsc0g|]}dt|iSr:)r)r3transs r z6__prepare_streaming_profile_params..Xs<DDD$-.CE.J.JKDDDr)r&jsondumps)rr(r<s rr,r,Msa'> * *FG##DD(/0A(BDDD$(J$?$? ! Mrc tddtj|dit |ddd}|||S)aq Prepares parameters for delete resource methods, including transformations, keep_original, next_cursor, invalidate, etc. :param options: A dict of delete-related options. :param params: Additional parameters (e.g., prefix, public_ids, asset_ids). :type params: dict :return: A combined dictionary of params. :rtype: dict :internal rrr`rr2)rFrrrr&r4)rr(ps rrr^si  L LU.w{{;L/M/MNN LG_m\JJ L LAHHV Hrc tdgifi|S)a Returns a list of all metadata field definitions. See: https://cloudinary.com/documentation/admin_api#get_metadata_fields :param options: Additional optional parameters (none currently recognized). :return: A list of metadata fields. :rtype: Response rrrs rlist_metadata_fieldsrFps UB 6 6g 6 66rc &|g}td|ifi|S)a Gets a metadata field by external id. See: https://cloudinary.com/documentation/admin_api#get_a_metadata_field_by_external_id :param field_external_id: The ID of the metadata field to retrieve. :type field_external_id: str :param options: Additional optional parameters (none currently recognized). :return: The metadata field details. :rtype: Response rrEfield_external_idrr!s rmetadata_field_by_field_idrJ}s&  C UC 7 7w 7 77rc :tdgt|fi|S)aL Creates a new metadata field definition. See: https://cloudinary.com/documentation/admin_api#create_a_metadata_field :param field: The field to add. :type field: dict :param options: Additional optional parameters (none currently recognized). :return: The created metadata field. :rtype: Response rkr__metadata_field_params)fieldrs radd_metadata_fieldrOs' VR)@)G)G S S7 S SSrc @|g}td|t|fi|S)a Updates a metadata field by external id. See: https://cloudinary.com/documentation/admin_api#update_a_metadata_field_by_external_id :param field_external_id: The ID of the metadata field to update. :type field_external_id: str :param field: The field definition to update. :type field: dict :param options: Additional optional parameters (none currently recognized). :return: The updated metadata field. :rtype: Response rrL)rIrNrr!s rupdate_metadata_fieldrQs/  C UC)@)G)G S S7 S SSrc 4t|ddddddddd d S) z Builds the parameters needed for creating or updating a metadata field. :param field: The field definition. :type field: dict :return: The relevant key-value pairs. :rtype: dict :internal r/ external_idlabel mandatory restrictions default_valuedefault_disabled validation datasourceallow_dynamic_list_valuesr)rNs rrMrMs2 v}g{N!3\ >g > >>rc g}|D]*}t|dd}|r||+|dg}d|i}td||fi|S)a Updates a metadata field datasource. See: https://cloudinary.com/documentation/admin_api#update_a_metadata_field_datasource :param field_external_id: The external ID of the field to update. :type field_external_id: str :param entries_external_id: The list of entries to update/add. :type entries_external_id: list[dict] :param options: Additional optional parameters (none currently recognized). :return: The updated metadata field. :rtype: Response rSrWrZvaluesr)r&r r)rIr`rrcitemexternalr!r(s r update_metadata_field_datasourcerfsrF#$$mW55  $ MM( # # # l +C F UC ; ;7 ; ;;rc 0|dg}d|i}td||fi|S)a@ Restores entries in a metadata field datasource. See: https://cloudinary.com/documentation/admin_api#restore_entries_in_a_metadata_field_datasource :param field_external_id: The ID of the metadata field. :type field_external_id: str :param entries_external_ids: An array of IDs of datasource entries to restore (unblock). :type entries_external_ids: list[str] :param options: Additional optional parameters (none currently recognized). :return: A response indicating the success or failure of the restore operation. :rtype: Response datasource_restorer_rkrE)rIentries_external_idsrr!r(s r!restore_metadata_field_datasourcerjs4 2 3C2 3F VS& < rs-  9 9 94444???" > > >8886888088828880888*888*88888      4444:"8"8"8J888B X X XC9C9C9L;;;6;;;*;;;2;;;4;;;.;;;$W[ ; ; ; ;F;;;&9999.999&;;;;.;;;&ggg&888$888(;;;"9992999&999(999(999( ] ] ] NNN" 7 7 7 888,999* e e euuu" C C CKKK$III&999,999$ ] ] ] 888";;;"888&999& 4 4 4 4 4 4 7 7 7 999(888& ? ? ? T T T "   $ 7 7 7 8 8 8 T T TTTT$ n n n ; ; ; ???&<<<2===&====*<<<<" = = = b b b X X XXXX" A A A <<<<<