### ----------------------------------------------------
### -- URI::Template
### -- Licenses: Artistic-2.0
### -- Authors: Jonathan Stowe <jns+git@gellyfish.co.uk>
### -- File: README.md
### ----------------------------------------------------
# URI::Template 

Implementation of https://tools.ietf.org/html/rfc6570 for Raku

![Build Status](https://github.com/jonathanstowe/URI-Template/workflows/CI/badge.svg)

## Synopsis

```raku

use URI::Template;

my $template = URI::Template.new(template => 'http://foo.com{/foo,bar}');

say $template.process(foo => 'baz', bar => 'quux'); # http://foo.com/baz/quux

```

## Description

This provides an implementation of [RFC 6570](https://tools.ietf.org/html/rfc6570) which allows for the definition of a URI through variable expansion.

## Installation

Assuming you have a working Rakudo installation you should be able to install this with *zef* :

    # From the source directory
   
    zef install .

    # Remote installation

    zef install URI::Template

## Support

Suggestions/patches are welcomed via github at https://github.com/jonathanstowe/URI-Template

The test data covers all of the examples given in the RFC and a few others,
if you think the behaviour is incorrect please state the section of the RFC
and provide a failing example with the required variables, template and the
expected output.


## Licence

Please see the LICENCE file in the distribution

© Jonathan Stowe 2015, 2016, 2017, 2019, 2020

The testing uses the test data from https://github.com/uri-templates/uritemplate-test
please see the README.md in the t/data/uritemplate-test for the license for that project.




