r225 - in packages: . libvalidate-net-perl libvalidate-net-perl/branches libvalidate-net-perl/branches/upstream libvalidate-net-perl/branches/upstream/current libvalidate-net-perl/branches/upstream/current/lib libvalidate-net-perl/branches/upstream/current/lib/Validate libvalidate-net-perl/branches/upstream/current/t
Allard Hoeve
hoeve-guest@haydn.debian.org
Thu, 17 Jun 2004 08:26:41 -0600
Author: hoeve-guest
Date: 2004-06-17 08:26:35 -0600 (Thu, 17 Jun 2004)
New Revision: 225
Added:
packages/libvalidate-net-perl/
packages/libvalidate-net-perl/branches/
packages/libvalidate-net-perl/branches/upstream/
packages/libvalidate-net-perl/branches/upstream/current/
packages/libvalidate-net-perl/branches/upstream/current/Changes
packages/libvalidate-net-perl/branches/upstream/current/LICENSE
packages/libvalidate-net-perl/branches/upstream/current/MANIFEST
packages/libvalidate-net-perl/branches/upstream/current/META.yml
packages/libvalidate-net-perl/branches/upstream/current/Makefile.PL
packages/libvalidate-net-perl/branches/upstream/current/README
packages/libvalidate-net-perl/branches/upstream/current/lib/
packages/libvalidate-net-perl/branches/upstream/current/lib/Validate/
packages/libvalidate-net-perl/branches/upstream/current/lib/Validate/Net.pm
packages/libvalidate-net-perl/branches/upstream/current/t/
packages/libvalidate-net-perl/branches/upstream/current/t/01_main.t
packages/libvalidate-net-perl/tags/
Log:
[svn-inject] Installing original source of libvalidate-net-perl
Added: packages/libvalidate-net-perl/branches/upstream/current/Changes
===================================================================
--- packages/libvalidate-net-perl/branches/upstream/current/Changes 2004-06-17 14:22:52 UTC (rev 224)
+++ packages/libvalidate-net-perl/branches/upstream/current/Changes 2004-06-17 14:26:35 UTC (rev 225)
@@ -0,0 +1,15 @@
+Revision history for Perl extension Validate::Net.
+
+0.5 Thu Dec 4 2003
+ - Fixed the tests to be Win32 compatible
+
+0.4 missing
+
+0.3 missing
+
+0.2 Mon April 14 8:29:21 2003
+ - Updated to better comply with the RFCs
+
+0.1 Fri July 12 21:01:52 2002
+ - original version
+
Property changes on: packages/libvalidate-net-perl/branches/upstream/current/Changes
___________________________________________________________________
Name: svn:executable
+
Added: packages/libvalidate-net-perl/branches/upstream/current/LICENSE
===================================================================
--- packages/libvalidate-net-perl/branches/upstream/current/LICENSE 2004-06-17 14:22:52 UTC (rev 224)
+++ packages/libvalidate-net-perl/branches/upstream/current/LICENSE 2004-06-17 14:26:35 UTC (rev 225)
@@ -0,0 +1,377 @@
+Terms of Perl itself
+
+a) the GNU General Public License as published by the Free
+ Software Foundation; either version 1, or (at your option) any
+ later version, or
+b) the "Artistic License"
+
+----------------------------------------------------------------------------
+
+The General Public License (GPL)
+Version 2, June 1991
+
+Copyright (C) 1989, 1991 Free Software Foundation, Inc. 675 Mass Ave,
+Cambridge, MA 02139, USA. Everyone is permitted to copy and distribute
+verbatim copies of this license document, but changing it is not allowed.
+
+Preamble
+
+The licenses for most software are designed to take away your freedom to share
+and change it. By contrast, the GNU General Public License is intended to
+guarantee your freedom to share and change free software--to make sure the
+software is free for all its users. This General Public License applies to most of
+the Free Software Foundation's software and to any other program whose
+authors commit to using it. (Some other Free Software Foundation software is
+covered by the GNU Library General Public License instead.) You can apply it to
+your programs, too.
+
+When we speak of free software, we are referring to freedom, not price. Our
+General Public Licenses are designed to make sure that you have the freedom
+to distribute copies of free software (and charge for this service if you wish), that
+you receive source code or can get it if you want it, that you can change the
+software or use pieces of it in new free programs; and that you know you can do
+these things.
+
+To protect your rights, we need to make restrictions that forbid anyone to deny
+you these rights or to ask you to surrender the rights. These restrictions
+translate to certain responsibilities for you if you distribute copies of the
+software, or if you modify it.
+
+For example, if you distribute copies of such a program, whether gratis or for a
+fee, you must give the recipients all the rights that you have. You must make
+sure that they, too, receive or can get the source code. And you must show
+them these terms so they know their rights.
+
+We protect your rights with two steps: (1) copyright the software, and (2) offer
+you this license which gives you legal permission to copy, distribute and/or
+modify the software.
+
+Also, for each author's protection and ours, we want to make certain that
+everyone understands that there is no warranty for this free software. If the
+software is modified by someone else and passed on, we want its recipients to
+know that what they have is not the original, so that any problems introduced by
+others will not reflect on the original authors' reputations.
+
+Finally, any free program is threatened constantly by software patents. We wish
+to avoid the danger that redistributors of a free program will individually obtain
+patent licenses, in effect making the program proprietary. To prevent this, we
+have made it clear that any patent must be licensed for everyone's free use or
+not licensed at all.
+
+The precise terms and conditions for copying, distribution and modification
+follow.
+
+GNU GENERAL PUBLIC LICENSE
+TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND
+MODIFICATION
+
+0. This License applies to any program or other work which contains a notice
+placed by the copyright holder saying it may be distributed under the terms of
+this General Public License. The "Program", below, refers to any such program
+or work, and a "work based on the Program" means either the Program or any
+derivative work under copyright law: that is to say, a work containing the
+Program or a portion of it, either verbatim or with modifications and/or translated
+into another language. (Hereinafter, translation is included without limitation in
+the term "modification".) Each licensee is addressed as "you".
+
+Activities other than copying, distribution and modification are not covered by
+this License; they are outside its scope. The act of running the Program is not
+restricted, and the output from the Program is covered only if its contents
+constitute a work based on the Program (independent of having been made by
+running the Program). Whether that is true depends on what the Program does.
+
+1. You may copy and distribute verbatim copies of the Program's source code as
+you receive it, in any medium, provided that you conspicuously and appropriately
+publish on each copy an appropriate copyright notice and disclaimer of warranty;
+keep intact all the notices that refer to this License and to the absence of any
+warranty; and give any other recipients of the Program a copy of this License
+along with the Program.
+
+You may charge a fee for the physical act of transferring a copy, and you may at
+your option offer warranty protection in exchange for a fee.
+
+2. You may modify your copy or copies of the Program or any portion of it, thus
+forming a work based on the Program, and copy and distribute such
+modifications or work under the terms of Section 1 above, provided that you also
+meet all of these conditions:
+
+a) You must cause the modified files to carry prominent notices stating that you
+changed the files and the date of any change.
+
+b) You must cause any work that you distribute or publish, that in whole or in
+part contains or is derived from the Program or any part thereof, to be licensed
+as a whole at no charge to all third parties under the terms of this License.
+
+c) If the modified program normally reads commands interactively when run, you
+must cause it, when started running for such interactive use in the most ordinary
+way, to print or display an announcement including an appropriate copyright
+notice and a notice that there is no warranty (or else, saying that you provide a
+warranty) and that users may redistribute the program under these conditions,
+and telling the user how to view a copy of this License. (Exception: if the
+Program itself is interactive but does not normally print such an announcement,
+your work based on the Program is not required to print an announcement.)
+
+These requirements apply to the modified work as a whole. If identifiable
+sections of that work are not derived from the Program, and can be reasonably
+considered independent and separate works in themselves, then this License,
+and its terms, do not apply to those sections when you distribute them as
+separate works. But when you distribute the same sections as part of a whole
+which is a work based on the Program, the distribution of the whole must be on
+the terms of this License, whose permissions for other licensees extend to the
+entire whole, and thus to each and every part regardless of who wrote it.
+
+Thus, it is not the intent of this section to claim rights or contest your rights to
+work written entirely by you; rather, the intent is to exercise the right to control
+the distribution of derivative or collective works based on the Program.
+
+In addition, mere aggregation of another work not based on the Program with the
+Program (or with a work based on the Program) on a volume of a storage or
+distribution medium does not bring the other work under the scope of this
+License.
+
+3. You may copy and distribute the Program (or a work based on it, under
+Section 2) in object code or executable form under the terms of Sections 1 and 2
+above provided that you also do one of the following:
+
+a) Accompany it with the complete corresponding machine-readable source
+code, which must be distributed under the terms of Sections 1 and 2 above on a
+medium customarily used for software interchange; or,
+
+b) Accompany it with a written offer, valid for at least three years, to give any
+third party, for a charge no more than your cost of physically performing source
+distribution, a complete machine-readable copy of the corresponding source
+code, to be distributed under the terms of Sections 1 and 2 above on a medium
+customarily used for software interchange; or,
+
+c) Accompany it with the information you received as to the offer to distribute
+corresponding source code. (This alternative is allowed only for noncommercial
+distribution and only if you received the program in object code or executable
+form with such an offer, in accord with Subsection b above.)
+
+The source code for a work means the preferred form of the work for making
+modifications to it. For an executable work, complete source code means all the
+source code for all modules it contains, plus any associated interface definition
+files, plus the scripts used to control compilation and installation of the
+executable. However, as a special exception, the source code distributed need
+not include anything that is normally distributed (in either source or binary form)
+with the major components (compiler, kernel, and so on) of the operating system
+on which the executable runs, unless that component itself accompanies the
+executable.
+
+If distribution of executable or object code is made by offering access to copy
+from a designated place, then offering equivalent access to copy the source
+code from the same place counts as distribution of the source code, even though
+third parties are not compelled to copy the source along with the object code.
+
+4. You may not copy, modify, sublicense, or distribute the Program except as
+expressly provided under this License. Any attempt otherwise to copy, modify,
+sublicense or distribute the Program is void, and will automatically terminate
+your rights under this License. However, parties who have received copies, or
+rights, from you under this License will not have their licenses terminated so long
+as such parties remain in full compliance.
+
+5. You are not required to accept this License, since you have not signed it.
+However, nothing else grants you permission to modify or distribute the Program
+or its derivative works. These actions are prohibited by law if you do not accept
+this License. Therefore, by modifying or distributing the Program (or any work
+based on the Program), you indicate your acceptance of this License to do so,
+and all its terms and conditions for copying, distributing or modifying the
+Program or works based on it.
+
+6. Each time you redistribute the Program (or any work based on the Program),
+the recipient automatically receives a license from the original licensor to copy,
+distribute or modify the Program subject to these terms and conditions. You
+may not impose any further restrictions on the recipients' exercise of the rights
+granted herein. You are not responsible for enforcing compliance by third parties
+to this License.
+
+7. If, as a consequence of a court judgment or allegation of patent infringement
+or for any other reason (not limited to patent issues), conditions are imposed on
+you (whether by court order, agreement or otherwise) that contradict the
+conditions of this License, they do not excuse you from the conditions of this
+License. If you cannot distribute so as to satisfy simultaneously your obligations
+under this License and any other pertinent obligations, then as a consequence
+you may not distribute the Program at all. For example, if a patent license would
+not permit royalty-free redistribution of the Program by all those who receive
+copies directly or indirectly through you, then the only way you could satisfy
+both it and this License would be to refrain entirely from distribution of the
+Program.
+
+If any portion of this section is held invalid or unenforceable under any particular
+circumstance, the balance of the section is intended to apply and the section as
+a whole is intended to apply in other circumstances.
+
+It is not the purpose of this section to induce you to infringe any patents or other
+property right claims or to contest validity of any such claims; this section has
+the sole purpose of protecting the integrity of the free software distribution
+system, which is implemented by public license practices. Many people have
+made generous contributions to the wide range of software distributed through
+that system in reliance on consistent application of that system; it is up to the
+author/donor to decide if he or she is willing to distribute software through any
+other system and a licensee cannot impose that choice.
+
+This section is intended to make thoroughly clear what is believed to be a
+consequence of the rest of this License.
+
+8. If the distribution and/or use of the Program is restricted in certain countries
+either by patents or by copyrighted interfaces, the original copyright holder who
+places the Program under this License may add an explicit geographical
+distribution limitation excluding those countries, so that distribution is permitted
+only in or among countries not thus excluded. In such case, this License
+incorporates the limitation as if written in the body of this License.
+
+9. The Free Software Foundation may publish revised and/or new versions of the
+General Public License from time to time. Such new versions will be similar in
+spirit to the present version, but may differ in detail to address new problems or
+concerns.
+
+Each version is given a distinguishing version number. If the Program specifies a
+version number of this License which applies to it and "any later version", you
+have the option of following the terms and conditions either of that version or of
+any later version published by the Free Software Foundation. If the Program does
+not specify a version number of this License, you may choose any version ever
+published by the Free Software Foundation.
+
+10. If you wish to incorporate parts of the Program into other free programs
+whose distribution conditions are different, write to the author to ask for
+permission. For software which is copyrighted by the Free Software Foundation,
+write to the Free Software Foundation; we sometimes make exceptions for this.
+Our decision will be guided by the two goals of preserving the free status of all
+derivatives of our free software and of promoting the sharing and reuse of
+software generally.
+
+NO WARRANTY
+
+11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS
+NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
+APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE
+COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM
+"AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR
+IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE
+ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
+PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE,
+YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR
+CORRECTION.
+
+12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED
+TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY
+WHO MAY MODIFY AND/OR REDISTRIBUTE THE PROGRAM AS
+PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
+GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES
+ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM
+(INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING
+RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
+PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY
+OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS
+BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
+
+END OF TERMS AND CONDITIONS
+
+
+----------------------------------------------------------------------------
+
+The Artistic License
+
+Preamble
+
+The intent of this document is to state the conditions under which a Package
+may be copied, such that the Copyright Holder maintains some semblance of
+artistic control over the development of the package, while giving the users of the
+package the right to use and distribute the Package in a more-or-less customary
+fashion, plus the right to make reasonable modifications.
+
+Definitions:
+
+- "Package" refers to the collection of files distributed by the Copyright
+ Holder, and derivatives of that collection of files created through textual
+ modification.
+- "Standard Version" refers to such a Package if it has not been modified,
+ or has been modified in accordance with the wishes of the Copyright
+ Holder.
+- "Copyright Holder" is whoever is named in the copyright or copyrights for
+ the package.
+- "You" is you, if you're thinking about copying or distributing this Package.
+- "Reasonable copying fee" is whatever you can justify on the basis of
+ media cost, duplication charges, time of people involved, and so on. (You
+ will not be required to justify it to the Copyright Holder, but only to the
+ computing community at large as a market that must bear the fee.)
+- "Freely Available" means that no fee is charged for the item itself, though
+ there may be fees involved in handling the item. It also means that
+ recipients of the item may redistribute it under the same conditions they
+ received it.
+
+1. You may make and give away verbatim copies of the source form of the
+Standard Version of this Package without restriction, provided that you duplicate
+all of the original copyright notices and associated disclaimers.
+
+2. You may apply bug fixes, portability fixes and other modifications derived from
+the Public Domain or from the Copyright Holder. A Package modified in such a
+way shall still be considered the Standard Version.
+
+3. You may otherwise modify your copy of this Package in any way, provided
+that you insert a prominent notice in each changed file stating how and when
+you changed that file, and provided that you do at least ONE of the following:
+
+ a) place your modifications in the Public Domain or otherwise
+ make them Freely Available, such as by posting said modifications
+ to Usenet or an equivalent medium, or placing the modifications on
+ a major archive site such as ftp.uu.net, or by allowing the
+ Copyright Holder to include your modifications in the Standard
+ Version of the Package.
+
+ b) use the modified Package only within your corporation or
+ organization.
+
+ c) rename any non-standard executables so the names do not
+ conflict with standard executables, which must also be provided,
+ and provide a separate manual page for each non-standard
+ executable that clearly documents how it differs from the Standard
+ Version.
+
+ d) make other distribution arrangements with the Copyright Holder.
+
+4. You may distribute the programs of this Package in object code or executable
+form, provided that you do at least ONE of the following:
+
+ a) distribute a Standard Version of the executables and library
+ files, together with instructions (in the manual page or equivalent)
+ on where to get the Standard Version.
+
+ b) accompany the distribution with the machine-readable source of
+ the Package with your modifications.
+
+ c) accompany any non-standard executables with their
+ corresponding Standard Version executables, giving the
+ non-standard executables non-standard names, and clearly
+ documenting the differences in manual pages (or equivalent),
+ together with instructions on where to get the Standard Version.
+
+ d) make other distribution arrangements with the Copyright Holder.
+
+5. You may charge a reasonable copying fee for any distribution of this Package.
+You may charge any fee you choose for support of this Package. You may not
+charge a fee for this Package itself. However, you may distribute this Package in
+aggregate with other (possibly commercial) programs as part of a larger
+(possibly commercial) software distribution provided that you do not advertise
+this Package as a product of your own.
+
+6. The scripts and library files supplied as input to or produced as output from
+the programs of this Package do not automatically fall under the copyright of this
+Package, but belong to whomever generated them, and may be sold
+commercially, and may be aggregated with this Package.
+
+7. C or perl subroutines supplied by you and linked into this Package shall not
+be considered part of this Package.
+
+8. The name of the Copyright Holder may not be used to endorse or promote
+products derived from this software without specific prior written permission.
+
+9. THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR
+IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
+WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR
+PURPOSE.
+
+The End
+
+
Added: packages/libvalidate-net-perl/branches/upstream/current/MANIFEST
===================================================================
--- packages/libvalidate-net-perl/branches/upstream/current/MANIFEST 2004-06-17 14:22:52 UTC (rev 224)
+++ packages/libvalidate-net-perl/branches/upstream/current/MANIFEST 2004-06-17 14:26:35 UTC (rev 225)
@@ -0,0 +1,8 @@
+Changes
+lib/Validate/Net.pm
+LICENSE
+Makefile.PL
+MANIFEST This list of files
+README
+t/01_main.t
+META.yml Module meta-data (added by MakeMaker)
Added: packages/libvalidate-net-perl/branches/upstream/current/META.yml
===================================================================
--- packages/libvalidate-net-perl/branches/upstream/current/META.yml 2004-06-17 14:22:52 UTC (rev 224)
+++ packages/libvalidate-net-perl/branches/upstream/current/META.yml 2004-06-17 14:26:35 UTC (rev 225)
@@ -0,0 +1,13 @@
+# http://module-build.sourceforge.net/META-spec.html
+#XXXXXXX This is a prototype!!! It will change in the future!!! XXXXX#
+name: Validate-Net
+version: 0.5
+version_from: lib/Validate/Net.pm
+installdirs: site
+requires:
+ Class::Default: 0.2
+ File::Spec: 0.83
+ Test::More: 0
+
+distribution_type: module
+generated_by: ExtUtils::MakeMaker version 6.16
Added: packages/libvalidate-net-perl/branches/upstream/current/Makefile.PL
===================================================================
--- packages/libvalidate-net-perl/branches/upstream/current/Makefile.PL 2004-06-17 14:22:52 UTC (rev 224)
+++ packages/libvalidate-net-perl/branches/upstream/current/Makefile.PL 2004-06-17 14:26:35 UTC (rev 225)
@@ -0,0 +1,18 @@
+require 5.000;
+use ExtUtils::MakeMaker;
+WriteMakefile(
+ 'NAME' => 'Validate::Net',
+ 'VERSION_FROM' => 'lib/Validate/Net.pm',
+ 'PREREQ_PM' => {
+ # For the module itself
+ 'Class::Default' => 0.2,
+
+ # For the tests
+ 'File::Spec' => 0.83,
+ 'Test::More' => 0,
+ },
+ ($] >= 5.005) ? (
+ 'AUTHOR' => 'Adam Kennedy (cpan@ali.as)',
+ 'ABSTRACT' => 'Provides standalone validation of Net:: related strings',
+ ) : (),
+);
Property changes on: packages/libvalidate-net-perl/branches/upstream/current/Makefile.PL
___________________________________________________________________
Name: svn:executable
+
Added: packages/libvalidate-net-perl/branches/upstream/current/README
===================================================================
--- packages/libvalidate-net-perl/branches/upstream/current/README 2004-06-17 14:22:52 UTC (rev 224)
+++ packages/libvalidate-net-perl/branches/upstream/current/README 2004-06-17 14:26:35 UTC (rev 225)
@@ -0,0 +1,91 @@
+NAME
+ Validate::Net - Format validation for Net:: related strings
+
+SYNOPSIS
+ use Validate::Net;
+
+ my $good = '123.1.23.123';
+ my $bad = '123.432.21.12';
+
+ foreach ( $good, $bad ) {
+ if ( Validate::Net->ip( $_ ) ) {
+ print "'$_' is a valid ip\n";
+ } else {
+ print "'$_' is not a valid ip address because:\n";
+ print Validate::Net->reason . "\n";
+ }
+ }
+
+ my $checker = Validate::Net->new( 'fast' );
+ unless ( $checker->host( 'foo.bar.blah' ) ) {
+ print "You provided an invalid host";
+ }
+
+DESCRIPTION
+ Validate::Net is a class designed to assist with the validation of
+ internet related strings. It can be used to validate CGI forms,
+ internally by modules, and in any place where you want to check that an
+ internet related string is valid before handing it off to a Net::*
+ modules.
+
+ It allows you to catch errors early, and with more detailed error
+ messages than you are likely to get further down in the Net::* modules.
+
+ Whenever a test is false, you can access the reason through the "reason"
+ method.
+
+METHODS
+ host $host
+ The "host" method is used to see if a value is a valid host. That is, it
+ is either a domain name, or an ip address.
+
+ domain $domain [, @options ]
+ The "domain" method is used to check for a valid domain name according
+ to RFC 1034. It additionally disallows two consective dashes 'foo--bar'.
+ I've never seen it used, and it's probably a mistaken version of
+ 'foo-bar'.
+
+ Depending on the options, additional checks may be made. No options are
+ available at this time
+
+ ip $ip
+ The "ip" method is used to validate the format, of an ip address. If
+ called with no options, it will just do a basic format check of the ip,
+ checking that it conforms to the basic dotted quad format.
+
+ Depending on the options, additional checks may be made. No options are
+ available at this time
+
+ port $port
+ The "port" method is used to test for a valid port number.
+
+BUGS
+ Unknown
+
+TO DO
+ This module is not all that completed. Just enough to do some basics.
+ Feel free to send me patches to add anything you like.
+
+ Add support for networks
+ Add "exists" support
+ Add "dns" support for host names
+
+SUPPORT
+ Contact the author
+
+AUTHOR
+ Adam Kennedy
+ cpan@ali.as
+ http://ali.as/
+
+SEE ALSO
+ Net::*
+
+COPYRIGHT
+ Copyright (c) 2002-2003 Adam Kennedy. All rights reserved. This program
+ is free software; you can redistribute it and/or modify it under the
+ same terms as Perl itself.
+
+ The full text of the license can be found in the LICENSE file included
+ with this module.
+
Added: packages/libvalidate-net-perl/branches/upstream/current/lib/Validate/Net.pm
===================================================================
--- packages/libvalidate-net-perl/branches/upstream/current/lib/Validate/Net.pm 2004-06-17 14:22:52 UTC (rev 224)
+++ packages/libvalidate-net-perl/branches/upstream/current/lib/Validate/Net.pm 2004-06-17 14:26:35 UTC (rev 225)
@@ -0,0 +1,310 @@
+package Validate::Net;
+
+# Validate::Net is designed to allow you to test net related string to
+# determine their relative "validity".
+
+# We use Class::Default to allow us to create a "default" validator
+# which has a "medium" setting. Settings are discussed later.
+
+use strict;
+use base 'Class::Default';
+
+# Globals
+use vars qw{$VERSION $errstr $reason};
+BEGIN {
+ $VERSION = 0.5;
+ $errstr = '';
+ $reason = ''
+}
+
+
+
+
+
+#####################################################################
+# Constructor and Friends
+
+sub new {
+ my $class = shift;
+ my $depth = shift || 'local';
+
+ # Create the validtor object
+ my $self = bless {
+ depth => undef,
+ }, $class;
+
+ # Set the depth
+ $self->depth( $depth ) or return undef;
+ $self;
+}
+
+sub depth {
+ my $self = shift;
+ unless ( ref $self ) {
+ return $self->andError( "Cannot change the depth of the default object. You should instantiate instead" );
+ }
+
+ my $depth = shift;
+ return $self->{depth} unless defined $depth;
+ unless ( $depth eq 'fast' or $depth eq 'local' or $depth eq 'full' ) {
+ return $self->andError( "Invalid depth '$depth'. Valid depths are 'fast', 'local'(default) or 'full'" );
+ }
+ $self->{depth} = $depth;
+ 1;
+}
+
+
+
+
+
+#####################################################################
+# Testing
+
+# Validate an ip address
+sub ip {
+ my $self = shift->_self;
+ my $ip = shift or return undef;
+
+ # Clear the reason
+ $reason = '';
+
+ # First, do a basic character test.
+ # Just what we can get away with in a regex.
+ unless ( $ip =~ /^[0-9]\d{0,2}(?:\.[0-9]\d{0,2}){3}$/ ) {
+ return $self->withReason( 'Does not fit the basic dotted quad format for an ip' );
+ }
+
+ # Split into parts in preperation for the remaining tests
+ my @quad = split /\./, $ip;
+
+ # Make sure the basic numeric range is ok
+ if ( scalar grep { $_ > 255 } @quad ) {
+ return $self->withReason( 'The maximum value for an ip element is 255' );
+ }
+
+ # End of the fast tests
+ return 1 if $self->{depth} eq 'fast';
+
+ ### Add tests for options
+
+ 1;
+}
+
+# Validate a full or partial domain name, or just a host name
+sub domain {
+ my $self = shift->_self;
+ my $domain = lc shift or return undef;
+
+ # Do a quick check for any invalid characters, or basic problems
+ if ( $domain =~ /[^a-z0-9\.-]/ ) {
+ return $self->withReason( "Domain '$domain' contains invalid characters" );
+ }
+ if ( $domain =~ /\.\./ ) {
+ return $self->withReason( "Domain '$domain' contains consecutive dots" );
+ }
+ if ( $domain =~ /^\./ ) {
+ return $self->withReason( "Domain '$domain' cannot start with a dot" );
+ }
+
+ # The use of a trailing dot is allowed, but we remove it for testing purposes.
+ $domain =~ s/\.$//;
+
+ # Split into elements
+ my @elements = split /\./, $domain;
+
+ # Check each element individually
+ foreach my $element ( @elements ) {
+ # Segments can be no more than 63 characters
+ if ( length $element > 63 ) {
+ return $self->withReason( "Domain section '$element' cannot be longer than 63 characters" );
+ }
+
+ # Segments are allowed to contain only digits
+ next if $element =~ /^\d+$/;
+
+ # Segment must start with a letter
+ if ( $element !~ /^[a-z]/ ) {
+ return $self->withReason( "Domain section '$element' must start with a letter" );
+ }
+
+ # Segment must end with a letter or number
+ if ( $element !~ /[a-z0-9]$/ ) {
+ return $self->withReason( "Domain section '$element' must end with a letter or number" );
+ }
+
+ # Cannot have two consecutive dashes ( RFC doesn't say so that I can find... is this correct? )
+ if ( $element =~ /--/ ) {
+ return $self->withReason( "Domain sections '$element' cannot have two dashes in a row" );
+ }
+ }
+
+ return 1 if $self->{depth} eq 'fast';
+
+ ### Add tests for options
+
+ 1;
+}
+
+# Validate a host.
+# A host is EITHER an ip address, or a domain
+sub host {
+ my $self = shift->_self;
+ my $host = shift;
+
+ # Test as an ip or a domain
+ $host =~ /^\d+\.\d+\.\d+\.\d+$/
+ ? $self->ip( $host )
+ : $self->domain( $host );
+}
+
+# Validate a port number
+sub port {
+ my $self = shift->_self;
+ my $port = shift;
+
+ # A port must be all numbers
+ if ( $port =~ /[^0-9]/ ) {
+ return $self->withReason( 'A port number must be an integer' );
+ }
+
+ # A port cannot start with 0
+ if ( $port =~ /^0/ ) {
+ return $self->withReason( 'A port number cannot start with zero' );
+ }
+
+ # A port must be less than or equal to 65535
+ if ( $port > 65535 ) {
+ return $self->withReason( 'The port number is too high' );
+ }
+
+ # Otherwise OK
+ 1;
+}
+
+
+
+
+#####################################################################
+# Error and Message Handling
+
+sub andError { $errstr = $_[1]; undef }
+sub withReason { $reason = $_[1]; '' }
+sub errstr { $errstr }
+sub reason { $reason }
+
+1;
+
+__END__
+
+=pod
+
+=head1 NAME
+
+Validate::Net - Format validation for Net:: related strings
+
+=head1 SYNOPSIS
+
+ use Validate::Net;
+
+ my $good = '123.1.23.123';
+ my $bad = '123.432.21.12';
+
+ foreach ( $good, $bad ) {
+ if ( Validate::Net->ip( $_ ) ) {
+ print "'$_' is a valid ip\n";
+ } else {
+ print "'$_' is not a valid ip address because:\n";
+ print Validate::Net->reason . "\n";
+ }
+ }
+
+ my $checker = Validate::Net->new( 'fast' );
+ unless ( $checker->host( 'foo.bar.blah' ) ) {
+ print "You provided an invalid host";
+ }
+
+=head1 DESCRIPTION
+
+Validate::Net is a class designed to assist with the validation of internet
+related strings. It can be used to validate CGI forms, internally by modules,
+and in any place where you want to check that an internet related string is
+valid before handing it off to a Net::* modules.
+
+It allows you to catch errors early, and with more detailed error messages
+than you are likely to get further down in the Net::* modules.
+
+Whenever a test is false, you can access the reason through the C<reason>
+method.
+
+=head1 METHODS
+
+=head2 host $host
+
+The C<host> method is used to see if a value is a valid host. That is, it is
+either a domain name, or an ip address.
+
+=head2 domain $domain [, @options ]
+
+The C<domain> method is used to check for a valid domain name according to
+RFC 1034. It additionally disallows two consective dashes 'foo--bar'. I've
+never seen it used, and it's probably a mistaken version of 'foo-bar'.
+
+Depending on the options, additional checks may be made. No options are
+available at this time
+
+=head2 ip $ip
+
+The C<ip> method is used to validate the format, of an ip address.
+If called with no options, it will just do a basic format check of the ip,
+checking that it conforms to the basic dotted quad format.
+
+Depending on the options, additional checks may be made. No options are
+available at this time
+
+=head2 port $port
+
+The C<port> method is used to test for a valid port number.
+
+=head1 BUGS
+
+Unknown
+
+=head1 TO DO
+
+This module is not all that completed. Just enough to do some basics. Feel
+free to send me patches to add anything you like.
+
+=over 4
+
+=item Add support for networks
+
+=item Add "exists" support
+
+=item Add "dns" support for host names
+
+=back
+
+=head1 SUPPORT
+
+Contact the author
+
+=head1 AUTHOR
+
+ Adam Kennedy
+ cpan@ali.as
+ http://ali.as/
+
+=head1 SEE ALSO
+
+Net::*
+
+=head1 COPYRIGHT
+
+Copyright (c) 2002-2003 Adam Kennedy. All rights reserved.
+This program is free software; you can redistribute
+it and/or modify it under the same terms as Perl itself.
+
+The full text of the license can be found in the
+LICENSE file included with this module.
+
+=cut
Added: packages/libvalidate-net-perl/branches/upstream/current/t/01_main.t
===================================================================
--- packages/libvalidate-net-perl/branches/upstream/current/t/01_main.t 2004-06-17 14:22:52 UTC (rev 224)
+++ packages/libvalidate-net-perl/branches/upstream/current/t/01_main.t 2004-06-17 14:26:35 UTC (rev 225)
@@ -0,0 +1,78 @@
+#!/usr/bin/perl
+
+# Formal testing for Validate::Net
+
+# Do all the tests on ourself, since we know we will be loaded.
+
+use strict;
+use File::Spec::Functions qw{:ALL};
+use lib catdir( updir(), updir(), 'modules' ), # Development testing
+ catdir( updir(), 'lib' ); # Installation testing
+use UNIVERSAL 'isa';
+use Test::More tests => 35;
+
+# Check their perl version
+BEGIN {
+ $| = 1;
+ ok( $] >= 5.005, "Your perl is new enough" );
+}
+
+
+
+
+
+# Does the module load
+use_ok( 'Validate::Net' );
+
+
+
+
+
+# Create a bunch of basic "good" and "bad" ips
+my @good = qw{
+ 1.2.3.4
+ 0.0.0.0
+ };
+my @bad = qw{1.2.3};
+
+# Check the good and bad ips
+foreach ( @good ) {
+ ok( Validate::Net->ip( $_ ), "'$_' passes ->ip correctly" );
+ ok( Validate::Net->host( $_ ), "'$_' passes ->host correctly" );
+}
+foreach ( @bad ) {
+ ok( ! Validate::Net->ip( $_ ), "'$_' fails ->ip correctly" );
+}
+
+
+
+
+# Create a bunch of basic "good" and "bad" domain and host names
+@good = qw{
+ foo
+ bar
+ foo-bar
+ 32146
+ black.342.hole
+ dot.at.end.
+ };
+@bad = qw{
+ 1st
+ -blah
+ blah-
+ blah--blah
+ reallyreallyreallyreallyreallyreallyreallyreallyreallyreallyreallyreallylong
+ .dot.at.start
+ this.is.1st.also.bad
+ blah.blah-.blah
+ };
+
+# Check the good and bad domains
+foreach ( @good ) {
+ ok( Validate::Net->domain( $_ ), "'$_' passes ->domain correctly" );
+ ok( Validate::Net->host( $_ ), "'$_' passes ->host correctly" );
+}
+foreach ( @bad ) {
+ ok( ! Validate::Net->domain( $_ ), "'$_' fails ->domain correctly" );
+ ok( ! Validate::Net->host( $_ ), "'$_' fails ->host correctly" );
+}