Identitas-j

Identitas: a set of libraries for coining, manipulating and checking identifiers.

License	LGPL 3.0
Categories	IDE Development Tools
GroupId	uk.org.russet
ArtifactId	identitas-j
Last Version	0.0.1
Release Date	Oct 12, 2018
Type	jar
Description	Identitas-j Identitas: a set of libraries for coining, manipulating and checking identifiers.
Project URL	https://github.com/Nizal-Shammry/identitas-j
Source Code Management	https://github.com/Nizal-Shammry/identitas/tree/master

Download identitas-j

Filename	Size
identitas-j-0.0.1.pom
identitas-j-0.0.1.jar	8 KB
identitas-j-0.0.1-sources.jar	6 KB
identitas-j-0.0.1-javadoc.jar	41 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/uk.org.russet/identitas-j/ -->
<dependency>
    <groupId>uk.org.russet</groupId>
    <artifactId>identitas-j</artifactId>
    <version>0.0.1</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/uk.org.russet/identitas-j/
implementation 'uk.org.russet:identitas-j:0.0.1'

Gradle Kotlin

// https://jarcasting.com/artifacts/uk.org.russet/identitas-j/
implementation ("uk.org.russet:identitas-j:0.0.1")

Apache Buildr

'uk.org.russet:identitas-j:jar:0.0.1'

Apache Ivy

<dependency org="uk.org.russet" name="identitas-j" rev="0.0.1">
  <artifact name="identitas-j" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='uk.org.russet', module='identitas-j', version='0.0.1')
)

Scala SBT

libraryDependencies += "uk.org.russet" % "identitas-j" % "0.0.1"

Leiningen

[uk.org.russet/identitas-j "0.0.1"]

Dependencies

test (1)

Group / Artifact	Type	Version
junit : junit	jar	4.12

Project Modules

There are no modules declared in this project.

identitas-j

Make identifers

A set of libraries for coining, manipulating and checking identifiers. More details available at https://arxiv.org/abs/1709.09021

An identifier is short string or integer which is used to represent other things, called here the identifed, such as database records, terms in an ontology or physical entities such as a people or proteins. Identifiers are semantics-free -- that is they do not depend on the characteristics of the thing that they represent; therefore, they can remain constant, even while the identified changes.

Identifier schemes can have many different characteristics, many of which conflict. A good identifier scheme, therefore, is one that makes the correct compromises for the requirements.

Identitas provides the following functionality:

• Proquint: converts between proquint, and decimal strings. Following the http://arxiv.org/html/0901.4016 scheme.
• Damm: check-digits using the https://en.wikibooks.org/wiki/Algorithm_Implementation/Checksums/Damm_Algorithm algorithm.
• Util: functions to convert between numbers (Integer, Short, Long) and an equivalent "pronouceable" version.

Usage

Proquint

Proquint are a transformation from numbers to a more pronounceable form.

      Util.Int_to_proint(0);
       ;; babab-babab
      Util.Int_to_proint(Integer.MAX_VALUE); 
       ;;  luzuz-zuzuz
      Util.Int_to_proint(Integer.MIN_VALUE);
       ;; mabab-babab

As an extension to original algorithm, we also provide support short and long transformations, useful depending on the size of identifier space required.

       Util.Short_to_prshort(0);
        ;;  babab
       Util.Short_to_prshort(Short.MAX_VALUE);
        ;; luzuz
       Util.Short_to_prshort(Short.MIN_VALUE);
        ;; mabab
 
       Util.Long_to_prolong(0);
        ;; babab-babab-babab-babab
       Util.Long_to_prolong(Long.MAX_VALUE);
        ;; luzuz-zuzuz-zuzuz-zuzuz
       Util.Long_to_prolong(Long.MIN_VALUE);
       ;; mabab-babab-babab-babab

Versions

Version
0.0.1 Oct 12, 2018