NAME

Perl::Box - is a ready to use Codio box. Start coding now!

SYNOPSIS

Go to Codio. Create a project. Choose Perl5 stack. Start coding!

DESCRIPTION

Perl::Box is a Task, a.k.a. Bundle distribution containing most used CPAN stuff needed for coding. Perl-Box is a Codio box. They are used to create a Codio stack that you can use to start coding Perl immediately.

MOTIVATION

I really got addicted with Codio. During 2015 CPAN Pull Request Challenge, Niel Bowers assigned me a task on a distribution, so I had to prepare a shared development environment to work on Bot::Training. Compiling latest Perl and distributions like Moose and Dist::Zilla with all its dependencies takes time. There were no Perl based Codio stack.

So, since 2+2=4, I wanted a ready to use Perl Box to start coding immediately.

STUFF INCLUDED

How to add or update distributions included? Fork this, edit the Makefile.PL and send a pull request.

Note that versions reported are those in the Perl Box actually.

• Task::BeLike::FIBO

  Yes, 'cause I'm my first (and only!? :) user. Read here what is included.

• Catalyst::Devel

• Catalyst::Runtime

• Mojolicious

  I really like it! It is my favourite web framework.

  Dancer

  Par condicio

• Moose

  Long live the Meta programming protocol!

• Moo

  Cause it completes Moose when performance overhead is a problem.

• Dist::Zilla

  It is used by a lot of Perl coders.

• App::cloc

  I packaged the famous CLOC tool. It is worth to add it in every development environment.

• DBI

• DBIx::Class

• DateTime

• App::FatPacker

• Digest::MD5

• LWP

  One of the must have distros.

• List::Util

• List::MoreUtils

• Regexp::Common

• Template

• Test::Class

  Write reusable tests, follow this best practice.

• Test::Exception

• Test::Most

• YAML

  A tribute to the mythic Ingy.

CREATION

Wanna create your own Perl Box? It will take few minutes.

Perl Box is created from Codio default stack. Create a Codio project and open a Terminal.

PERL

Use dotsoftware to install latest Perl. Just copy and paste the following commands.

# get latest .software
cd
git clone https://github.com/fibo/.software.git
# source it in your profile and in current session
[ -f ~/.bash_profile ] && grep 'source ~/.software/etc/profile' ~/.bash_profile || echo 'source ~/.software/etc/profile' >> ~/.bash_profile && source ~/.software/etc/profile
# install latest Perl
.software_install Perl
# you are done!

Configure a CPAN client that works like a charm.

DISTRIBUTIONS

Install what you need from CPAN, for instance

cpan Perl::Box

EDITOR

Choose vim as default editor

# Needed by git commit -a
echo export EDITOR=vim >> ~/.bash_profile

Minimal vim configuration

cat >> ~/.vimrc <<EOF
" my Perl preferences
autocmd filetype perl map <F2> :%!perltidy<CR> " indent
autocmd filetype perl map <F3> :!prove -l<CR>  " run tests
autocmd filetype perl setlocal autoindent
autocmd filetype perl setlocal expandtab
autocmd filetype perl setlocal shiftwidth=4
autocmd filetype perl setlocal tabstop=4

" use perltidy for .pl, .pm, and .t
au BufRead,BufNewFile *.pl setl equalprg=perltidy
au BufRead,BufNewFile *.pm setl equalprg=perltidy
au BufRead,BufNewFile *.t setl equalprg=perltidy
EOF

COPYRIGHT AND LICENSE

This software is copyright (c) 2015 by G. Casati.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

cpanm Perl::Box

perl -MCPAN -e shell
install Perl::Box