Merge branch 'main' into feat/better-docs

Author: malmeloo

.envrc

@@ -0,0 +1 @@
+use nix

.github/actions/setup-project/action.yml

@@ -0,0 +1,43 @@
+name: Common Python + Poetry Setup
+
+inputs:
+  dependency-groups:
+    description: 'A comma-separated list of dependency groups to install'
+    default: 'main'
+  python-version:
+    description: 'The Python version to use'
+    default: '3.10'
+
+runs:
+  using: 'composite'
+
+  steps:
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ inputs.python-version }}
+
+    - name: Install poetry
+      shell: bash
+      run: |
+        python -m pip install poetry
+        poetry config virtualenvs.in-project true
+
+    - name: Get cache key
+      id: cache-key
+      shell: bash
+      run: |
+        key=$(echo "${{ inputs.dependency-groups }}" | sed 's/,/+/')
+        echo "key=$key" >> "$GITHUB_OUTPUT"
+
+    - name: Load cached venv
+      id: cache-dependencies
+      uses: actions/cache@v4
+      with:
+        path: .venv
+        key: venv-${{ runner.os }}-python-${{ inputs.python-version }}-groups-${{ steps.cache-key.outputs.key }}-${{ hashFiles('**/poetry.lock') }}
+
+    - name: Install dependencies
+      if: steps.cache-dependencies.outputs.cache-hit != 'true'
+      shell: bash
+      run: poetry install --with ${{ inputs.dependency-groups }}

.github/workflows/docs.yml

@@ -16,17 +16,10 @@ jobs:
 
     steps:
     - uses: actions/checkout@v4
-    
-    - name: Set up Python
-      uses: actions/setup-python@v5
+
+    - uses: './.github/actions/setup-project'
       with:
-        python-version: '3.10'
-      
-    - name: Install dependencies
-      run: |
-        python -m pip install poetry
-        poetry config virtualenvs.in-project true
-        poetry install
+        dependency-groups: 'docs'
 
     - name: Build documentation
       run: |

.github/workflows/pre-commit.yml

@@ -3,26 +3,17 @@ name: Pre-commit
 on:
   workflow_dispatch:
   push:
-    branches-ignore:
-      - main
 
 jobs:
-  deploy:
+  check:
     runs-on: ubuntu-latest
 
     steps:
     - uses: actions/checkout@v4
-    
-    - name: Set up Python
-      uses: actions/setup-python@v5
-      with:
-        python-version: '3.10'
 
-    - name: Install dependencies
-      run: |
-        python -m pip install poetry
-        poetry config virtualenvs.in-project true
-        poetry install
+    - uses: './.github/actions/setup-project'
+      with:
+        dependency-groups: 'dev,test'
 
     - uses: pre-commit/action@v3.0.1
 

.github/workflows/publish.yml

@@ -15,16 +15,13 @@ jobs:
 
     steps:
     - uses: actions/checkout@v4
-    - name: Set up Python
-      uses: actions/setup-python@v5
+
+    - uses: './.github/actions/setup-project'
       with:
-        python-version: '3.10'
-      
-    - name: Install dependencies
-      run: |
-        python -m pip install poetry
-        poetry config virtualenvs.in-project true
-        poetry install
+        dependency-groups: 'dev'
+
+    - name: Prepare README
+      run: ./scripts/refactor_readme.py README.md
 
     - name: Build package
       run: poetry build

.github/workflows/test.yml

@@ -0,0 +1,56 @@
+name: Run unit tests
+
+on:
+  workflow_dispatch:
+  push:
+
+jobs:
+  versions:
+    runs-on: ubuntu-latest
+
+    outputs:
+      py-versions: ${{ steps.supported-versions.outputs.py-versions }}
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - uses: './.github/actions/setup-project'
+      with:
+        dependency-groups: 'dev'
+
+    - id: supported-versions
+      name: Get supported versions
+      run: |
+        set -e
+        echo "py-versions=$(poetry run ./scripts/supported_py_versions.py)" >> "$GITHUB_OUTPUT"
+
+  test:
+    runs-on: ubuntu-latest
+
+    needs: versions
+    strategy:
+      matrix:
+        py-version: ${{ fromJson(needs.versions.outputs.py-versions) }}
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: './.github/actions/setup-project'
+        with:
+          python-version: ${{ matrix.py-version }}
+          dependency-groups: 'test'
+
+      - name: Run unit tests
+        run: poetry run pytest
+
+  results:
+    runs-on: ubuntu-latest
+    needs: test
+    steps:
+      - run: |
+          result="${{ needs.test.result }}"
+          if [[ $result == "success" || $result == "skipped" ]]; then
+            exit 0
+          else
+            exit 1
+          fi

.gitignore

@@ -163,3 +163,4 @@ cython_debug/
 account.json
 airtag.plist
 DO_NOT_COMMIT*
+.direnv/

.pre-commit-config.yaml

@@ -1,11 +1,11 @@
 repos:
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.1.9
+    rev: v0.6.3
     hooks:
       - id: ruff
         args: ["--fix"]
       - id: ruff-format
   - repo: https://github.com/RobertCraigie/pyright-python
-    rev: v1.1.350
+    rev: v1.1.378
     hooks:
       - id: pyright

README.md

@@ -1,6 +1,7 @@
 # FindMy.py
 
 [![](https://img.shields.io/pypi/v/FindMy)](https://pypi.org/project/FindMy/)
+[![](https://img.shields.io/pypi/dm/FindMy)](#)
 [![](https://img.shields.io/github/license/malmeloo/FindMy.py)](LICENSE.md)
 [![](https://img.shields.io/pypi/pyversions/FindMy)](#)
 
@@ -19,13 +20,15 @@ application wishing to integrate with the Find My network.
 > without prior warning.
 > 
 > You are encouraged to report any issues you can find on the
-> [issue tracker](https://github.com/malmeloo/FindMy.py/)!
+> [issue tracker](https://github.com/malmeloo/FindMy.py/issues/)!
 
 ### Features
 
 - [x] Cross-platform: no Mac needed
-- [x] Fetch location reports
-  - [x] Apple acount sign-in
+- [x] Fetch and decrypt location reports
+  - [x] Official accessories (AirTags, iDevices, etc.)
+  - [x] Custom AirTags (OpenHaystack) 
+- [x] Apple account sign-in
   - [x] SMS 2FA support
   - [x] Trusted Device 2FA support
 - [x] Scan for nearby FindMy-devices
@@ -36,8 +39,7 @@ application wishing to integrate with the Find My network.
 ### Roadmap
 
 - [ ] Local anisette generation (without server)
-    - Can be done using [pyprovision](https://github.com/Dadoum/pyprovision/),
-      however I want to wait until Python wheels are available.
+    - More information: [#2](https://github.com/malmeloo/FindMy.py/issues/2)
 
 ## Installation
 

examples/_login.py

@@ -1,3 +1,5 @@
+# ruff: noqa: ASYNC230
+
 import json
 from pathlib import Path