Urial

Changes in this version:

* Fix incorrect version in `__init__.py` and update Makefile to do it.

Changes in this version:

* Switch to MIT license and drop mention of Caltech (the latter as a result of discussions at work).
* Update some files for git and metadata to follow my latest template versions of those files.
* Add `.flake8` and `.editorconfig` files.
* Split out requirements for linting Python code into `requirements-lint.txt`.
* Added GitHub Actions workflows for linting code and Markdown files automatically.
* Fix some lint warnings in `__main__.py`.
* Update the `Makefile`.
* Use an image of a urial, instead of the stylized line drawing.

This release fixes a bug in the arguments to the `OSAX` constructor, which takes different arguments in the latest release of the `appscript` package.

Changes in this release:

* Updated dependencies.
* Updated format of `CITATION.cff`

For help on installing and using Urial, please see the [project front page](https://github.com/mhucka/urial#table-of-contents).

Summary of changes in this release
* Added `--mode prepend`, similar to `--mode append` but to prepend the URI to the front of the Finder comment instead of appending it to the end.
* Updated versions of dependencies in `requirements.txt`.
* Added `requirements-dev.txt`.
* Improved `codemeta.json`.
* Updated `Makefile`.

To learn how to use Urial, the best resource currently is the [README in the GitHub repo](https://github.com/mhucka/urial#usage).

Self-contained runnable copies of Urial

Copies of ready-to-run executable versions of Urial are included with this release. They need a Python interpreter version 3.8 or higher installed 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:
sh
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.) Make sure the version is at least 3.8. Note that if you are running a macOS version before 10.15, you will need to manually install Python 3.8 or later.

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 `urial-1.0.0-macos-python3.8`)
5. Look inside for `urial` 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 `urial` into `/usr/local/bin`):
shell
sudo mkdir /usr/local/bin


The following is an example command that you can type in a terminal to move Urial there:
shell
sudo mv urial /usr/local/bin

This is the first public release of Urial. This version improves parsing of URIs in Finder comments, and the release now includes ready-to-run binary executables for macOS.

Self-contained runnable copies of Urial

Copies of ready-to-run executable versions of Urial are included with this release. They need a Python interpreter version 3.8 or higher installed 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:
sh
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.) Make sure the version is at least 3.8. Note that if you are running a macOS version before 10.15, you will need to manually install Python 3.8 or later.

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 `urial-1.0.0-macos-python3.8`)
5. Look inside for `urial` 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 `urial` into `/usr/local/bin`):
shell
sudo mkdir /usr/local/bin


The following is an example command that you can type in a terminal to move Urial there:
shell
sudo mv urial /usr/local/bin