jskos-tools
Advanced tools
Tools for working with the JSKOS data format.
This repository contains tools for working with the JSKOS data format for knowledge organization systems.
git clone https://github.com/gbv/jskos-tools.git
cd jskos-tools
npm i jskos-tools
const jskos = require("jskos-tools")
See https://gbv.github.io/jskos-tools/ for full API documentation of module jskos-tools.
let mapping = {
...
}
mappingContentIdentifier starts with urn:jskos:mapping:content: and takes concepts and type into consideration. It uses the mappingContent function to get relevant properties from the mapping.
let contentIdentifier = jskos.mappingContentIdentifier(mapping)
mappingMembersIdentifier starts with urn:jskos:mapping:members: and only takes concepts into consideration. It uses the mappingMembers function to get relevant properties from the mapping.
let membersIdentifier = jskos.mappingMembersIdentifier(mapping)
addMappingIdentifiers creates a new mapping with property "identifiers", containing mappingContentIdentifier and mappingMembersIdentifier.
let mappingWithIdentifiers = jskos.addMappingIdentifiers(mapping)
compareMappings compares two mappings based on their mappingContentIdentifier.
if (jskos.compareMappings(mapping1, mapping2)) { ... }
Aliases: compareMappingContent
compareMappingMembers compares two mappings based on their mappingMembersIdentifier.
if (jskos.compareMappingMembers(mapping1, mapping2)) { ... }
See class ConceptScheme.
Add @context URI to a JSKOS object or to an array of JSKOS objects.
jskos.addContext(object)
Removes properties starting with _ or containing only uppercase letters from a JSKOS object.
jskos.clean(object)
Aliases: cleanJSKOS
Creates a deep copy of a JSKOS object, replacing possibly circular structures with open world [null] statements. As the second argument it is possible to add additional properties that should be replaced with open world [null] statements. The third argument determines whether all properties starting with _ should be ignored (true by default).
jskos.copyDeep(object)
jskos.copyDeep(object, ["someCircularProperty"])
jskos.copyDeep(object, null, false)
Aliases: deepCopy
Returns all possible URIs for a JSKOS object. Takes into consideration both the uri and identifier properties, as well as different variants of those identifiers. Returns an empty array if object is null.
jskos.getAllUris(object)
Compares two objects based on their URIs, using getAllUris. Returns true if both objects are null.
jskos.compare(object1, object2)
Aliases: compareObjects, compareSchemes, compareConcepts
Checks whether JSKOS object is a concept based on type property.
jskos.isConcept(object)
Checks whether JSKOS object is a concept scheme based on type property.
jskos.isScheme(object)
// Checks whether an object is contained in a list of objects using compare.
jskos.isContainedIn(object, listOfObjects)
Aliases: isSchemeInList
Sorts a list of concepts by their notation, then URI. Returns a copy of the list. If the second parameter is true, it will try to sort by numerical notations.
jskos.sortConcepts(concepts)
Sorts a list of schemes by their prefLabel (de or en), then notation, then URI. Returns a copy of the list.
jskos.sortSchemes(schemes)
Removes unnecessary properties from mapping before export or saving. In particular, all properties except for to, from, toScheme, fromScheme, type, creator, contributor, created, modified, note, and identifier on the mapping will be removed, and all properties except for uri and notation on concepts and schemes will be removed.
let newMapping = jskos.minifyMapping(mapping)
An array of mapping types in form of objects. Objects can have the following properties:
notation - an array of notations (in this case symbols)uri - the URI of the mapping typeprefLabel - a language maps of labelsbroader - array of broader mapping types for this typerelated - array of related mapping typesRELEVANCE - relevance label for GND terms (low, medium, high, very high)SHORT - a short name for the type, used for CSV import/exportThe labels are taken from Wikidata (see script bin/localize-mapping-types).
Example object:
{
"notation": ["≈"],
"uri": "http://www.w3.org/2004/02/skos/core#closeMatch",
"prefLabel": { "en": "close match" },
"broader": [ { "uri": "http://www.w3.org/2004/02/skos/core#mappingRelation" } ],
"RELEVANCE": "high",
"SHORT": "close"
}
Returns a mapping type object for an URI.
jskos.mappingTypeByUri("http://www.w3.org/2004/02/skos/core#closeMatch")
Returns a mapping type for a JSKOS type property. This is usually an array where the first type is taken, but a workaround for string types is included as well.
jskos.mappingTypeByType(mapping.type)
The default mapping type (currently mapping relation).
Converts a mapping into a flat object with for serialization as CSV. Returns an object with fields fromNotation, toNotation, type, and (if option language has been provided) fromLabel, toLabel, and creator.
Returns an object of preconfigured conversion functions to convert mappings into CSV. Supports 1-to-1, 1-to-n, and n-to-n mappings.
// Initialize converter with default options
const csv = jskos.mappingCSV({
delimiter: ",",
quoteChar: "\"",
lineTerminator: "\n",
type: true,
schemes: false,
labels: false,
creator: false,
language: "en",
})
// Header line for an array of mappings (assuming 1-to-1 mappings if no array is given)
csv.header(mappings)
// Single CSV line for a mapping (uses fromCount and toCount from the mapping by default)
csv.fromMapping(mapping, { fromCount: null, toCount: null })
// Multiline CSV from array of mappings (includes header by default)
csv.fromMappings(mappings, { header: true })
The order of the CSV fields is fromScheme, fromNotation, (fromLabel,) (fromNotation2, fromLabel2, ...) toNotation, (toLabel,) (toNotation2, toLabel2, ...) type, creator.
Returns a function to serialize an array as CSV row as configured with CSV Dialect.
Returns an array of concepts contained in a mapping. side can either be from or to. If side is left out, concepts from both sides will be returned. null values will be omitted.
jskos.conceptsOfMapping(mapping)
compareMappingsDeep compares two mappings based on their properties. Concept sets and schemes are compared by URI.
if (jskos.compareMappingsDeep(mapping1, mapping2)) { ... }
Compares two JSKOS objects based on their types. Returns false only if both types could be guessed using guessObjectType and they did not match, otherwise it will assume that the types match.
Merge URIs of two objects a and b into a by adding/removing URIs from identifier property.
Merges two JSKOS objects. See documentation for more information.
Applies recursive unicode normalization to data.
Checks whether a string is a valid URI.
An object that maps JSKOS object type names to their description.
Guess the JSKOS object type of an object, URI or name and return its canonical name.
type = guessObjectType(objectOrString) // get full name such as `ConceptScheme`
type = guessObjectType(objectOrString, true) // get short name such as `scheme`
An object containing compare functions that can be used with array.sort() etc.
Available functions:
compareFunctions.mappingsByConcepts - compares mappings by the notations of their first conceptsgit clone --recursive https://github.com/gbv/jskos-tools.git
cd jskos-tools/
npm install
API documentation can be generated in directory jsdoc/build:
npm run docs
npm test
To publish a new version on npm after committing your changes, follow these steps:
npm version patch # or minor, or major
git push --tags origin master
Travis will automatically deploy the new version based on the tag to npm.
PRs accepted.
Small note: If editing the README, please conform to the standard-readme specification.
MIT © 2018 Verbundzentrale des GBV (VZG)
FAQs
Tools for working with the JSKOS data format.
The npm package jskos-tools receives a total of 203 weekly downloads. As such, jskos-tools popularity was classified as not popular.
We found that jskos-tools demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 0 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Research
An advanced npm supply chain attack is leveraging Ethereum smart contracts for decentralized, persistent malware control, evading traditional defenses.
Security News
Research
Attackers are impersonating Sindre Sorhus on npm with a fake 'chalk-node' package containing a malicious backdoor to compromise developers' projects.
Security News
The npm package for the LottieFiles Player web component was hit with a supply chain attack after a software engineer's npmjs credentials were compromised.