diff --git a/CHANGES.md b/CHANGES.md index 2efa0e5..53381ca 100644 --- a/CHANGES.md +++ b/CHANGES.md @@ -1,6 +1,13 @@ Change log for Zowie ==================== +Version 1.1.2 +-------------- + +* Add missing dependency to `requirements.txt` +* Mention Zowie can't work with Zotero installations that use the linked attachment file method. + + Version 1.1.1 -------------- diff --git a/Makefile b/Makefile index 5dc424f..4fe6ed7 100644 --- a/Makefile +++ b/Makefile @@ -46,13 +46,14 @@ $(info Gathering data ... Done.) # make binary ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -binary: | dependencies dist/$(name) +binary: | dependencies dist/$(name).zip dependencies:; pip3 install -r requirements.txt -dist/$(name): +dist/$(name).zip: pyinstaller --clean pyinstaller-$(platform).spec + zip dist/$(name).zip dist/$(name) # make release ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -92,7 +93,7 @@ release-on-github: | update-init-file update-codemeta-file check-in-updated-file sleep 2 $(EDITOR) $(tmp_file) gh release create v$(version) -t "Release $(version)" -F $(tmp_file) - gh release upload v$(version) dist/$(name) + gh release upload v$(version) dist/$(name).zip print-instructions:; $(info ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓) @@ -131,7 +132,7 @@ pypi: create-dist clean: clean-dist clean-build clean-release clean-other clean-dist:; - -rm -fr dist/$(name) dist/$(name)-$(version).tar.gz \ + -rm -fr dist/$(name) dist/$(name).zip dist/$(name)-$(version).tar.gz \ dist/$(name)-$(version)-py3-none-any.whl clean-build:; diff --git a/README.md b/README.md index 695ca9d..58d126a 100644 --- a/README.md +++ b/README.md @@ -31,7 +31,9 @@ When using [Zotero](https://zotero.org), you may on occasion want to work with P Enter Zowie (a loose acronym for _"**Zo**tero link **w**r**i**t**e**r"_, and pronounced like [the interjection](https://www.merriam-webster.com/dictionary/zowie)). Zowie scans through the files in a local Zotero database, looks up the Zotero bibliographic record corresponding to each attachment file found, and writes a [Zotero select link](https://forums.zotero.org/discussion/78053/given-the-pdf-file-of-an-article-how-can-you-find-out-its-uri#latest) into the file and/or certain macOS Finder/Spotlight metadata fields (depending on the user's choice). A Zotero select link has the form `zotero://select/...` and when opened on macOS, causes the Zotero desktop application to open that item in your database. Zowie thus makes it possible to go from a file opened in an application other than Zotero (e.g., DEVONthink, Adobe Acrobat), to the Zotero record corresponding to that file. -Zowie uses the Zotero network API to discover the user's shared libraries and groups. This allows it to look up Zotero item URIs for files regardless of whether they belong to the user's personal library or shared libraries, and from there, construct the appropriate Zotero select link for the files. +Zowie uses the Zotero network API to discover the user's shared libraries and groups. This allows it to look up Zotero item URIs for files regardless of whether they belong to the user's personal library or shared libraries, and from there, construct the appropriate Zotero select link for the files. + +Regretfully, Zowie can only work with Zotero libraries that use normal/local data storage; it cannot work when Zotero is configured to use linked attachments. Installation @@ -223,7 +225,11 @@ This program exits with a return code of 0 if no problems are encountered. It r Known issues and limitations ---------------------------- -For reasons I have not had time to investigate, the binary version of `zowie` takes a very long time to start up on macOS 10.15 (Catalina) and 11.1 (Big Sur). On my test system inside a virtual machine running on a fast iMac, it takes 10 seconds or more before the first output from `zowie` appears. +The following is a list of currently-known issues and limitations: + +* Zowie can only work when Zotero is set to use direct data storage; i.e., where attached files are stored in Zotero. It cannot work if you use [linked attachments](https://www.zotero.org/support/preferences/advanced#files_and_folders), that is, if you set _Linked Attachment Base Directory_ in your Zotero Preferences' _Advanced_ → _Files and Folders_ panel. + +* For reasons I have not had time to investigate, the binary version of `zowie` takes a very long time to start up on macOS 10.15 (Catalina) and 11.1 (Big Sur). On my test system inside a virtual machine running on a fast iMac, it takes 10 seconds or more before the first output from `zowie` appears. Getting help diff --git a/requirements.txt b/requirements.txt index 87ed73e..5d41d25 100644 --- a/requirements.txt +++ b/requirements.txt @@ -1,16 +1,17 @@ aenum >= 2.2.3 biplist >= 1.0.3 -bun >= 0.0.3 +boltons >= 20.2.0 +bun >= 0.0.5 commonpy >= 1.0.0 keyring >= 12.2.0 keyrings.alt >= 3.1 pdfrw >= 0.4 -plac >= 1.0.0 +plac >= 1.2.0 py-applescript >= 1.0.2 pyzotero >= 1.4.18 pyxattr >= 0.7.1 setuptools >= 41.0.1 -sidetrack >= 1.0.0 +sidetrack >= 1.3.0 # The following are needed by the py-applescript module, but because the # py-applescript module doesn't have a requirements.txt, installation via pip diff --git a/setup.cfg b/setup.cfg index 3e33d21..c1d0da5 100644 --- a/setup.cfg +++ b/setup.cfg @@ -8,7 +8,7 @@ [metadata] name = zowie -version = 1.1.1 +version = 1.1.2 description = Write Zotero select links into article attachment files author = Michael Hucka author_email = mhucka@caltech.edu