RubyGems - javonet-ruby-sdk - Versions diffs - 2.5.13 → 2.5.15 - Mend

javonet-ruby-sdk 2.5.13 → 2.5.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (477) hide show

data/lib/javonet-ruby-sdk/Binaries/Perl/Linux/X64/deps/lib/perl5/Module/Build/Cookbook.pm DELETED Viewed

@@ -1,529 +0,0 @@
-package Module::Build::Cookbook;
-use strict;
-use warnings;
-our $VERSION = '0.4234';
-=head1 NAME
-Module::Build::Cookbook - Examples of Module::Build Usage
-=head1 DESCRIPTION
-C<Module::Build> isn't conceptually very complicated, but examples are
-always helpful.  The following recipes should help developers and/or
-installers put together the pieces from the other parts of the
-documentation.
-=head1 BASIC RECIPES
-=head2 Installing modules that use Module::Build
-In most cases, you can just issue the following commands:
-  perl Build.PL
-  ./Build
-  ./Build test
-  ./Build install
-There's nothing complicated here - first you're running a script
-called F<Build.PL>, then you're running a (newly-generated) script
-called F<Build> and passing it various arguments.
-The exact commands may vary a bit depending on how you invoke perl
-scripts on your system.  For instance, if you have multiple versions
-of perl installed, you can install to one particular perl's library
-directories like so:
-  /usr/bin/perl5.8.1 Build.PL
-  ./Build
-  ./Build test
-  ./Build install
-If you're on Windows where the current directory is always searched
-first for scripts, you'll probably do something like this:
-  perl Build.PL
-  Build
-  Build test
-  Build install
-On the old Mac OS (version 9 or lower) using MacPerl, you can
-double-click on the F<Build.PL> script to create the F<Build> script,
-then double-click on the F<Build> script to run its C<build>, C<test>,
-and C<install> actions.
-The F<Build> script knows what perl was used to run F<Build.PL>, so
-you don't need to re-invoke the F<Build> script with the complete perl
-path each time.  If you invoke it with the I<wrong> perl path, you'll
-get a warning or a fatal error.
-=head2 Modifying Config.pm values
-C<Module::Build> relies heavily on various values from perl's
-C<Config.pm> to do its work.  For example, default installation paths
-are given by C<installsitelib> and C<installvendorman3dir> and
-friends, C linker & compiler settings are given by C<ld>,
-C<lddlflags>, C<cc>, C<ccflags>, and so on.  I<If you're pretty sure
-you know what you're doing>, you can tell C<Module::Build> to pretend
-there are different values in F<Config.pm> than what's really there,
-by passing arguments for the C<--config> parameter on the command
-line:
-  perl Build.PL --config cc=gcc --config ld=gcc
-Inside the C<Build.PL> script the same thing can be accomplished by
-passing values for the C<config> parameter to C<new()>:
- my $build = Module::Build->new
-   (
-    ...
-    config => { cc => 'gcc', ld => 'gcc' },
-    ...
-   );
-In custom build code, the same thing can be accomplished by calling
-the L<Module::Build/config> method:
- $build->config( cc => 'gcc' );     # Set
- $build->config( ld => 'gcc' );     # Set
- ...
- my $linker = $build->config('ld'); # Get
-=head2 Installing modules using the programmatic interface
-If you need to build, test, and/or install modules from within some
-other perl code (as opposed to having the user type installation
-commands at the shell), you can use the programmatic interface.
-Create a Module::Build object (or an object of a custom Module::Build
-subclass) and then invoke its C<dispatch()> method to run various
-actions.
-  my $build = Module::Build->new
-    (
-     module_name => 'Foo::Bar',
-     license     => 'perl',
-     requires    => { 'Some::Module'   => '1.23' },
-    );
-  $build->dispatch('build');
-  $build->dispatch('test', verbose => 1);
-  $build->dispatch('install');
-The first argument to C<dispatch()> is the name of the action, and any
-following arguments are named parameters.
-This is the interface we use to test Module::Build itself in the
-regression tests.
-=head2 Installing to a temporary directory
-To create packages for package managers like RedHat's C<rpm> or
-Debian's C<deb>, you may need to install to a temporary directory
-first and then create the package from that temporary installation.
-To do this, specify the C<destdir> parameter to the C<install> action:
-  ./Build install --destdir /tmp/my-package-1.003
-This essentially just prepends all the installation paths with the
-F</tmp/my-package-1.003> directory.
-=head2 Installing to a non-standard directory
-To install to a non-standard directory (for example, if you don't have
-permission to install in the system-wide directories), you can use the
-C<install_base> or C<prefix> parameters:
-  ./Build install --install_base /foo/bar
-See L<Module::Build/"INSTALL PATHS"> for a much more complete
-discussion of how installation paths are determined.
-=head2 Installing in the same location as ExtUtils::MakeMaker
-With the introduction of C<--prefix> in Module::Build 0.28 and
-C<INSTALL_BASE> in C<ExtUtils::MakeMaker> 6.31 its easy to get them both
-to install to the same locations.
-First, ensure you have at least version 0.28 of Module::Build
-installed and 6.31 of C<ExtUtils::MakeMaker>.  Prior versions have
-differing (and in some cases quite strange) installation behaviors.
-The following installation flags are equivalent between
-C<ExtUtils::MakeMaker> and C<Module::Build>.
-    MakeMaker             Module::Build
-    PREFIX=...            --prefix ...
-    INSTALL_BASE=...      --install_base ...
-    DESTDIR=...           --destdir ...
-    LIB=...               --install_path lib=...
-    INSTALLDIRS=...       --installdirs ...
-    INSTALLDIRS=perl      --installdirs core
-    UNINST=...            --uninst ...
-    INC=...               --extra_compiler_flags ...
-    POLLUTE=1             --extra_compiler_flags -DPERL_POLLUTE
-For example, if you are currently installing C<MakeMaker> modules with
-this command:
-    perl Makefile.PL PREFIX=~
-    make test
-    make install UNINST=1
-You can install into the same location with Module::Build using this:
-    perl Build.PL --prefix ~
-    ./Build test
-    ./Build install --uninst 1
-=head3 C<prefix> vs C<install_base>
-The behavior of C<prefix> is complicated and depends on
-how your Perl is configured.  The resulting installation locations
-will vary from machine to machine and even different installations of
-Perl on the same machine.  Because of this, it's difficult to document
-where C<prefix> will place your modules.
-In contrast, C<install_base> has predictable, easy to explain
-installation locations.  Now that C<Module::Build> and C<MakeMaker> both
-have C<install_base> there is little reason to use C<prefix> other
-than to preserve your existing installation locations.  If you are
-starting a fresh Perl installation we encourage you to use
-C<install_base>.  If you have an existing installation installed via
-C<prefix>, consider moving it to an installation structure matching
-C<install_base> and using that instead.
-=head2 Running a single test file
-C<Module::Build> supports running a single test, which enables you to
-track down errors more quickly.  Use the following format:
-  ./Build test --test_files t/mytest.t
-In addition, you may want to run the test in verbose mode to get more
-informative output:
-  ./Build test --test_files t/mytest.t --verbose 1
-I run this so frequently that I define the following shell alias:
-  alias t './Build test --verbose 1 --test_files'
-So then I can just execute C<t t/mytest.t> to run a single test.
-=head1 ADVANCED RECIPES
-=head2 Making a CPAN.pm-compatible distribution
-New versions of CPAN.pm understand how to use a F<Build.PL> script,
-but old versions don't.  If authors want to help users who have old
-versions, some form of F<Makefile.PL> should be supplied.  The easiest
-way to accomplish this is to use the C<create_makefile_pl> parameter to
-C<< Module::Build->new() >> in the C<Build.PL> script, which can
-create various flavors of F<Makefile.PL> during the C<dist> action.
-As a best practice, we recommend using the "traditional" style of
-F<Makefile.PL> unless your distribution has needs that can't be
-accomplished that way.
-The C<Module::Build::Compat> module, which is part of
-C<Module::Build>'s distribution, is responsible for creating these
-F<Makefile.PL>s.  Please see L<Module::Build::Compat> for the details.
-=head2 Changing the order of the build process
-The C<build_elements> property specifies the steps C<Module::Build>
-will take when building a distribution.  To change the build order,
-change the order of the entries in that property:
-  # Process pod files first
-  my @e = @{$build->build_elements};
-  my ($i) = grep {$e[$_] eq 'pod'} 0..$#e;
-  unshift @e, splice @e, $i, 1;
-Currently, C<build_elements> has the following default value:
-  [qw( PL support pm xs pod script )]
-Do take care when altering this property, since there may be
-non-obvious (and non-documented!) ordering dependencies in the
-C<Module::Build> code.
-=head2 Adding new file types to the build process
-Sometimes you might have extra types of files that you want to install
-alongside the standard types like F<.pm> and F<.pod> files.  For
-instance, you might have a F<Bar.dat> file containing some data
-related to the C<Foo::Bar> module and you'd like for it to end up as
-F<Foo/Bar.dat> somewhere in perl's C<@INC> path so C<Foo::Bar> can
-access it easily at runtime.  The following code from a sample
-C<Build.PL> file demonstrates how to accomplish this:
-  use Module::Build;
-  my $build = Module::Build->new
-    (
-     module_name => 'Foo::Bar',
-     ...other stuff here...
-    );
-  $build->add_build_element('dat');
-  $build->create_build_script;
-This will find all F<.dat> files in the F<lib/> directory, copy them
-to the F<blib/lib/> directory during the C<build> action, and install
-them during the C<install> action.
-If your extra files aren't located in the C<lib/> directory in your
-distribution, you can explicitly say where they are, just as you'd do
-with F<.pm> or F<.pod> files:
-  use Module::Build;
-  my $build = new Module::Build
-    (
-     module_name => 'Foo::Bar',
-     dat_files => {'some/dir/Bar.dat' => 'lib/Foo/Bar.dat'},
-     ...other stuff here...
-    );
-  $build->add_build_element('dat');
-  $build->create_build_script;
-If your extra files actually need to be created on the user's machine,
-or if they need some other kind of special processing, you'll probably
-want to subclass C<Module::Build> and create a special method to
-process them, named C<process_${kind}_files()>:
-  use Module::Build;
-  my $class = Module::Build->subclass(code => <<'EOF');
-    sub process_dat_files {
-      my $self = shift;
-      ... locate and process *.dat files,
-      ... and create something in blib/lib/
-    }
-  EOF
-  my $build = $class->new
-    (
-     module_name => 'Foo::Bar',
-     ...other stuff here...
-    );
-  $build->add_build_element('dat');
-  $build->create_build_script;
-If your extra files don't go in F<lib/> but in some other place, see
-L<"Adding new elements to the install process"> for how to actually
-get them installed.
-Please note that these examples use some capabilities of Module::Build
-that first appeared in version 0.26.  Before that it could
-still be done, but the simple cases took a bit more work.
-=head2 Adding new elements to the install process
-By default, Module::Build creates seven subdirectories of the F<blib>
-directory during the build process: F<lib>, F<arch>, F<bin>,
-F<script>, F<bindoc>, F<libdoc>, and F<html> (some of these may be
-missing or empty if there's nothing to go in them).  Anything copied
-to these directories during the build will eventually be installed
-during the C<install> action (see L<Module::Build/"INSTALL PATHS">.
-If you need to create a new custom type of installable element, e.g. C<conf>,
-then you need to tell Module::Build where things in F<blib/conf/>
-should be installed.  To do this, use the C<install_path> parameter to
-the C<new()> method:
-  my $build = Module::Build->new
-    (
-     ...other stuff here...
-     install_path => { conf => $installation_path }
-    );
-Or you can call the C<install_path()> method later:
-  $build->install_path(conf => $installation_path);
-The user may also specify the path on the command line:
-  perl Build.PL --install_path conf=/foo/path/etc
-The important part, though, is that I<somehow> the install path needs
-to be set, or else nothing in the F<blib/conf/> directory will get
-installed, and a runtime error during the C<install> action will
-result.
-See also L<"Adding new file types to the build process"> for how to
-create the stuff in F<blib/conf/> in the first place.
-=head1 EXAMPLES ON CPAN
-Several distributions on CPAN are making good use of various features
-of Module::Build.  They can serve as real-world examples for others.
-=head2 SVN-Notify-Mirror
-L<http://search.cpan.org/~jpeacock/SVN-Notify-Mirror/>
-John Peacock, author of the C<SVN-Notify-Mirror> distribution, says:
-=over 4
-=item 1. Using C<auto_features>, I check to see whether two optional
-modules are available - SVN::Notify::Config and Net::SSH;
-=item 2. If the S::N::Config module is loaded, I automatically
-generate test files for it during Build (using the C<PL_files>
-property).
-=item 3. If the C<ssh_feature> is available, I ask if the user wishes
-to perform the ssh tests (since it requires a little preliminary
-setup);
-=item 4. Only if the user has C<ssh_feature> and answers yes to the
-testing, do I generate a test file.
-I'm sure I could not have handled this complexity with EU::MM, but it
-was very easy to do with M::B.
-=back
-=head2 Modifying an action
-Sometimes you might need an to have an action, say C<./Build install>,
-do something unusual.  For instance, you might need to change the
-ownership of a file or do something else peculiar to your application.
-You can subclass C<Module::Build> on the fly using the C<subclass()>
-method and override the methods that perform the actions.  You may
-need to read through C<Module::Build::Authoring> and
-C<Module::Build::API> to find the methods you want to override.  All
-"action" methods are implemented by a method called "ACTION_" followed
-by the action's name, so here's an example of how it would work for
-the C<install> action:
-  # Build.PL
-  use Module::Build;
-  my $class = Module::Build->subclass(
-      class => "Module::Build::Custom",
-      code => <<'SUBCLASS' );
-  sub ACTION_install {
-      my $self = shift;
-      # YOUR CODE HERE
-      $self->SUPER::ACTION_install;
-  }
-  SUBCLASS
-  $class->new(
-      module_name => 'Your::Module',
-      # rest of the usual Module::Build parameters
-  )->create_build_script;
-=head2 Adding an action
-You can add a new C<./Build> action simply by writing the method for
-it in your subclass.  Use C<depends_on> to declare that another action
-must have been run before your action.
-For example, let's say you wanted to be able to write C<./Build
-commit> to test your code and commit it to Subversion.
-  # Build.PL
-  use Module::Build;
-  my $class = Module::Build->subclass(
-      class => "Module::Build::Custom",
-      code => <<'SUBCLASS' );
-  sub ACTION_commit {
-      my $self = shift;
-      $self->depends_on("test");
-      $self->do_system(qw(svn commit));
-  }
-  SUBCLASS
-=head2 Bundling Module::Build
-Note: This section probably needs an update as the technology improves
-(see contrib/bundle.pl in the distribution).
-Suppose you want to use some new-ish features of Module::Build,
-e.g. newer than the version of Module::Build your users are likely to
-already have installed on their systems.  The first thing you should
-do is set C<configure_requires> to your minimum version of
-Module::Build.  See L<Module::Build::Authoring>.
-But not every build system honors C<configure_requires> yet.  Here's
-how you can ship a copy of Module::Build, but still use a newer
-installed version to take advantage of any bug fixes and upgrades.
-First, install Module::Build into F<Your-Project/inc/Module-Build>.
-CPAN will not index anything in the F<inc> directory so this copy will
-not show up in CPAN searches.
-    cd Module-Build
-    perl Build.PL --install_base /path/to/Your-Project/inc/Module-Build
-    ./Build test
-    ./Build install
-You should now have all the Module::Build .pm files in
-F<Your-Project/inc/Module-Build/lib/perl5>.
-Next, add this to the top of your F<Build.PL>.
-    my $Bundled_MB = 0.30;  # or whatever version it was.
-    # Find out what version of Module::Build is installed or fail quietly.
-    # This should be cross-platform.
-    my $Installed_MB =
-        `$^X -e "eval q{require Module::Build; print Module::Build->VERSION} or exit 1"`;
-    # some operating systems put a newline at the end of every print.
-    chomp $Installed_MB;
-    $Installed_MB = 0 if $?;
-    # Use our bundled copy of Module::Build if it's newer than the installed.
-    unshift @INC, "inc/Module-Build/lib/perl5" if $Bundled_MB > $Installed_MB;
-    require Module::Build;
-And write the rest of your F<Build.PL> normally.  Module::Build will
-remember your change to C<@INC> and use it when you run F<./Build>.
-In the future, we hope to provide a more automated solution for this
-scenario; see C<inc/latest.pm> in the Module::Build distribution for
-one indication of the direction we're moving.
-=head1 AUTHOR
-Ken Williams <kwilliams@cpan.org>
-=head1 COPYRIGHT
-Copyright (c) 2001-2008 Ken Williams.  All rights reserved.
-This library is free software; you can redistribute it and/or
-modify it under the same terms as Perl itself.
-=head1 SEE ALSO
-perl(1), L<Module::Build>(3), L<Module::Build::Authoring>(3),
-L<Module::Build::API>(3)
-=cut

data/lib/javonet-ruby-sdk/Binaries/Perl/Linux/X64/deps/lib/perl5/Module/Build/Dumper.pm DELETED Viewed

@@ -1,19 +0,0 @@
-package Module::Build::Dumper;
-use strict;
-use warnings;
-our $VERSION = '0.4234';
-# This is just a split-out of a wrapper function to do Data::Dumper
-# stuff "the right way".  See:
-# http://groups.google.com/group/perl.module.build/browse_thread/thread/c8065052b2e0d741
-use Data::Dumper;
-sub _data_dump {
-  my ($self, $data) = @_;
-  return ("do{ my "
-	  . Data::Dumper->new([$data],['x'])->Purity(1)->Terse(0)->Sortkeys(1)->Dump()
-	  . '$x; }')
-}
-1;