Skip to content

Latest commit

 

History

History
307 lines (242 loc) · 11.3 KB

README.md

File metadata and controls

307 lines (242 loc) · 11.3 KB

janus-uri-factory-plugins

Build Status

Plugins for the Janus URI factory.

Contents

Scopes and Formats

Except for Conservancy, PubMed, and WorldCat, each plugin defines a list of valid scope values.

Plugins may also define a list of valid format values, implemented only by Primo.

ArchiveSpace

We use ArchiveSpace repositories for scopes.

Name/Description Value
Bell (James Ford Bell Library of Natural History) 2
CBI (Charles Babbage Institute) 3
CCR-SCRB (Carlson Company Records) 18
CLRC (Children's Literature Research Collections) 4
Givens (Givens Collection of African American Literature) 5
IHRCA (Immigration History Research Center Archives) 6
NAA (Northwest Architectural Archives) 8
PAA (Performing Arts Archives) 9
SCRB (Special Collections and Rare Books) 12
SWHA (Social Welfare History Archives) 11
Training (Training Repository) 20
Tretter (Jean-Nickolaus Tretter Collection in GLBT Studies) 13
UA (University Archives) 14
UMJA (Upper Midwest Jewish Archives) 15
UMLA (Upper Midwest Literary Archives) 16
WHL (Wangensteen Historical Library of Biology and Medicine) 19
YMCA (Krautz Family YMCA Archives) 7

Conservancy

UDC scopes in DSpace 7.x take the form of a UUID, where a UUID may represent either a community (such as a system campus) or a more limited collection. A scope query can therefore limit results at either of those levels.

Available community and collection scopes can be found at:

https://conservancy.umn.edu/community-list

Examples:

Name/Description Community or Collection URL Scope Value
University of Minnesota - Twin Cities https://conservancy.umn.edu/communities/600d3b06-e18e-4f60-aef0-ae4ad51c5c2b 600d3b06-e18e-4f60-aef0-ae4ad51c5c2b
Articles and Scholarly Works https://conservancy.umn.edu/collections/06a2bbc2-0c84-4c15-913a-4e6aef330315 06a2bbc2-0c84-4c15-913a-4e6aef330315

Google Custom Search

Performs a search via the Google Custom Search endpoint configured at https://www.lib.umn.edu/search or https://hsl.lib.umn.edu/search

Base site URLs are available as scopes

scope Name/Description URL
www (default if unspeficied) https://www.lib.umn.edu/search UL www website
hsl https://hsl.lib.umn.edu/search HSL website
wangensteen https://hsl.lib.umn.edu/search HSL website (alias)

Google Custom Search has no fields.

MncatDiscovery

Alias of Primo.

Primo

Primo Scopes

Name/Description Value
Ames Library of South Asia ames
Andersen Library andersen
Andersen Horticultural Library (Chanhassen) andersen_horticultural
Andersen Rare Books andersen_rare
Architecture and Landscape Architecture Library architecture
Archives and Special Collections asc
Charles Babbage Institute Collection babbage
James Ford Bell Library bell
Berman Upper Midwest Jewish Archives berman
Bio-Medical Library bio_med
Children's Literature Research Collection children
Twin Cities Catalog default_scope
East Asian Library east_asian
Givens Collection of African American Literature givens
Immigration History Research Center immigration
Journalism Library journalism
Lake Itasca Biological Station lake_itasca
Law Library law
Law Library Rare Books law_rare
Magrath Library magrath
Mathematics Library math
Minnesota Library Access Center (MLAC) mlac
Libraries Search mncat_discovery
Music Library music
Natural Resources Library natural_resources
Northwest Architecture Archives northwest_architecture
Performing Arts Archives performing_arts
Plant Pathology Library plant_pathology
Sherlock Holmes Collection sherlock
Social Welfare History Archives social_welfare
Tretter GLBT Collection tretter
University Archives university_archives
Upper Midwest Literary Archives upper_midwest_lit
Veterinary Medical Library veterinary_medical
Walter Science and Engineering Library walter
Walter SMART Learning Commons walter_smart
Wangensteen Historical Library of Biology & Medicine wangensteen
Wilson Library wilson
John R. Borchert Map Library wilson_map
Wilson Library Rare Books wilson_rare
YMCA Archives ymca

Primo Formats

Name/Description Value
Archival/MSS Mtls and Archival Material/Manuscripts archive
Articles articles
Audio audios
Books books
Journals journals
Maps maps
Media (combination of audio, video, image) media
Available online online
Realia realia
Scores scores
Videos videos

Primonews

Newspaper searches within Primo. Does not use scopes or formats.

PubMed

The PubMed search engine does not use scopes.

UMedia

Alias of umediaorganization

UMedia Organization

Scope UMedia search results by Contributing Organization facet. Contributing Organizations are valiated against this list, and provided with an abbreviated name for convenience. Currently available Contributing Organizations are listed at https://umedia.lib.umn.edu/facets?facet_field=contributing_organization_name_s&facet_limit=500&facet_sort=index

Sample Usage:

# Search for "maps" within United States Geological Survey contributions
/janus?target=umediaorganization&scope=usgs&search=maps
Name Value
Donald Clay Johnson djohnson
Hennepin County Library, James K. Hosmer Special Collections. hosmer
Joanne B. Eicher eichner
Timothy J. Johnson tjohnson
United States Geological Survey usgs
University of Minnesota Extensions. umnext
University of Minnesota Law Library, Riesenfeld Rare Books Research Center. riesenfeld
University of Minnesota Libraries, Ames Library of South Asia. ames
University of Minnesota Libraries, Andersen Horticultural Library. andersen
University of Minnesota Libraries, Archie Givens, Sr. Collection of African American Literature. givens
University of Minnesota Libraries, Business Library. umnbus
University of Minnesota Libraries, Charles Babbage Institute. babbage
University of Minnesota Libraries, Children's Literature Research Collections. clrc
University of Minnesota Libraries, East Asian Library. eastasian
University of Minnesota Libraries, Immigration History Research Center Archives. ihrca
University of Minnesota Libraries, James Ford Bell Library. bell
University of Minnesota Libraries, Jean-Nickolaus Tretter Collection in Gay, Lesbian, Bisexual and Transgender Studies. tretter
University of Minnesota Libraries, John R. Borchert Map Library. borchert
University of Minnesota Libraries, Kautz Family YMCA Archives. ymca
University of Minnesota Libraries, Magrath Library. magrath
University of Minnesota Libraries, Music Library. music
University of Minnesota Libraries, Nathan and Theresa Berman Upper Midwest Jewish Archives. umja
University of Minnesota Libraries, Northwest Architectural Archives. naa
University of Minnesota Libraries, Owen H. Wangensteen Historical Library of Biology and Medicine. wangensteen
University of Minnesota Libraries, Performing Arts Archives. paa
University of Minnesota Libraries, Rare Books and Special Collections. rare
University of Minnesota Libraries, Social Welfare History Archives. swha
University of Minnesota Libraries, Special Collections and Rare Books. scrbm
University of Minnesota Libraries, University Archives. uarch
University of Minnesota Libraries, Upper Midwest Literary Archives. mss
University of Minnesota Libraries, Wilson Library. wilson
University of Minnesota Libraries. Library Media Services. lms
University of Minnesota Press Test Division. upress
University of Minnesota, Bell Museum. bellmuseum
University of Minnesota, Center for Holocaust and Genocide Studies. chgs
University of Minnesota, Department of American Indian Studies. umnais
University of Minnesota, Department of Psychology. umnpsych
University of Minnesota, Horticultural Research Center. hrc
University of Minnesota, Institute for Advanced Study. advanced
University of Minnesota, Institute for Mathematics and its Applications. umnima
University of Minnesota, Minnesota Agricultural Experiment Station. agex
University of Minnesota, Minnesota Institute for Sustainable Agriculture (MISA). misa
University of Minnesota, School of Physics and Astronomy. physics
University of Minnesota, School of Public Health. pubhealth

UMedia Collection

Scope UMedia search results by Collection name. Hundreds of collections are available and the list is too fluid to validate. Scope values will be accepted and passed to UMedia as a facet. Currently available collections usable as scope values are listed at https://umedia.lib.umn.edu/facets?facet_field=collection_name_s&facet_limit=500&facet_sort=index

Sample Usage:

# Search for "arboretum" within the Cloquet Forestry Center Records collection
/janus?target=umediacollection&scope=Cloquet+Forestry+Center+Records&search=arboretum

WorldCat

The WorldCat search engine does not use scopes.

Install

Install with npm. In package.json, include something like...

  "dependencies": {
    "@nihiliad/janus-uri-factory-plugins": "^2.0.0"
  }

...where version based on the version value in this project's package.json. Then npm install.

Missing Dependencies of Dev Dependencies

Sometimes npm install has not installed dependencies of packages in devDependencies, e.g., eslint, in package.json. If this happens, running npm install --save-dev should fix it.

Use

const janus = require('@nihiliad/janus');
const plugins = require('@nihiliad/janus-uri-factory-plugins');
const app = janus({
  uriFactoryPlugins: plugins,
});

Test

To run the linter and all unit tests:

npm test

Lint

We use standardjs for linting. To lint all files:

npx standard

To automatically fix any errors that can be fixed automatically:

npx standard --fix

To lint a single file, e.g., index.js:

npx standard index.js

Integration Tests

Some unit tests make HTTP requests to real web services. To run those tests, set the RUN_INTEGRATION_TESTS environment variable to a true value. The default value is false. This works for npm test and all commands described below.

Unit Tests

We use tape for unit tests. To run all unit tests:

npx tape test/*.js

To run a single unit test file, e.g., test/factory.js:

npx tape test/factory.js