ont-app.vocabulary.core — ont-app/vocabulary 0.3.0

clj

Defines utilities and a set of namespaces for commonly used linked data constructs, metadata of which specifies RDF namespaces, prefixes and other details.

*alias-map* cljs

{alias ns-name, ...} Where alias is a symbol ns-name is a symbol naming an ns in the current lexical env NOTE: Informs cljc-ns-aliases in cljs space.

*exceptional-iri-str-re* clj/s

A regex matching an IRI string which doesn't match the usual http//-ish scheme, such as urn:.

as-kwi clj/s multimethod

Returns keyword identifier for an instance of Resource.

• Signature: [this] -> kwi.
• Where:
  • this is an instance of RESOURCE
  • kwi conforms to :voc/kwi-spec

as-qname clj/s multimethod

Returns a qname for instance of Resource.

• Signature: [this] -> qname
• Where
  • this is an instance of Resource
  • qname conforms to :voc/qname-spec

as-uri-string clj/s multimethod

Returns URI string for instance of Resource.

• Signature: [this] -> uri-string
• Where
  • this is a Resource
  • uri-string conforms to :voc/uri-str-spec

clear-caches! clj/s

(clear-caches!)

Side-effects: resets all caches in voc/ to nil NOTE: call this when you may have imported new namespace metadata

cljc-all-ns clj/s

(cljc-all-ns)

Returns (ns-name-or-obj ...) Where

• ns-name-or-obj may either be a namespace (in clj) or the name of a namespace (in cljs)

cljc-find-ns clj/s

