Rhet Turnbull RhetTbull

## get_latest_pypi_version.py
"""Given a PyPI package name, print the latest version number of the package.

This uses the standard library instead of requests to avoid adding a dependency to the project.
"""

from __future__ import annotations

import json
import ssl
import sys

## pyapp.sh
#!/bin/bash

# PyApp Runner
# This script is used to build and copy the PyApp executable
# See https://ofek.dev/pyapp/latest/how-to/ for more information on PyApp.

# Change this to the path where pyapp is installed
PYAPP="/path/to/pyapp-latest"

# Check that both arguments are provided

## pyapp_runner.sh
#!/bin/bash

# PyApp Runner
# This script is used to build and copy the PyApp executable from a remote server.
# See https://ofek.dev/pyapp/latest/how-to/ for more information on PyApp.
# The remote server must have PYAPP defined in the ~/.zshenv file
# to point to the install location of pyapp.
# For example:
# echo 'export PYAPP="/Users/johndoe/code/pyapp-latest"' >> ~/.zshenv
# For code signing to work via ssh, you must first run this one time on the machine via GUI

## minimal.py
"""Implements a minimalist Cocoa application using pyobjc

Based on the example found here:
https://www.cocoawithlove.com/2010/09/minimalist-cocoa-programming.html

To run this:
    - save as minimal.py
    - pip3 install pyobjc
    - python3 minimal.py


## image_metadata.py
"""Get EXIF/IPTC/XMP metadata from an image file on macOS using CoreGraphics via pyobjc.

Requires installation of the following [pyobjc](https://pyobjc.readthedocs.io/en/latest/index.html) packages:

`pip install pyobjc-core pyobjc-framework-Quartz`

This module provides 3 public functions:

- get_image_properties(): Returns the metadata properties dictionary from the image at the given path.
- get_image_xmp_metadata(): Returns the XMP metadata dictionary from the image at the given path.

## pyver.sh
#!/bin/bash

# Change symlink to Python version in /usr/local/bin/python to point to a
# specified version as installed by the official python.org installer for macOS
# usage: ./pyver.sh <version>
# when called without arguments, prints the currently linked Python version
# This is useful for use with pyenv (https://github.com/pyenv/pyenv) which can only
# handle a single "system" python version and offers no way to switch between multiple
# system pythons

## copyfile.py
"""Copy a file on macOS using native API.
This allows copied files to use copy-on-write when used on a volume formatted with APFS.

When used on an APFS volume, a file copied with this function will be copied almost instantly
and will not use any additional disk space until the file is modified.

To use, you will need to install pyobjc-core and pyobjc-framework-Cocoa:

    `python3 -m pip install pyobjc-core pyobjc-framework-Cocoa`

## count_photos.py
"""Count photos for a given query criteria"""

from __future__ import annotations

import osxphotos
from osxphotos.cli import query_command


@query_command
def count_photos(photos: list[osxphotos.PhotoInfo], **kwargs):

## tkoutput.py
"""Redirect output of a command to a tkinter text box in real-time"""

from __future__ import annotations

import subprocess
import threading
import tkinter as tk


def update_text_box(text_box: tk.Text, proc: subprocess.Popen):

## noterescue.py
"""Rescue lost Apple Notes notes, reference: https://fosstodon.org/@Cyberneticist@hachyderm.io/109992039449199371

To run this:

1. Install python (I recommend the latest version of python 3 from python.org)
2. Install the dependencies: python3 -m pip install bpylist2
3. Run the script: python3 noterescue.py <path to note file(s)>

The extracted files will be saved in the parent directory of the note file.
	"""Given a PyPI package name, print the latest version number of the package.

	This uses the standard library instead of requests to avoid adding a dependency to the project.
	"""

	from __future__ import annotations

	import json
	import ssl
	import sys
	#!/bin/bash

	# PyApp Runner
	# This script is used to build and copy the PyApp executable
	# See https://ofek.dev/pyapp/latest/how-to/ for more information on PyApp.

	# Change this to the path where pyapp is installed
	PYAPP="/path/to/pyapp-latest"

	# Check that both arguments are provided
	"""Implements a minimalist Cocoa application using pyobjc

	Based on the example found here:
	https://www.cocoawithlove.com/2010/09/minimalist-cocoa-programming.html

	To run this:
	- save as minimal.py
	- pip3 install pyobjc
	- python3 minimal.py
	"""Get EXIF/IPTC/XMP metadata from an image file on macOS using CoreGraphics via pyobjc.

	Requires installation of the following [pyobjc](https://pyobjc.readthedocs.io/en/latest/index.html) packages:

	`pip install pyobjc-core pyobjc-framework-Quartz`

	This module provides 3 public functions:

	- get_image_properties(): Returns the metadata properties dictionary from the image at the given path.
	- get_image_xmp_metadata(): Returns the XMP metadata dictionary from the image at the given path.
	#!/bin/bash

	# Change symlink to Python version in /usr/local/bin/python to point to a
	# specified version as installed by the official python.org installer for macOS
	# usage: ./pyver.sh <version>
	# when called without arguments, prints the currently linked Python version
	# This is useful for use with pyenv (https://github.com/pyenv/pyenv) which can only
	# handle a single "system" python version and offers no way to switch between multiple
	# system pythons
	"""Copy a file on macOS using native API.
	This allows copied files to use copy-on-write when used on a volume formatted with APFS.

	When used on an APFS volume, a file copied with this function will be copied almost instantly
	and will not use any additional disk space until the file is modified.

	To use, you will need to install pyobjc-core and pyobjc-framework-Cocoa:

	`python3 -m pip install pyobjc-core pyobjc-framework-Cocoa`
	"""Count photos for a given query criteria"""

	from __future__ import annotations

	import osxphotos
	from osxphotos.cli import query_command


	@query_command
	def count_photos(photos: list[osxphotos.PhotoInfo], **kwargs):
	"""Redirect output of a command to a tkinter text box in real-time"""

	from __future__ import annotations

	import subprocess
	import threading
	import tkinter as tk


	def update_text_box(text_box: tk.Text, proc: subprocess.Popen):
	"""Rescue lost Apple Notes notes, reference: https://fosstodon.org/@Cyberneticist@hachyderm.io/109992039449199371

	To run this:

	1. Install python (I recommend the latest version of python 3 from python.org)
	2. Install the dependencies: python3 -m pip install bpylist2
	3. Run the script: python3 noterescue.py <path to note file(s)>

	The extracted files will be saved in the parent directory of the note file.