Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/robrwo/types-sql
Type library for SQL types
https://github.com/robrwo/types-sql
Last synced: 11 days ago
JSON representation
Type library for SQL types
- Host: GitHub
- URL: https://github.com/robrwo/types-sql
- Owner: robrwo
- Created: 2016-01-12T14:14:41.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2023-06-02T16:29:33.000Z (over 1 year ago)
- Last Synced: 2024-10-11T21:56:27.615Z (about 1 month ago)
- Language: Perl
- Size: 124 KB
- Stars: 0
- Watchers: 2
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: Changes
Awesome Lists containing this project
README
# NAME
Types::SQL - a library of SQL types
# VERSION
version v0.7.0
# SYNOPSIS
```perl
use Types::SQL -types;
my $type = Varchar[16];
```
# DESCRIPTION
This module provides a type library of SQL types. These are
[Type::Tiny](https://metacpan.org/pod/Type%3A%3ATiny) objects that are augmented with a `dbic_column_info`
method that returns column information for use with
[DBIx::Class](https://metacpan.org/pod/DBIx%3A%3AClass).
# TYPES
The following types are provided:
## `Blob`
```perl
my $type = Blob;
```
Returns a `blob` data type.
## `Text`
```perl
my $type = Text;
```
Returns a `text` data type.
## `Varchar`
```perl
my $type = Varchar[ $size ];
```
Returns a `varchar` data type, with an optional size parameter.
## `Char`
```perl
my $type = Char[ $size ];
```
Returns a `char` data type, with an optional size parameter.
If `$size` is omitted, then it will default to 1.
## `Integer`
```perl
my $type = Integer[ $precision ];
```
Returns a `integer` data type, with an optional precision parameter.
## `SmallInt`
This is shorthand for `Integer[5]`.
## `BigInt`
This is shorthand for `Integer[19]`.
## `Serial`
```perl
my $type = Serial[ $precision ];
```
Returns a `serial` data type, with an optional precision parameter.
## `Numeric`
```perl
my $type = Numeric[ $precision, $scale ];
```
Returns a `integer` data type, with optional precision and scale parameters.
If `$scale` is omitted, then it is assumed to be `0`.
# CUSTOM TYPES
Any type that has these types as a parent can have column information
extracted using [Types::SQL::Util](https://metacpan.org/pod/Types%3A%3ASQL%3A%3AUtil).
Alternatively, you can specify a custom `dbic_column_info` method in
a type, e.g.:
```perl
my $type = Type::Tiny->new(
name => 'MyType',
my_methods => {
dbic_column_info => sub {
my ($self) = @_;
return (
data_type => 'custom',
parameter => 1234,
);
},
},
...
);
```
The method should return a hash of values that are passed to the
`add_column` method of [DBIx::Class::ResultSource](https://metacpan.org/pod/DBIx%3A%3AClass%3A%3AResultSource).
# SUPPORT FOR OLDER PERL VERSIONS
Since v0.7.0, the this module requires Perl v5.14 or later.
Future releases may only support Perl versions released in the last ten years.
If you need this module on Perl v5.10, please use one of the v0.6.x
versions of this module. Significant bug or security fixes may be
backported to those versions.
# SEE ALSO
[Type::Tiny](https://metacpan.org/pod/Type%3A%3ATiny).
[Types::SQL::Util](https://metacpan.org/pod/Types%3A%3ASQL%3A%3AUtil), which provides a utility function for translating
these types and other types from [Types::Standard](https://metacpan.org/pod/Types%3A%3AStandard) into column
information for [DBIx::Class::ResultSource](https://metacpan.org/pod/DBIx%3A%3AClass%3A%3AResultSource).
# SOURCE
The development version is on github at [https://github.com/robrwo/Types-SQL](https://github.com/robrwo/Types-SQL)
and may be cloned from [git://github.com/robrwo/Types-SQL.git](git://github.com/robrwo/Types-SQL.git)
# BUGS
Please report any bugs or feature requests on the bugtracker website
[https://github.com/robrwo/Types-SQL/issues](https://github.com/robrwo/Types-SQL/issues)
When submitting a bug or request, please include a test-file or a
patch to an existing test-file that illustrates the bug or desired
feature.
# AUTHOR
Robert Rothenberg
# CONTRIBUTOR
Slaven Rezić
# COPYRIGHT AND LICENSE
This software is Copyright (c) 2016-2023 by Robert Rothenberg.
This is free software, licensed under:
```
The Artistic License 2.0 (GPL Compatible)
```