v15.0.0
YVS v15 is a major release with welcome new features, improvements, and other fixes. Please note that release requires Alfred 5.5, and this version of the workflow cannot be backported to Alfred 4.
New Features
Preview Mode
YVS v15 introduces a fully-featured preview mode (using Alfred 5.5's new Text View)! Now, if you hold down the Shift key when actioning a result, you can preview the contents of the reference directly in Alfred! This preview mode replaces the old Quick Look functionality.
Once you're in the preview mode, you can then use the usual keyboard shortcuts to act on the reference, including Command+Enter for copying the contents to the clipboard, and Control+Enter for searching the reference on the web.
Universal Actions
YVS v15 brings integration with Alfred's Universal Actions feature, enabling you to pass any arbitrary text to the workflow when you select it within an app or on a webpage. To use this, you must enable the Workflow Universal Actions checkbox in Alfred Preferences, under Features > Universal Actions > Actions.
In particularly, there are two universal actions available:
- Look up Bible address (e.g. if you select "Philippians 4:13")
- Search phrase in Bible
Copy URL to clipboard
You can also now copy the URL of the selected reference to the clipboard by holding down the Option key while actioning the result. This can be useful if you want to share the YouVersion link to a particular reference, rather than the textual contents of the reference.
Improvements
Latest Bible data from YouVersion
YVS v15 comes bundled with the latest Bible data from the YouVersion website. For details on what's changed, please see the diff on the youversion-suggest-data repository.
Error handling when setting preferences
If, for any reason, you encounter an error while trying to change a preference (i.e. using the yvset keyword), YVS v15 now spawns a notification indicating that it failed to set the preference.
Error handling when clearing cache
If, for any reason, you encounter an error while trying to clear the workflow cache (i.e. using the yvclearcache keyword), YVS v15 now spawns a notification indicating that it failed to clear the cache.
Housekeeping
Cleaned up workflow objects
The entire workflow has been rewired to utilize Alfred's External Triggers feature, which eliminates the tangled mess of connections between the various workflow objects. This means YVS v15 is significantly more maintainable and easier to tweak (if you are the adventurous type)!
Refactored test suite
The test suite has been refactored to be class-based, thus adhering to the conventional paradigm for writing unit tests with the unittest module. Additional tests have also been added for the new Preview Mode, as well as for other specific edge cases (e.g. related to reference formats).