bionic (3) Bio::Root::Build.3pm.gz

SYNOPSIS

         ...TO BE ADDED

DESCRIPTION

       This is a subclass of Module::Build so we can override certain methods and do fancy stuff

       It was first written against Module::Build::Base v0.2805. Many of the methods here are copy/pasted from
       there in their entirety just to change one or two minor things, since for the most part
       Module::Build::Base code is hard to cleanly override.

       Note: per bug 3196, the majority of the code in this module has been revised or commented out to bring it
       in line with the Module::Build API. In particular, 'requires/recommends' tags in the Build.PL file were
       not of the same format as those for Module::Build, and so caused serious issues with newer versions
       (including giving incorrect meta data). Other problematic methods involving automatic installation of
       prereq modules via CPAN were also removed as they do not work with more modern perl tools such as
       perlbrew and cpanm.

AUTHOR Sendu Bala

   find_pm_files
       Our modules are in Bio, not lib

   choose_scripts
       Ask what scripts to install (this method is unique to bioperl)

   script_files
       Our version of script_files doesn't take args but just installs those scripts requested by the user after
       choose_scripts() is called. If it wasn't called, installs all scripts in scripts directory

   prompt
       Overridden simply to not print the default answer if chosen by hitting return

   ACTION_manifest
       We always generate a new MANIFEST instead of allowing existing files to remain MANIFEST.SKIP is left
       alone

   ACTION_install
       Extended to run scripts post-installation

   test_internet
       For use with auto_features, which should require LWP::UserAgent as one of its reqs

       Note: as of 4-11-11, this is no longer called - if someone wants to run network tests (off by default)
       w/o a network, then they are hanging themselves by their own shoelaces.

   ACTION_ppmdist
       Don't copy across man3 docs since they're of little use under Windows and have bad filenames

   install_types
       When supplied a true value, pretends libdoc doesn't exist (preventing man3 installation for ppmdist).
       when supplied false, they exist again

   ACTION_dist
       We make all archive formats we want, not just .tar.gz we also auto-run manifest action, since we always
       want to re-create MANIFEST and MANIFEST.SKIP just-in-time

   ACTION_clean
       Define custom clean/realclean actions to rearrange config file cleanup

   ACTION_realclean
       Define custom clean/realclean actions to rearrange config file cleanup

   get_metadata
       This wraps the base metafile method to add in version information from Bio::Root::Version to META.json
       and META.yml if it isn't already present. Note this should be compliant with meta_add and meta_merge, but
       occurs after those steps. If a version is already set and dist_version differs from the set one, a
       warning is printed.

   make_zip
       Makes zip file for windows users and bzip2 files as well

   prompt_for_network
       A method that can be called in a Build.PL script to ask the user if they want internet tests.  Should
       only be called if you have tested for yourself that $build->feature('Network Tests') is true

   print_build_script
       Override the build script warnings flag