The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
package Farly::IPv4::Network;

use 5.008008;
use strict;
use warnings;
use Carp;
use Farly::IPv4::Object;
use Farly::IPv4::Address;
require Farly::IPv4::Range;

our @ISA     = qw(Farly::IPv4::Object);
our $VERSION = '0.25';

sub new {
    my ( $class, $network ) = @_;
    confess "IP address and subnet mask required"
      unless ($network);

    my $self = {
        NETWORK => undef,    #Farly::IPv4::Address object
        MASK    => undef     #Farly::IPv4::Address object
    };
    bless( $self, $class );

    $self->_init($network);

    return $self;
}

sub _init {
    my ( $self, $network ) = @_;

    $network =~ s/^\s+|\s+$//g;

    my $address;
    my $mask;
    my $bits;

    if ( $network =~ /^((\d{1,3})((\.)(\d{1,3})){3})\s+((\d{1,3})((\.)(\d{1,3})){3})$/ )
    {
        ( $address, $mask ) = split( /\s+/, $network );
    }
    elsif ( $network =~ /^(\d{1,3}(\.\d{1,3}){3})(\/)(\d+)$/ ) {
        ( $address, $bits ) = split( "/", $network );
        $mask = $self->_bits_to_mask($bits);
    }
    elsif ( $network =~ /^\d+\s+\d+$/ ) {
        ( $address, $mask ) = split( /\s+/, $network );
    }
    else {
        confess "Invalid input $network";
    }

    $self->_set_address($address);
    $self->_set_mask($mask);
}

sub _set_address {
    my ( $self, $address ) = @_;
    $self->{NETWORK} = Farly::IPv4::Address->new($address);
}

sub _set_mask {
    my ( $self, $mask ) = @_;

    if ( $mask =~ /0.0.0.0/ ) {
        $self->{MASK} = Farly::IPv4::Address->new($mask);
    }
    elsif ( $mask =~ /^0/ ) {
        my $ip = Farly::IPv4::Address->new($mask);
        $self->{MASK} = Farly::IPv4::Address->new( $ip->inverse() );
    }
    else {
        $self->{MASK} = Farly::IPv4::Address->new($mask);
    }

    $self->_is_valid_mask();
}

sub _bits_to_mask {
    my ( $self, $bits ) = @_;
    if ( $bits >= 0 && $bits <= 32 ) {
        my $zeroBits = 32 - $bits;
        my $ip       = ( 1 << $zeroBits ) - 1;
        return ~$ip & 4294967295;
    }
    else {
        confess "$bits is not a valid subnet mask";
    }
}

sub _is_valid_mask {
    my $mask = $_[0]->{MASK}->address();
    my $current_bit;
    my $flag = 0;

    for ( my $i = 0 ; $i < 32 ; ++$i ) {
        $current_bit = ( $mask >> $i ) & 1;
        if ( $current_bit == 1 ) {
            $flag = 1;
        }
        if ( ( $flag == 1 ) && ( $current_bit == 0 ) ) {
            confess "$mask is not a valid subnet mask";
        }
    }

    return 1;
}

sub address {
    return $_[0]->{NETWORK}->address();
}

sub network {
    return $_[0]->{NETWORK}->address() & $_[0]->{MASK}->address();
}

sub mask {
    return $_[0]->{MASK};
}

sub inverse_mask {
    return $_[0]->mask()->inverse();
}

sub first {
    return ( $_[0]->network() );
}

sub last {
    return ( $_[0]->network() + $_[0]->inverse_mask() );
}

sub as_string {
    return join( " ", $_[0]->network_address()->as_string(), $_[0]->mask()->as_string() );
}

sub as_wc_string {
    return join( " ", $_[0]->network_address()->as_string(), $_[0]->wc_mask()->as_string() );
}

sub network_address {
    return Farly::IPv4::Address->new( $_[0]->network() );
}

sub wc_mask {
    return Farly::IPv4::Address->new( $_[0]->inverse_mask() );
}

sub broadcast_address {
    return Farly::IPv4::Address->new( $_[0]->network() + $_[0]->inverse_mask() );
}

sub start {
    return $_[0]->network_address();
}

sub end {
    return $_[0]->broadcast_address();
}

sub iter {
    my @iter = ( Farly::IPv4::Range->new( $_[0]->first(), $_[0]->last() ) );
    return @iter;
}

1;
__END__

=head1 NAME

Farly::IPv4::Network - IPv4 network class

=head1 DESCRIPTION

This class represents an IPv4 network.

Inherits from Farly::IPv4::Object.

=head1 METHODS

=head2 new( <string> )

The constructor accepts a dotted decimal format address and mask
or CIDR format network.

 my $ip_network = Farly::IPv4::Network->new( "10.0.0.0 255.0.0.0" );
 my $ip_network = Farly::IPv4::Network->new( "10.0.0.0/8" );

=head2 address()

Returns the 32 bit integer network address

  $32bit_int_network_addr = $ip_network->address();

=head2 mask()

Returns the network mask Farly::IPv4:Address object

  my $mask_object = $ip_network->inverse_mask()

=head2 inverse_mask()

Returns the bit wise logical not of the 32 bit integer network mask IP address

 my $32bit_int_inverse_mask = $ip_network->inverse_mask()

=head2 network_address()

Returns the network address as an Farly::IPv4::Address object

  $ipv4_addr_object = $ip_network->network_address();

=head2 broadcast_address

Returns the broadcast address as an Farly::IPv4::Address object

  $ipv4_addr_object = $ip_network->broadcast_address();

=head2 first()

Returns the 32 bit integer network address

  $32bit_int_network_addr = $ip_network->first();

=head2 last()

Returns the 32 bit integer network broadcast IP address

  $32bit_int_network_addr = $ip_network->last();

=head2 start()

Returns the network address as an Farly::IPv4::Address object

  $ipv4_addr_object = $ip_network->start();

=head2 end()

Returns the broadcast address as an Farly::IPv4::Address object

  $ipv4_addr_object = $ip_network->end();

=head2 as_string()

Returns the current Farly::IPv4::Network as a dotted decimal format string

  print $ip_network->as_string();

=head2 as_wc_string

Returns the current Farly::IPv4::Network as a dotted decimal format string
with a wild card mask

  print $ip_network->as_wc_string();

=head2 iter()

Returns an array containing the current IP network as a Farly::IPv4::Range
object.

  my @array = $ip->iter();

=head1 COPYRIGHT AND LICENSE

Farly::IPv4::Network
Copyright (C) 2012  Trystan Johnson

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.