# RDFtk: Names

This crate provides a set of modules that contain the `IRI`s and `QName`
strings for commonly used vocabularies. It also provides macro support for
defining new namespaces in the same style as this library.

## Vocabularies

Te following table shows the set of namespaces supported, those with "TBD" in
the module column are yet to be encoded.

| Module           | Vocabulary | Namespace |
|------------------|------------|-----------|
| `dt::dcam`       | [DCMI Abstract Model](https://www.dublincore.org/specifications/dublin-core/abstract-model/) | `http://purl.org/dc/dcam/` |
| `dt::dcmi_types` | [DCMI Type Vocabulary](https://www.dublincore.org/specifications/dublin-core/dcmi-type-vocabulary/) | `http://purl.org/dc/dcmitype/` |
| `dt::elements`'  | [DCMI Terms](https://www.dublincore.org/specifications/dublin-core/dcmi-terms/) | `http://purl.org/dc/elements/1.1/` |
| `dt::terms`      | [DCMI Terms](https://www.dublincore.org/specifications/dublin-core/dcmi-terms/) legacy elements | `http://purl.org/dc/terms/` |
| `foaf`           | [Friend of a Friend](http://xmlns.com/foaf/spec/) | `http://xmlns.com/foaf/0.1/` |
| `geo`            | [Basic Geo Vocabulary](https://www.w3.org/2003/01/geo/) | `http://www.w3.org/2003/01/geo/wgs84_pos#` |
| `owl`            | [OWL](http://www.w3.org/2001/sw/wiki/OWL) Web Ontology Language  | `http://www.w3.org/2002/07/owl#` |
| `rdf`            | [RDF](http://www.w3.org/2001/sw/wiki/RDF) RDF Syntax  | `http://www.w3.org/1999/02/22-rdf-syntax-ns#` |
| `rdfs`           | [RDF(http://www.w3.org/2001/sw/wiki/RDF) RDF Schema  | `http://www.w3.org/2000/01/rdf-schema#` |
| `xsd`            | [XML Schema data types](https://www.w3.org/TR/xmlschema-2) | `http://www.w3.org/2001/XMLSchema#` |
| TBD              | [SKOS](http://www.w3.org/2001/sw/wiki/SKOS) Simple Knowledge Organization System (SKOS) | `http://www.w3.org/2004/02/skos/core#` |
| TBD              | [PROV](http://www.w3.org/2001/sw/wiki/PROV) PROV | `http://www.w3.org/ns/prov#` |
| TBD              | [RDFa](http://www.w3.org/2001/sw/wiki/RDFa) RDF in Attributes (RDFa) | `http://www.w3.org/ns/rdfa#` |
| TBD              | [RDF Calendar](https://www.w3.org/TR/rdfcal/) | `http://www.w3.org/2002/12/cal#`  |
| TBD              | [vCard Ontology](https://www.w3.org/TR/vcard-rdf/) | `http://www.w3.org/2006/vcard/ns#` |
| TBD              | [The Organization Ontology](https://www.w3.org/TR/vocab-org/) | `http://www.w3.org/ns/org#` |
| TBD              | [Creative Commons Rights Expression Language](https://wiki.creativecommons.org/wiki/CC_REL) | `http://creativecommons.org/ns#` |

## The namespace Macro

The `namespace!` macro takes three parameters:

* The common prefix for the module,
* The namespace IRI for the module,
* A list of pairs where the first is the name of the function to return the IRI
  for the name, and the second is the string name of the vocabulary element.
  
Note that as this macro uses `paste::item` the client will need to have a
dependency on the [paste crate](https://crates.io/crates/paste).

## Example

The following example replicates the `geo` module using the `namespace!` macro.

```rust
#[macro_use]
extern crate rdftk_names;

use rdftk_names::Vocabulary;

namespace! {
    GeoSpatialVocabulary,
    "geo",
    "http://www.w3.org/2003/01/geo/wgs84_pos#",
    {
        spatial_thing, "SpatialThing",
        temporal_thing, "TemporalThing",
        event, "Event",
        point, "Point",
        lat, "lat",
        location, "location",
        long, "long",
        alt, "alt",
        lat_long, "lat_long"
    }
}
```

## Changes

### Version 0.2.4

* Fix: add comments to `skos` module members to remove build warnings.

### Version 0.2.4

* Feature: add `skos` namespaces.

### Version 0.2.3

* Feature: added missing `date` and `hex_binary` names in `xsd` namespace.

### Version 0.2.2

* Feature: rename `namespace_uri` to simply `namespace`.
* Feature: new version of the iri package requires validation of names.
* Feature: add new `$name _str` function for namespace members.

### Version 0.2.1
* Build: cargo audit/outdated/udeps

### Version 0.2.0

* Feature: moved to new `rdftk_iri` package which uses the `url::Url` and is more
  efficient.
* Feature: performance improvements in the `namespace` and `nsname` macros.
* Feature: removed need for any `use` statements in either macro or client.
* Build: updated Rust edition from 2018 to 2021.
* Docs: run markuplint on `README.md`.

### Version 0.1.9

* Build: `rdftk_iri` dependency reset to only major/minor.

### Version 0.1.8

* Style:
  * applied a lot more warnings in `lib.rs`,
  * applied resulting warnings and Clippy suggestions,
  * reformatted macro layout.

### Version 0.1.7

* Feature: added missing names in `rdfs` vocabulary.

### Version 0.1.6

* Build: updated [paste](https://crates.io/crates/paste) package dependency.

### Version 0.1.5

* Build: explicit version management.

### Version 0.1.3

* Feature: `namespace` macro now creates a local cache of `Arc<IRI>` instances to
  reduce memory consumption.

### Version 0.1.2

* Feature: added `rdf:li`.

### Version 0.1.1

* Feature: made `nsname` macro public.

### Version 0.1.0

* First release.
