========
ds_store
========

.. |pyversions| image:: https://img.shields.io/pypi/pyversions/ds_store.svg
   :target: https://pypi.python.org/pypi/ds_store
   :alt: Python Versions

.. |version| image:: https://img.shields.io/pypi/v/ds_store.svg
   :target: https://pypi.python.org/pypi/ds_store
   :alt: PyPI Version

.. |maturity| image:: https://img.shields.io/pypi/status/ds_store.svg
   :target: https://pypi.python.org/pypi/ds_store
   :alt: Maturity

.. |license| image:: https://img.shields.io/pypi/l/ds_store.svg
   :target: https://github.com/dmgbuild/ds_store/blob/main/LICENSE
   :alt: MIT License

.. |ci| image:: https://github.com/dmgbuild/ds_store/actions/workflows/ci.yml/badge.svg?branch=main
   :target: https://github.com/dmgbuild/ds_store/actions/workflows/ci.yml
   :alt: Build Status

|pyversions| |version| |maturity| |license| |ci|

What is this?
-------------

``ds_store`` lets you examine and modify ``.DS_Store`` files from Python
code; since it is written in pure Python, it is portable and will run on any
platform, not just macOS.

Credit is due to Wim Lewis, Mark Mentovai and Yvan Barthélemy for
reverse-engineering the .DS_Store file format. See
`Wim Lewis’ excellent documentation on CPAN`__ for more information.

__ http://search.cpan.org/~wiml/Mac-Finder-DSStore/DSStoreFormat.pod