File: README.md

package info (click to toggle)
libmoosex-types-uri-perl 0.07-1
  • links: PTS, VCS
  • area: main
  • in suites: jessie, jessie-kfreebsd
  • size: 256 kB
  • ctags: 1
  • sloc: perl: 308; makefile: 2
file content (75 lines) | stat: -rw-r--r-- 2,437 bytes parent folder | download
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
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
# NAME

MooseX::Types::URI - URI related types and coercions for Moose

# VERSION

version 0.07

# SYNOPSIS

        use MooseX::Types::URI qw(Uri FileUri DataUri);

# DESCRIPTION

This package provides Moose types for fun with [URI](https://metacpan.org/pod/URI)s.

# TYPES

## `Uri`

Either [URI](https://metacpan.org/pod/URI) or [URI::WithBase](https://metacpan.org/pod/URI::WithBase)

Coerces from `Str` via ["new" in URI](https://metacpan.org/pod/URI#new).

Coerces from [Path::Class::File](https://metacpan.org/pod/Path::Class::File) and [Path::Class::Dir](https://metacpan.org/pod/Path::Class::Dir) via ["new" in URI::file](https://metacpan.org/pod/URI::file#new).

Coerces from `ScalarRef` via ["new" in URI::data](https://metacpan.org/pod/URI::data#new).

Coerces from `HashRef` using [URI::FromHash](https://metacpan.org/pod/URI::FromHash).

## `DataUri`

A URI whose scheme is `data`.

Coerces from `Str` and `ScalarRef` via ["new" in URI::data](https://metacpan.org/pod/URI::data#new).

## `FileUri`

A [URI::file](https://metacpan.org/pod/URI::file) class type.

Has coercions from `Str`, [Path::Class::File](https://metacpan.org/pod/Path::Class::File) and [Path::Class::Dir](https://metacpan.org/pod/Path::Class::Dir) via ["new" in URI::file](https://metacpan.org/pod/URI::file#new)

It has slightly DWIMier types than the [URI](https://metacpan.org/pod/URI) classes have due to
implementation details, so the types should be more forgiving when ducktyping
will work anyway (e.g. [URI::WithBase](https://metacpan.org/pod/URI::WithBase) does not inherit [URI](https://metacpan.org/pod/URI)).

# TYPES

The types are with `ucfirst` naming convention so that they don't mask the
[URI](https://metacpan.org/pod/URI) class.

# TODO

Think about [Path::Resource](https://metacpan.org/pod/Path::Resource) integration of some sort

# AUTHOR

יובל קוג'מן (Yuval Kogman) <nothingmuch@woobling.org>

# CONTRIBUTORS

- Daniel Pittman <daniel@rimspace.net>
- Florian Ragwitz <rafl@debian.org>
- Karen Etheridge <ether@cpan.org>
- MORIYA Masaki (gardejo) <moriya@ermitejo.com>
- Olivier Mengué <dolmen@cpan.org>
- Shawn M Moore <sartak@gmail.com>
- Yuval Kogman <nothingmuch@woobling.org>

# COPYRIGHT AND LICENSE

This software is copyright (c) 2008 by יובל קוג'מן (Yuval Kogman).

This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.