(cljc-find-ns ns')

Returns ns-name-or-obj for ns', or nil. Where

• ns-name-or-obj may either be a namespace (in clj) or the name of a namespace (in cljs)
• _ns is a symbol which may name a namespace. NOTE: Implementations involving cljs must use cljs-put/get-ns-meta to declare ns metadata.

cljc-find-prefixes clj/s

(cljc-find-prefixes re-str s)

Returns #{prefix...} for s matching re-str Where

• prefix is a prefix found in s, for which some (meta ns) has a :vann/preferredNamespacePrefix declaration
• re-str is a regex string
• s is a string, typically a SPARQL query body for which we want to infer prefix declarations.

cljc-get-ns-meta clj/s deprecated

Deprecated. Use get-ns-meta

cljc-ns-aliases clj/s

(cljc-ns-aliases)

Returns {alias ns, ...} Where

• alias is a symbol
• ns is its associated ns in the current lexical environment. NOTE: cljs will require explicit maintenance of alias-map This is really only necessary if you're importing a package as some symbol other than the preferred prefix.

cljc-ns-map clj/s

mimics behavior of ns-map on cljs, but returns empty symbol->binding map

cljc-put-ns-meta! clj/s deprecated

Deprecated. Use put-ns-meta!

cljs-ns-metadata cljs

Namespaces in cljs are not proper objects, and there is no metadata available at runtime. This atom stores 'pseudo-metadata' declared with cljc-put-ns-metadata and accessed with cljc-get-metadata. Clj just uses the metadata regime for its ns's

collect-prefixes clj/s

(collect-prefixes acc next-ns)

Returns {prefix namespace ...} s.t. next-ns is included Where

• acc := {prefix namespace ...}
• next-ns is typically an element in a reduction sequence of ns's
• prefix is a prefix declared in the metadata of next-ns
• namespace is a URI namespace declared for prefix in metadata of next-ns

default-on-no-kwi-ns clj/s

(default-on-no-kwi-ns kw)

Returns the name-string of kw if its name string is a typical URI or URN, otherwise throws a :NoIRIForKw error.

• Where:
  • kw is a keyword with no namespace.

default-on-no-ns clj/s

(default-on-no-ns _uri kw)

Returns the kwi normally appropriate for kw in cases where no ns can be matched, as is the case with say http://...

• Where
  • _uri is a dummy provided to conform to the expected function signature.
  • kw is either a keyword or a string (which will be read into a keyword)

escape-slash clj/s

(escape-slash s)

Replaces a slash in s with a backslash-escaped slash

get-ns-meta clj/s

(get-ns-meta)

(get-ns-meta ns')

Returns metadata assigned to ns named ns' Where

• ns' names a namespace or a 'dummy' namespace whose sole purpose is to hold metadata.
• metadata := {key value, ...}
• key is a keyword containing vocabulary metadata, e.g. :vann/preferredNamespacePrefix

iri-for clj/s

Alias of uri-for

keyword-for clj/s

(keyword-for uri)

(keyword-for on-no-ns uri)

Returns a keyword equivalent of uri, properly prefixed if Vann declarations exist in some ns in the current lexical environment.

• Side effects per on-no-ns
• Where
  • uri is a string representing a URI
  • on-no-ns (optional) := fn [uri kw] -> kwi', possibly with side-effects in response to the fact that no qname was found for uri (default returns kw)
• NOTE: typically on-no-ns would log a warning or make an assertion.

kwi-missing-namespace-if-not-urn-or-arn clj/s

(kwi-missing-namespace-if-not-urn-or-arn kw)

Returns the name-stiring of kw, or throws ::NoIRIForKw if kw is incorrectly missing a namespace.

namespace-re clj/s

(namespace-re)

Returns a regex to recognize substrings matching a URI for an ns declared with LOD metadata.

• Note: Groups for namespace and value.

namespace-to-ns clj/s

(namespace-to-ns)

returns {namespace ns ...} for each ns with :vann/preferredNamespaceUri declaration

• Where
  • namespace is the URI suitable for for an RDF prefix declaration
  • ns is either a clojure ns (clj) or a symbol naming a clojure ns (cljs).

ns-to-namespace clj/s

(ns-to-namespace ns')

Returns iri for ns

• Where
  • ns' is an instance of clojure.lang.Namespace (in clj) or a symbol-name for ns (cljs)
  • iri is an iri declared with :vann/preferredNamespaceUri in the metadata for ns', or nil

ns-to-prefix clj/s

(ns-to-prefix ns')

Returns the prefix associated with ns'

• Where
  • ns' is a clojure namespace, which may have :vann/preferredNamespacePrefix declaration in its metadata.

on-duplicate-prefix clj/s

(on-duplicate-prefix prefixes prefix ns')

Throws an error if a prefix is bound to more than one namespace. Reduces into prefix argument

• Where
  • prefixes := {prefix ns, ...}
  • prefix := is a string naming the vann:preferredNamespaceUri for ns'
  • ns' refers to a namespace NOTE: Can be overridden with with-redefs.

ordinary-iri-str-re clj/s

A regex matching a standard IRI string.

prefix-re-str clj/s

(prefix-re-str)

Returns a regex string that recognizes prefixes declared in ns metadata with :vann/preferredNamespacePrefix keys.

• NOTE: this is a string because the actual re-pattern will differ per clj/cljs.

prefix-to-namespace-uri clj/s

(prefix-to-namespace-uri prefix)

returns namespace URI associated with prefix

• Where:
  • prefix is a string declared for ns with vann/preferredNamespacePrefix
  • namespace is a string declared for some ns with vann/preferredNamespaceUri

prefix-to-ns clj/s

(prefix-to-ns)

Returns {prefix ns ...}

• Where
  • prefix is declared in metadata for some ns with :vann/preferredNamespacePrefix
  • ns is an instance of clojure.lang.ns available within the lexical context in which the call was made.

prefixed-ns clj/s

(prefixed-ns prefix)

Returns nil or the ns whose prefix was declared in metadata with :vann/preferredNamespacePrefix.

• Where
  • prefix is a string, typically parsed from a keyword.

prepend-prefix-declarations clj/s

(prepend-prefix-declarations sparql-string)

Returns sparql-string, prepended with appropriate PREFIX decls.

• Where
  • sparql-string is a string of SPARQL, typically without prefixes.

put-ns-meta! clj/s

(put-ns-meta! m)

(put-ns-meta! ns' m)

Side-effect: ensures that subsequent calls to (cljc-get-ns-meta ns' return m Where

• ns' is an ns(clj only) or the name of a namespace, possibly declared for the sole purpose of holding vocabulary metadata (e.g. rdf, foaf, etc)
• m := {key value, ...}, metadata (clj) or 'pseudo-metadata' (cljs)
• key is a keyword containing vocabulary metadata, e.g. ::vann/preferredNamespacePrefix NOTE: In cljs, ns's are not available at runtime, so the metadata is stored in an atom called 'voc/cljs-ns-metadata' See also declarations for ont-app.vocabulary.rdf, ont-app.vocabulary.foaf, etc. for examples of namespaces declared solely to hold vocabulary metadata.

qname-for clj/s

(qname-for kw)

Returns the 'qname' URI for kw, or <...>'d full URI if no valid qname could be found.

• Throws an error if the prefix is specified, but can't be mapped to metadata.
• Where
  • kw is a keyword, in a namespace with LOD declarations in its metadata.

qname-re clj/s

(qname-re)

Resource clj/s protocol

Declare a resource-class to dispatch as-kwi as-uri-string as-qname methods

resource-class clj/s

(resource-class this)

sparql-prefixes-for clj/s

(sparql-prefixes-for sparql-string)

Returns [prefix-string...] for each prefix identified in sparql-string.

• Where

  • sparql-string is a string of SPARQL, typically without prefixes

  • prefix-string := PREFIX prefix: namespace

  • prefix is a prefix defined for namespace in metadata of some ns with :vann/preferredNamespacePrefix

  • namespace is a namespace defined in the metadata for some ns with :vann/preferredNamespaceUri

terms clj/s

Describes vocabulary for this namespace. May be read into an IGraph downstream.

unescaped-slash-re clj/s

Matches a string preceded by a backslash escape

uri-for clj/s

(uri-for kw)

(uri-for on-no-kwi-ns kw)

Returns iri for kw based on metadata attached to ns Alias of iri-for or `on-no-prefix (kw) if the keyword is not namespaced.

• Where
  • kw is a keyword of the form prefix:value
  • on-no-kwi-ns := fn [kw] -> uri, for cases where kw is not namespaced default is default-on-no-kwi-ns
  • iri is of the form namespace``value
  • ns is an instance of clojure.lang.ns
  • prefix is declared with :vann/preferredNamespacePrefix in metadata of ns
  • namespace is typically of the form http://...., declared with :vann/preferredNamespaceUri in metadata of ns

uri-str-for clj/s multimethod

Deprecated. Use Resource protocol and as-uri-string instead.

vann-annotated-objects clj/s

(vann-annotated-objects)

Returns `[obj, ...]

• Where:
  • obj bears metadata s.t. (get-ns-meta obj) includes :vann/... annotations
    • these may be either namespaces or vars