go-urn
Public
Pull mirror status: ok
L
fix: generate Ragel parser marker
.github
ci: pin Codecov action
docs
test: increase the code coverage
scim
refactor: move SCIM schema types to their own module
tools
test: test snake2camel
.gitignore
chore: ignore snake2camel binary
examples_test.go
test: provide example for SCIM only parsing
go.mod
ci: require Go 1.24 and modernize test matrix
go.sum
ci: remove support for Go 1.16 and Go 1.17
kind.go
feat: add kind RFC8141
lexicaleq_test.go
test: check equality with nil gives false
LICENSE
Update: Explicitly test for go 1.11.x too
machine_test.go
fix: reject invalid RFC 8141 terminal states
machine.go
fix: generate Ragel parser marker
machine.go.rl
fix: reject invalid RFC 8141 terminal states
makefile
fix: generate Ragel parser marker
options.go
feat: introduce parser options
parsing_mode.go
test: test RFC 8141 URNs too
performance_test.go
test: update benchmarks
README.md
docs: update README for RFC8141
scim_test.go
test: check custom (un)marshalling for SCIM URNs
scim.go
feat: implement custom (un)marshalling for SCIM URNs
tables_test.go
test: add test cases for RFC8141
urn_test.go
test: check custom (un)marshalling for SCIM URNs
urn.go
fix: reject invalid RFC 8141 terminal states
urn8141_test.go
fix: reject invalid RFC 8141 terminal states
urn8141.go
feat: implement custom (un)marshalling for RFC 8141 URNs

A parser for URNs.

As seen on RFC 2141, RFC 7643, and on RFC 8141.

API documentation.

Starting with version 1.3 this library also supports RFC 7643 SCIM URNs.

Starting with version 1.4 this library also supports RFC 8141 URNs (2017).

Installation

go get github.com/leodido/go-urn

Features

  1. RFC 2141 URNs parsing (default)
  2. RFC 8141 URNs parsing (supersedes RFC 2141)
  3. RFC 7643 SCIM URNs parsing
  4. Normalization as per RFCs
  5. Lexical equivalence as per RFCs
  6. Precise, fine-grained errors

Performances

This implementation results to be really fast.

Usually below 400 ns on my machine1.

Notice it also performs, while parsing:

  1. fine-grained and informative erroring
  2. specific-string normalization
ok/00/urn:a:b______________________________________/-10    51372006    109.0 ns/op    275 B/op    3 allocs/op
ok/01/URN:foo:a123,456_____________________________/-10    36024072    160.8 ns/op    296 B/op    6 allocs/op
ok/02/urn:foo:a123%2C456___________________________/-10    31901007    188.4 ns/op    320 B/op    7 allocs/op
ok/03/urn:ietf:params:scim:schemas:core:2.0:User___/-10    22736756    266.6 ns/op    376 B/op    6 allocs/op
ok/04/urn:ietf:params:scim:schemas:extension:enterp/-10    18291859    335.2 ns/op    408 B/op    6 allocs/op
ok/05/urn:ietf:params:scim:schemas:extension:enterp/-10    15283087    379.4 ns/op    440 B/op    6 allocs/op
ok/06/urn:burnout:nss______________________________/-10    39407593    155.1 ns/op    288 B/op    6 allocs/op
ok/07/urn:abcdefghilmnopqrstuvzabcdefghilm:x_______/-10    27832718    211.4 ns/op    307 B/op    4 allocs/op
ok/08/urn:urnurnurn:urn____________________________/-10    33269596    168.1 ns/op    293 B/op    6 allocs/op
ok/09/urn:ciao:!!*_________________________________/-10    41100675    148.8 ns/op    288 B/op    6 allocs/op
ok/10/urn:ciao:=@__________________________________/-10    37214253    149.7 ns/op    284 B/op    6 allocs/op
ok/11/urn:ciao:@!=%2C(xyz)+a,b.*@g=$_'_____________/-10    26534240    229.8 ns/op    336 B/op    7 allocs/op
ok/12/URN:x:abc%1Dz%2F%3az_________________________/-10    28166396    211.8 ns/op    336 B/op    7 allocs/op
no/13/URN:---xxx:x_________________________________/-10    23635159    255.6 ns/op    419 B/op    5 allocs/op
no/14/urn::colon:nss_______________________________/-10    23594779    258.4 ns/op    419 B/op    5 allocs/op
no/15/URN:@,:x_____________________________________/-10    23742535    261.5 ns/op    419 B/op    5 allocs/op
no/16/URN:URN:NSS__________________________________/-10    27432714    223.3 ns/op    371 B/op    5 allocs/op
no/17/urn:UrN:NSS__________________________________/-10    26922117    224.9 ns/op    371 B/op    5 allocs/op
no/18/urn:a:%______________________________________/-10    24926733    224.6 ns/op    371 B/op    5 allocs/op
no/19/urn:urn:NSS__________________________________/-10    27652641    220.7 ns/op    371 B/op    5 allocs/op
  • [1]: Apple M1 Pro

Example

For more examples take a look at the examples file.

package main

import (
	"fmt"
	"github.com/leodido/go-urn"
)

func main() {
	var uid = "URN:foo:a123,456"

    // Parse the input string as a RFC 2141 URN only
	u, e := urn.NewMachine().Parse(uid)
	if e != nil {
		fmt.Errorf(err)

		return
	}

	fmt.Println(u.ID)
	fmt.Println(u.SS)

	// Output:
	// foo
	// a123,456
}
package main

import (
	"fmt"
	"github.com/leodido/go-urn"
)

func main() {
	var uid = "URN:foo:a123,456"

    // Parse the input string as a RFC 2141 URN only
	u, ok := urn.Parse([]byte(uid))
	if !ok {
		panic("error parsing urn")
	}

	fmt.Println(u.ID)
	fmt.Println(u.SS)

	// Output:
	// foo
	// a123,456
}
package main

import (
	"fmt"
	"github.com/leodido/go-urn"
)

func main() {
	input := "urn:ietf:params:scim:api:messages:2.0:ListResponse"

	// Parsing the input string as a RFC 7643 SCIM URN
	u, ok := urn.Parse([]byte(input), urn.WithParsingMode(urn.RFC7643Only))
	if !ok {
		panic("error parsing urn")
	}

	fmt.Println(u.IsSCIM())
	scim := u.SCIM()
	fmt.Println(scim.Type.String())
	fmt.Println(scim.Name)
	fmt.Println(scim.Other)

	// Output:
	// true
	// api
	// messages
	// 2.0:ListResponse
}