mac-alias 2.2.3__tar.gz → 2.2.4rc1__tar.gz

mac_alias-2.2.4rc1/.github/dependabot.yml

@@ -0,0 +1,30 @@
+version: 2
+
+multi-ecosystem-groups:
+  dependencies:
+    schedule:
+      # Check for updates on the first Sunday of every month, 8PM UTC
+      interval: "cron"
+      cronjob: "0 20 * * sun#1"
+
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    patterns: ["*"]
+    multi-ecosystem-group: "dependencies"
+    cooldown:
+      default-days: 7
+
+  - package-ecosystem: "pip"
+    directory: "/"
+    patterns: ["*"]
+    multi-ecosystem-group: "dependencies"
+    cooldown:
+      default-days: 7
+
+  - package-ecosystem: "pre-commit"
+    directory: "/"
+    patterns: ["*"]
+    multi-ecosystem-group: "dependencies"
+    cooldown:
+      default-days: 7

mac_alias-2.2.4rc1/.github/workflows/ci.yml

@@ -0,0 +1,114 @@
+name: CI
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+  workflow_call:
+    inputs:
+      attest-package:
+        description: "Create GitHub provenance attestation for the package."
+        default: "false"
+        type: string
+    outputs:
+      artifact-basename:
+        description: "Base name of the uploaded artifacts; use for artifact retrieval."
+        value: ${{ jobs.package.outputs.artifact-basename }}
+
+# Cancel active CI runs for a PR before starting another run
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+defaults:
+  run:
+    shell: bash
+
+env:
+  FORCE_COLOR: "1"
+
+jobs:
+  pre-commit:
+    name: Pre-commit checks
+    runs-on: "ubuntu-latest"
+    steps:
+      - name: Checkout
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1  # v7.0.1
+        with:
+          persist-credentials: false
+          fetch-depth: 1
+
+      - name: Set up Python
+        uses: actions/setup-python@6d4fd22b20465ccc0f7354476588e8df7c9ca0e0  # v7.1.0
+        with:
+          python-version: "3.X"
+
+      - name: Lint with prek
+        uses: j178/prek-action@44924fe9ef4a6f88253c4b6b1bf11c689d3ce53d  # v3.1.0
+
+  towncrier:
+    name: Check towncrier
+    uses: beeware/.github/.github/workflows/towncrier-run.yml@main
+    permissions:
+      contents: read
+      pull-requests: write
+    with:
+      tox-source: "--group tox"
+
+  package:
+    name: Package mac_alias
+    needs: [ pre-commit, towncrier ]
+    permissions:
+      id-token: write
+      attestations: write
+      contents: read
+    uses: beeware/.github/.github/workflows/python-package-create.yml@main
+    with:
+      attest: ${{ inputs.attest-package }}
+
+  unit-tests:
+    name: Unit tests
+    needs: package
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: [ "3.11", "3.12", "3.13", "3.14", "3.15", "3.16" ]
+        include:
+          # Run all Python versions on M1
+          - macOS-version: "macos-26"
+
+          # Run the most recent Python on macOS 15 M1
+          - python-version: "3.x"
+            macOS-version: "macos-15"
+          # Run the most recent Python on macOS 15 intel
+          - python-version: "3.x"
+            macOS-version: "macos-15-intel"
+          # Run the most recent Python on macOS 27
+          - python-version: "3.x"
+            macOS-version: "xcode-27"
+
+    runs-on: ${{ matrix.macOS-version }}
+    steps:
+      - name: Checkout
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1  # v7.0.1
+        with:
+          persist-credentials: false
+          fetch-depth: 1
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@6d4fd22b20465ccc0f7354476588e8df7c9ca0e0  # v7.1.0
+        with:
+          python-version: ${{ matrix.python-version }}
+          allow-prereleases: true
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install --group tox
+
+      - name: Test
+        run: |
+          tox -e py

mac_alias-2.2.4rc1/.github/workflows/dependabot-changenote.yml

@@ -0,0 +1,19 @@
+name: Dependabot Change Note
+
+on:
+  push:
+    branches:
+      - 'dependabot/**'
+
+permissions:
+  contents: read
+  pull-requests: write
+
+jobs:
+  changenote:
+    name: Dependabot Change Note
+    uses: beeware/.github/.github/workflows/dependabot-changenote.yml@main
+    secrets:
+      BRUTUS_PAT_TOKEN: ${{ secrets.BRUTUS_PAT_TOKEN }}
+    with:
+      changenote-format: "md"

mac_alias-2.2.4rc1/.github/workflows/publish.yml

@@ -0,0 +1,22 @@
+name: Upload Python Package
+
+on:
+  release:
+    types: published
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    permissions:
+      # This permission is required for trusted publishing.
+      id-token: write
+    steps:
+      - uses: dsaltares/fetch-gh-release-asset@aa2ab1243d6e0d5b405b973c89fa4d06a2d0fff7  # 1.1.2
+        with:
+          version: tags/${{ github.event.release.tag_name }}
+          file: ${{ github.event.repository.name }}.*
+          regex: true
+          target: dist/
+
+      - name: Publish release to production PyPI
+        uses: pypa/gh-action-pypi-publish@7245906fb61fa33a13554f9d5fb856fe61758086  # v1.14.3

