<?php
use PHPUnit\Framework\Attributes\DataProvider;
use PHPUnit\Framework\TestCase;
use PHPUnit\Metadata\Covers;
use Rize\UriTemplate\UriTemplate;
/**
* URI Template
*
* http://tools.ietf.org/html/rfc6570
*/
class UriTemplateTest extends TestCase
{
public function service($uri = '', $params = [])
{
return new UriTemplate($uri, $params);
}
public static function dataExpansion()
{
$params = ['count' => ["one", "two", "three"], 'dom' => ["example", "com"], 'dub' => "me/too", 'hello' => "Hello World!", 'half' => "50%", 'var' => "value", 'who' => "fred", 'base' => "http://example.com/home/", 'path' => "/foo/bar", 'list' => ["red", "green", "blue"], 'keys' => ["semi" => ";", "dot" => ".", "comma" => ","], 'list_with_empty' => [''], 'keys_with_empty' => ['john' => ''], 'v' => "6", 'x' => "1024", 'y' => "768", 'empty' => "", 'empty_keys' => [], 'undef' => null];
return [
['http://example.com/~john', ['uri' => 'http://example.com/~{username}', 'params' => ['username' => 'john']]],
['http://example.com/dictionary/d/dog', ['uri' => 'http://example.com/dictionary/{term:1}/{term}', 'params' => ['term' => 'dog'], 'extract' => ['term:1' => 'd', 'term' => 'dog']]],
# Form-style parameters expression
['http://example.com/j/john/search?q=mycelium&q=3&lang=th,jp,en', ['uri' => 'http://example.com/{term:1}/{term}/search{?q*,lang}', 'params' => ['q' => ['mycelium', 3], 'lang' => ['th', 'jp', 'en'], 'term' => 'john']]],
['http://www.example.com/john', ['uri' => 'http://www.example.com/{username}', 'params' => ['username' => 'john']]],
['http://www.example.com/foo?query=mycelium&number=100', ['uri' => 'http://www.example.com/foo{?query,number}', 'params' => ['query' => 'mycelium', 'number' => 100]]],
# 'query' is undefined
['http://www.example.com/foo?number=100', [
'uri' => 'http://www.example.com/foo{?query,number}',
'params' => ['number' => 100],
# we can't extract undefined values
'extract' => false,
]],
# undefined variables
['http://www.example.com/foo', ['uri' => 'http://www.example.com/foo{?query,number}', 'params' => [], 'extract' => ['query' => null, 'number' => null]]],
['http://www.example.com/foo', ['uri' => 'http://www.example.com/foo{?number}', 'params' => [], 'extract' => ['number' => null]]],
['one,two,three|one,two,three|/one,two,three|/one/two/three|;count=one,two,three|;count=one;count=two;count=three|?count=one,two,three|?count=one&count=two&count=three|&count=one&count=two&count=three', ['uri' => '{count}|{count*}|{/count}|{/count*}|{;count}|{;count*}|{?count}|{?count*}|{&count*}', 'params' => ['count' => ['one', 'two', 'three']]]],
['http://www.host.com/path/to/a/file.x.y', ['uri' => 'http://{host}{/segments*}/{file}{.extensions*}', 'params' => ['host' => 'www.host.com', 'segments' => ['path', 'to', 'a'], 'file' => 'file', 'extensions' => ['x', 'y']], 'extract' => ['host' => 'www.host.com', 'segments' => ['path', 'to', 'a'], 'file' => 'file.x.y', 'extensions' => null]]],
# level 1 - Simple String Expansion: {var}
['value|Hello%20World%21|50%25|OX|OX|1024,768|1024,Hello%20World%21,768|?1024,|?1024|?768|val|value|red,green,blue|semi,%3B,dot,.,comma,%2C|semi=%3B,dot=.,comma=%2C', ['uri' => '{var}|{hello}|{half}|O{empty}X|O{undef}X|{x,y}|{x,hello,y}|?{x,empty}|?{x,undef}|?{undef,y}|{var:3}|{var:30}|{list}|{keys}|{keys*}', 'params' => $params]],
# level 2 - Reserved Expansion: {+var}
['value|Hello%20World!|50%25|http%3A%2F%2Fexample.com%2Fhome%2Findex|http://example.com/home/index|OX|OX|/foo/bar/here|here?ref=/foo/bar|up/foo/barvalue/here|1024,Hello%20World!,768|/foo/bar,1024/here|/foo/b/here|red,green,blue|red,green,blue|semi,;,dot,.,comma,,|semi=;,dot=.,comma=,', ['uri' => '{+var}|{+hello}|{+half}|{base}index|{+base}index|O{+empty}X|O{+undef}X|{+path}/here|here?ref={+path}|up{+path}{var}/here|{+x,hello,y}|{+path,x}/here|{+path:6}/here|{+list}|{+list*}|{+keys}|{+keys*}', 'params' => $params]],
# level 2 - Fragment Expansion: {#var}
['#value|#Hello%20World!|#50%25|foo#|foo|#1024,Hello%20World!,768|#/foo/bar,1024/here|#/foo/b/here|#red,green,blue|#red,green,blue|#semi,;,dot,.,comma,,|#semi=;,dot=.,comma=,', ['uri' => '{#var}|{#hello}|{#half}|foo{#empty}|foo{#undef}|{#x,hello,y}|{#path,x}/here|{#path:6}/here|{#list}|{#list*}|{#keys}|{#keys*}', 'params' => $params]],
# Label Expansion with Dot-Prefix: {.var}
['.fred|.fred.fred|.50%25.fred|www.example.com|X.value|X.|X|X.val|X.red,green,blue|X.red.green.blue|X.semi,%3B,dot,.,comma,%2C|X.semi=%3B.dot=..comma=%2C|X|X', ['uri' => '{.who}|{.who,who}|{.half,who}|www{.dom*}|X{.var}|X{.empty}|X{.undef}|X{.var:3}|X{.list}|X{.list*}|X{.keys}|X{.keys*}|X{.empty_keys}|X{.empty_keys*}', 'params' => $params]],
# Path Segment Expansion: {/var}
['/fred|/fred/fred|/50%25/fred|/fred/me%2Ftoo|/value|/value/|/value|/value/1024/here|/v/value|/red,green,blue|/red/green/blue|/red/green/blue/%2Ffoo|/semi,%3B,dot,.,comma,%2C|/semi=%3B/dot=./comma=%2C', ['uri' => '{/who}|{/who,who}|{/half,who}|{/who,dub}|{/var}|{/var,empty}|{/var,undef}|{/var,x}/here|{/var:1,var}|{/list}|{/list*}|{/list*,path:4}|{/keys}|{/keys*}', 'params' => $params]],
# Path-Style Parameter Expansion: {;var}
[';who=fred|;half=50%25|;empty|;v=6;empty;who=fred|;v=6;who=fred|;x=1024;y=768|;x=1024;y=768;empty|;x=1024;y=768|;hello=Hello|;list=red,green,blue|;list=red;list=green;list=blue|;keys=semi,%3B,dot,.,comma,%2C|;semi=%3B;dot=.;comma=%2C', ['uri' => '{;who}|{;half}|{;empty}|{;v,empty,who}|{;v,bar,who}|{;x,y}|{;x,y,empty}|{;x,y,undef}|{;hello:5}|{;list}|{;list*}|{;keys}|{;keys*}', 'params' => $params]],
# Form-Style Query Expansion: {?var}
['?who=fred|?half=50%25|?x=1024&y=768|?x=1024&y=768&empty=|?x=1024&y=768|?var=val|?list=red,green,blue|?list=red&list=green&list=blue|?keys=semi,%3B,dot,.,comma,%2C|?semi=%3B&dot=.&comma=%2C|?list_with_empty=|?john=', ['uri' => '{?who}|{?half}|{?x,y}|{?x,y,empty}|{?x,y,undef}|{?var:3}|{?list}|{?list*}|{?keys}|{?keys*}|{?list_with_empty*}|{?keys_with_empty*}', 'params' => $params]],
# Form-Style Query Continuation: {&var}
['&who=fred|&half=50%25|?fixed=yes&x=1024|&x=1024&y=768&empty=|&x=1024&y=768|&var=val|&list=red,green,blue|&list=red&list=green&list=blue|&keys=semi,%3B,dot,.,comma,%2C|&semi=%3B&dot=.&comma=%2C', ['uri' => '{&who}|{&half}|?fixed=yes{&x}|{&x,y,empty}|{&x,y,undef}|{&var:3}|{&list}|{&list*}|{&keys}|{&keys*}', 'params' => $params]],
# Test empty values
['|||', ['uri' => '{empty}|{empty*}|{?empty}|{?empty*}', 'params' => ['empty' => []]]],
];
}
public static function dataExpandWithArrayModifier()
{
return [
# List
[
# '?choices[]=a&choices[]=b&choices[]=c',
'?choices%5B%5D=a&choices%5B%5D=b&choices%5B%5D=c',
['uri' => '{?choices%}', 'params' => ['choices' => ['a', 'b', 'c']]],
],
# Keys
[
# '?choices[a]=1&choices[b]=2&choices[c][test]=3',
'?choices%5Ba%5D=1&choices%5Bb%5D=2&choices%5Bc%5D%5Btest%5D=3',
['uri' => '{?choices%}', 'params' => ['choices' => ['a' => 1, 'b' => 2, 'c' => ['test' => 3]]]],
],
# Mixed
[
# '?list[]=a&list[]=b&keys[a]=1&keys[b]=2',
'?list%5B%5D=a&list%5B%5D=b&keys%5Ba%5D=1&keys%5Bb%5D=2',
['uri' => '{?list%,keys%}', 'params' => ['list' => ['a', 'b'], 'keys' => ['a' => 1, 'b' => 2]]],
],
];
}
public static function dataBaseTemplate()
{
return [
[
'http://google.com/api/1/users/1',
# base uri
['uri' => '{+host}/api/{v}', 'params' => ['host' => 'http://google.com', 'v' => 1]],
# other uri
['uri' => '/{resource}/{id}', 'params' => ['resource' => 'users', 'id' => 1]],
],
# test override base params
[
'http://github.com/api/1/users/1',
# base uri
['uri' => '{+host}/api/{v}', 'params' => ['host' => 'http://google.com', 'v' => 1]],
# other uri
['uri' => '/{resource}/{id}', 'params' => ['host' => 'http://github.com', 'resource' => 'users', 'id' => 1]],
],
];
}
public static function dataExtraction()
{
return [['/no/{term:1}/random/foo{?query,list%,keys%}', '/no/j/random/foo?query=1,2,3&list%5B%5D=a&list%5B%5D=b&keys%5Ba%5D=1&keys%5Bb%5D=2&keys%5Bc%5D%5Btest%5D%5Btest%5D=1', ['term:1' => 'j', 'query' => [1, 2, 3], 'list' => ['a', 'b'], 'keys' => ['a' => 1, 'b' => 2, 'c' => ['test' => ['test' => 1]]]]], ['/no/{term:1}/random/{term}/{test*}/foo{?query,number}', '/no/j/random/john/a,b,c/foo?query=1,2,3&number=10', ['term:1' => 'j', 'term' => 'john', 'test' => ['a', 'b', 'c'], 'query' => [1, 2, 3], 'number' => 10]], ['/search/{term:1}/{term}/{?q*,limit}', '/search/j/john/?a=1&b=2&limit=10', ['term:1' => 'j', 'term' => 'john', 'q' => ['a' => 1, 'b' => 2], 'limit' => 10]], ['http://www.example.com/foo{?query,number}', 'http://www.example.com/foo?query=5', ['query' => 5, 'number' => null]], ['{count}|{count*}|{/count}|{/count*}|{;count}|{;count*}|{?count}|{?count*}|{&count*}', 'one,two,three|one,two,three|/one,two,three|/one/two/three|;count=one,two,three|;count=one;count=two;count=three|?count=one,two,three|?count=one&count=two&count=three|&count=one&count=two&count=three', ['count' => ['one', 'two', 'three']]], ['http://example.com/{term:1}/{term}/search{?q*,lang}', 'http://example.com/j/john/search?q=Hello%20World%21&q=3&lang=th,jp,en', ['q' => ['Hello World!', 3], 'lang' => ['th', 'jp', 'en'], 'term' => 'john', 'term:1' => 'j']], ['/foo/bar/{number}', '/foo/bar/0', ['number' => 0]], ['/some/{path}{?ref}', '/some/foo', ['path' => 'foo', 'ref' => null]]];
}
/**
* @dataProvider dataExpansion
*/
public function testExpansion($expected, $input)
{
$service = $this->service();
$result = $service->expand($input['uri'], $input['params']);
$this->assertEquals($expected, $result);
}
/**
* @dataProvider dataExpandWithArrayModifier
*/
public function testExpandWithArrayModifier($expected, $input)
{
$service = $this->service();
$result = $service->expand($input['uri'], $input['params']);
$this->assertEquals($expected, $result);
}
/**
* @dataProvider dataBaseTemplate
*/
public function testBaseTemplate($expected, $base, $other)
{
$service = $this->service($base['uri'], $base['params']);
$result = $service->expand($other['uri'], $other['params']);
$this->assertEquals($expected, $result);
}
/**
* @dataProvider dataExtraction
*/
public function testExtract($template, $uri, $expected)
{
$service = $this->service();
$actual = $service->extract($template, $uri);
$this->assertEquals($expected, $actual);
}
public function testExpandFromFixture()
{
$dir = dirname(__DIR__) . DIRECTORY_SEPARATOR . 'fixtures' . DIRECTORY_SEPARATOR;
$files = ['spec-examples.json', 'spec-examples-by-section.json', 'extended-tests.json'];
$service = $this->service();
foreach ($files as $file) {
$content = json_decode(file_get_contents($dir . $file), $array = true);
# iterate through each fixture
foreach ($content as $fixture) {
$vars = $fixture['variables'];
# assert each test cases
foreach ($fixture['testcases'] as $case) {
[$uri, $expected] = $case;
$actual = $service->expand($uri, $vars);
if (is_array($expected)) {
$expected = current(array_filter($expected, fn($input) => $actual === $input));
}
$this->assertEquals($expected, $actual);
}
}
}
}
public static function dataExtractStrictMode()
{
$dataTest = [['/search/{term:1}/{term}/{?q*,limit}', '/search/j/john/?a=1&b=2&limit=10', ['term:1' => 'j', 'term' => 'john', 'limit' => '10', 'q' => ['a' => '1', 'b' => '2']]], ['http://example.com/{term:1}/{term}/search{?q*,lang}', 'http://example.com/j/john/search?q=Hello%20World%21&q=3&lang=th,jp,en', ['term:1' => 'j', 'term' => 'john', 'lang' => ['th', 'jp', 'en'], 'q' => ['Hello World!', '3']]], ['/foo/bar/{number}', '/foo/bar/0', ['number' => 0]], ['/', '/', []]];
$rfc3986AllowedPathCharacters = ['-', '.', '_', '~', '!', '$', '&', "'", '(', ')', '*', '+', ',', ';', '=', ':', '@'];
foreach ($rfc3986AllowedPathCharacters as $char) {
$title = "RFC3986 path character ($char)";
$title = str_replace("'", 'single quote', $title); // PhpStorm workaround
if ($char === ',') { // , means array on RFC6570
$params = ['term' => ['foo', 'baz']];
} else {
$params = ['term' => "foo{$char}baz"];
}
$data = ['/search/{term}', "/search/foo{$char}baz", $params];
$dataTest[$title] = $data;
$data = ['/search/{;term}', "/search/;term=foo{$char}baz", $params];
$dataTest['Named ' . $title] = $data;
}
$rfc3986AllowedQueryCharacters = $rfc3986AllowedPathCharacters;
$rfc3986AllowedQueryCharacters[] = '/';
$rfc3986AllowedQueryCharacters[] = '?';
unset($rfc3986AllowedQueryCharacters[array_search('&', $rfc3986AllowedQueryCharacters, true)]);
foreach ($rfc3986AllowedQueryCharacters as $char) {
$title = "RFC3986 query character ($char)";
$title = str_replace("'", 'single quote', $title); // PhpStorm workaround
if ($char === ',') { // , means array on RFC6570
$params = ['term' => ['foo', 'baz']];
} else {
$params = ['term' => "foo{$char}baz"];
}
$data = ['/search/{?term}', "/search/?term=foo{$char}baz", $params];
$dataTest['Named ' . $title] = $data;
}
return $dataTest;
}
public static function extractStrictModeNotMatchProvider()
{
return [['/', '/a'], ['/{test}', '/a/'], ['/search/{term:1}/{term}/{?q*,limit}', '/search/j/?a=1&b=2&limit=10'], ['http://www.example.com/foo{?query,number}', 'http://www.example.com/foo?query=5'], ['http://www.example.com/foo{?query,number}', 'http://www.example.com/foo'], ['http://example.com/{term:1}/{term}/search{?q*,lang}', 'http://example.com/j/john/search?q=']];
}
#[DataProvider('dataExtractStrictMode')]
public function testExtractStrictMode(string $template, string $uri, array $expectedParams)
{
$service = $this->service();
$params = $service->extract($template, $uri, true);
$this->assertTrue(isset($params));
$this->assertEquals($expectedParams, $params);
}
#[DataProvider('extractStrictModeNotMatchProvider')]
public function testExtractStrictModeNotMatch(string $template, string $uri)
{
$service = $this->service();
$actual = $service->extract($template, $uri, true);
$this->assertFalse(isset($actual));
}
}
|