Build.PL missing (or README -> installation outdated)

[obilodeau]

README says:

INSTALLATION
  In most cases, you can just issue the following commands:

  perl Build.PL
  ./Build
  ./Build test
  ./Build install

Please see the documentation for Module::Build if you have questions
about installing to custom locations etc.

but there's no such thing as a Build.PL. Being unfamiliar with Build.PL maybe I'm missing something obvious.

[oalders]

As far as using the Git repo goes, I should add some extra instructions. This dist uses Dist::Zilla, so if you want to build from the repo directly (assuming you have cpanminus installed):

cpanm Dist::Zilla
dzil build

To run the test suite:
dzil test

To install deps:

dzil listdeps | cpanm

I'm not sure if that will work without having installed the Dist::Zilla plugins listed in dist.ini first. Maybe you could try that and let me know?

[obilodeau]

# dzil build
Required plugin Bugtracker isn't installed.

Run 'dzil authordeps' to see a list of all required plugins.
You can pipe the list to your CPAN client to install or update them:

    dzil authordeps | cpanm

and doing so it takes care of installing the required plugins.

I'm having a hard time to believe how much perl modules are pulled (by cpanm, dist::zilla and then authordeps)... It's a very long install process for a single perl module ;)

Anyway, I can't even get it to install on our target platform (CentOS 5.6) because it's running perl 5.8.8 and Dist-Zilla-Plugin-Git requires 5.10..

Perl v5.10.0 required--this is only v5.8.8, stopped at lib/Dist/Zilla/Plugin/Git/Init.pm line 9.

That said, may I suggest you put in a 'devel' section with the commands you gave me above in the README?

[oalders]

Fair enough! The dependency chain for Dist::Zilla is big, but at least the end user doesn't have to deal with it. :) Having said that, I will add your notes to a Devel section. So, you'll only need dzil to build and package the distro. Are you able to install a custom perl on your development platform? If you haven't looked at perlbrew, I'd suggest trying it out. It's great for exactly this sort of thing:

http://search.metacpan.org/#/showpod/App::perlbrew

[obilodeau]

Thanks for sharing that perl wisdom!

Following your instructions I was able to run the test suite and make a build successfully.

I also reproduced your 'YAML_LOAD_WARN_DUPLICATE_KEY' issue but I guess you fixed that when you migrated to json?

[oalders]

Thanks for letting me know! Yeah, switching to JSON got rid of that error. I think it was just a problem with quoting, but JSON is probably enough for this sort of serialization. YAML feels like overkill and the parsers are a pain to deal with.

[oalders]

A reference to this ticket has been added to the Pod, to make getting started with Dist::Zilla and perlbrew a bit easier.