cmeta.utils.files module
========================

Reusable functions for safe loading, storing and caching of files 

cMeta author and developer: (C) 2025-2026 Grigori Fursin

See the cMeta COPYRIGHT and LICENSE files in the project root for details.

Functions
---------

.. autofunction:: cmeta.utils.files.apply_sharding_to_path

.. autofunction:: cmeta.utils.files.files_decode

.. autofunction:: cmeta.utils.files.files_encode

.. autofunction:: cmeta.utils.files.get_creation_time

.. autofunction:: cmeta.utils.files.get_latest_modification_time

.. autofunction:: cmeta.utils.files.get_latest_tree_modification_time

.. autofunction:: cmeta.utils.files.is_path_within

.. autofunction:: cmeta.utils.files.lock_path

.. autofunction:: cmeta.utils.files.quote_path

.. autofunction:: cmeta.utils.files.read_file

.. autofunction:: cmeta.utils.files.safe_delete_directory

.. autofunction:: cmeta.utils.files.safe_delete_directory_if_empty

.. autofunction:: cmeta.utils.files.safe_delete_directory_if_empty_with_sharding

.. autofunction:: cmeta.utils.files.safe_read_file

.. autofunction:: cmeta.utils.files.safe_read_file_via_cache

.. autofunction:: cmeta.utils.files.safe_read_yaml_or_json

.. autofunction:: cmeta.utils.files.safe_write_file

.. autofunction:: cmeta.utils.files.shard_name

.. autofunction:: cmeta.utils.files.unlock_path

.. autofunction:: cmeta.utils.files.unzip

.. autofunction:: cmeta.utils.files.write_file

.. autofunction:: cmeta.utils.files.zip_directory

Constants
---------

.. autodata:: cmeta.utils.files.ERROR_CODE_FILE_NOT_FOUND

.. autodata:: cmeta.utils.files.LOCK_SUFFIX

.. autodata:: cmeta.utils.files.RETRY_DELAY

.. autodata:: cmeta.utils.files.RETRY_DELETE_ATTEMPTS

.. autodata:: cmeta.utils.files.RETRY_NOT_FOUND_FILE

.. autodata:: cmeta.utils.files.RETRY_NOT_FOUND_INDEX_FILE

.. autodata:: cmeta.utils.files.RETRY_REPLACE_FILE

.. autodata:: cmeta.utils.files.RETRY_TIMESTAMP_FILE