-
-
01 Aug 2021 10:12:54 UTC
- Distribution: Data-Sah
- Source (raw)
- Browse (raw)
- Changes
- Homepage
- How to Contribute
- Repository
- Issues (2)
- Testers (1384 / 4 / 6)
- Kwalitee
Bus factor: 1- 92.92% Coverage
- License: perl_5
- Perl: v5.10.1
- Activity
24 month- Tools
- Download (116KB)
- MetaCPAN Explorer
- Permissions
- Subscribe to distribution
- Permalinks
- This version
- Latest version
- Dependencies
- Data::Cmp
- Data::Dmp
- Data::Dump
- Data::Sah::Coerce
- Data::Sah::CoerceCommon
- Data::Sah::Filter
- Data::Sah::FilterCommon
- Data::Sah::Normalize
- Data::Sah::Resolve
- Exporter
- File::ShareDir
- File::ShareDir::Tarball
- File::Slurper
- File::chdir
- JSON
- Language::Expr
- Language::Expr::Interpreter::var_enumer
- Lingua::EN::Numbers::Ordinate
- Log::ger
- Mo
- Module::Installed::Tiny
- POSIX
- Regexp::Stringify
- Role::Tiny
- Role::Tiny::With
- Scalar::Util
- Scalar::Util::Numeric::PP
- Test::More
- Text::sprintfn
- Tie::IxHash
- Time::HiRes
- parent
- strict
- utf8
- warnings
- Reverse dependencies
- CPAN Testers List
- Dependency graph
- NAME
- VERSION
- DESCRIPTION
- ADDING A NEW CLAUSE
- CREATING A NEW TYPE
- ADDING A NEW FUNCTION
- CREATING A NEW FUNCTION SET
- CREATING A NEW COMPILER
- HOMEPAGE
- SOURCE
- BUGS
- AUTHOR
- COPYRIGHT AND LICENSE
NAME
Data::Sah::Manual::Extending - Extending Data::Sah
VERSION
This document describes version 0.910 of Data::Sah::Manual::Extending (from Perl distribution Data-Sah), released on 2021-08-01.
DESCRIPTION
This document explains the various ways of extending Data::Sah.
ADDING A NEW CLAUSE
Example: Add an
is_palindrome
clause tostr
.Create a distribution called Data-Sah-TypeX-str-is_palindrome
In lib/Data/Sah/TypeX/str/is_palindrome.pm, write:
package Data::Sah::TypeX::str::is_palindrome; use Data::Sah::Util::Compiler qw(add_clause add_translation_path); add_clause("str", "is_palindrome", definition => { }, handlers => { perl => sub { ... }, js => sub { ... }, human => sub { ... }, }, );
Provide translation of messages
For example, for Indonesian, in lib/Data/Sah/Lang/id_ID/TypeX/str/is_palindrome.pm write:
package Data::Sah::Lang::id_ID::TypeX::str::is_palindrome: ...
Add more language files as necessary.
CREATING A NEW TYPE
Example: complex number.
Create distribution Data-Sah-Type-complex
In lib/Data/Sah/Type/complex.pm write:
package Data::Sah::Type::complex; use Moo::Role; use Data::Sah::Util::Role 'has_clause'; with 'Data::Sah::Type::Comparable'; with 'Data::Sah::Type::Sortable'; ... 1;
In lib/Data/Sah/Compiler/perl/TH/complex.pm write:
XXX
In lib/Data/Sah/Compiler/js/TH/complex.pm write:
XXX
In lib/Data/Sah/Compiler/human/TH/complex.pm write:
XXX
Provide translation of messages
For example, for Indonesian, in lib/Data/Sah/Lang/id_ID/Type/complex.pm write:
package Data::Sah::Lang::id_ID::TypeX::str::is_palindrome: ...
Add more language files as necessary.
ADDING A NEW FUNCTION
XXX
CREATING A NEW FUNCTION SET
XXX
CREATING A NEW COMPILER
Take a look at one of the existing compilers like Data::Sah::Compiler::perl or Data::Sah::Compiler::human.
HOMEPAGE
Please visit the project's homepage at https://metacpan.org/release/Data-Sah.
SOURCE
Source repository is at https://github.com/perlancar/perl-Data-Sah.
BUGS
Please report any bugs or feature requests on the bugtracker website https://rt.cpan.org/Public/Dist/Display.html?Name=Data-Sah
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
perlancar <perlancar@cpan.org>
COPYRIGHT AND LICENSE
This software is copyright (c) 2021, 2020, 2019, 2018, 2017, 2016, 2015, 2014, 2013, 2012 by perlancar@cpan.org.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
Module Install Instructions
To install Data::Sah, copy and paste the appropriate command in to your terminal.
cpanm Data::Sah
perl -MCPAN -e shell install Data::Sah
For more information on module installation, please visit the detailed CPAN module installation guide.