Release 1.3.0

For help on installing and using Zowie, please see the project front page.

All changes in this release

This release fixes issues #13 and #18, updates the required version of some dependencies, and changes the minimum version of Python to version 3.8.

Detailed changes:

• Fix issue #13: filtering by date using the -d option is broken.
• Fix issue #18: installations using pipx failed.
• Updated versions of dependencies in requirements.txt.
• Added requirements-dev.txt.
• Improved codemeta.json.
• Updated Makefile and setup.py to use versions developed for other projects.
• Updated copyright year in various files.

Self-contained runnable programs

The first variant of a runnable Zowie program needs a Python interpreter version 3.8 or higher on your computer. run the following command in a terminal and take note of the version of Python that it prints:

python3 --version

Next,

1. In the files attached to this release, look for a ZIP file with a name that contains your version of Python
2. Click on that ZIP file to download it
3. Unzip the file (if your browser did not automatically unzip it for you)
4. Open the folder thus created (it will have a name like zowie-1.2.0-macos-python3.8)
5. Look inside for zowie and move it to a location where you put other command-line programs (such as /usr/local/bin).

If you want to put it in /usr/local/bin but that folder does not exist on your computer yet, you can create it by opening a terminal window and running the following command (prior to moving zowie into /usr/local/bin):

sudo mkdir /usr/local/bin

The following is an example command that you can type in a terminal to move Zowie there:

sudo mv zowie /usr/local/bin

Note: the first time you run this ready-to-run version, Zowie will take longer than usual to start because it does a one-time configuration step, but on subsequent runs, startup times should be shorter.

Release 1.2.0

See sections further below for instructions about the binary/ready-to-run copies of Zowie.

All changes in this release

• Add new -s option. Please see the section on special-case behavior for an explanation.
• Fix issue #9: version incompatibility with Sidetrack version 2.0 package.
• Use lazy imports of Python packages for faster application startup.
• Add script to create zipapp version of Zowie.
• Overhaul Makefile.
• Update versions of all Python packages dependencies, and make requirements.txt pin the exact version of the packages used at release time.
• Update LICENSE file, which had the wrong license text!

Self-contained runnable programs

There are two variants of Zowie in its ready-to-run form, suitable for different versions of macOS.

macOS 10.15 (Catalina) and later

The first variant of a runnable Zowie program needs a Python interpreter version 3.8 or higher on your computer. Happily, that's the case for macOS 10.15 and later. To be sure, first check the version of the program python3 that you get by running the following command in a terminal and inspecting the results:

python3 --version

(Note: if this is the first time you've run python3 on your system, macOS will ask if you want to install certain additional software components. Let it do so.)

Next,

1. In the files attached to this release, look for a ZIP file with a name that contains your version of Python
2. Click on that ZIP file to download it
3. Unzip the file (if your browser did not automatically unzip it for you)
4. Open the folder thus created (it will have a name like zowie-1.2.0-macos-python3.8)
5. Look inside for zowie and move it to a location where you put other command-line programs (such as /usr/local/bin).

If you want to put it in /usr/local/bin but that folder does not exist on your computer yet, you can create it by opening a terminal window and running the following command (prior to moving zowie into /usr/local/bin):

sudo mkdir /usr/local/bin

The following is an example command that you can type in a terminal to move Zowie there:

sudo mv zowie /usr/local/bin

Note: the first time you run this variant, Zowie will take longer than usual to start because it does a one-time configuration step, but on subsequent runs, startup times should be shorter.

macOS 10.14 (Mojave) and earlier

Another other variant of the runnable Zowie app is available for macOS before 10.15, for which Apple did not provide Python version 3. This copy of Zowie works like any normal command-line program and does not require Python. (However, it does not run on macOS Catalina or later due to Apple security issues.)

1. Look for the file named zowie.zip in the files attached to this release
2. Click on zowie.zip to download it
3. Unzip the file; this will leave you with a file named zowie, which is the program itself
4. Move zowie to a folder where you put other command-line programs (e.g. /usr/local/bin)

If you want to put it in /usr/local/bin but that folder does not exist on your computer yet, you can create it by opening a terminal window and running the following command (prior to moving zowie into /usr/local/bin):

sudo mkdir /usr/local/bin

The following is an example command that you can type in a terminal to move Zowie there:

sudo mv zowie /usr/local/bin

Additional notes

• The first variant of the app described above (with file names like zowie-1.2.0-macos-python3.8) will also run on macOS 10.14 and probably 10.13, but only if you install your own copy of Python version 3.8 or later. Experienced Python users may want to try this, because this variant of Zowie starts much faster than the second variant described above.

• The first time you run one of the first variants, Zowie will take longer than usual to start because it does a one-time configuration step, but on subsequent runs, startup times should be shorter.

Release 1.1.2

Changes in this release:

• Add missing dependency to requirements.txt
• Mention Zowie can't work with Zotero installations that use the linked attachment file method.

Release 1.1.1

This release fixes issue #4 (Zowie producing an error when no path argument is given), caused by not checking that a path has been provided on the command line.

Release 1.1.0

This release brings several important changes:

• Zowie now operates on all types of files by default, not just PDF files.
• Zowie has a new command-line option: -f, to allow you to filter files by their extensions and limit its operation to specific file types instead of all files, if you wish.
• A ready-to-run binary executable for some versions of macOS is now available for downloading from GitHub.

Important: the .zip file contains a precompiled binary that runs only on macOS 10.13–10.14 (Mojave), and not on 10.15 (Catalina) or later. Please read the installation instructions for more information.

Release 1.0.6

This update limits the parts of the PyObjC package that are required in requirements.txt, to improve installation time as well as avoid a conflict between pyobjc-framework-PubSub and the Python PyPubSub package used by Bun.

Release 1.0.5

Fixed issue #1: PDF files that have no parent records are not necessarily an error. Zotero now prints warnings, not errors, for those cases.

Release 1.0.4

Changes in this release:

• Fixed issue #2: errors about database lookups were unclear about which file was involved.
• Added info to installation instructions about using --upgrade option to pip.
• Fixed some minor code errors that had few, if any, external implications.
• Made some very minor documentation changes and elaborations.
• Started adding unit tests.
• Made other minor internal fixes and changes.

Release 1.0.3

This release fixes a missing Python package import in some code files, and also protects more print statements against file names that contain { and/or } characters. (The latter have special meaning to some Python constructs.)

Release 1.0.2

This release fixes an important bug in regular expressions used to replace existing Zotero select links inside Finder comments and PDF Subject and Producer fields. It also includes some internal cleanup for some Pylint issues (a cleanup process that is not finished).