mint: mint

Description Usage Arguments Value Methods (by class) Examples

Description

mint a new minid for a digital object

Usage

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
mint(minid, configuration, test = TRUE)

## S4 method for signature 'minid,configuration'
mint(minid, configuration, test = TRUE)

## S4 method for signature 'list,list'
mint(minid, configuration, test = TRUE)

## S4 method for signature 'minid,list'
mint(minid, configuration, test = TRUE)

## S4 method for signature 'list,configuration'
mint(minid, configuration, test = TRUE)

## S4 method for signature 'character,configuration'
mint(minid, configuration, test = TRUE)

Arguments

minid

minid object or list of fields or file path

configuration

configuration object or list of server parameters

test

creates names in a test namespace that is removed periodically default = TRUE

Value

a newly minted minid

Methods (by class)

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
## Not run: 
# load config
config <- load_configuration()

# mint minid from file path
mint(minid = "./a_file.RDa", configuration = config, test = TRUE)

# or manually set up config
config <- configuration()
user(config) <- "Jane Example"
email(config) <- "jexample@example.com"
orcid(config) <- "0000-0000-0000-0000" # see http://orch.id
code(config) <- "00000000-0000-0000-0000-000000000000" # see register()

# set up minid object
new_minid <- minid()
checksum_function(new_minid) <- "sha256"
checksum(new_minid) <- digest::digest("./somefile.RDa",
                                      file = TRUE,
                                      algo = "sha256")
titles(new_minid) <- list(title = "An Example Object Title")
locations(new_minid) <- list(link = "http://example.com/somefile.RDa") # optional

# mint the new minid
minted <- mint(minid = new_minid, configuration = config, test = TRUE)

# OR use lists:
computed_checksum <- digest::digest(path = "./somefile.RDa",
                                    file = TRUE,
                                    algo = "sha256")
new_minid = list(
  checksum_function = "sha256",
  checksum = computed_checksum,
  titles = "An Example Object Title",
  locations = "http://example.com/somefile.RDa"
  )

configuration = list(
  server = "http://minid.bd2k.org/minid",
  user(config) <- "Jane Example"
  email(config) <- "jexample@example.com"
  orcid(config) <- "0000-0000-0000-0000", # see http://orch.id
  code(config) <- "00000000-0000-0000-0000-000000000000" # see register()
  )

minted <- mint(minid = new_minid, configuration = config, test = TRUE)

## End(Not run)

bheavner/minid documentation built on Aug. 1, 2020, 9:38 p.m.