Foliage is the FOLIo chAnGe Editor, a tool to do bulk changes and other operations in FOLIO using the network API.
Foliage (Folio change Editor) is a desktop computer application that can perform operations in FOLIO, a library services platform (LSP) used by Caltech and other institutions. Foliage allows a user to look up records of various kinds, perform bulk changes in the values of record fields, delete records, and more. It communicates with a FOLIO server using the OKAPI network API. The program is cross-platform compatible and currently in use on Windows and macOS computers at the Caltech Library.
Although Foliage is a desktop application and not a web service, it uses a web page as its user interface – it opens a page in a browser on the user's computer, letting the user interact with the program through the familiar elements of a web page. This lets Foliage present an identical user interface no matter whether it is running on Window, macOS, or Linux.
There are multiple ways of installing Foliage, ranging from downloading a self-contained, single-file, ready-to-run program, to installing it as a typical Python program using pip
. Please choose the alternative that suits you.
For the Caltech Library, we provide Foliage in a ready-to-run form for Windows computers. This is the easiest and preferred way of getting a copy of Foliage. Please contact the author for more information.
The instructions below assume you have a Python 3 interpreter installed on your computer. Note that the default on macOS at least through 10.14 (Mojave) is Python 2 – please first install Python version 3 and familiarize yourself with running Python programs on your system before proceeding further.
You should be able to install foliage
with pip
for Python 3. To install foliage
from the Python package repository (PyPI), run the following two commands:
python3 -m pip install git+https://github.com/mhucka/PyWebIO.git@2af53fc
python3 -m pip install foliage
If you already installed Foliage once before, and want to update to the latest version, add --upgrade
to the ends the commands above.
If you prefer to install Foliage directly from the source code, you can do that too. To get a copy of the files, you can clone the GitHub repository:
git clone https://github.com/caltechlibrary/foliage
Alternatively, you can download the files as a ZIP archive using this link directly from your browser using this link: https://github.com/caltechlibrary/foliage/archive/refs/heads/main.zip
Next, after getting a copy of the files, run setup.py
inside the code directory:
cd foliage
python3 -m pip install git+https://github.com/mhucka/PyWebIO.git@2af53fc
python3 setup.py install
Documentation for Foliage is available online at https://caltechlibrary.github.io/foliage/.
If you find an issue, please submit it in the GitHub issue tracker for this repository.
Your help and participation in enhancing Foliage is welcome! Please visit the guidelines for contributing for some tips on getting started. Developer documentation is available in the repository at dev/dev-docs
.
Software produced by the Caltech Library is Copyright © 2021–2023 California Institute of Technology. This software is freely distributed under a BSD type license. Please see the LICENSE file for more information.
This work was funded by the California Institute of Technology Library.
The vector artwork used as a starting point for the logo for this repository was created by Alice Noir for the Noun Project. It is licensed under the Creative Commons Attribution 3.0 Unported license. The vector graphics was modified by Mike Hucka to change the color.