package Data::PerlSurvey2007;
use warnings;
use strict;
=head1 NAME
Data::PerlSurvey2007 - Data results and simple code for the results of Perl Survey 2007
=head1 VERSION
Version 1.00
=cut
our $VERSION = '1.00';
our @columns;
=head1 SYNOPSIS
Now you can do your own analyses of the data from Perl Survey 2007.
use Data::PerlSurvey2007;
my @responses = Data::PerlSurvey2007::read_responses( 'results.csv' );
Each element of the responses coming back is a hashref that looks like this
{
'Attended Perl Mongers' => '1',
'Attended Perl Mongers (non-local)' => '0',
'Attended conference' => '1',
'Attended conference (non-local)' => '0',
'CPAN modules maintained' => '12',
'Contributed to CPAN' => '1',
'Contributed to Perl 5' => '0',
'Contributed to Perl 6' => '0',
'Contributed to other projects' => '1',
'Contributed to websites' => '1',
'Country of birth' => 'au',
'Country of residence' => 'au',
'Date survey completed' => '2007-07-26 12:49:37',
'ID' => '25',
'Income' => '80000-89999',
'Industry/ies' => [
'Internet',
'Real Estate'
],
'Led other projects' => '1',
'Other programming languages known' => [],
'Perl versions' => [
'5.005',
'5.6.1',
'5.8.4',
'5.8.5',
'5.8.8'
],
'Perlmonks' => '0',
'Platforms' => [
'BSD - FreeBSD',
'Linux - Debian',
'Linux - Ubuntu',
'Mac OS/X',
'Windows XP'
],
'Posted to Perl Mongers list' => '1',
'Posted to other list' => '1',
'Presented at conference' => '1',
'Primary language spoken' => 'English',
'Programming languages known' => [
'JavaScript',
'MOO',
'PHP',
'Ruby'
],
'Proportion of Perl' => '90',
'Provided feedback' => '1',
'Sex' => 'female',
'Subscribed to Perl Mongers list' => '1',
'Subscribed to other list' => '1',
'Year of birth' => '1975',
'Years programming (total)' => '22',
'Years programming Perl' => '11'
},
=head1 FUNCTIONS
=head2 read_responses( $filename )
Reads in the responses from F<$filename> and returns an array of them.
=cut
sub read_responses {
my $filename = shift;
my @responses = ();
open( my $fh, '<', $filename ) or die "Unable to read $filename: $!\n";
while ( <$fh> ) {
chomp;
next if /^#/ || !/./;
my @fields = split_csv( $_ );
my $nfields = @fields;
$nfields == 34 or die "I need 34 fields, but line $. has $nfields";
if ( @columns ) {
my %response;
# Turn the multi-value responses into arrayrefs
for my $col ( 7, 10, 11, 13, 14 ) {
$fields[$col] = [ split( /\s*;\s*/, $fields[$col] ) ];
}
@response{ @columns } = @fields;
push( @responses, \%response );
}
else {
@columns = @fields;
}
}
return @responses;
}
=head2 split_csv( $str )
Split the CSV fields into individual columns, and get rid of the quotes.
=cut
sub split_csv {
my $str = shift;
my @cols = ( $str =~ /(?:^|,)("(?:[^"]+|"")*"|[^,]*)/g );
s/^"(.*)"$/$1/ for @cols;
return @cols;
}
=head1 AUTHOR
Andy Lester, C<< <andy at petdance.com> >>
=head1 BUGS
Please report any bugs or feature requests to
C<bug-data-perlsurvey2007 at rt.cpan.org>, or through the web interface at
L<http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Data-PerlSurvey2007>.
I will be notified, and then you'll automatically be notified of progress on
your bug as I make changes.
=head1 SUPPORT
You can find documentation for this module with the perldoc command.
perldoc Data::PerlSurvey2007
You can also look for information at:
=over 4
=item * AnnoCPAN: Annotated CPAN documentation
L<http://annocpan.org/dist/Data-PerlSurvey2007>
=item * CPAN Ratings
L<http://cpanratings.perl.org/d/Data-PerlSurvey2007>
=item * RT: CPAN's request tracker
L<http://rt.cpan.org/NoAuth/Bugs.html?Dist=Data-PerlSurvey2007>
=item * Search CPAN
L<http://search.cpan.org/dist/Data-PerlSurvey2007>
=back
=head1 ACKNOWLEDGEMENTS
=head1 COPYRIGHT & LICENSE
Copyright 2007 Andy Lester, all rights reserved.
This program is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.
=cut
1; # End of Data::PerlSurvey2007