mac_alias-2.2.4rc1/.github/workflows/release.yml

@@ -0,0 +1,86 @@
+name: Create Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  ci:
+    name: CI
+    permissions:
+      id-token: write
+      contents: read
+      attestations: write
+      pull-requests: write
+    uses: $/.github/workflows/ci.yml
+    with:
+      attest-package: "true"
+
+  docs:
+    permissions:
+      contents: read
+    name: Verify Docs Build
+    uses: beeware/.github/.github/workflows/docs-build-verify.yml@main
+    secrets:
+      RTD_API_TOKEN: ${{ secrets.RTD_API_TOKEN }}
+    with:
+      project-name: "mac-alias"
+      project-version: ${{ github.ref_name }}
+
+  release:
+    name: Create Release
+    needs: ci
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      # This permission is required for trusted publishing.
+      id-token: write
+    steps:
+      - name: Set build variables
+        run: |
+          echo "VERSION=${GITHUB_REF_NAME#v}" | tee -a $GITHUB_ENV
+
+      - name: Checkout
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1  # v7.0.1
+        with:
+          persist-credentials: false
+          fetch-depth: 0
+          fetch-tags: true
+
+      - name: Set up Python
+        uses: actions/setup-python@6d4fd22b20465ccc0f7354476588e8df7c9ca0e0  # v7.1.0
+        with:
+          python-version: "3.x"
+
+      - name: Get packages
+        uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333  # v8.0.2
+        with:
+          pattern: Packages-*
+          merge-multiple: true
+          path: dist
+
+      - name: Install packages
+        run: pip install dist/*.whl
+
+      - name: Check version number
+        # Check that the version number of the installed package matches the tag.
+        run: |
+          set -x
+          test $(python -c "import mac_alias; print(mac_alias.__version__)") = $VERSION
+
+      - name: Create release
+        env:
+          GH_TOKEN: ${{ github.token }}
+          GH_REPO: ${{ github.repository }}
+        run: |
+          gh release create "${GITHUB_REF_NAME}" \
+            --title "$VERSION" \
+            --draft \
+            --verify-tag \
+            dist/*
+
+      - name: Publish release to Test PyPI
+        uses: pypa/gh-action-pypi-publish@7245906fb61fa33a13554f9d5fb856fe61758086  # v1.14.3
+        with:
+          repository-url: https://test.pypi.org/legacy/

mac_alias-2.2.4rc1/.github/zizmor.yml

@@ -0,0 +1,9 @@
+rules:
+  unpinned-uses:
+    config:
+      # Allow BeeWare-provided actions to be unpinned. If an attacker is in a
+      # position to exploit those action, they're probably able to exploit
+      # repositories directly; and it's significantly easier for our internal
+      # actions to automatically be the most recent versions.
+      policies:
+        beeware/*: ref-pin

mac_alias-2.2.4rc1/.gitignore

@@ -0,0 +1,14 @@
+.cache
+.coverage
+.eggs
+.tox
+.vscode
+*.egg
+*.egg-info
+*.pyc
+*~
+build
+coverage.xml
+dist
+docs/_build
+venv*

{mac_alias-2.2.3 → mac_alias-2.2.4rc1}/.pre-commit-config.yaml

@@ -9,8 +9,12 @@ repos:
       - id: end-of-file-fixer
       - id: trailing-whitespace
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.14.6
+    rev: v0.17.2
     hooks:
       - id: ruff-format
       - id: ruff-check
         args: [ --fix ]
+  - repo: https://github.com/zizmorcore/zizmor-pre-commit
+    rev: v1.31.1
+    hooks:
+    - id: zizmor

mac_alias-2.2.4rc1/CHANGELOG.md

@@ -0,0 +1,144 @@
+# Release History
+
+<!-- towncrier release notes start -->
+
+## 2.2.4 (2026-11-11)
+
+### Features
+
+* Support for Python 3.16 was added. ([#234](https://github.com/dmgbuild/mac_alias/issues/234))
+
+### Backward Incompatible Changes
+
+* Support for Python 3.10 was dropped. ([#231](https://github.com/dmgbuild/mac_alias/issues/231))
+
+### Misc
+
+* [#205](https://github.com/dmgbuild/mac_alias/issues/205), [#206](https://github.com/dmgbuild/mac_alias/issues/206), [#207](https://github.com/dmgbuild/mac_alias/issues/207), [#208](https://github.com/dmgbuild/mac_alias/issues/208), [#209](https://github.com/dmgbuild/mac_alias/issues/209), [#211](https://github.com/dmgbuild/mac_alias/issues/211), [#212](https://github.com/dmgbuild/mac_alias/issues/212), [#213](https://github.com/dmgbuild/mac_alias/issues/213), [#214](https://github.com/dmgbuild/mac_alias/issues/214), [#215](https://github.com/dmgbuild/mac_alias/issues/215), [#216](https://github.com/dmgbuild/mac_alias/issues/216), [#217](https://github.com/dmgbuild/mac_alias/issues/217), [#218](https://github.com/dmgbuild/mac_alias/issues/218), [#220](https://github.com/dmgbuild/mac_alias/issues/220), [#222](https://github.com/dmgbuild/mac_alias/issues/222), [#223](https://github.com/dmgbuild/mac_alias/issues/223), [#224](https://github.com/dmgbuild/mac_alias/issues/224), [#225](https://github.com/dmgbuild/mac_alias/issues/225), [#226](https://github.com/dmgbuild/mac_alias/issues/226), [#227](https://github.com/dmgbuild/mac_alias/issues/227), [#228](https://github.com/dmgbuild/mac_alias/issues/228), [#229](https://github.com/dmgbuild/mac_alias/issues/229), [#230](https://github.com/dmgbuild/mac_alias/issues/230), [#232](https://github.com/dmgbuild/mac_alias/issues/232), [#233](https://github.com/dmgbuild/mac_alias/issues/233), [#235](https://github.com/dmgbuild/mac_alias/issues/235), [#236](https://github.com/dmgbuild/mac_alias/issues/236)
+
+## 2.2.3 (2025-12-04)
+
+### Features
+
+* Support for Python 3.13, 3.14 and 3.15 was added.
+
+### Backward Incompatible Changes
+
+* Support for Python 3.7, 3.8 and 3.9 was dropped.
+
+### Misc
+
+* [#204](https://github.com/dmgbuild/mac_alias/issues/204), [#24](https://github.com/dmgbuild/mac_alias/issues/24)
+
+## 2.2.2 (2022-12-06)
+
+### Bugfixes
+
+* `kBookmarkVolumePath` and `kBookmarkVolumeURL` are now correctly exported from the top-level package. ([#20](https://github.com/dmgbuild/mac_alias/issues/20))
+
+## 2.2.1 (2022-11-24)
+
+### Features
+
+* The project now uses a PEP 517 compliant build configuration, and declares Python 3.7 to 3.12 as supported versions. ([#19](https://github.com/dmgbuild/mac_alias/issues/19))
+
+### Bugfixes
+
+* A stray entry in Alias serialization was removed. ([#12](https://github.com/dmgbuild/mac_alias/issues/12))
+
+### Backward Incompatible Changes
+
+* Support for Python 2, and Python 3 versions prior to 3.7 was dropped.
+
+### Misc
+
+* [#13](https://github.com/dmgbuild/mac_alias/issues/13), [#14](https://github.com/dmgbuild/mac_alias/issues/14), [#16](https://github.com/dmgbuild/mac_alias/issues/16), [#17](https://github.com/dmgbuild/mac_alias/issues/17)
+
+## 2.2.0 (2020-12-08)
+
+### Features
+
+* `osx.py` was updated with definitions from macOS 11 (Big Sur).
+
+### Bugfixes
+
+* `statfs` and `fstatfs` are now correctly located on ARM64 (Apple Silicon) machines. ([#11](https://github.com/dmgbuild/mac_alias/issues/11))
+
+## 2.1.1 (2020-11-28)
+
+### Bugfixes
+
+* A `NameError` when reading an Alias from a file descriptor was corrected. ([#9](https://github.com/dmgbuild/mac_alias/issues/9))
+
+## 2.1.0 (2020-10-11)
+
+### Features
+
+* Tentative support for the Alias v3 format was added.
+
+### Bugfixes
+
+* Volume paths are now normalized to NFC form before being compared, avoiding Unicode string comparison issues. ([#7](https://github.com/dmgbuild/mac_alias/issues/7))
+
+## 2.0.7 (2018-02-13)
+
+### Bugfixes
+
+* A number of Python 3 compatibility problems were corrected. ([#3](https://github.com/dmgbuild/mac_alias/issues/3))
+
+## 2.0.6 (2017-08-02)
+
+### Features
+
+* Bookmarks can now be parsed from `bytearray` data.
+
+### Bugfixes
+
+* Stray debugging `print` statements were removed from bookmark generation.
+
+## 2.0.5 (2017-08-02)
+
+### Bugfixes
+
+* Byte strings are now used with `struct.pack`, correcting a Python 3 compatibility problem.
+
+## 2.0.4 (2017-07-28)
+
+### Bugfixes
+
+* A number of Python 3 compatibility problems were corrected.
+
+## 2.0.2 (2017-07-27)
+
+### Features
+
+* A basic test suite was added.
+
+### Bugfixes
+
+* A number of Python 3 compatibility problems were corrected.
+
+## 2.0.1 (2017-04-28)
+
+### Bugfixes
+
+* Generated bookmarks now use generic ("nobody") user information, rather than details of the author.
+
+## 2.0.0 (2016-12-02)
+
+### Features
+
+* Support for reading and generating Bookmark records was added.
+
+## 1.1.0 (2015-10-19)
+
+### Bugfixes
+
+* Values provided to the `TargetInfo` initializer are now used, rather than being ignored.
+* Floor division is now used explicitly where required, correcting Python 3 compatibility.
+* The `TAG_APPLESHARE_SERVER_NAME` tag value was corrected.
+* The full path to `libc` is now used, correcting a problem on OS X 10.11 (El Capitan).
+
+## 1.0.0 (2014-02-13)
+
+* Initial release.

mac_alias-2.2.4rc1/PKG-INFO

@@ -0,0 +1,39 @@
+Metadata-Version: 2.4
+Name: mac_alias
+Version: 2.2.4rc1
+Summary: Generate/parse macOS Alias records from Python
+Author-email: Alastair Houghton <alastair@alastairs-place.net>
+Maintainer-email: Russell Keith-Magee <russell@keith-magee.com>
+License-Expression: MIT
+Project-URL: Documentation, https://mac-alias.readthedocs.io/en/latest/
+Project-URL: Homepage, https://github.com/dmgbuild/mac_alias
+Project-URL: Tracker, https://github.com/dmgbuild/mac_alias/issues
+Project-URL: Source, https://github.com/dmgbuild/mac_alias
+Keywords: mac_alias
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
+Classifier: Programming Language :: Python :: 3.16
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Desktop Environment
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# mac_alias
+
+[![Python Versions](https://img.shields.io/pypi/pyversions/mac_alias.svg)](https://pypi.python.org/pypi/mac_alias) [![PyPI Version](https://img.shields.io/pypi/v/mac_alias.svg)](https://pypi.python.org/pypi/mac_alias) [![Maturity](https://img.shields.io/pypi/status/mac_alias.svg)](https://pypi.python.org/pypi/mac_alias) [![MIT License](https://img.shields.io/pypi/l/mac_alias.svg)](https://github.com/dmgbuild/mac_alias/blob/main/LICENSE) [![Build status](https://github.com/dmgbuild/mac_alias/workflows/CI/badge.svg?branch=main)](https://github.com/dmgbuild/mac_alias/actions)
+
+`mac_alias` lets you generate or read binary Alias and Bookmark records from Python code.
+
+While it is written in pure Python, some macOS 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](https://mac-alias.readthedocs.io) for more information.

mac_alias-2.2.4rc1/README.md

@@ -0,0 +1,11 @@
+# mac_alias
+
+[![Python Versions](https://img.shields.io/pypi/pyversions/mac_alias.svg)](https://pypi.python.org/pypi/mac_alias) [![PyPI Version](https://img.shields.io/pypi/v/mac_alias.svg)](https://pypi.python.org/pypi/mac_alias) [![Maturity](https://img.shields.io/pypi/status/mac_alias.svg)](https://pypi.python.org/pypi/mac_alias) [![MIT License](https://img.shields.io/pypi/l/mac_alias.svg)](https://github.com/dmgbuild/mac_alias/blob/main/LICENSE) [![Build status](https://github.com/dmgbuild/mac_alias/workflows/CI/badge.svg?branch=main)](https://github.com/dmgbuild/mac_alias/actions)
+
+`mac_alias` lets you generate or read binary Alias and Bookmark records from Python code.
+
+While it is written in pure Python, some macOS 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](https://mac-alias.readthedocs.io) for more information.

mac_alias-2.2.4rc1/changes/template.md

@@ -0,0 +1,29 @@
+{% for section, _ in sections.items() %}
+{% if section %}
+{{section}}
+
+{% endif %}
+
+{% if sections[section] %}
+{% for category, val in definitions.items() if category in sections[section]%}
+### {{ definitions[category]['name'] }}
+
+{% if definitions[category]['showcontent'] %}
+{% for text, values in sections[section][category].items() %}
+* {{ text }} ({{ values|join(', ') }})
+{% endfor %}
+{% else %}
+* {{ sections[section][category]['']|join(', ') }}
+{% endif %}
+{% if sections[section][category]|length == 0 %}
+No significant changes.
+
+{% else %}
+{% endif %}
+
+{% endfor %}
+{% else %}
+No significant changes.
+
+{% endif %}
+{% endfor %}

{mac_alias-2.2.3 → mac_alias-2.2.4rc1}/docs/conf.py

@@ -12,8 +12,8 @@
 # serve to show the default.
 
 import os
-import re
 import sys
+from importlib.metadata import version
 
 # If extensions (or modules to document with autodoc) are in another directory,
 # add these directories to sys.path here. If the directory is relative to the
@@ -57,14 +57,7 @@ copyright = "2014-2020, Alastair Houghton"
 # built documents.
 #
 # The full version, including alpha/beta/rc tags.
-with open("../src/mac_alias/__init__.py", encoding="utf8") as version_file:
-    version_match = re.search(
-        r"^__version__ = ['\"]([^'\"]*)['\"]", version_file.read(), re.MULTILINE
-    )
-    if version_match:
-        release = version_match.group(1)
-    else:
-        raise RuntimeError("Unable to find version string.")
+release = version("mac_alias")
 
 # The short X.Y version.
 version = ".".join(release.split(".")[:2])

{mac_alias-2.2.3 → mac_alias-2.2.4rc1}/pyproject.toml

@@ -1,6 +1,7 @@
 [build-system]
 requires = [
-    "setuptools==80.9.0",
+    "setuptools==84.2.1",
+    "setuptools_scm==10.3.4",
 ]
 build-backend = "setuptools.build_meta"
 
@@ -8,8 +9,8 @@ build-backend = "setuptools.build_meta"
 dynamic = ["version"]
 name = "mac_alias"
 description = "Generate/parse macOS Alias records from Python"
-readme = "README.rst"
-requires-python = ">= 3.10"
+readme = "README.md"
+requires-python = ">= 3.11"
 license = "MIT"
 license-files = [
     "LICENSE",
@@ -26,12 +27,12 @@ keywords = [
 classifiers = [
     "Development Status :: 5 - Production/Stable",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
     "Programming Language :: Python :: 3.14",
     "Programming Language :: Python :: 3.15",
+    "Programming Language :: Python :: 3.16",
     "Programming Language :: Python :: 3 :: Only",
     "Topic :: Desktop Environment",
     "Topic :: Software Development :: Libraries :: Python Modules",
@@ -43,26 +44,27 @@ Homepage = "https://github.com/dmgbuild/mac_alias"
 Tracker = "https://github.com/dmgbuild/mac_alias/issues"
 Source = "https://github.com/dmgbuild/mac_alias"
 
-[project.scripts]
-mac_alias = "mac_alias.__main__:main"
-
 [dependency-groups]
 package = [
-    "build == 1.2.1",
-    "twine == 6.1.0",
+    "build == 1.6.1",
+    "twine == 7.0.0",
 ]
 
 pre-commit = [
-    "prek == 0.2.19",
+    "prek == 0.5.7",
+]
+
+towncrier = [
+    "towncrier==26.9.0",
 ]
 
 test = [
-    "coverage == 7.10.7",
-    "pytest == 8.4.2",
+    "coverage == 7.17.0",
+    "pytest == 9.1.1",
 ]
 
 tox = [
-    "tox-uv == 1.29.0"
+    "tox-uv == 1.37.0"
 ]
 
 dev = [
@@ -73,12 +75,12 @@ dev = [
 
 # Docs are always built on Py3.12; see RTD and tox config files.
 docs = [
-    "furo == 2025.9.25",
-    "sphinx == 8.2.3",
+    "furo == 2025.12.19",
+    "sphinx == 9.0.4",
 ]
 
-[tool.setuptools.dynamic]
-version = {attr = "mac_alias.__version__"}
+[tool.setuptools_scm]
+# An empty table is needed to enable setuptools_scm
 
 [tool.coverage.run]
 branch = true
@@ -129,3 +131,22 @@ extend-select = [
 # F403: * import used; unable to detect undefined names
 # F405: undefined, or defined from star imports
 "src/mac_alias/__init__.py" = ["F403", "F405"]
+# Ignores needed to pass the Ruff 0.16 update.
+"src/mac_alias/alias.py" = ["UP031", "RUF012"]
+"src/mac_alias/osx.py" = ["UP031", "RUF012"]
+
+[tool.towncrier]
+directory = "changes"
+package = "mac_alias"
+package_dir = "src"
+filename = "CHANGELOG.md"
+title_format = "## {version} ({project_date})"
+issue_format = "[#{issue}](https://github.com/dmgbuild/mac_alias/issues/{issue})"
+template = "changes/template.md"
+type = [
+    { directory = "feature", name = "Features", showcontent = true },
+    { directory = "bugfix", name = "Bugfixes", showcontent = true },
+    { directory = "removal", name = "Backward Incompatible Changes", showcontent = true },
+    { directory = "doc", name = "Documentation", showcontent = true },
+    { directory = "misc", name = "Misc", showcontent = false },
+]

{mac_alias-2.2.3 → mac_alias-2.2.4rc1}/src/mac_alias/__init__.py

@@ -1,46 +1,48 @@
+from importlib.metadata import version
+
 from .alias import *
 from .bookmark import *
 
-__version__ = "2.2.3"
+__version__ = version("mac_alias")
 
 __all__ = [
-    "__version__",
-    "ALIAS_KIND_FILE",
-    "ALIAS_KIND_FOLDER",
-    "ALIAS_HFS_VOLUME_SIGNATURE",
-    "ALIAS_FIXED_DISK",
-    "ALIAS_NETWORK_DISK",
+    "ALIAS_1_44MB_FLOPPY_DISK",
     "ALIAS_400KB_FLOPPY_DISK",
     "ALIAS_800KB_FLOPPY_DISK",
-    "ALIAS_1_44MB_FLOPPY_DISK",
     "ALIAS_EJECTABLE_DISK",
+    "ALIAS_FIXED_DISK",
+    "ALIAS_HFS_VOLUME_SIGNATURE",
+    "ALIAS_KIND_FILE",
+    "ALIAS_KIND_FOLDER",
+    "ALIAS_NETWORK_DISK",
     "ALIAS_NO_CNID",
-    "kBookmarkPath",
+    "URL",
+    "Alias",
+    "AppleShareInfo",
+    "Bookmark",
+    "Data",
+    "TargetInfo",
+    "VolumeInfo",
+    "__version__",
     "kBookmarkCNIDPath",
-    "kBookmarkFileProperties",
-    "kBookmarkFileName",
-    "kBookmarkFileID",
+    "kBookmarkContainingFolder",
+    "kBookmarkCreationOptions",
     "kBookmarkFileCreationDate",
+    "kBookmarkFileID",
+    "kBookmarkFileName",
+    "kBookmarkFileProperties",
+    "kBookmarkPath",
+    "kBookmarkSecurityExtension",
     "kBookmarkTOCPath",
+    "kBookmarkUID",
+    "kBookmarkURLLengths",
+    "kBookmarkUserName",
+    "kBookmarkVolumeCreationDate",
+    "kBookmarkVolumeName",
     "kBookmarkVolumePath",
+    "kBookmarkVolumeProperties",
+    "kBookmarkVolumeSize",
     "kBookmarkVolumeURL",
-    "kBookmarkVolumeName",
     "kBookmarkVolumeUUID",
-    "kBookmarkVolumeSize",
-    "kBookmarkVolumeCreationDate",
-    "kBookmarkVolumeProperties",
-    "kBookmarkContainingFolder",
-    "kBookmarkUserName",
-    "kBookmarkUID",
     "kBookmarkWasFileReference",
-    "kBookmarkCreationOptions",
-    "kBookmarkURLLengths",
-    "kBookmarkSecurityExtension",
-    "AppleShareInfo",
-    "VolumeInfo",
-    "TargetInfo",
-    "Alias",
-    "Bookmark",
-    "Data",
-    "URL",
 ]

{mac_alias-2.2.3 → mac_alias-2.2.4rc1}/src/mac_alias/alias.py

@@ -297,12 +297,14 @@ class Alias:
         version=2,
         volume=None,
         target=None,
-        extra=[],
+        extra=None,
     ):
         """Construct a new :class:`Alias` object with the specified
         contents."""
 
         #: Application specific information (four byte byte-string)
+        if extra is None:
+            extra = []
         self.appinfo = appinfo
 
         #: Version (we support versions 2 and 3)
@@ -344,7 +346,7 @@ class Alias:
                 levels_to,  # h
                 volattrs,  # I
                 volfsid,  # 2s
-                reserved,  # 10s
+                _reserved,  # 10s
             ) = struct.unpack(b">h28pI2shI64pII4s4shhI2s10s", b.read(142))
         else:
             (
@@ -356,7 +358,7 @@ class Alias:
                 cnid,  # I
                 crdate_hr,  # Q
                 volattrs,  # I
-                reserved,  # 14s
+                _reserved,  # 14s
             ) = struct.unpack(b">hQ4shIIQI14s", b.read(46))
 
             volname = b""
@@ -463,7 +465,7 @@ class Alias:
     def for_file(cls, path):
         """Create an :class:`Alias` that points at the specified file."""
         if sys.platform != "darwin":
-            raise Exception("Not implemented (requires special support)")
+            raise RuntimeError("Not implemented (requires special support)")
 
         path = encode_utf8(path)
 

{mac_alias-2.2.3 → mac_alias-2.2.4rc1}/src/mac_alias/bookmark.py

@@ -294,7 +294,7 @@ class Bookmark:
         elif dtype == BMK_NULL:
             return None
 
-        print("Unknown data type %08x" % typecode)  # noqa: T201
+        print(f"Unknown data type {typecode:08x}")  # noqa: T201
         return (typecode, databytes)
 
     @classmethod
@@ -307,7 +307,7 @@ class Bookmark:
         if isinstance(data, bytearray):
             data = bytes(data)
 
-        magic, size, dummy, hdrsize = struct.unpack(b"<4sIII", data[0:16])
+        magic, size, _dummy, hdrsize = struct.unpack(b"<4sIII", data[0:16])
 
         if magic not in (b"book", b"alis"):
             raise ValueError(f"Not a bookmark file (bad magic) {magic!r}")
@@ -348,7 +348,7 @@ class Bookmark:
             toc = {}
             for n in range(toccount):
                 ebase = tocbase + 20 + 12 * n
-                eid, eoffset, edummy = struct.unpack(b"<III", data[ebase : ebase + 12])
+                eid, eoffset, _edummy = struct.unpack(b"<III", data[ebase : ebase + 12])
 
                 if eid & 0x80000000:
                     eid = cls._get_item(data, hdrsize, eid & 0x7FFFFFFF)
@@ -418,7 +418,7 @@ class Bookmark:
             if item.base:
                 baseoff = offset + 16
                 reloff, baseenc = cls._encode_item(item.base, baseoff)
-                xoffset, relenc = cls._encode_item(item.relative, reloff)
+                _xoffset, relenc = cls._encode_item(item.relative, reloff)
                 result = b"".join(
                     [
                         struct.pack(

mac_alias-2.2.4rc1/src/mac_alias.egg-info/PKG-INFO

@@ -0,0 +1,39 @@
+Metadata-Version: 2.4
+Name: mac_alias
+Version: 2.2.4rc1
+Summary: Generate/parse macOS Alias records from Python
+Author-email: Alastair Houghton <alastair@alastairs-place.net>
+Maintainer-email: Russell Keith-Magee <russell@keith-magee.com>
+License-Expression: MIT
+Project-URL: Documentation, https://mac-alias.readthedocs.io/en/latest/
+Project-URL: Homepage, https://github.com/dmgbuild/mac_alias
+Project-URL: Tracker, https://github.com/dmgbuild/mac_alias/issues
+Project-URL: Source, https://github.com/dmgbuild/mac_alias
+Keywords: mac_alias
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
+Classifier: Programming Language :: Python :: 3.16
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Desktop Environment
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# mac_alias
+
+[![Python Versions](https://img.shields.io/pypi/pyversions/mac_alias.svg)](https://pypi.python.org/pypi/mac_alias) [![PyPI Version](https://img.shields.io/pypi/v/mac_alias.svg)](https://pypi.python.org/pypi/mac_alias) [![Maturity](https://img.shields.io/pypi/status/mac_alias.svg)](https://pypi.python.org/pypi/mac_alias) [![MIT License](https://img.shields.io/pypi/l/mac_alias.svg)](https://github.com/dmgbuild/mac_alias/blob/main/LICENSE) [![Build status](https://github.com/dmgbuild/mac_alias/workflows/CI/badge.svg?branch=main)](https://github.com/dmgbuild/mac_alias/actions)
+
+`mac_alias` lets you generate or read binary Alias and Bookmark records from Python code.
+
+While it is written in pure Python, some macOS 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](https://mac-alias.readthedocs.io) for more information.

{mac_alias-2.2.3 → mac_alias-2.2.4rc1}/src/mac_alias.egg-info/SOURCES.txt

@@ -1,9 +1,18 @@
+.gitignore
 .pre-commit-config.yaml
 .readthedocs.yaml
+CHANGELOG.md
 LICENSE
-README.rst
+README.md
 pyproject.toml
 tox.ini
+.github/dependabot.yml
+.github/zizmor.yml
+.github/workflows/ci.yml
+.github/workflows/dependabot-changenote.yml
+.github/workflows/publish.yml
+.github/workflows/release.yml
+changes/template.md
 docs/Makefile
 docs/alias_fmt.rst
 docs/bookmark_fmt.rst
@@ -20,7 +29,8 @@ src/mac_alias/utils.py
 src/mac_alias.egg-info/PKG-INFO
 src/mac_alias.egg-info/SOURCES.txt
 src/mac_alias.egg-info/dependency_links.txt
-src/mac_alias.egg-info/entry_points.txt
+src/mac_alias.egg-info/scm_file_list.json
+src/mac_alias.egg-info/scm_version.json
 src/mac_alias.egg-info/top_level.txt
 tests/__init__.py
 tests/test_alias.py

mac_alias-2.2.4rc1/src/mac_alias.egg-info/scm_file_list.json

@@ -0,0 +1,35 @@
+{
+  "files": [
+    ".github/dependabot.yml",
+    ".github/workflows/ci.yml",
+    ".github/workflows/dependabot-changenote.yml",
+    ".github/workflows/publish.yml",
+    ".github/workflows/release.yml",
+    ".github/zizmor.yml",
+    ".gitignore",
+    ".pre-commit-config.yaml",
+    ".readthedocs.yaml",
+    "CHANGELOG.md",
+    "LICENSE",
+    "README.md",
+    "changes/template.md",
+    "docs/Makefile",
+    "docs/_static/README.rst",
+    "docs/alias_fmt.rst",
+    "docs/bookmark_fmt.rst",
+    "docs/conf.py",
+    "docs/index.rst",
+    "docs/mac_alias.rst",
+    "docs/make.bat",
+    "pyproject.toml",
+    "src/mac_alias/__init__.py",
+    "src/mac_alias/alias.py",
+    "src/mac_alias/bookmark.py",
+    "src/mac_alias/osx.py",
+    "src/mac_alias/utils.py",
+    "tests/__init__.py",
+    "tests/test_alias.py",
+    "tests/test_bookmark.py",
+    "tox.ini"
+  ]
+}

mac_alias-2.2.4rc1/src/mac_alias.egg-info/scm_version.json

@@ -0,0 +1,8 @@
+{
+  "tag": "2.2.4rc1",
+  "distance": 0,
+  "node": "g9b5bdf511f82cace8411dd1f3f75bf9731024765",
+  "dirty": false,
+  "branch": "HEAD",
+  "node_date": "2026-11-11"
+}

{mac_alias-2.2.3 → mac_alias-2.2.4rc1}/tox.ini

@@ -1,8 +1,20 @@
 [tox]
-envlist = docs,package,py{310,311,312,313,314,315}
+envlist = pre-commit,towncrier-check,docs,py{311,312,313,314,315,316}
 skip_missing_interpreters = true
 
-[testenv]
+[testenv:pre-commit]
+package = wheel
+wheel_build_env = .pkg
+dependency_groups = pre-commit
+commands = prek run --all-files --show-diff-on-failure --color=always
+
+[testenv:towncrier{,-check}]
+dependency_groups = towncrier
+commands =
+    check  : python -m towncrier.check --compare-with origin/main
+    !check : python -m towncrier {posargs}
+
+[testenv:py{,311,312,313,314,315,316}]
 dependency_groups = test
 commands =
     python -m coverage run -m pytest -vv
@@ -15,11 +27,3 @@ change_dir = docs
 dependency_groups = docs
 commands =
     python -m sphinx build --fail-on-warning --keep-going --jobs auto -n --verbose --fresh-env --show-traceback --write-all -d _build/doctrees --builder html . {posargs:_build/html}
-
-[testenv:package]
-skip_install = True
-passenv = FORCE_COLOR
-dependency_groups = package
-commands =
-    python -m build --sdist --wheel --outdir dist/ .
-    python -m twine check dist/*

mac_alias-2.2.3/PKG-INFO

@@ -1,72 +0,0 @@
-Metadata-Version: 2.4
-Name: mac_alias
-Version: 2.2.3
-Summary: Generate/parse macOS Alias records from Python
-Author-email: Alastair Houghton <alastair@alastairs-place.net>
-Maintainer-email: Russell Keith-Magee <russell@keith-magee.com>
-License-Expression: MIT
-Project-URL: Documentation, https://mac-alias.readthedocs.io/en/latest/
-Project-URL: Homepage, https://github.com/dmgbuild/mac_alias
-Project-URL: Tracker, https://github.com/dmgbuild/mac_alias/issues
-Project-URL: Source, https://github.com/dmgbuild/mac_alias
-Keywords: mac_alias
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Programming Language :: Python :: 3.14
-Classifier: Programming Language :: Python :: 3.15
-Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Topic :: Desktop Environment
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: >=3.10
-Description-Content-Type: text/x-rst
-License-File: LICENSE
-Dynamic: license-file
-
-=========
-mac_alias
-=========
-
-.. |pyversions| image:: https://img.shields.io/pypi/pyversions/mac_alias.svg
-   :target: https://pypi.python.org/pypi/mac_alias
-   :alt: Python Versions
-
-.. |version| image:: https://img.shields.io/pypi/v/mac_alias.svg
-   :target: https://pypi.python.org/pypi/mac_alias
-   :alt: PyPI Version
-
-.. |maturity| image:: https://img.shields.io/pypi/status/mac_alias.svg
-   :target: https://pypi.python.org/pypi/mac_alias
-   :alt: Maturity
-
-.. |license| image:: https://img.shields.io/pypi/l/mac_alias.svg
-   :target: https://github.com/dmgbuild/mac_alias/blob/main/LICENSE
-   :alt: MIT License
-
-.. |ci| image:: https://github.com/dmgbuild/mac_alias/workflows/CI/badge.svg?branch=main
-   :target: https://github.com/dmgbuild/mac_alias/actions
-   :alt: Build Status
-
-|pyversions| |version| |maturity| |license| |ci|
-
-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

mac_alias-2.2.3/README.rst

@@ -1,44 +0,0 @@
-=========
-mac_alias
-=========
-
-.. |pyversions| image:: https://img.shields.io/pypi/pyversions/mac_alias.svg
-   :target: https://pypi.python.org/pypi/mac_alias
-   :alt: Python Versions
-
-.. |version| image:: https://img.shields.io/pypi/v/mac_alias.svg
-   :target: https://pypi.python.org/pypi/mac_alias
-   :alt: PyPI Version
-
-.. |maturity| image:: https://img.shields.io/pypi/status/mac_alias.svg
-   :target: https://pypi.python.org/pypi/mac_alias
-   :alt: Maturity
-
-.. |license| image:: https://img.shields.io/pypi/l/mac_alias.svg
-   :target: https://github.com/dmgbuild/mac_alias/blob/main/LICENSE
-   :alt: MIT License
-
-.. |ci| image:: https://github.com/dmgbuild/mac_alias/workflows/CI/badge.svg?branch=main
-   :target: https://github.com/dmgbuild/mac_alias/actions
-   :alt: Build Status
-
-|pyversions| |version| |maturity| |license| |ci|
-
-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

mac_alias-2.2.3/src/mac_alias.egg-info/PKG-INFO

@@ -1,72 +0,0 @@
-Metadata-Version: 2.4
-Name: mac_alias
-Version: 2.2.3
-Summary: Generate/parse macOS Alias records from Python
-Author-email: Alastair Houghton <alastair@alastairs-place.net>
-Maintainer-email: Russell Keith-Magee <russell@keith-magee.com>
-License-Expression: MIT
-Project-URL: Documentation, https://mac-alias.readthedocs.io/en/latest/
-Project-URL: Homepage, https://github.com/dmgbuild/mac_alias
-Project-URL: Tracker, https://github.com/dmgbuild/mac_alias/issues
-Project-URL: Source, https://github.com/dmgbuild/mac_alias
-Keywords: mac_alias
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Programming Language :: Python :: 3.14
-Classifier: Programming Language :: Python :: 3.15
-Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Topic :: Desktop Environment
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: >=3.10
-Description-Content-Type: text/x-rst
-License-File: LICENSE
-Dynamic: license-file
-
-=========
-mac_alias
-=========
-
-.. |pyversions| image:: https://img.shields.io/pypi/pyversions/mac_alias.svg
-   :target: https://pypi.python.org/pypi/mac_alias
-   :alt: Python Versions
-
-.. |version| image:: https://img.shields.io/pypi/v/mac_alias.svg
-   :target: https://pypi.python.org/pypi/mac_alias
-   :alt: PyPI Version
-
-.. |maturity| image:: https://img.shields.io/pypi/status/mac_alias.svg
-   :target: https://pypi.python.org/pypi/mac_alias
-   :alt: Maturity
-
-.. |license| image:: https://img.shields.io/pypi/l/mac_alias.svg
-   :target: https://github.com/dmgbuild/mac_alias/blob/main/LICENSE
-   :alt: MIT License
-
-.. |ci| image:: https://github.com/dmgbuild/mac_alias/workflows/CI/badge.svg?branch=main
-   :target: https://github.com/dmgbuild/mac_alias/actions
-   :alt: Build Status
-
-|pyversions| |version| |maturity| |license| |ci|
-
-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

mac_alias-2.2.3/src/mac_alias.egg-info/entry_points.txt

@@ -1,2 +0,0 @@
-[console_scripts]
-mac_alias = mac_alias.__main__:main