capturl

License	Apache-2.0
GroupId	fr.davit
ArtifactId	capturl_2.11
Last Version	0.2.8
Release Date	Jan 19, 2020
Type	jar
Description	capturl capturl
Project URL	https://github.com/RustedBones/capturl
Project Organization	Michel Davit
Source Code Management	https://github.com/RustedBones/capturl

Download capturl_2.11

Filename	Size
capturl_2.11-0.2.8.pom
capturl_2.11-0.2.8.jar	320 KB
capturl_2.11-0.2.8-sources.jar	28 KB
capturl_2.11-0.2.8-javadoc.jar	657 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/fr.davit/capturl_2.11/ -->
<dependency>
    <groupId>fr.davit</groupId>
    <artifactId>capturl_2.11</artifactId>
    <version>0.2.8</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/fr.davit/capturl_2.11/
implementation 'fr.davit:capturl_2.11:0.2.8'

Gradle Kotlin

// https://jarcasting.com/artifacts/fr.davit/capturl_2.11/
implementation ("fr.davit:capturl_2.11:0.2.8")

Apache Buildr

'fr.davit:capturl_2.11:jar:0.2.8'

Apache Ivy

<dependency org="fr.davit" name="capturl_2.11" rev="0.2.8">
  <artifact name="capturl_2.11" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='fr.davit', module='capturl_2.11', version='0.2.8')
)

Scala SBT

libraryDependencies += "fr.davit" % "capturl_2.11" % "0.2.8"

Leiningen

[fr.davit/capturl_2.11 "0.2.8"]

Dependencies

compile (3)

Group / Artifact	Type	Version
org.scala-lang : scala-library	jar	2.11.12
org.scala-lang.modules : scala-java8-compat_2.11	jar	0.9.0
org.parboiled : parboiled_2.11	jar	2.1.8

test (1)

Group / Artifact	Type	Version
org.scalatest : scalatest_2.11	jar	3.1.0

Project Modules

There are no modules declared in this project.

capturl

Capturl is a Scala/Java library that provide parsers and models to work with Internationalized Resource Identifier aka IRIs.

The implementation is strongly inspired by the great akka-http Uri model with modularity and simplicity in mind.

Setup

Add to your build.sbt:

libraryDependencies += "fr.davit" %% "capturl" % "0.2.7"

Parsers

All the apply/create methods accepting String input will be validated against RFC 3987 compliant parsers to create the model classes.

Warning: Exception is made for spaces in path, query and fragment which are allowed at the moment (see TODOs)

If you are sure about your input, and want to skip validation for efficiency reason, you can construct the models using the implementation classes. eg:

Scheme("b@d_scheme") // throws a parsing exception
Scheme.Protocol("b@d_scheme") // this is very wrong but will create your scheme

Normalization

Those are the IRI normalization steps:

• Scheme
  • lower case normalization
• Hosts
  • NamedHost are lower cased and decoded (punycode)
  • IPv4 and IPv6 are normalized
• Path
  • collapse current folder
  • collapse parent folder
• Query
  • spaces are replaced by '+'
• Iri
  • omit custom port if matches the scheme default port
  • root path is added for absolute / host relative iris
  • default port is hidden
• General
  • all encoded characters are decoded

IRI string interpolation

Add to your build.sbt:

libraryDependencies += "fr.davit" %% "capturl-contextual" % <version>

This sub module provides compile time string interpolation to create IRIs:

val iri = iri"http://localhost:8080/path?key#identifier"

If iri string is not valid, the scala compiler will notify you:

val iri = iri"http://user{[email protected]/"

[error] Invalid IRI http://user{[email protected]/
[error]     iri"http://user{[email protected]/"
[error]         ^
[error] one error found

TODO

• provide strict / relax parser mode
• provide more normalization options
• support holes in interpolation
• support scala 2.13

capturl-akka-http

Add to your build.sbt:

libraryDependencies += "fr.davit" %% "capturl-akka-http" % <version>

This sub module provides all the necessary implicits in UriConverters to go from an Iri to the akka Uri model.

TODO

• provide converters for akka-http javadsl model

Versions

Version
0.2.8 Jan 19, 2020
0.2.7 Dec 19, 2019
0.2.6 Nov 12, 2019
0.2.5 Nov 11, 2019
0.2.4 Nov 8, 2019
0.2.3 Nov 6, 2019
0.2.2 Oct 31, 2019
0.2.1 Oct 29, 2019
0.2.0 Oct 11, 2019