| 1 |
URI/db version 0.23 |
| 2 |
=================== |
| 3 |
|
| 4 |
This library implements a Perl interface for a proposed standard for database |
| 5 |
connection URIs. The basic formats are: |
| 6 |
|
| 7 |
* `db:engine://username:[email protected]:8042/over/there/widget.db?type=animal&name=narwhal` |
| 8 |
* `db:engine:my_big_fat_database?subject=Topic` |
| 9 |
|
| 10 |
This library also includes an interface to convert database URIs to |
| 11 |
[DBI](https://metacpan.org/module/DBI) DSNs. For additional information on the |
| 12 |
format, see `README.md`. |
| 13 |
|
| 14 |
**Warning:** This is an alpha release. I will do my best to preserve |
| 15 |
functionality going forward, especially as [Sqitch](http://sqitch.org/) uses |
| 16 |
this module. However, as the database URI specification moves forward, changes |
| 17 |
*may* require backwards-incompatible changes. Caveat Hackor. |
| 18 |
|
| 19 |
Installation |
| 20 |
------------ |
| 21 |
|
| 22 |
To install this module, type the following: |
| 23 |
|
| 24 |
perl Build.PL |
| 25 |
./Build |
| 26 |
./Build test |
| 27 |
./Build install |
| 28 |
|
| 29 |
Dependencies |
| 30 |
------------ |
| 31 |
|
| 32 |
URI::db requires the following modules: |
| 33 |
|
| 34 |
* URI |
| 35 |
* URI::Nested |
| 36 |
|
| 37 |
Copyright and Licence |
| 38 |
--------------------- |
| 39 |
|
| 40 |
Copyright (c) 2013-2023 David E. Wheeler. Some Rights Reserved. |
| 41 |
|
| 42 |
This module is free software; you can redistribute it and/or modify it under |
| 43 |
the same terms as Perl itself. |