File manager - Edit - /opt/saltstack/salt/lib/python3.10/site-packages/salt/modules/__pycache__/libcloud_storage.cpython-310.pyc
Back
o ;j�0 � @ s d Z ddlZddlZddlZddlmZ e�e�Z dZ z(ddl Z ddl m Z ee d�r7ee j�ee �k r7e� �e�d��ej� dZW n eyN d ZY nw d d � Zd d � Zdd� Zdd� Zdd� Zdd� Zdd� Z d"dd�Z d#dd�Z d d � Z d d � Z d d!� Z dS )$a Apache Libcloud Storage Management ================================== Connection module for Apache Libcloud Storage (object/blob) management for a full list of supported clouds, see http://libcloud.readthedocs.io/en/latest/storage/supported_providers.html Clouds include Amazon S3, Google Storage, Aliyun, Azure Blobs, Ceph, OpenStack swift .. versionadded:: 2018.3.0 :configuration: This module uses a configuration profile for one or multiple Storage providers .. code-block:: yaml libcloud_storage: profile_test1: driver: google_storage key: GOOG0123456789ABCXYZ secret: mysecret profile_test2: driver: s3 key: 12345 secret: mysecret :depends: apache-libcloud � N)�Versionz1.5.0)� get_driver� __version__�libcloudTFc C s t s dd�t�fS dS )z0 Only load if libcloud libraries exist. Fz@A apache-libcloud library with version at least {} was not foundT)� HAS_LIBCLOUD�format�REQUIRED_LIBCLOUD_VERSION� r r �Q/opt/saltstack/salt/lib/python3.10/site-packages/salt/modules/libcloud_storage.py� __virtual__; s ��r c C s� t d d�| }t|d �}|�� }|d= |�d�|d< |�dd �|d< |�dd�|d< |�dd �|d< |�d d �|d < |d i |��S ) Nz config.optionZlibcloud_storageZdriver�keyZsecretZsecureT�host�portr )Z__salt__r �copy�get)�profileZconfig�cls�argsr r r � _get_driverI s r c K sT t | d�}tjjjdi |��}|jdi |��}g }|D ] }|�|j|jd�� q|S )aN Return a list of containers. :param profile: The profile key :type profile: ``str`` :param libcloud_kwargs: Extra arguments for the driver's list_containers method :type libcloud_kwargs: ``dict`` CLI Example: .. code-block:: bash salt myminion libcloud_storage.list_containers profile1 �r ��name�extraNr ) r �salt�utilsr � clean_kwargs�list_containers�appendr r )r �libcloud_kwargs�connZ containers�ret� containerr r r r V s r c K sr t |d�}|�| �}tjjjdi |��}|j|fi |��}g }|D ]}|�|j|j |j |j j|j |j d�� q!|S )a� List container objects (e.g. files) for the given container_id on the given profile :param container_name: Container name :type container_name: ``str`` :param profile: The profile key :type profile: ``str`` :param libcloud_kwargs: Extra arguments for the driver's list_container_objects method :type libcloud_kwargs: ``dict`` CLI Example: .. code-block:: bash salt myminion libcloud_storage.list_container_objects MyFolder profile1 r �r �size�hashr! r � meta_dataNr )r � get_containerr r r r �list_container_objectsr r r# r$ r! r r% )�container_namer r r r! Zobjectsr �objr r r r' o s �� r' c K �> t |d�}tjjjdi |��}|j| fi |��}|j|jd�S )a� Create a container in the cloud :param container_name: Container name :type container_name: ``str`` :param profile: The profile key :type profile: ``str`` :param libcloud_kwargs: Extra arguments for the driver's create_container method :type libcloud_kwargs: ``dict`` CLI Example: .. code-block:: bash salt myminion libcloud_storage.create_container MyFolder profile1 r r Nr )r r r r r �create_containerr r �r( r r r r! r r r r+ � � r+ c K r* )a� List container details for the given container_name on the given profile :param container_name: Container name :type container_name: ``str`` :param profile: The profile key :type profile: ``str`` :param libcloud_kwargs: Extra arguments for the driver's get_container method :type libcloud_kwargs: ``dict`` CLI Example: .. code-block:: bash salt myminion libcloud_storage.get_container MyFolder profile1 r r Nr )r r r r r r& r r r, r r r r& � r- r& c K sR t |d�}tjjjdi |��}|j| |fi |��}|j|j|j|j j|j |j d�S )a' Get the details for a container object (file or object in the cloud) :param container_name: Container name :type container_name: ``str`` :param object_name: Object name :type object_name: ``str`` :param profile: The profile key :type profile: ``str`` :param libcloud_kwargs: Extra arguments for the driver's get_container_object method :type libcloud_kwargs: ``dict`` CLI Example: .. code-block:: bash salt myminion libcloud_storage.get_container_object MyFolder MyFile.xyz profile1 r r" Nr ) r r r r r �get_container_objectr r# r$ r! r r% �r( � object_namer r r r) r r r r. � s �r. c K sB t |d�}|�| |�}tjjjdi |��}|j||||fi |��S )a� Download an object to the specified destination path. :param container_name: Container name :type container_name: ``str`` :param object_name: Object name :type object_name: ``str`` :param destination_path: Full path to a file or a directory where the incoming file will be saved. :type destination_path: ``str`` :param profile: The profile key :type profile: ``str`` :param overwrite_existing: True to overwrite an existing file, defaults to False. :type overwrite_existing: ``bool`` :param delete_on_failure: True to delete a partially downloaded file if the download was not successful (hash mismatch / file size). :type delete_on_failure: ``bool`` :param libcloud_kwargs: Extra arguments for the driver's download_object method :type libcloud_kwargs: ``dict`` :return: True if an object has been successfully downloaded, False otherwise. :rtype: ``bool`` CLI Example: .. code-block:: bash salt myminion libcloud_storage.download_object MyFolder me.jpg /tmp/me.jpg profile1 r Nr )r � get_objectr r r r �download_object) r( r0 Zdestination_pathr Zoverwrite_existingZdelete_on_failurer r r) r r r r2 � s 0 ��r2 c K sJ t |d�}tjjjdi |��}|�|�} |j| | ||||fi |��} | jS )a Upload an object currently located on a disk. :param file_path: Path to the object on disk. :type file_path: ``str`` :param container_name: Destination container. :type container_name: ``str`` :param object_name: Object name. :type object_name: ``str`` :param profile: The profile key :type profile: ``str`` :param verify_hash: Verify hash :type verify_hash: ``bool`` :param extra: Extra attributes (driver specific). (optional) :type extra: ``dict`` :param headers: (optional) Additional request headers, such as CORS headers. For example: headers = {'Access-Control-Allow-Origin': 'http://mozilla.com'} :type headers: ``dict`` :param libcloud_kwargs: Extra arguments for the driver's upload_object method :type libcloud_kwargs: ``dict`` :return: The object name in the cloud :rtype: ``str`` CLI Example: .. code-block:: bash salt myminion libcloud_storage.upload_object /file/to/me.jpg MyFolder me.jpg profile1 r Nr )r r r r r r& � upload_objectr ) Z file_pathr( r0 r r Z verify_hash�headersr r r! r) r r r r3 " s 1 �� r3 c K s< t |d�}tjjjdi |��}|j| |fi |��}|�|�S )ac Delete an object in the cloud :param container_name: Container name :type container_name: ``str`` :param object_name: Object name :type object_name: ``str`` :param profile: The profile key :type profile: ``str`` :param libcloud_kwargs: Extra arguments for the driver's delete_object method :type libcloud_kwargs: ``dict`` :return: True if an object has been successfully deleted, False otherwise. :rtype: ``bool`` CLI Example: .. code-block:: bash salt myminion libcloud_storage.delete_object MyFolder me.jpg profile1 r Nr )r r r r r r1 � delete_objectr/ r r r r5 b s r5 c K s: t |d�}tjjjdi |��}|�| �}|j|fi |��S )a1 Delete an object container in the cloud :param container_name: Container name :type container_name: ``str`` :param profile: The profile key :type profile: ``str`` :param libcloud_kwargs: Extra arguments for the driver's delete_container method :type libcloud_kwargs: ``dict`` :return: True if an object container has been successfully deleted, False otherwise. :rtype: ``bool`` CLI Example: .. code-block:: bash salt myminion libcloud_storage.delete_container MyFolder profile1 r Nr )r r r r r r& �delete_containerr, r r r r6 � s r6 c K s6 t jjjdi |��}t|d�}t|| �}|di |��S )a� Call an extended method on the driver :param method: Driver's method name :type method: ``str`` :param profile: The profile key :type profile: ``str`` :param libcloud_kwargs: Extra arguments for the driver's delete_container method :type libcloud_kwargs: ``dict`` CLI Example: .. code-block:: bash salt myminion libcloud_storage.extra ex_get_permissions google container_name=my_container object_name=me.jpg --out=yaml r Nr )r r r r r �getattr)�methodr r r Zconnection_methodr r r r � s r )FT)NTN) �__doc__�loggingZsalt.utils.argsr Zsalt.utils.compatZsalt.utils.versionsr � getLogger�__name__�logr r Zlibcloud.storage.providersr �hasattrr � ImportError�setLevel�CRITICALr r r r r' r+ r& r. r2 r3 r5 r6 r r r r r �<module> sH ! � � &( �= �@
| ver. 1.4 |
Github
|
.
| PHP 8.2.30 | Generation time: 0 |
proxy
|
phpinfo
|
Settings