Metadata-Version: 2.1
Name: mac_alias
Version: 2.2.2
Summary: Generate/parse Mac OS Alias records from Python
Home-page: http://alastairs-place.net/projects/mac_alias
Author: Alastair Houghton
Author-email: alastair@alastairs-place.net
Maintainer: Russell Keith-Magee
Maintainer-email: russell@keith-magee.com
License: MIT License
Project-URL: Source, https://github.com/al45stair/mac_alias
Keywords: mac_alias
Platform: darwin
Classifier: Development Status :: 5 - Production/Stable
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Desktop Environment
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.7
Description-Content-Type: text/x-rst; charset=UTF-8
License-File: LICENSE
Provides-Extra: dev
Requires-Dist: pre-commit; extra == "dev"
Requires-Dist: tox; extra == "dev"
Provides-Extra: test
Requires-Dist: pytest; extra == "test"
Requires-Dist: pytest-tldr; extra == "test"
Requires-Dist: pytest-cov; extra == "test"
Provides-Extra: docs
Requires-Dist: sphinx; extra == "docs"
Requires-Dist: sphinx-autobuild; extra == "docs"
Requires-Dist: sphinx_rtd_theme; extra == "docs"

=========
mac_alias
=========

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

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

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

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

.. image:: https://github.com/dmgbuild/mac_alias/workflows/CI/badge.svg?branch=main
   :target: https://github.com/dmgbuild/mac_alias/actions
   :alt: Build Status

.. image:: https://readthedocs.org/projects/mac_alias/badge/?version=latest
   :target: http://mac_alias.readthedocs.io/en/latest/?badge=latest
   :alt: Docs Build Status

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

``mac_alias`` lets you generate or read binary Alias and Bookmark records
from Python code.

While it is written in pure Python, some OS X specific code is required to
generate a proper Alias or Bookmark record for a given file, so this module
currently is not portable to other platforms.

Credit is due to Wim Lewis <wiml@hhhh.org>, whose work on reverse engineering
the alias format was extremely useful in writing this code.  Alastair Houghton
<alastair@alastairs-place.net> was responsible for reverse engineering the
bookmark format.

See the documentation_ for more information.

.. _documentation: http://mac-alias.rtfd.org
