Zonemaster-CLI-v8.0.1/000755 001754 001754 00000000000 15121024076 014732 5ustar00matsdmatsd000000 000000 Zonemaster-CLI-v8.0.1/t/000755 001754 001754 00000000000 15121024076 015175 5ustar00matsdmatsd000000 000000 Zonemaster-CLI-v8.0.1/share/000755 001754 001754 00000000000 15121024076 016034 5ustar00matsdmatsd000000 000000 Zonemaster-CLI-v8.0.1/lib/000755 001754 001754 00000000000 15121024076 015500 5ustar00matsdmatsd000000 000000 Zonemaster-CLI-v8.0.1/inc/000755 001754 001754 00000000000 15121024076 015503 5ustar00matsdmatsd000000 000000 Zonemaster-CLI-v8.0.1/MANIFEST000644 001754 001754 00000001752 15071701617 016077 0ustar00matsdmatsd000000 000000 Changes CONTRIBUTING.md inc/Module/Install.pm inc/Module/Install/Base.pm inc/Module/Install/Can.pm inc/Module/Install/External.pm inc/Module/Install/Fetch.pm inc/Module/Install/Makefile.pm inc/Module/Install/Metadata.pm inc/Module/Install/Scripts.pm inc/Module/Install/Share.pm inc/Module/Install/Win32.pm inc/Module/Install/WriteAll.pm lib/Zonemaster/CLI.pm lib/Zonemaster/CLI/TestCaseSet.pm LICENSE Makefile.PL MANIFEST This list of files META.yml README.md script/zonemaster-cli share/GNUmakefile share/Makefile share/locale/da/LC_MESSAGES/Zonemaster-CLI.mo share/locale/es/LC_MESSAGES/Zonemaster-CLI.mo share/locale/fi/LC_MESSAGES/Zonemaster-CLI.mo share/locale/fr/LC_MESSAGES/Zonemaster-CLI.mo share/locale/nb/LC_MESSAGES/Zonemaster-CLI.mo share/locale/sl/LC_MESSAGES/Zonemaster-CLI.mo share/locale/sv/LC_MESSAGES/Zonemaster-CLI.mo t/00-load.t t/pod.t t/test_case_set.t t/usage.fake-data.data t/usage.fake-root.data t/usage.hints t/usage.normal.data t/usage.profile t/usage.t t/usage.wrapper.pl Zonemaster-CLI-v8.0.1/README.md000644 001754 001754 00000004647 15121024026 016217 0ustar00matsdmatsd000000 000000 # Zonemaster-CLI ## Purpose This Git repository is one of the components of the Zonemaster software and contains the source for the Zonemaster-CLI utility. For an overview of the Zonemaster software, please see the [Zonemaster repository]. ## Prerequisite Before you install the Zonemaster-CLI utility, you need the Zonemaster-Engine test framework installed. Please see the [Zonemaster Engine installation instructions][Zonemaster-Engine installation]. ## Installation For installation, see the [installation] document. ## Configuration This repository does not need any specific configuration. ## Docker Zonemaster-CLI is available on [Docker Hub], and can be conveniently downloaded and run without any installation. See [USING] Zonemaster-CLI for how to run Zonemaster-CLI on Docker. To build your own Docker image, see the [Docker Image Creation] documentation. ## Documentation Run `zonemaster-cli --help` to get brief descriptions of a selection of the most important command line options. For complete reference documentation, see the manual page by running `man zonemaster-cli`. Additional end-user documentation is available in the [USING] document. When developing Zonemaster-CLI, refer to the [development documentation]. ## Participation, Contact and Bug reporting For participation, contact and bug reporting, please see the main [Zonemaster README]. ## License This is free software under a 2-clause BSD license. The full text of the license can be found in the [LICENSE](LICENSE) file included in this respository. [Development documentation]: https://github.com/zonemaster/zonemaster/blob/master/docs/public/development/cli.md [Docker Image Creation]: https://github.com/zonemaster/zonemaster/blob/master/docs/internal/maintenance/ReleaseProcess-create-docker-image.md [Docker Hub]: https://hub.docker.com/u/zonemaster [Installation]: https://github.com/zonemaster/zonemaster/blob/master/docs/public/installation/zonemaster-cli.md [USING]: https://github.com/zonemaster/zonemaster/blob/master/docs/public/using/cli.md [Zonemaster-Engine installation]: https://github.com/zonemaster/zonemaster/blob/master/docs/public/installation/zonemaster-engine.md [Zonemaster README]: https://github.com/zonemaster/zonemaster/blob/master/README.md [Zonemaster repository]: https://github.com/zonemaster/zonemaster Zonemaster-CLI-v8.0.1/script/000755 001754 001754 00000000000 15121024076 016236 5ustar00matsdmatsd000000 000000 Zonemaster-CLI-v8.0.1/Makefile.PL000644 001754 001754 00000003356 15121024050 016703 0ustar00matsdmatsd000000 000000 use 5.014002; use strict; use warnings FATAL => 'all'; use inc::Module::Install; use ExtUtils::MakeMaker (); name 'Zonemaster-CLI'; all_from 'lib/Zonemaster/CLI.pm'; resources( repository => 'https://github.com/zonemaster/zonemaster-cli', bugtracker => 'https://github.com/zonemaster/zonemaster-cli/issues', ); tests_recursive( 't' ); # "2.1.0" could be declared as "2.001" but not as "2.1" # (see Zonemaster::LDNS below) requires( 'Readonly' => 0, 'Net::IP::XS' => 0, 'JSON::XS' => 0, 'Locale::TextDomain' => 1.23, 'Try::Tiny' => 0, 'Zonemaster::LDNS' => 5.000001, # v5.0.1 'Zonemaster::Engine' => 8.001000, # v8.1.0 ); test_requires( 'JSON::Validator' => 0, 'Test::Differences' => 0, ); # Make all platforms include inc/Module/Install/External.pm requires_external_bin 'find'; if ($^O eq "freebsd") { requires_external_bin 'gmake'; }; sub MY::postamble { my $pure_all; my $sharemakefile = 'share/GNUmakefile'; if ($^O eq "freebsd") { # Make FreeBSD use gmake for share $pure_all = "GMAKE ?= \"gmake\"\n" . "pure_all :: $sharemakefile\n" . "\tcd share && \$(GMAKE) all\n"; } else { # Here Linux and GNU Make is assumed $pure_all = "pure_all :: $sharemakefile\n" . "\tcd share && \$(MAKE) all\n"; }; my $docker = <<'END_DOCKER'; docker-build: docker build --tag zonemaster/cli:local --build-arg version=$(VERSION) . docker-tag-version: docker tag zonemaster/cli:local zonemaster/cli:$(VERSION) docker-tag-latest: docker tag zonemaster/cli:local zonemaster/cli:latest END_DOCKER return $pure_all . $docker; }; install_script 'zonemaster-cli'; install_share; WriteAll; Zonemaster-CLI-v8.0.1/CONTRIBUTING.md000644 001754 001754 00000002720 15121024026 017157 0ustar00matsdmatsd000000 000000 # Contributing to Zonemaster::CLI Contribution to this repository is welcome. Contribution can be either an issue report or a code or a documentation update. Also see the information in the [main README][Zonemaster/Zonemaster README] in the main Zonemaster respository. ## Issue First search for a similar issue in the [issues list]. If a relevant issue is found, add your information as a comment. If no relevant issue is found, create [a new issue][create issue]. Give as many details as you have and describe, if possible, how the issue can be reproduced. ## Pull request If you would like to contribute an update, first please look for issues and open [pull requests] that are about the same thing. If nothing relevant is found or you have a different solution, create [a new pull request][create pull request]. Creating a pull request assumes that you have your proposal in a fork repository. When you create a pull request, please always start with the `develop` branch and create the pull request against the same branch. [issues list]: https://github.com/zonemaster/zonemaster-cli/issues [create issue]: https://github.com/zonemaster/zonemaster-cli/issues/new [pull requests]: https://github.com/zonemaster/zonemaster-cli/pulls [create pull request]: https://github.com/zonemaster/zonemaster-cli/compare [Zonemaster/Zonemaster README]: https://github.com/zonemaster/zonemaster#readme Zonemaster-CLI-v8.0.1/Changes000644 001754 001754 00000027237 15121024050 016230 0ustar00matsdmatsd000000 000000 Release history for Zonemaster component Zonemaster-CLI v8.0.1 2025-12-17 (part of Zonemaster v2025.2 release) [Fixes] - This version has no changes besides requiring updated Zonemaster-LDNS and Zonemaster-Engine. v8.0.0 2025-06-26 (part of Zonemaster v2025.1 release) [Breaking changes] - Makes the --test option more flexible #359 [Features] - Expands the --nstimes option #421 - Expands the --count option #424 [Fixes] - Updates translations #444, #445 - Slows down the spinner a bit #419 v7.2.0 2025-03-04 (part of Zonemaster v2024.2.1 release) [Release information] - Translations have not been fully updated in this release. They will be updated in an upcoming extra release. [Features] - Adds translation to Slovenian language (#384) [Fixes] - Updates translations (#418, #425, #415, #422, #414) - Minor code cleanup (#420) - Fixes to make early messages not to be lost (#416) v7.1.0 2024-12-09 (part of Zonemaster v2024.2 release) [Release information] - Translations have not been fully updated in this release. They will be updated in an upcoming extra release. [Features] - Corrects display when running 'zonemaster-cli' with '--ns' or '--ds' (#382) - Allows explicitly setting '--stop-level' to empty string (#395) [Fixes] - Provides a useful link in man page (#401) - Write “AS” in uppercase in Dockerfile (#400) - Corrects gettext code (#398) - Organizes "zonemaster-cli --help" text (#389) - Make "zonemaster-cli" usage documentation consistent and also remove dependency on the Moose library (#371) - Fixes the handling of invalid --hints argument (#386) - Moves the "zonemaster-info" utility from this repository (#385) - Clean-up exit statuses (#381) v7.0.0 2024-07-01 (part of Zonemaster v2024.1 release) [Release information] - Translations have not been fully updated in this release. They will be updated in an upcoming release. [Breaking change] - Removes deprecated '--sourceaddr' option. Breaks custom 'cli.args' using this option. Use '--sourceaddr4' and '--sourceaddr6' instead. (#370) [Fixes] - Fixes command line argument handling of domain names (#365) - Speeds up Docker build (#374) v6.1.0 2024-03-18 (public release version) [Features] - Extends "--test" option to allow passing of test case only (#333) - Updates "--list_tests" option (#354) - Adds input name normalization (#357) [Fixes] - Fixes the "--raw" output (#360) v6.0.3 2023-09-08 (public fix version) [Fixes] - Fixes a spelling error (text) in the zonemaster-cli script (#351). - This version contains no real code changes, but it requires a higher (fixed) version of Zonemaster-Engine. v6.0.2 2023-08-07 (public fix version) [Fixes] - This version contains no real changes. It has been created to require a higher (fixed) version of Zonemaster-Engine. v6.0.1 2023-07-24 (public fix version) [Fixes] - Updates the translation to Norwegian (#342) v6.0.0 2023-06-21 (public release version) [Breaking changes] - Adds display of Zonemaster::LDNS and libldns versions when --version has been selected (#306) [Features] - Updates various report options to zonemaster-cli script (#318, #337, #309, #308) - Adds options "--sourceaddr4" and "--sourceaddr6" to zonemaster-cli script (#317) [Fixes] - Updates translations (#338, #328, #329, #331, #327, #322) - Updates documentation in zonemaster-cli script (#336) - Fixes table layout in zonemaster-cli output (#335) - Removes documentation moved to the zonemaster/zonemaster repository (#332) - Removes some untranslatable characters from msgids (#307) v5.0.2 2023-03-01 (public fix version) [Fixes] - Updates translations (#303) v5.0.1 2023-01-31 (public fix version) [Fixes] - Updates translations (#298, #297) v5.0.0 2022-12-19 (public release version) [Breaking changes] - Makes zonemaster-cli fail if there are multiple domain names in entry (#287, #286) [Features] - Adds --hints option (#284, #293, #292) [Fixes] - Updates installation instruction (#291, #289) - Corrects the license statement in CLI.pm (#288) - Sets lowercase fragments to refer to internal headings in markdown documents (#282) - Cleans-up unused import (#283) - Adds Mac note on USING.md when it comes to Docker (#281) v4.0.1 2022-07-08 (public fix version) [Fixes] - Adds missing installation instructions for CentOS Linux 7 (#275) - Updates translation to Danish (#271) v4.0.0 2022-06-09 (public release version) [Breaking changes] - Updates how trailing dots of domain name or name server name is handled. Trailing double dot is now always an error. (#253) [Features] - Uses pre-built packages for ubuntu (#268) - Adds support for global configuration file (#260, #252) [Fixes] - Updates translation (#263, #267, #266, #265, #269, #264, #261) - Fixes a bug where a trailing dot on name server name gives a crash (#253) - Fixes warning message (#255) - Uses libidn2 instead of libidn (#254) - Updates documentation for users (#241, #244) - Updates installation document (#243) v3.2.0 2021-12-20 (public fix version) [Features] - Adds translation to Spanish language (#219) [Fixes] - Clarifies IPv6 limitations in Docker (#238) - Updates Danish translation (#236, #233) - Updates French translation (#237, #225) v3.1.1 2021-12-03 (public release version) [Features] - Deb packages are available for Debian (#233) - Adds support for Docker (#221, #218, #216) - Replaces CentOS with Rocky Linux (#220) [Fixes] - Updates Finnish translation (#230, #224) - Updates Norwegian translation (#228, #226) - Updates Swedish translation (#227) - Updates dependencies (#217) - Improves DEBUG3 output (#215, #111) - Improves output when option is incorrect (#214, #160) - Clean-up removing unused options (#213, #145) - More user-friendly options (#212, #159) v3.1.0 2021-05-28 (public release version) [Features] - Adds Finnish translation (PO file) (#192, #191) [Fixes] - Updates the installation instructions (#193, #191) - Updates translations (#204, #201, #205, #200, #207, #202) v3.0.4 2021-02-10 (public release version) [Features] - Updates --raw mode output in debug level (#113) [Fixes] - Updates the installation instructions (#188) - Prevents PO files to be updated unintentionally (#186) - Fixes how command line options of profile and IP interact (#185, #183, #182) - Makes --sourceaddr behavior more reasonable when selected address is not reasonable (#110, #38) v3.0.3 (never released) v3.0.2 (never released) v3.0.1 2020-11-09 (public release version) [Fixes] - Fixed an version specification error in Makefile.PL (#178) v3.0.0 2020-11-06 (public release version) [Breaking changes] - Added "--show_testcase" and changed format when "--raw" is selected (#157) [Features] - Added Norwegian language support to match added translation to Norwegian in Zonemaster-Engine (#164, #155, #161) [Fixes] - Updated/corrected translations/PO files (#174, #173) - Corrected documentation (#172) - Rename share/Makefile to share/GNUmakefile and create wrapper for FreeBSD. Make FreeBSD use gmake for share/GNUmakefile (#169) - Corrected MANIFEST (#168) - Updated share/Makefile (#167) - Clean-up (#166, #158) - Correcting --nstimes option (#163, #148) - Updated translation/PO files handling (#151, #132, #147, #150, #149) v2.0.4 2020-05-22 [Fixes] - Bumping the version of Zonemaster::CLI to be able to upload a new package to CPAN to avoid the confusion that the version v2.0.3.1 created. There are no changes compared to v2.0.3. v2.0.3.1 2020-05-15 [Fixes] - This release fixes inconsitency between the branches in the repository. See the release notes for v2.0.3 for the real changes. - There is no change in data so this release has not been published on CPAN. v2.0.3 2020-04-30 [Features] - (none) [Fixes] - Update installation instructions (#119, #117, #137) - Translation into Danish (#109, #61) v2.0.2 2019-05-31 (public fix version) [Fixes] - Corrects in Makefile.PL the versions of Zonemaster::Engine and Zonemaster::LDNS that this version of Zonemaster::CLI depends on (#105) v2.0.1 2019-05-22 (public release version) [Status] - This a public release fully tested before release. This version will be available on CPAN. [Fixes] - Updated installation instructions for FreeBSD (#101) - Dropped support for Ubuntu 14.04 (#99) - Made Travis use the equivalent branch in Zonemaster-Engine (#98) v2.0.0 2019-01-25 (pre-release version) - Status - This is a pre-release version not fully tested on all supported OS's and Perl versions. This version will not be available on CPAN. - API change - Replaced separate config and policy with a unified profile (see below) - Some changes in printout that can affect scripts using zonemaster-cli (see below) - Features - Changes in printout - Print information on STDERR if --json has been selected #84 - Diagnostics #85 - Only show spinner in human readable output mode #86 - Make --level and --stop_level case-insensitive #87 - Replaced separate config and policy with a unified profile - Removed config and policy and added profile #70, #93 - Fixes - All link references on Github now to zonemaster/zonemaster instead of old dotse/zonemaster #81 - Clarify documentation of --progress option #88 - Travis tests against develop branch of Zonemaster-Engine instead of fetching from CPAN #92 - Update travis configuration when it comes to Perl versions. #95 v1.1.3 2018-06-25 Fixed: - Move license from Makefile.PL to main module (#67) - Initialize gettext according to gettext documentation (#71), which solves issues with translations in Linux (#46) and FreeBSD (#64) - Updated the install instructions for debian and centos (#75) - Update Installation.md for FreeBSD (uses cpan instead of cpanm) (#78) v1.1.2 2018-01-12 Natural Language support: - Adding support for Danish translation. (#62) Fixed: - Fixes issues with pre-delegation testing ("fake delegation") (#63) v1.1.1 2017-11-02 Public release Fixed: - Update licensing (#58) - Specify smallest version of Locale::TextDomain i Makefile.PL. (#57) - Updated installation instruction (#53) - Changed dependency from Net::LDNS to Zonemaster::LDNS due to name space change (#51) - Various updates to packaging (#52) - Fix Commonmark rendering on Github. Replace NBSP with SPACE. (#49) - Changed dependency from Zonemaster to Zonemaster::Engine due to name space change (#43) v1.1.0 2017-04-04 Public pre-release - This release will not be published on CPAN since it contains updates that have not been fully tested. Do not update production systems without verification. - Update install instructions (#34) - Fixes packaging issue with version numbering (#35) - Solved --sourceaddr is not correctly implemented (#36) - Updates so that "fake delegation" is tested correctly (#42) 1.0.5 2016-10-14 - Correcting version in CLI.pm. Update missing in 1.0.4. 1.0.4 2016-10-14 - Updating README.md and USING.md - Better way to check ExtUtils::MakeMaker version - Introduced MANIFEST.SKIP 1.0.3 2015-12-22 - Added JSON streaming - Changed all instances from .SE to IIS 1.0.2 2015-06-25 - Allow lookup of nameservers for undelegated tests - Net::LDNS::to_idn() takes Perl characters, not octets with utf-8 data - Fixed display bug when using --nstimes with --no-ipv6 or --no-ipv4 1.0.1 2015-04-07 - State clearly that a given name is not a domain when it is not a domain - Send "Net::LDNS not compiled with libidn" to STDERR, not STDOUT 1.0.0 2014-12-11 Release version 1.000000 2014-12-11 Public beta release. 0.001002 2014-11-26 0.001001 2014-11-19 0.001000 2014-11-17 0.03 2014-10-30 0.01 2014-05-25 - initial CPAN release Zonemaster-CLI-v8.0.1/META.yml000644 001754 001754 00000001613 15121024073 016201 0ustar00matsdmatsd000000 000000 --- abstract: 'run Zonemaster tests from the command line' author: - 'Vincent Levigneron ' build_requires: ExtUtils::MakeMaker: 6.59 JSON::Validator: 0 Test::Differences: 0 configure_requires: ExtUtils::MakeMaker: 6.59 distribution_type: module dynamic_config: 1 generated_by: 'Module::Install version 1.21' license: bsd meta-spec: url: http://module-build.sourceforge.net/META-spec-v1.4.html version: 1.4 name: Zonemaster-CLI no_index: directory: - inc - share - t requires: JSON::XS: 0 Locale::TextDomain: 1.23 Net::IP::XS: 0 Readonly: 0 Try::Tiny: 0 Zonemaster::Engine: 8.001 Zonemaster::LDNS: 5.000001 perl: 5.26.0 resources: bugtracker: https://github.com/zonemaster/zonemaster-cli/issues license: http://opensource.org/licenses/bsd-license.php repository: https://github.com/zonemaster/zonemaster-cli version: '8.000001' Zonemaster-CLI-v8.0.1/LICENSE000644 001754 001754 00000003561 15121024026 015737 0ustar00matsdmatsd000000 000000 ### Code license Copyright (c) The Swedish Internet Foundation () Copyright (c) AFNIC () All rights reserved. Copyright belongs to external contributor where applicable. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. ### Documentation license Copyright (c) The Swedish Internet Foundation () Copyright (c) AFNIC () All rights reserved. Copyright belongs to external contributor where applicable. Creative Commons Attribution 4.0 International License You should have received a copy of the license along with this work. If not, see . Zonemaster-CLI-v8.0.1/script/zonemaster-cli000755 001754 001754 00000027331 15121024026 021121 0ustar00matsdmatsd000000 000000 #!/usr/bin/env perl use 5.14.2; use warnings; use Zonemaster::CLI; use File::Spec; use autodie; sub read_conf_file { # Returns list of command line parameters. List can be empty. my ( $conf_file ) = @_; my @lines; open my $fh, '<', $conf_file; while ( <$fh> ) { chomp; next if /^\s*$/; next if /^\s*#/; push @lines, $_; } return @lines; } # Load default arguments from file in home directory, if any # This must be loaded before any global file to make the local # file take precedence my $home_dir = ( ( getpwuid( $< ) )[7] ) || $ENV{HOME}; my $home_conf_file = File::Spec->catfile( $home_dir, '.zonemaster', 'cli.args' ); if ( -r $home_conf_file ) { my @lines = read_conf_file( $home_conf_file ); unshift @ARGV, @lines; } # Load default arguments from global file, if any my @global_conf = ( '/etc/zonemaster/cli.args', '/usr/local/etc/zonemaster/cli.args' ); # Order is significant. my $global_conf_file; for my $p ( @global_conf ) { if ( -e $p and -r $p ) { $global_conf_file = $p; last; } } if ( defined $global_conf_file ) { my @lines = read_conf_file( $global_conf_file ); unshift @ARGV, @lines; } eval { my $exitstatus = Zonemaster::CLI->run( @ARGV ); exit $exitstatus; }; print STDERR $@; exit $Zonemaster::CLI::EXIT_GENERIC_ERROR; =head1 NAME zonemaster-cli - run Zonemaster tests from the command line =head1 SYNOPSIS zonemaster-cli [--help | --version | --list-tests] zonemaster-cli [OPTIONS] --dump-profile zonemaster-cli [OPTIONS] DOMAINNAME =head1 DESCRIPTION L is a command-line interface to the Zonemaster test engine. It takes instructions the user provides as command line arguments, transforms them into suitable API calls to the engine, runs the test suite and prints the resulting messages. By default, the messages will be translated by the engine's translation module, with the corresponding timestamp and logging level when printed. See the available options below. =head1 OPTIONS =head2 Special Options =over 4 =item B<-h>, B<--help> Print brief usage information and exit. (run `man zonemaster-cli` for the full manual page) =item B<--version> Print version information and exit. =for :man The printed version numbers are the versions of this program as well as the ones from the underlying Zonemaster test engine. =item B<--list-tests> Print all test cases listed in the test modules, then exit. =item B<--dump-profile> Print the effective profile used in JSON format, then exit. =back =head2 Testing Options =over 4 =item B<--test>=EXPR Specify which test cases to run by setting the C property in the profile. The EXPR is a flexible expression consisting of terms (individual test cases, test modules, or all) and operators (C<+> to add, C<-> to remove). For details, see C. =begin :man An EXPR starting with a term (e.g., C, C) I the current selection. An EXPR starting with an operator (C<+> or C<->) I the current selection. An empty EXPR (C<--test=>) does not modify the selection (i.e., it is a no-op). Multiple C<--test> options may be specified; they are applied in the order they are given. When used together with the C<--profile>, the profile option is applied first. Use C<--list-tests> to list all test cases and test modules in the default profile. Examples: =over 4 =item --test=B selects all test cases in the default profile, i.e. overrides any custom profile. =item --test=B selects all test cases in the Nameserver test module in the default profile. =item --test=B selects only the Nameserver01 test case. =item --test=B selects all DNSSEC test cases except DNSSEC05. =item --test=B selects all test cases, excludes the Nameserver test cases, and adds back Nameserver03. =item --test=B<-dnssec> removes all DNSSEC test cases from the selection. =item --test=B<+syntax01+syntax02> adds the Syntax01 and Syntax02 test cases to the selection. =item --test= empty value is valid, but does not change the selection of test cases Specifying C<--test=> without an argument is a no-op. Having this possibility may come in handy when invoking zonemaster-cli from scripts. =back =end :man =item B<--level>=LEVEL Specify the minimum level of a message to be printed. (default: NOTICE) =for :man Messages with this level (or higher) will be printed. The levels are, from highest to lowest: CRITICAL, ERROR, WARNING, NOTICE, INFO, DEBUG, DEBUG2 and DEBUG3. The lowest three levels (DEBUG) add a significant amount of messages to be shown. They reveal some of the internal workings of the test engine, and are probably not useful for most users. =begin :man =item B<--stop-level>=LEVEL Specify the minimum severity level after which the testing suite is terminated. (default: the empty string) =for :man When set to the empty string, testing is allowed to complete normally no matter what messages are emitted. =for :man The levels are, from highest to lowest: CRITICAL, ERROR, WARNING, NOTICE, INFO, DEBUG, DEBUG2 and DEBUG3. =end :man =item B<--[no-]progress> Print an activity indicator ("spinner"). (default: enabled if the process' standard output is a TTY) =for :man Useful to know that something is happening during a run. =item B<--[no-]ipv4>, B<--[no-]ipv6> Enable or disable queries over IPv4 or IPv6. (default: both enabled) =begin :man =item B<--sourceaddr4>=IPADDR, B<--sourceaddr6>=IPADDR Set IPv4 or IPv6 source address for DNS queries. =for :man Setting an address not correctly configured on a local network interface fails silently. =end :man =item B<--profile>=FILE Override the Zonemaster Engine default profile data with values from the given profile JSON file. =back =head2 Formatting Options =over 4 =item B<--[no-]json> Print results as JSON instead of human language. (default: disabled) =begin :man =item B<--[no-]json-stream> Stream the results as JSON. (default: disabled) =for :man Useful to follow the progress in a machine-readable way. =item B<--[no-]raw> Print messages as raw dumps (message identifiers) instead of translating them to human language. =end :man =item B<--locale>=LOCALE Specify which locale to be used by the translation system. (default: system locale or English) =for :man If not given, the translation system itself will look at environment variables to try and guess. If the requested translation does not exist, it will fall back to the local locale, and if that does not exist either, to English. =begin :man =item B<--[no-]time> Print the timestamp for each message. (default: enabled) =item B<--[no-]show-level> Print the severity level for each message. (default: enabled) =item B<--[no-]show-module> Print the name of the module which produced the message. (default: disabled) =item B<--[no-]show-testcase> Print the name of the test case (test case identifier) which produced the message. (default: disabled) =end :man =back =begin :man =head2 Summary Options =over 4 =item B<--[no-]count> Print a summary, at the end of a run, of the numbers of messages for each severity level that were logged during the run, as well as a count of each message tag. (default: disabled) =item B<--[no-]nstimes> Print a summary, at the end of a run, of various metrics related to the times (in milliseconds) each name server took to answer, as well as a count of the number of sent queries per name server. (default: disabled) =item B<--[no-]elapsed> Print elapsed time (in seconds) at end of a run. (default: disabled) =back =head2 Undelegated Test Options =over 4 =item B<--ns>=DOMAINNAME, B<--ns>=DOMAINNAME/IPADDR Provide information about a nameserver, for undelegated tests. =for :man The argument must be either: (i) a domain name and an IP address, separated by a single slash character (/), or (ii) only a domain name, in which case a A and AAAA records lookup for that name is done in the live global DNS tree (unless overridden by --hints) and from which the results of that lookup will be used. =for :man This switch can be given multiple times. As long as any of these switches are present, their aggregated content will be used as the entirety of the parent-side delegation information. =item B<--ds>=KEYTAG,ALGORITHM,TYPE,DIGEST Provide a DS record for undelegated testing (that is, a test where the delegating nameserver information is given via --ns switches). =for :man The four pieces of data (keytag, algorithm, type, digest) should be in the same format they would have in a zone file. =item B<--hints>=FILE Name of a root hints file to override the defaults. =back =head2 Cache Options =over 4 =item B<--save>=FILE Write the contents of the accumulated DNS packet cache to a file with the given name after the testing suite has finished running. =item B<--restore>=FILE Prime the DNS packet cache with the contents from the file with the given name before starting the testing suite. =for :man The format of the file should be from one produced by the --save switch. =back =head2 Deprecated Options =over 4 =item B<--encoding>=ENCODING Deprecated: Simply remove it from your usage. It is ignored. =item B<--[no-]json-translate> Deprecated since v2023.1, use --no-raw instead. =for :man For streaming JSON output, include the translated message of the tag. =back =head2 Option Aliases These options are provided for compatibility with older scripts. The first two are aliases for C<--help>. The rest are aliases for their namesakes spelled with dash C<-> instead of underscore C<_>. =over 4 =item B<-?> =item B<--usage> =item B<--dump_profile> =item B<--[no-]json_stream> =item B<--[no-]json_translate> =item B<--list_tests> =item B<--[no-]show_level> =item B<--[no-]show_module> =item B<--[no-]show_testcase> =item B<--stop_level>=LEVEL =back =end :man =head1 EXAMPLES zonemaster-cli zonemaster.net zonemaster-cli --test=delegation --level=info --no-time zonemaster.net zonemaster-cli --test=delegation01 --level=debug zonemaster.net zonemaster-cli --list-tests =head1 PROFILES The testing and result analysis performed by Zonemaster Engine is always guided by a profile. Zonemaster Engine has a default profile with sensible defaults. Zonemaster CLI allows users to override the default profile data with values from a profile JSON file with the C<--profile> option. For details on profiles and how they are represented in files, see L. =head1 CONFIGURATION If there is a readable file F (Linux style), each line in that file will be prepended as an argument on the command line. If no F is found (or is not readable) but F (FreeBSD style) is found and readable then that file will be used instead. Only one global file is loaded. If there is a readable file F<.zonemaster/cli.args> in the user's home directory, it will be used in the same way even when a global file has been loaded. Any argument in user's F will override the same argument in the global config file. For example, if one would like to by default run with the log level set to DEBUG and with translation to human-readable messages turned off, one could put this in the config file: --raw --level=DEBUG Only one argument per line. If the argument has a value there must be a "=" between argument and value. A line starting with "#" is a comment. Comments cannot be added on lines with arguments. Any arguments actually given on the command line will override what is in any of the loaded config files. =head1 SEE ALSO More complete documentation on Zonemaster and its tests can be found on L. =head1 AUTHOR Calle Dybedahl and others from the Zonemaster project Zonemaster-CLI-v8.0.1/inc/Module/000755 001754 001754 00000000000 15121024076 016730 5ustar00matsdmatsd000000 000000 Zonemaster-CLI-v8.0.1/inc/Module/Install/000755 001754 001754 00000000000 15121024076 020336 5ustar00matsdmatsd000000 000000 Zonemaster-CLI-v8.0.1/inc/Module/Install.pm000644 001754 001754 00000027145 15121024073 020702 0ustar00matsdmatsd000000 000000 #line 1 package Module::Install; # For any maintainers: # The load order for Module::Install is a bit magic. # It goes something like this... # # IF ( host has Module::Install installed, creating author mode ) { # 1. Makefile.PL calls "use inc::Module::Install" # 2. $INC{inc/Module/Install.pm} set to installed version of inc::Module::Install # 3. The installed version of inc::Module::Install loads # 4. inc::Module::Install calls "require Module::Install" # 5. The ./inc/ version of Module::Install loads # } ELSE { # 1. Makefile.PL calls "use inc::Module::Install" # 2. $INC{inc/Module/Install.pm} set to ./inc/ version of Module::Install # 3. The ./inc/ version of Module::Install loads # } use 5.006; use strict 'vars'; use Cwd (); use File::Find (); use File::Path (); use vars qw{$VERSION $MAIN}; BEGIN { # All Module::Install core packages now require synchronised versions. # This will be used to ensure we don't accidentally load old or # different versions of modules. # This is not enforced yet, but will be some time in the next few # releases once we can make sure it won't clash with custom # Module::Install extensions. $VERSION = '1.21'; # Storage for the pseudo-singleton $MAIN = undef; *inc::Module::Install::VERSION = *VERSION; @inc::Module::Install::ISA = __PACKAGE__; } sub import { my $class = shift; my $self = $class->new(@_); my $who = $self->_caller; #------------------------------------------------------------- # all of the following checks should be included in import(), # to allow "eval 'require Module::Install; 1' to test # installation of Module::Install. (RT #51267) #------------------------------------------------------------- # Whether or not inc::Module::Install is actually loaded, the # $INC{inc/Module/Install.pm} is what will still get set as long as # the caller loaded module this in the documented manner. # If not set, the caller may NOT have loaded the bundled version, and thus # they may not have a MI version that works with the Makefile.PL. This would # result in false errors or unexpected behaviour. And we don't want that. my $file = join( '/', 'inc', split /::/, __PACKAGE__ ) . '.pm'; unless ( $INC{$file} ) { die <<"END_DIE" } Please invoke ${\__PACKAGE__} with: use inc::${\__PACKAGE__}; not: use ${\__PACKAGE__}; END_DIE # This reportedly fixes a rare Win32 UTC file time issue, but # as this is a non-cross-platform XS module not in the core, # we shouldn't really depend on it. See RT #24194 for detail. # (Also, this module only supports Perl 5.6 and above). eval "use Win32::UTCFileTime" if $^O eq 'MSWin32' && $] >= 5.006; # If the script that is loading Module::Install is from the future, # then make will detect this and cause it to re-run over and over # again. This is bad. Rather than taking action to touch it (which # is unreliable on some platforms and requires write permissions) # for now we should catch this and refuse to run. if ( -f $0 ) { my $s = (stat($0))[9]; # If the modification time is only slightly in the future, # sleep briefly to remove the problem. my $a = $s - time; if ( $a > 0 and $a < 5 ) { sleep 5 } # Too far in the future, throw an error. my $t = time; if ( $s > $t ) { die <<"END_DIE" } Your installer $0 has a modification time in the future ($s > $t). This is known to create infinite loops in make. Please correct this, then run $0 again. END_DIE } # Build.PL was formerly supported, but no longer is due to excessive # difficulty in implementing every single feature twice. if ( $0 =~ /Build.PL$/i ) { die <<"END_DIE" } Module::Install no longer supports Build.PL. It was impossible to maintain duel backends, and has been deprecated. Please remove all Build.PL files and only use the Makefile.PL installer. END_DIE #------------------------------------------------------------- # To save some more typing in Module::Install installers, every... # use inc::Module::Install # ...also acts as an implicit use strict. $^H |= strict::bits(qw(refs subs vars)); #------------------------------------------------------------- unless ( -f $self->{file} ) { foreach my $key (keys %INC) { delete $INC{$key} if $key =~ /Module\/Install/; } local $^W; require "$self->{path}/$self->{dispatch}.pm"; File::Path::mkpath("$self->{prefix}/$self->{author}"); $self->{admin} = "$self->{name}::$self->{dispatch}"->new( _top => $self ); $self->{admin}->init; @_ = ($class, _self => $self); goto &{"$self->{name}::import"}; } local $^W; *{"${who}::AUTOLOAD"} = $self->autoload; $self->preload; # Unregister loader and worker packages so subdirs can use them again delete $INC{'inc/Module/Install.pm'}; delete $INC{'Module/Install.pm'}; # Save to the singleton $MAIN = $self; return 1; } sub autoload { my $self = shift; my $who = $self->_caller; my $cwd = Cwd::getcwd(); my $sym = "${who}::AUTOLOAD"; $sym->{$cwd} = sub { my $pwd = Cwd::getcwd(); if ( my $code = $sym->{$pwd} ) { # Delegate back to parent dirs goto &$code unless $cwd eq $pwd; } unless ($$sym =~ s/([^:]+)$//) { # XXX: it looks like we can't retrieve the missing function # via $$sym (usually $main::AUTOLOAD) in this case. # I'm still wondering if we should slurp Makefile.PL to # get some context or not ... my ($package, $file, $line) = caller; die <<"EOT"; Unknown function is found at $file line $line. Execution of $file aborted due to runtime errors. If you're a contributor to a project, you may need to install some Module::Install extensions from CPAN (or other repository). If you're a user of a module, please contact the author. EOT } my $method = $1; if ( uc($method) eq $method ) { # Do nothing return; } elsif ( $method =~ /^_/ and $self->can($method) ) { # Dispatch to the root M:I class return $self->$method(@_); } # Dispatch to the appropriate plugin unshift @_, ( $self, $1 ); goto &{$self->can('call')}; }; } sub preload { my $self = shift; unless ( $self->{extensions} ) { $self->load_extensions( "$self->{prefix}/$self->{path}", $self ); } my @exts = @{$self->{extensions}}; unless ( @exts ) { @exts = $self->{admin}->load_all_extensions; } my %seen; foreach my $obj ( @exts ) { while (my ($method, $glob) = each %{ref($obj) . '::'}) { next unless $obj->can($method); next if $method =~ /^_/; next if $method eq uc($method); $seen{$method}++; } } my $who = $self->_caller; foreach my $name ( sort keys %seen ) { local $^W; *{"${who}::$name"} = sub { ${"${who}::AUTOLOAD"} = "${who}::$name"; goto &{"${who}::AUTOLOAD"}; }; } } sub new { my ($class, %args) = @_; delete $INC{'FindBin.pm'}; { # to suppress the redefine warning local $SIG{__WARN__} = sub {}; require FindBin; } # ignore the prefix on extension modules built from top level. my $base_path = Cwd::abs_path($FindBin::Bin); unless ( Cwd::abs_path(Cwd::getcwd()) eq $base_path ) { delete $args{prefix}; } return $args{_self} if $args{_self}; $base_path = VMS::Filespec::unixify($base_path) if $^O eq 'VMS'; $args{dispatch} ||= 'Admin'; $args{prefix} ||= 'inc'; $args{author} ||= ($^O eq 'VMS' ? '_author' : '.author'); $args{bundle} ||= 'inc/BUNDLES'; $args{base} ||= $base_path; $class =~ s/^\Q$args{prefix}\E:://; $args{name} ||= $class; $args{version} ||= $class->VERSION; unless ( $args{path} ) { $args{path} = $args{name}; $args{path} =~ s!::!/!g; } $args{file} ||= "$args{base}/$args{prefix}/$args{path}.pm"; $args{wrote} = 0; bless( \%args, $class ); } sub call { my ($self, $method) = @_; my $obj = $self->load($method) or return; splice(@_, 0, 2, $obj); goto &{$obj->can($method)}; } sub load { my ($self, $method) = @_; $self->load_extensions( "$self->{prefix}/$self->{path}", $self ) unless $self->{extensions}; foreach my $obj (@{$self->{extensions}}) { return $obj if $obj->can($method); } my $admin = $self->{admin} or die <<"END_DIE"; The '$method' method does not exist in the '$self->{prefix}' path! Please remove the '$self->{prefix}' directory and run $0 again to load it. END_DIE my $obj = $admin->load($method, 1); push @{$self->{extensions}}, $obj; $obj; } sub load_extensions { my ($self, $path, $top) = @_; my $should_reload = 0; unless ( grep { ! ref $_ and lc $_ eq lc $self->{prefix} } @INC ) { unshift @INC, $self->{prefix}; $should_reload = 1; } foreach my $rv ( $self->find_extensions($path) ) { my ($file, $pkg) = @{$rv}; next if $self->{pathnames}{$pkg}; local $@; my $new = eval { local $^W; require $file; $pkg->can('new') }; unless ( $new ) { warn $@ if $@; next; } $self->{pathnames}{$pkg} = $should_reload ? delete $INC{$file} : $INC{$file}; push @{$self->{extensions}}, &{$new}($pkg, _top => $top ); } $self->{extensions} ||= []; } sub find_extensions { my ($self, $path) = @_; my @found; File::Find::find( {no_chdir => 1, wanted => sub { my $file = $File::Find::name; return unless $file =~ m!^\Q$path\E/(.+)\.pm\Z!is; my $subpath = $1; return if lc($subpath) eq lc($self->{dispatch}); $file = "$self->{path}/$subpath.pm"; my $pkg = "$self->{name}::$subpath"; $pkg =~ s!/!::!g; # If we have a mixed-case package name, assume case has been preserved # correctly. Otherwise, root through the file to locate the case-preserved # version of the package name. if ( $subpath eq lc($subpath) || $subpath eq uc($subpath) ) { my $content = Module::Install::_read($File::Find::name); my $in_pod = 0; foreach ( split /\n/, $content ) { $in_pod = 1 if /^=\w/; $in_pod = 0 if /^=cut/; next if ($in_pod || /^=cut/); # skip pod text next if /^\s*#/; # and comments if ( m/^\s*package\s+($pkg)\s*;/i ) { $pkg = $1; last; } } } push @found, [ $file, $pkg ]; }}, $path ) if -d $path; @found; } ##################################################################### # Common Utility Functions sub _caller { my $depth = 0; my $call = caller($depth); while ( $call eq __PACKAGE__ ) { $depth++; $call = caller($depth); } return $call; } sub _read { local *FH; open( FH, '<', $_[0] ) or die "open($_[0]): $!"; binmode FH; my $string = do { local $/; }; close FH or die "close($_[0]): $!"; return $string; } sub _readperl { my $string = Module::Install::_read($_[0]); $string =~ s/(?:\015{1,2}\012|\015|\012)/\n/sg; $string =~ s/(\n)\n*__(?:DATA|END)__\b.*\z/$1/s; $string =~ s/\n\n=\w+.+?\n\n=cut\b.+?\n+/\n\n/sg; return $string; } sub _readpod { my $string = Module::Install::_read($_[0]); $string =~ s/(?:\015{1,2}\012|\015|\012)/\n/sg; return $string if $_[0] =~ /\.pod\z/; $string =~ s/(^|\n=cut\b.+?\n+)[^=\s].+?\n(\n=\w+|\z)/$1$2/sg; $string =~ s/\n*=pod\b[^\n]*\n+/\n\n/sg; $string =~ s/\n*=cut\b[^\n]*\n+/\n\n/sg; $string =~ s/^\n+//s; return $string; } sub _write { local *FH; open( FH, '>', $_[0] ) or die "open($_[0]): $!"; binmode FH; foreach ( 1 .. $#_ ) { print FH $_[$_] or die "print($_[0]): $!"; } close FH or die "close($_[0]): $!"; } # _version is for processing module versions (eg, 1.03_05) not # Perl versions (eg, 5.8.1). sub _version { my $s = shift || 0; my $d =()= $s =~ /(\.)/g; if ( $d >= 2 ) { # Normalise multipart versions $s =~ s/(\.)(\d{1,3})/sprintf("$1%03d",$2)/eg; } $s =~ s/^(\d+)\.?//; my $l = $1 || 0; my @v = map { $_ . '0' x (3 - length $_) } $s =~ /(\d{1,3})\D?/g; $l = $l . '.' . join '', @v if @v; return $l + 0; } sub _cmp { _version($_[1]) <=> _version($_[2]); } # Cloned from Params::Util::_CLASS sub _CLASS { ( defined $_[0] and ! ref $_[0] and $_[0] =~ m/^[^\W\d]\w*(?:::\w+)*\z/s ) ? $_[0] : undef; } 1; # Copyright 2008 - 2012 Adam Kennedy. Zonemaster-CLI-v8.0.1/inc/Module/Install/Fetch.pm000644 001754 001754 00000004627 15121024073 021733 0ustar00matsdmatsd000000 000000 #line 1 package Module::Install::Fetch; use strict; use Module::Install::Base (); use vars qw{$VERSION @ISA $ISCORE}; BEGIN { $VERSION = '1.21'; @ISA = 'Module::Install::Base'; $ISCORE = 1; } sub get_file { my ($self, %args) = @_; my ($scheme, $host, $path, $file) = $args{url} =~ m|^(\w+)://([^/]+)(.+)/(.+)| or return; if ( $scheme eq 'http' and ! eval { require LWP::Simple; 1 } ) { $args{url} = $args{ftp_url} or (warn("LWP support unavailable!\n"), return); ($scheme, $host, $path, $file) = $args{url} =~ m|^(\w+)://([^/]+)(.+)/(.+)| or return; } $|++; print "Fetching '$file' from $host... "; unless (eval { require Socket; Socket::inet_aton($host) }) { warn "'$host' resolve failed!\n"; return; } return unless $scheme eq 'ftp' or $scheme eq 'http'; require Cwd; my $dir = Cwd::getcwd(); chdir $args{local_dir} or return if exists $args{local_dir}; if (eval { require LWP::Simple; 1 }) { LWP::Simple::mirror($args{url}, $file); } elsif (eval { require Net::FTP; 1 }) { eval { # use Net::FTP to get past firewall my $ftp = Net::FTP->new($host, Passive => 1, Timeout => 600); $ftp->login("anonymous", 'anonymous@example.com'); $ftp->cwd($path); $ftp->binary; $ftp->get($file) or (warn("$!\n"), return); $ftp->quit; } } elsif (my $ftp = $self->can_run('ftp')) { eval { # no Net::FTP, fallback to ftp.exe require FileHandle; my $fh = FileHandle->new; local $SIG{CHLD} = 'IGNORE'; unless ($fh->open("|$ftp -n")) { warn "Couldn't open ftp: $!\n"; chdir $dir; return; } my @dialog = split(/\n/, <<"END_FTP"); open $host user anonymous anonymous\@example.com cd $path binary get $file $file quit END_FTP foreach (@dialog) { $fh->print("$_\n") } $fh->close; } } else { warn "No working 'ftp' program available!\n"; chdir $dir; return; } unless (-f $file) { warn "Fetching failed: $@\n"; chdir $dir; return; } return if exists $args{size} and -s $file != $args{size}; system($args{run}) if exists $args{run}; unlink($file) if $args{remove}; print(((!exists $args{check_for} or -e $args{check_for}) ? "done!" : "failed! ($!)"), "\n"); chdir $dir; return !$?; } 1; Zonemaster-CLI-v8.0.1/inc/Module/Install/WriteAll.pm000644 001754 001754 00000002376 15121024073 022424 0ustar00matsdmatsd000000 000000 #line 1 package Module::Install::WriteAll; use strict; use Module::Install::Base (); use vars qw{$VERSION @ISA $ISCORE}; BEGIN { $VERSION = '1.21'; @ISA = qw{Module::Install::Base}; $ISCORE = 1; } sub WriteAll { my $self = shift; my %args = ( meta => 1, sign => 0, inline => 0, check_nmake => 1, @_, ); $self->sign(1) if $args{sign}; $self->admin->WriteAll(%args) if $self->is_admin; $self->check_nmake if $args{check_nmake}; unless ( $self->makemaker_args->{PL_FILES} ) { # XXX: This still may be a bit over-defensive... unless ($self->makemaker(6.25)) { $self->makemaker_args( PL_FILES => {} ) if -f 'Build.PL'; } } # Until ExtUtils::MakeMaker support MYMETA.yml, make sure # we clean it up properly ourself. $self->realclean_files('MYMETA.yml'); if ( $args{inline} ) { $self->Inline->write; } else { $self->Makefile->write; } # The Makefile write process adds a couple of dependencies, # so write the META.yml files after the Makefile. if ( $args{meta} ) { $self->Meta->write; } # Experimental support for MYMETA if ( $ENV{X_MYMETA} ) { if ( $ENV{X_MYMETA} eq 'JSON' ) { $self->Meta->write_mymeta_json; } else { $self->Meta->write_mymeta_yaml; } } return 1; } 1; Zonemaster-CLI-v8.0.1/inc/Module/Install/Win32.pm000644 001754 001754 00000003403 15121024073 021573 0ustar00matsdmatsd000000 000000 #line 1 package Module::Install::Win32; use strict; use Module::Install::Base (); use vars qw{$VERSION @ISA $ISCORE}; BEGIN { $VERSION = '1.21'; @ISA = 'Module::Install::Base'; $ISCORE = 1; } # determine if the user needs nmake, and download it if needed sub check_nmake { my $self = shift; $self->load('can_run'); $self->load('get_file'); require Config; return unless ( $^O eq 'MSWin32' and $Config::Config{make} and $Config::Config{make} =~ /^nmake\b/i and ! $self->can_run('nmake') ); print "The required 'nmake' executable not found, fetching it...\n"; require File::Basename; my $rv = $self->get_file( url => 'http://download.microsoft.com/download/vc15/Patch/1.52/W95/EN-US/Nmake15.exe', ftp_url => 'ftp://ftp.microsoft.com/Softlib/MSLFILES/Nmake15.exe', local_dir => File::Basename::dirname($^X), size => 51928, run => 'Nmake15.exe /o > nul', check_for => 'Nmake.exe', remove => 1, ); die <<'END_MESSAGE' unless $rv; ------------------------------------------------------------------------------- Since you are using Microsoft Windows, you will need the 'nmake' utility before installation. It's available at: http://download.microsoft.com/download/vc15/Patch/1.52/W95/EN-US/Nmake15.exe or ftp://ftp.microsoft.com/Softlib/MSLFILES/Nmake15.exe Please download the file manually, save it to a directory in %PATH% (e.g. C:\WINDOWS\COMMAND\), then launch the MS-DOS command line shell, "cd" to that directory, and run "Nmake15.exe" from there; that will create the 'nmake.exe' file needed by this module. You may then resume the installation process described in README. ------------------------------------------------------------------------------- END_MESSAGE } 1; Zonemaster-CLI-v8.0.1/inc/Module/Install/Scripts.pm000644 001754 001754 00000001011 15121024073 022311 0ustar00matsdmatsd000000 000000 #line 1 package Module::Install::Scripts; use strict 'vars'; use Module::Install::Base (); use vars qw{$VERSION @ISA $ISCORE}; BEGIN { $VERSION = '1.21'; @ISA = 'Module::Install::Base'; $ISCORE = 1; } sub install_script { my $self = shift; my $args = $self->makemaker_args; my $exe = $args->{EXE_FILES} ||= []; foreach ( @_ ) { if ( -f $_ ) { push @$exe, $_; } elsif ( -d 'script' and -f "script/$_" ) { push @$exe, "script/$_"; } else { die("Cannot find script '$_'"); } } } 1; Zonemaster-CLI-v8.0.1/inc/Module/Install/Share.pm000644 001754 001754 00000004643 15121024073 021742 0ustar00matsdmatsd000000 000000 #line 1 package Module::Install::Share; use strict; use Module::Install::Base (); use File::Find (); use ExtUtils::Manifest (); use vars qw{$VERSION @ISA $ISCORE}; BEGIN { $VERSION = '1.21'; @ISA = 'Module::Install::Base'; $ISCORE = 1; } sub install_share { my $self = shift; my $dir = @_ ? pop : 'share'; my $type = @_ ? shift : 'dist'; unless ( defined $type and $type eq 'module' or $type eq 'dist' ) { die "Illegal or invalid share dir type '$type'"; } unless ( defined $dir and -d $dir ) { require Carp; Carp::croak("Illegal or missing directory install_share param: '$dir'"); } # Split by type my $S = ($^O eq 'MSWin32') ? "\\" : "\/"; my $root; if ( $type eq 'dist' ) { die "Too many parameters to install_share" if @_; # Set up the install $root = "\$(INST_LIB)${S}auto${S}share${S}dist${S}\$(DISTNAME)"; } else { my $module = Module::Install::_CLASS($_[0]); unless ( defined $module ) { die "Missing or invalid module name '$_[0]'"; } $module =~ s/::/-/g; $root = "\$(INST_LIB)${S}auto${S}share${S}module${S}$module"; } my $manifest = -r 'MANIFEST' ? ExtUtils::Manifest::maniread() : undef; my $skip_checker = $ExtUtils::Manifest::VERSION >= 1.54 ? ExtUtils::Manifest::maniskip() : ExtUtils::Manifest::_maniskip(); my $postamble = ''; my $perm_dir = eval($ExtUtils::MakeMaker::VERSION) >= 6.52 ? '$(PERM_DIR)' : 755; File::Find::find({ no_chdir => 1, wanted => sub { my $path = File::Spec->abs2rel($_, $dir); if (-d $_) { return if $skip_checker->($File::Find::name); $postamble .=<<"END"; \t\$(NOECHO) \$(MKPATH) "$root${S}$path" \t\$(NOECHO) \$(CHMOD) $perm_dir "$root${S}$path" END } else { return if ref $manifest && !exists $manifest->{$File::Find::name}; return if $skip_checker->($File::Find::name); $postamble .=<<"END"; \t\$(NOECHO) \$(CP) "$dir${S}$path" "$root${S}$path" END } }, }, $dir); # Set up the install $self->postamble(<<"END_MAKEFILE"); config :: $postamble END_MAKEFILE # The above appears to behave incorrectly when used with old versions # of ExtUtils::Install (known-bad on RHEL 3, with 5.8.0) # So when we need to install a share directory, make sure we add a # dependency on a moderately new version of ExtUtils::MakeMaker. $self->build_requires( 'ExtUtils::MakeMaker' => '6.11' ); # 99% of the time we don't want to index a shared dir $self->no_index( directory => $dir ); } 1; __END__ #line 154 Zonemaster-CLI-v8.0.1/inc/Module/Install/Makefile.pm000644 001754 001754 00000027437 15121024073 022423 0ustar00matsdmatsd000000 000000 #line 1 package Module::Install::Makefile; use strict 'vars'; use ExtUtils::MakeMaker (); use Module::Install::Base (); use Fcntl qw/:flock :seek/; use vars qw{$VERSION @ISA $ISCORE}; BEGIN { $VERSION = '1.21'; @ISA = 'Module::Install::Base'; $ISCORE = 1; } sub Makefile { $_[0] } my %seen = (); sub prompt { shift; # Infinite loop protection my @c = caller(); if ( ++$seen{"$c[1]|$c[2]|$_[0]"} > 3 ) { die "Caught an potential prompt infinite loop ($c[1]|$c[2]|$_[0])"; } # In automated testing or non-interactive session, always use defaults if ( ($ENV{AUTOMATED_TESTING} or -! -t STDIN) and ! $ENV{PERL_MM_USE_DEFAULT} ) { local $ENV{PERL_MM_USE_DEFAULT} = 1; goto &ExtUtils::MakeMaker::prompt; } else { goto &ExtUtils::MakeMaker::prompt; } } # Store a cleaned up version of the MakeMaker version, # since we need to behave differently in a variety of # ways based on the MM version. my $makemaker = eval $ExtUtils::MakeMaker::VERSION; # If we are passed a param, do a "newer than" comparison. # Otherwise, just return the MakeMaker version. sub makemaker { ( @_ < 2 or $makemaker >= eval($_[1]) ) ? $makemaker : 0 } # Ripped from ExtUtils::MakeMaker 6.56, and slightly modified # as we only need to know here whether the attribute is an array # or a hash or something else (which may or may not be appendable). my %makemaker_argtype = ( C => 'ARRAY', CONFIG => 'ARRAY', # CONFIGURE => 'CODE', # ignore DIR => 'ARRAY', DL_FUNCS => 'HASH', DL_VARS => 'ARRAY', EXCLUDE_EXT => 'ARRAY', EXE_FILES => 'ARRAY', FUNCLIST => 'ARRAY', H => 'ARRAY', IMPORTS => 'HASH', INCLUDE_EXT => 'ARRAY', LIBS => 'ARRAY', # ignore '' MAN1PODS => 'HASH', MAN3PODS => 'HASH', META_ADD => 'HASH', META_MERGE => 'HASH', PL_FILES => 'HASH', PM => 'HASH', PMLIBDIRS => 'ARRAY', PMLIBPARENTDIRS => 'ARRAY', PREREQ_PM => 'HASH', CONFIGURE_REQUIRES => 'HASH', SKIP => 'ARRAY', TYPEMAPS => 'ARRAY', XS => 'HASH', # VERSION => ['version',''], # ignore # _KEEP_AFTER_FLUSH => '', clean => 'HASH', depend => 'HASH', dist => 'HASH', dynamic_lib=> 'HASH', linkext => 'HASH', macro => 'HASH', postamble => 'HASH', realclean => 'HASH', test => 'HASH', tool_autosplit => 'HASH', # special cases where you can use makemaker_append CCFLAGS => 'APPENDABLE', DEFINE => 'APPENDABLE', INC => 'APPENDABLE', LDDLFLAGS => 'APPENDABLE', LDFROM => 'APPENDABLE', ); sub makemaker_args { my ($self, %new_args) = @_; my $args = ( $self->{makemaker_args} ||= {} ); foreach my $key (keys %new_args) { if ($makemaker_argtype{$key}) { if ($makemaker_argtype{$key} eq 'ARRAY') { $args->{$key} = [] unless defined $args->{$key}; unless (ref $args->{$key} eq 'ARRAY') { $args->{$key} = [$args->{$key}] } push @{$args->{$key}}, ref $new_args{$key} eq 'ARRAY' ? @{$new_args{$key}} : $new_args{$key}; } elsif ($makemaker_argtype{$key} eq 'HASH') { $args->{$key} = {} unless defined $args->{$key}; foreach my $skey (keys %{ $new_args{$key} }) { $args->{$key}{$skey} = $new_args{$key}{$skey}; } } elsif ($makemaker_argtype{$key} eq 'APPENDABLE') { $self->makemaker_append($key => $new_args{$key}); } } else { if (defined $args->{$key}) { warn qq{MakeMaker attribute "$key" is overriden; use "makemaker_append" to append values\n}; } $args->{$key} = $new_args{$key}; } } return $args; } # For mm args that take multiple space-separated args, # append an argument to the current list. sub makemaker_append { my $self = shift; my $name = shift; my $args = $self->makemaker_args; $args->{$name} = defined $args->{$name} ? join( ' ', $args->{$name}, @_ ) : join( ' ', @_ ); } sub build_subdirs { my $self = shift; my $subdirs = $self->makemaker_args->{DIR} ||= []; for my $subdir (@_) { push @$subdirs, $subdir; } } sub clean_files { my $self = shift; my $clean = $self->makemaker_args->{clean} ||= {}; %$clean = ( %$clean, FILES => join ' ', grep { length $_ } ($clean->{FILES} || (), @_), ); } sub realclean_files { my $self = shift; my $realclean = $self->makemaker_args->{realclean} ||= {}; %$realclean = ( %$realclean, FILES => join ' ', grep { length $_ } ($realclean->{FILES} || (), @_), ); } sub libs { my $self = shift; my $libs = ref $_[0] ? shift : [ shift ]; $self->makemaker_args( LIBS => $libs ); } sub inc { my $self = shift; $self->makemaker_args( INC => shift ); } sub _wanted_t { } sub tests_recursive { my $self = shift; my $dir = shift || 't'; unless ( -d $dir ) { die "tests_recursive dir '$dir' does not exist"; } my %tests = map { $_ => 1 } split / /, ($self->tests || ''); require File::Find; File::Find::find( sub { /\.t$/ and -f $_ and $tests{"$File::Find::dir/*.t"} = 1 }, $dir ); $self->tests( join ' ', sort keys %tests ); } sub write { my $self = shift; die "&Makefile->write() takes no arguments\n" if @_; # Check the current Perl version my $perl_version = $self->perl_version; if ( $perl_version ) { eval "use $perl_version; 1" or die "ERROR: perl: Version $] is installed, " . "but we need version >= $perl_version"; } # Make sure we have a new enough MakeMaker require ExtUtils::MakeMaker; if ( $perl_version and $self->_cmp($perl_version, '5.006') >= 0 ) { # This previous attempted to inherit the version of # ExtUtils::MakeMaker in use by the module author, but this # was found to be untenable as some authors build releases # using future dev versions of EU:MM that nobody else has. # Instead, #toolchain suggests we use 6.59 which is the most # stable version on CPAN at time of writing and is, to quote # ribasushi, "not terminally fucked, > and tested enough". # TODO: We will now need to maintain this over time to push # the version up as new versions are released. $self->build_requires( 'ExtUtils::MakeMaker' => 6.59 ); $self->configure_requires( 'ExtUtils::MakeMaker' => 6.59 ); } else { # Allow legacy-compatibility with 5.005 by depending on the # most recent EU:MM that supported 5.005. $self->build_requires( 'ExtUtils::MakeMaker' => 6.36 ); $self->configure_requires( 'ExtUtils::MakeMaker' => 6.36 ); } # Generate the MakeMaker params my $args = $self->makemaker_args; $args->{DISTNAME} = $self->name; $args->{NAME} = $self->module_name || $self->name; $args->{NAME} =~ s/-/::/g; $args->{VERSION} = $self->version or die <<'EOT'; ERROR: Can't determine distribution version. Please specify it explicitly via 'version' in Makefile.PL, or set a valid $VERSION in a module, and provide its file path via 'version_from' (or 'all_from' if you prefer) in Makefile.PL. EOT if ( $self->tests ) { my @tests = split ' ', $self->tests; my %seen; $args->{test} = { TESTS => (join ' ', grep {!$seen{$_}++} @tests), }; } elsif ( $Module::Install::ExtraTests::use_extratests ) { # Module::Install::ExtraTests doesn't set $self->tests and does its own tests via harness. # So, just ignore our xt tests here. } elsif ( -d 'xt' and ($Module::Install::AUTHOR or $ENV{RELEASE_TESTING}) ) { $args->{test} = { TESTS => join( ' ', map { "$_/*.t" } grep { -d $_ } qw{ t xt } ), }; } if ( $] >= 5.005 ) { $args->{ABSTRACT} = $self->abstract; $args->{AUTHOR} = join ', ', @{$self->author || []}; } if ( $self->makemaker(6.10) ) { $args->{NO_META} = 1; #$args->{NO_MYMETA} = 1; } if ( $self->makemaker(6.17) and $self->sign ) { $args->{SIGN} = 1; } unless ( $self->is_admin ) { delete $args->{SIGN}; } if ( $self->makemaker(6.31) and $self->license ) { $args->{LICENSE} = $self->license; } my $prereq = ($args->{PREREQ_PM} ||= {}); %$prereq = ( %$prereq, map { @$_ } # flatten [module => version] map { @$_ } grep $_, ($self->requires) ); # Remove any reference to perl, PREREQ_PM doesn't support it delete $args->{PREREQ_PM}->{perl}; # Merge both kinds of requires into BUILD_REQUIRES my $build_prereq = ($args->{BUILD_REQUIRES} ||= {}); %$build_prereq = ( %$build_prereq, map { @$_ } # flatten [module => version] map { @$_ } grep $_, ($self->configure_requires, $self->build_requires) ); # Remove any reference to perl, BUILD_REQUIRES doesn't support it delete $args->{BUILD_REQUIRES}->{perl}; # Delete bundled dists from prereq_pm, add it to Makefile DIR my $subdirs = ($args->{DIR} || []); if ($self->bundles) { my %processed; foreach my $bundle (@{ $self->bundles }) { my ($mod_name, $dist_dir) = @$bundle; delete $prereq->{$mod_name}; $dist_dir = File::Basename::basename($dist_dir); # dir for building this module if (not exists $processed{$dist_dir}) { if (-d $dist_dir) { # List as sub-directory to be processed by make push @$subdirs, $dist_dir; } # Else do nothing: the module is already present on the system $processed{$dist_dir} = undef; } } } unless ( $self->makemaker('6.55_03') ) { %$prereq = (%$prereq,%$build_prereq); delete $args->{BUILD_REQUIRES}; } if ( my $perl_version = $self->perl_version ) { eval "use $perl_version; 1" or die "ERROR: perl: Version $] is installed, " . "but we need version >= $perl_version"; if ( $self->makemaker(6.48) ) { $args->{MIN_PERL_VERSION} = $perl_version; } } if ($self->installdirs) { warn qq{old INSTALLDIRS (probably set by makemaker_args) is overriden by installdirs\n} if $args->{INSTALLDIRS}; $args->{INSTALLDIRS} = $self->installdirs; } my %args = map { ( $_ => $args->{$_} ) } grep {defined($args->{$_} ) } keys %$args; my $user_preop = delete $args{dist}->{PREOP}; if ( my $preop = $self->admin->preop($user_preop) ) { foreach my $key ( keys %$preop ) { $args{dist}->{$key} = $preop->{$key}; } } my $mm = ExtUtils::MakeMaker::WriteMakefile(%args); $self->fix_up_makefile($mm->{FIRST_MAKEFILE} || 'Makefile'); } sub fix_up_makefile { my $self = shift; my $makefile_name = shift; my $top_class = ref($self->_top) || ''; my $top_version = $self->_top->VERSION || ''; my $preamble = $self->preamble ? "# Preamble by $top_class $top_version\n" . $self->preamble : ''; my $postamble = "# Postamble by $top_class $top_version\n" . ($self->postamble || ''); local *MAKEFILE; open MAKEFILE, "+< $makefile_name" or die "fix_up_makefile: Couldn't open $makefile_name: $!"; eval { flock MAKEFILE, LOCK_EX }; my $makefile = do { local $/; }; $makefile =~ s/\b(test_harness\(\$\(TEST_VERBOSE\), )/$1'inc', /; $makefile =~ s/( -I\$\(INST_ARCHLIB\))/ -Iinc$1/g; $makefile =~ s/( "-I\$\(INST_LIB\)")/ "-Iinc"$1/g; $makefile =~ s/^(FULLPERL = .*)/$1 "-Iinc"/m; $makefile =~ s/^(PERL = .*)/$1 "-Iinc"/m; # Module::Install will never be used to build the Core Perl # Sometimes PERL_LIB and PERL_ARCHLIB get written anyway, which breaks # PREFIX/PERL5LIB, and thus, install_share. Blank them if they exist $makefile =~ s/^PERL_LIB = .+/PERL_LIB =/m; #$makefile =~ s/^PERL_ARCHLIB = .+/PERL_ARCHLIB =/m; # Perl 5.005 mentions PERL_LIB explicitly, so we have to remove that as well. $makefile =~ s/(\"?)-I\$\(PERL_LIB\)\1//g; # XXX - This is currently unused; not sure if it breaks other MM-users # $makefile =~ s/^pm_to_blib\s+:\s+/pm_to_blib :: /mg; seek MAKEFILE, 0, SEEK_SET; truncate MAKEFILE, 0; print MAKEFILE "$preamble$makefile$postamble" or die $!; close MAKEFILE or die $!; 1; } sub preamble { my ($self, $text) = @_; $self->{preamble} = $text . $self->{preamble} if defined $text; $self->{preamble}; } sub postamble { my ($self, $text) = @_; $self->{postamble} ||= $self->admin->postamble; $self->{postamble} .= $text if defined $text; $self->{postamble} } 1; __END__ #line 544 Zonemaster-CLI-v8.0.1/inc/Module/Install/Metadata.pm000644 001754 001754 00000043437 15121024073 022424 0ustar00matsdmatsd000000 000000 #line 1 package Module::Install::Metadata; use strict 'vars'; use Module::Install::Base (); use vars qw{$VERSION @ISA $ISCORE}; BEGIN { $VERSION = '1.21'; @ISA = 'Module::Install::Base'; $ISCORE = 1; } my @boolean_keys = qw{ sign }; my @scalar_keys = qw{ name module_name abstract version distribution_type tests installdirs }; my @tuple_keys = qw{ configure_requires build_requires requires recommends bundles resources }; my @resource_keys = qw{ homepage bugtracker repository }; my @array_keys = qw{ keywords author }; *authors = \&author; sub Meta { shift } sub Meta_BooleanKeys { @boolean_keys } sub Meta_ScalarKeys { @scalar_keys } sub Meta_TupleKeys { @tuple_keys } sub Meta_ResourceKeys { @resource_keys } sub Meta_ArrayKeys { @array_keys } foreach my $key ( @boolean_keys ) { *$key = sub { my $self = shift; if ( defined wantarray and not @_ ) { return $self->{values}->{$key}; } $self->{values}->{$key} = ( @_ ? $_[0] : 1 ); return $self; }; } foreach my $key ( @scalar_keys ) { *$key = sub { my $self = shift; return $self->{values}->{$key} if defined wantarray and !@_; $self->{values}->{$key} = shift; return $self; }; } foreach my $key ( @array_keys ) { *$key = sub { my $self = shift; return $self->{values}->{$key} if defined wantarray and !@_; $self->{values}->{$key} ||= []; push @{$self->{values}->{$key}}, @_; return $self; }; } foreach my $key ( @resource_keys ) { *$key = sub { my $self = shift; unless ( @_ ) { return () unless $self->{values}->{resources}; return map { $_->[1] } grep { $_->[0] eq $key } @{ $self->{values}->{resources} }; } return $self->{values}->{resources}->{$key} unless @_; my $uri = shift or die( "Did not provide a value to $key()" ); $self->resources( $key => $uri ); return 1; }; } foreach my $key ( grep { $_ ne "resources" } @tuple_keys) { *$key = sub { my $self = shift; return $self->{values}->{$key} unless @_; my @added; while ( @_ ) { my $module = shift or last; my $version = shift || 0; push @added, [ $module, $version ]; } push @{ $self->{values}->{$key} }, @added; return map {@$_} @added; }; } # Resource handling my %lc_resource = map { $_ => 1 } qw{ homepage license bugtracker repository }; sub resources { my $self = shift; while ( @_ ) { my $name = shift or last; my $value = shift or next; if ( $name eq lc $name and ! $lc_resource{$name} ) { die("Unsupported reserved lowercase resource '$name'"); } $self->{values}->{resources} ||= []; push @{ $self->{values}->{resources} }, [ $name, $value ]; } $self->{values}->{resources}; } # Aliases for build_requires that will have alternative # meanings in some future version of META.yml. sub test_requires { shift->build_requires(@_) } sub install_requires { shift->build_requires(@_) } # Aliases for installdirs options sub install_as_core { $_[0]->installdirs('perl') } sub install_as_cpan { $_[0]->installdirs('site') } sub install_as_site { $_[0]->installdirs('site') } sub install_as_vendor { $_[0]->installdirs('vendor') } sub dynamic_config { my $self = shift; my $value = @_ ? shift : 1; if ( $self->{values}->{dynamic_config} ) { # Once dynamic we never change to static, for safety return 0; } $self->{values}->{dynamic_config} = $value ? 1 : 0; return 1; } # Convenience command sub static_config { shift->dynamic_config(0); } sub perl_version { my $self = shift; return $self->{values}->{perl_version} unless @_; my $version = shift or die( "Did not provide a value to perl_version()" ); # Normalize the version $version = $self->_perl_version($version); # We don't support the really old versions unless ( $version >= 5.005 ) { die "Module::Install only supports 5.005 or newer (use ExtUtils::MakeMaker)\n"; } $self->{values}->{perl_version} = $version; } sub all_from { my ( $self, $file ) = @_; unless ( defined($file) ) { my $name = $self->name or die( "all_from called with no args without setting name() first" ); $file = join('/', 'lib', split(/-/, $name)) . '.pm'; $file =~ s{.*/}{} unless -e $file; unless ( -e $file ) { die("all_from cannot find $file from $name"); } } unless ( -f $file ) { die("The path '$file' does not exist, or is not a file"); } $self->{values}{all_from} = $file; # Some methods pull from POD instead of code. # If there is a matching .pod, use that instead my $pod = $file; $pod =~ s/\.pm$/.pod/i; $pod = $file unless -e $pod; # Pull the different values $self->name_from($file) unless $self->name; $self->version_from($file) unless $self->version; $self->perl_version_from($file) unless $self->perl_version; $self->author_from($pod) unless @{$self->author || []}; $self->license_from($pod) unless $self->license; $self->abstract_from($pod) unless $self->abstract; return 1; } sub provides { my $self = shift; my $provides = ( $self->{values}->{provides} ||= {} ); %$provides = (%$provides, @_) if @_; return $provides; } sub auto_provides { my $self = shift; return $self unless $self->is_admin; unless (-e 'MANIFEST') { warn "Cannot deduce auto_provides without a MANIFEST, skipping\n"; return $self; } # Avoid spurious warnings as we are not checking manifest here. local $SIG{__WARN__} = sub {1}; require ExtUtils::Manifest; local *ExtUtils::Manifest::manicheck = sub { return }; require Module::Build; my $build = Module::Build->new( dist_name => $self->name, dist_version => $self->version, license => $self->license, ); $self->provides( %{ $build->find_dist_packages || {} } ); } sub feature { my $self = shift; my $name = shift; my $features = ( $self->{values}->{features} ||= [] ); my $mods; if ( @_ == 1 and ref( $_[0] ) ) { # The user used ->feature like ->features by passing in the second # argument as a reference. Accomodate for that. $mods = $_[0]; } else { $mods = \@_; } my $count = 0; push @$features, ( $name => [ map { ref($_) ? ( ref($_) eq 'HASH' ) ? %$_ : @$_ : $_ } @$mods ] ); return @$features; } sub features { my $self = shift; while ( my ( $name, $mods ) = splice( @_, 0, 2 ) ) { $self->feature( $name, @$mods ); } return $self->{values}->{features} ? @{ $self->{values}->{features} } : (); } sub no_index { my $self = shift; my $type = shift; push @{ $self->{values}->{no_index}->{$type} }, @_ if $type; return $self->{values}->{no_index}; } sub read { my $self = shift; $self->include_deps( 'YAML::Tiny', 0 ); require YAML::Tiny; my $data = YAML::Tiny::LoadFile('META.yml'); # Call methods explicitly in case user has already set some values. while ( my ( $key, $value ) = each %$data ) { next unless $self->can($key); if ( ref $value eq 'HASH' ) { while ( my ( $module, $version ) = each %$value ) { $self->can($key)->($self, $module => $version ); } } else { $self->can($key)->($self, $value); } } return $self; } sub write { my $self = shift; return $self unless $self->is_admin; $self->admin->write_meta; return $self; } sub version_from { require ExtUtils::MM_Unix; my ( $self, $file ) = @_; $self->version( ExtUtils::MM_Unix->parse_version($file) ); # for version integrity check $self->makemaker_args( VERSION_FROM => $file ); } sub abstract_from { require ExtUtils::MM_Unix; my ( $self, $file ) = @_; $self->abstract( bless( { DISTNAME => $self->name }, 'ExtUtils::MM_Unix' )->parse_abstract($file) ); } # Add both distribution and module name sub name_from { my ($self, $file) = @_; if ( Module::Install::_read($file) =~ m/ ^ \s* package \s* ([\w:]+) [\s|;]* /ixms ) { my ($name, $module_name) = ($1, $1); $name =~ s{::}{-}g; $self->name($name); unless ( $self->module_name ) { $self->module_name($module_name); } } else { die("Cannot determine name from $file\n"); } } sub _extract_perl_version { if ( $_[0] =~ m/ ^\s* (?:use|require) \s* v? ([\d_\.]+) \s* ; /ixms ) { my $perl_version = $1; $perl_version =~ s{_}{}g; return $perl_version; } else { return; } } sub perl_version_from { my $self = shift; my $perl_version=_extract_perl_version(Module::Install::_read($_[0])); if ($perl_version) { $self->perl_version($perl_version); } else { warn "Cannot determine perl version info from $_[0]\n"; return; } } sub author_from { my $self = shift; my $content = Module::Install::_read($_[0]); if ($content =~ m/ =head \d \s+ (?:authors?)\b \s* ([^\n]*) | =head \d \s+ (?:licen[cs]e|licensing|copyright|legal)\b \s* .*? copyright .*? \d\d\d[\d.]+ \s* (?:\bby\b)? \s* ([^\n]*) /ixms) { my $author = $1 || $2; # XXX: ugly but should work anyway... if (eval "require Pod::Escapes; 1") { # Pod::Escapes has a mapping table. # It's in core of perl >= 5.9.3, and should be installed # as one of the Pod::Simple's prereqs, which is a prereq # of Pod::Text 3.x (see also below). $author =~ s{ E<( (\d+) | ([A-Za-z]+) )> } { defined $2 ? chr($2) : defined $Pod::Escapes::Name2character_number{$1} ? chr($Pod::Escapes::Name2character_number{$1}) : do { warn "Unknown escape: E<$1>"; "E<$1>"; }; }gex; } elsif (eval "require Pod::Text; 1" && $Pod::Text::VERSION < 3) { # Pod::Text < 3.0 has yet another mapping table, # though the table name of 2.x and 1.x are different. # (1.x is in core of Perl < 5.6, 2.x is in core of # Perl < 5.9.3) my $mapping = ($Pod::Text::VERSION < 2) ? \%Pod::Text::HTML_Escapes : \%Pod::Text::ESCAPES; $author =~ s{ E<( (\d+) | ([A-Za-z]+) )> } { defined $2 ? chr($2) : defined $mapping->{$1} ? $mapping->{$1} : do { warn "Unknown escape: E<$1>"; "E<$1>"; }; }gex; } else { $author =~ s{E}{<}g; $author =~ s{E}{>}g; } $self->author($author); } else { warn "Cannot determine author info from $_[0]\n"; } } #Stolen from M::B my %license_urls = ( perl => 'http://dev.perl.org/licenses/', apache => 'http://apache.org/licenses/LICENSE-2.0', artistic => 'http://opensource.org/licenses/artistic-license.php', lgpl => 'http://opensource.org/licenses/lgpl-license.php', bsd => 'http://opensource.org/licenses/bsd-license.php', gpl => 'http://opensource.org/licenses/gpl-license.php', gpl2 => 'http://opensource.org/licenses/gpl-2.0.php', gpl3 => 'http://opensource.org/licenses/gpl-3.0.html', mit => 'http://opensource.org/licenses/mit-license.php', mozilla => 'http://opensource.org/licenses/mozilla1.1.php', open_source => undef, unrestricted => undef, restrictive => undef, unknown => undef, # these are not actually allowed in meta-spec v1.4 but are left here for compatibility: apache_1_1 => 'http://apache.org/licenses/LICENSE-1.1', artistic_2 => 'http://opensource.org/licenses/artistic-license-2.0.php', lgpl2 => 'http://opensource.org/licenses/lgpl-2.1.php', lgpl3 => 'http://opensource.org/licenses/lgpl-3.0.html', ); sub license { my $self = shift; return $self->{values}->{license} unless @_; my $license = shift or die( 'Did not provide a value to license()' ); $license = __extract_license($license) || lc $license; $self->{values}->{license} = $license; # Automatically fill in license URLs if ( $license_urls{$license} ) { $self->resources( license => $license_urls{$license} ); } return 1; } sub _extract_license { my $pod = shift; my $matched; return __extract_license( ($matched) = $pod =~ m/ (=head \d \s+ L(?i:ICEN[CS]E|ICENSING)\b.*?) (=head \d.*|=cut.*|)\z /xms ) || __extract_license( ($matched) = $pod =~ m/ (=head \d \s+ (?:C(?i:OPYRIGHTS?)|L(?i:EGAL))\b.*?) (=head \d.*|=cut.*|)\z /xms ); } sub __extract_license { my $license_text = shift or return; my @phrases = ( '(?:under )?the same (?:terms|license) as (?:perl|the perl (?:\d )?programming language)' => 'perl', 1, '(?:under )?the terms of (?:perl|the perl programming language) itself' => 'perl', 1, 'Artistic and GPL' => 'perl', 1, 'GNU general public license' => 'gpl', 1, 'GNU public license' => 'gpl', 1, 'GNU lesser general public license' => 'lgpl', 1, 'GNU lesser public license' => 'lgpl', 1, 'GNU library general public license' => 'lgpl', 1, 'GNU library public license' => 'lgpl', 1, 'GNU Free Documentation license' => 'unrestricted', 1, 'GNU Affero General Public License' => 'open_source', 1, '(?:Free)?BSD license' => 'bsd', 1, 'Artistic license 2\.0' => 'artistic_2', 1, 'Artistic license' => 'artistic', 1, 'Apache (?:Software )?license' => 'apache', 1, 'GPL' => 'gpl', 1, 'LGPL' => 'lgpl', 1, 'BSD' => 'bsd', 1, 'Artistic' => 'artistic', 1, 'MIT' => 'mit', 1, 'Mozilla Public License' => 'mozilla', 1, 'Q Public License' => 'open_source', 1, 'OpenSSL License' => 'unrestricted', 1, 'SSLeay License' => 'unrestricted', 1, 'zlib License' => 'open_source', 1, 'proprietary' => 'proprietary', 0, ); while ( my ($pattern, $license, $osi) = splice(@phrases, 0, 3) ) { $pattern =~ s#\s+#\\s+#gs; if ( $license_text =~ /\b$pattern\b/i ) { return $license; } } return ''; } sub license_from { my $self = shift; if (my $license=_extract_license(Module::Install::_read($_[0]))) { $self->license($license); } else { warn "Cannot determine license info from $_[0]\n"; return 'unknown'; } } sub _extract_bugtracker { my @links = $_[0] =~ m#L<( https?\Q://rt.cpan.org/\E[^>]+| https?\Q://github.com/\E[\w_]+/[\w_]+/issues| https?\Q://code.google.com/p/\E[\w_\-]+/issues/list )>#gx; my %links; @links{@links}=(); @links=keys %links; return @links; } sub bugtracker_from { my $self = shift; my $content = Module::Install::_read($_[0]); my @links = _extract_bugtracker($content); unless ( @links ) { warn "Cannot determine bugtracker info from $_[0]\n"; return 0; } if ( @links > 1 ) { warn "Found more than one bugtracker link in $_[0]\n"; return 0; } # Set the bugtracker bugtracker( $links[0] ); return 1; } sub requires_from { my $self = shift; my $content = Module::Install::_readperl($_[0]); my @requires = $content =~ m/^use\s+([^\W\d]\w*(?:::\w+)*)\s+(v?[\d\.]+)/mg; while ( @requires ) { my $module = shift @requires; my $version = shift @requires; $self->requires( $module => $version ); } } sub test_requires_from { my $self = shift; my $content = Module::Install::_readperl($_[0]); my @requires = $content =~ m/^use\s+([^\W\d]\w*(?:::\w+)*)\s+([\d\.]+)/mg; while ( @requires ) { my $module = shift @requires; my $version = shift @requires; $self->test_requires( $module => $version ); } } # Convert triple-part versions (eg, 5.6.1 or 5.8.9) to # numbers (eg, 5.006001 or 5.008009). # Also, convert double-part versions (eg, 5.8) sub _perl_version { my $v = $_[-1]; $v =~ s/^([1-9])\.([1-9]\d?\d?)$/sprintf("%d.%03d",$1,$2)/e; $v =~ s/^([1-9])\.([1-9]\d?\d?)\.(0|[1-9]\d?\d?)$/sprintf("%d.%03d%03d",$1,$2,$3 || 0)/e; $v =~ s/(\.\d\d\d)000$/$1/; $v =~ s/_.+$//; if ( ref($v) ) { # Numify $v = $v + 0; } return $v; } sub add_metadata { my $self = shift; my %hash = @_; for my $key (keys %hash) { warn "add_metadata: $key is not prefixed with 'x_'.\n" . "Use appopriate function to add non-private metadata.\n" unless $key =~ /^x_/; $self->{values}->{$key} = $hash{$key}; } } ###################################################################### # MYMETA Support sub WriteMyMeta { die "WriteMyMeta has been deprecated"; } sub write_mymeta_yaml { my $self = shift; # We need YAML::Tiny to write the MYMETA.yml file unless ( eval { require YAML::Tiny; 1; } ) { return 1; } # Generate the data my $meta = $self->_write_mymeta_data or return 1; # Save as the MYMETA.yml file print "Writing MYMETA.yml\n"; YAML::Tiny::DumpFile('MYMETA.yml', $meta); } sub write_mymeta_json { my $self = shift; # We need JSON to write the MYMETA.json file unless ( eval { require JSON; 1; } ) { return 1; } # Generate the data my $meta = $self->_write_mymeta_data or return 1; # Save as the MYMETA.yml file print "Writing MYMETA.json\n"; Module::Install::_write( 'MYMETA.json', JSON->new->pretty(1)->canonical->encode($meta), ); } sub _write_mymeta_data { my $self = shift; # If there's no existing META.yml there is nothing we can do return undef unless -f 'META.yml'; # We need Parse::CPAN::Meta to load the file unless ( eval { require Parse::CPAN::Meta; 1; } ) { return undef; } # Merge the perl version into the dependencies my $val = $self->Meta->{values}; my $perl = delete $val->{perl_version}; if ( $perl ) { $val->{requires} ||= []; my $requires = $val->{requires}; # Canonize to three-dot version after Perl 5.6 if ( $perl >= 5.006 ) { $perl =~ s{^(\d+)\.(\d\d\d)(\d*)}{join('.', $1, int($2||0), int($3||0))}e } unshift @$requires, [ perl => $perl ]; } # Load the advisory META.yml file my @yaml = Parse::CPAN::Meta::LoadFile('META.yml'); my $meta = $yaml[0]; # Overwrite the non-configure dependency hashes delete $meta->{requires}; delete $meta->{build_requires}; delete $meta->{recommends}; if ( exists $val->{requires} ) { $meta->{requires} = { map { @$_ } @{ $val->{requires} } }; } if ( exists $val->{build_requires} ) { $meta->{build_requires} = { map { @$_ } @{ $val->{build_requires} } }; } return $meta; } 1; Zonemaster-CLI-v8.0.1/inc/Module/Install/External.pm000644 001754 001754 00000003545 15121024073 022462 0ustar00matsdmatsd000000 000000 #line 1 package Module::Install::External; # Provides dependency declarations for external non-Perl things use strict; use Module::Install::Base (); use vars qw{$VERSION $ISCORE @ISA}; BEGIN { $VERSION = '1.21'; $ISCORE = 1; @ISA = qw{Module::Install::Base}; } sub requires_xs { my $self = shift; # First check for the basic C compiler $self->requires_external_cc; # We need a C compiler that can build XS files unless ( $self->can_xs ) { print "Unresolvable missing external dependency.\n"; print "This package requires perl's header files.\n"; print STDERR "NA: Unable to build distribution on this platform.\n"; exit(0); } 1; } sub requires_external_cc { my $self = shift; # We need a C compiler, use the can_cc method for this unless ( $self->can_cc ) { print "Unresolvable missing external dependency.\n"; print "This package requires a C compiler.\n"; print STDERR "NA: Unable to build distribution on this platform.\n"; exit(0); } # Unlike some of the other modules, while we need to specify a # C compiler as a dep, it needs to be a build-time dependency. 1; } sub requires_external_bin { my ($self, $bin, $version) = @_; if ( $version ) { die "requires_external_bin does not support versions yet"; } # Load the package containing can_run early, # to avoid breaking the message below. $self->load('can_run'); # Locate the bin print "Locating bin:$bin..."; my $found_bin = $self->can_run( $bin ); if ( $found_bin ) { print " found at $found_bin.\n"; } else { print " missing.\n"; print "Unresolvable missing external dependency.\n"; print "Please install '$bin' seperately and try again.\n"; print STDERR "NA: Unable to build distribution on this platform.\n"; exit(0); } # Once we have some way to specify external deps, do it here. # In the mean time, continue as normal. 1; } 1; __END__ #line 171 Zonemaster-CLI-v8.0.1/inc/Module/Install/Base.pm000644 001754 001754 00000002147 15121024073 021547 0ustar00matsdmatsd000000 000000 #line 1 package Module::Install::Base; use strict 'vars'; use vars qw{$VERSION}; BEGIN { $VERSION = '1.21'; } # Suspend handler for "redefined" warnings BEGIN { my $w = $SIG{__WARN__}; $SIG{__WARN__} = sub { $w }; } #line 42 sub new { my $class = shift; unless ( defined &{"${class}::call"} ) { *{"${class}::call"} = sub { shift->_top->call(@_) }; } unless ( defined &{"${class}::load"} ) { *{"${class}::load"} = sub { shift->_top->load(@_) }; } bless { @_ }, $class; } #line 61 sub AUTOLOAD { local $@; my $func = eval { shift->_top->autoload } or return; goto &$func; } #line 75 sub _top { $_[0]->{_top}; } #line 90 sub admin { $_[0]->_top->{admin} or Module::Install::Base::FakeAdmin->new; } #line 106 sub is_admin { ! $_[0]->admin->isa('Module::Install::Base::FakeAdmin'); } sub DESTROY {} package Module::Install::Base::FakeAdmin; use vars qw{$VERSION}; BEGIN { $VERSION = $Module::Install::Base::VERSION; } my $fake; sub new { $fake ||= bless(\@_, $_[0]); } sub AUTOLOAD {} sub DESTROY {} # Restore warning handler BEGIN { $SIG{__WARN__} = $SIG{__WARN__}->(); } 1; #line 159 Zonemaster-CLI-v8.0.1/inc/Module/Install/Can.pm000644 001754 001754 00000006405 15121024073 021377 0ustar00matsdmatsd000000 000000 #line 1 package Module::Install::Can; use strict; use Config (); use ExtUtils::MakeMaker (); use Module::Install::Base (); use vars qw{$VERSION @ISA $ISCORE}; BEGIN { $VERSION = '1.21'; @ISA = 'Module::Install::Base'; $ISCORE = 1; } # check if we can load some module ### Upgrade this to not have to load the module if possible sub can_use { my ($self, $mod, $ver) = @_; $mod =~ s{::|\\}{/}g; $mod .= '.pm' unless $mod =~ /\.pm$/i; my $pkg = $mod; $pkg =~ s{/}{::}g; $pkg =~ s{\.pm$}{}i; local $@; eval { require $mod; $pkg->VERSION($ver || 0); 1 }; } # Check if we can run some command sub can_run { my ($self, $cmd) = @_; my $_cmd = $cmd; return $_cmd if (-x $_cmd or $_cmd = MM->maybe_command($_cmd)); for my $dir ((split /$Config::Config{path_sep}/, $ENV{PATH}), '.') { next if $dir eq ''; require File::Spec; my $abs = File::Spec->catfile($dir, $cmd); return $abs if (-x $abs or $abs = MM->maybe_command($abs)); } return; } # Can our C compiler environment build XS files sub can_xs { my $self = shift; # Ensure we have the CBuilder module $self->configure_requires( 'ExtUtils::CBuilder' => 0.27 ); # Do we have the configure_requires checker? local $@; eval "require ExtUtils::CBuilder;"; if ( $@ ) { # They don't obey configure_requires, so it is # someone old and delicate. Try to avoid hurting # them by falling back to an older simpler test. return $self->can_cc(); } # Do we have a working C compiler my $builder = ExtUtils::CBuilder->new( quiet => 1, ); unless ( $builder->have_compiler ) { # No working C compiler return 0; } # Write a C file representative of what XS becomes require File::Temp; my ( $FH, $tmpfile ) = File::Temp::tempfile( "compilexs-XXXXX", SUFFIX => '.c', ); binmode $FH; print $FH <<'END_C'; #include "EXTERN.h" #include "perl.h" #include "XSUB.h" int main(int argc, char **argv) { return 0; } int boot_sanexs() { return 1; } END_C close $FH; # Can the C compiler access the same headers XS does my @libs = (); my $object = undef; eval { local $^W = 0; $object = $builder->compile( source => $tmpfile, ); @libs = $builder->link( objects => $object, module_name => 'sanexs', ); }; my $result = $@ ? 0 : 1; # Clean up all the build files foreach ( $tmpfile, $object, @libs ) { next unless defined $_; 1 while unlink; } return $result; } # Can we locate a (the) C compiler sub can_cc { my $self = shift; if ($^O eq 'VMS') { require ExtUtils::CBuilder; my $builder = ExtUtils::CBuilder->new( quiet => 1, ); return $builder->have_compiler; } my @chunks = split(/ /, $Config::Config{cc}) or return; # $Config{cc} may contain args; try to find out the program part while (@chunks) { return $self->can_run("@chunks") || (pop(@chunks), next); } return; } # Fix Cygwin bug on maybe_command(); if ( $^O eq 'cygwin' ) { require ExtUtils::MM_Cygwin; require ExtUtils::MM_Win32; if ( ! defined(&ExtUtils::MM_Cygwin::maybe_command) ) { *ExtUtils::MM_Cygwin::maybe_command = sub { my ($self, $file) = @_; if ($file =~ m{^/cygdrive/}i and ExtUtils::MM_Win32->can('maybe_command')) { ExtUtils::MM_Win32->maybe_command($file); } else { ExtUtils::MM_Unix->maybe_command($file); } } } } 1; __END__ #line 245 Zonemaster-CLI-v8.0.1/lib/Zonemaster/000755 001754 001754 00000000000 15121024076 017627 5ustar00matsdmatsd000000 000000 Zonemaster-CLI-v8.0.1/lib/Zonemaster/CLI.pm000644 001754 001754 00000077254 15121024050 020603 0ustar00matsdmatsd000000 000000 # Brief help module to define the exception we use for early exits. package Zonemaster::Engine::Exception::NormalExit; use v5.26; use warnings; use parent 'Zonemaster::Engine::Exception'; # The actual interesting module. package Zonemaster::CLI; use v5.26; use warnings; use version; our $VERSION = version->declare( "v8.0.1" ); use Locale::TextDomain 'Zonemaster-CLI'; use Encode; use File::Slurp; use Getopt::Long qw[GetOptionsFromArray :config gnu_compat bundling no_auto_abbrev]; use JSON::XS; use List::Util qw[max uniq]; use Net::IP::XS; use Pod::Usage; use POSIX qw[setlocale LC_MESSAGES LC_CTYPE]; use Readonly; use Scalar::Util qw[blessed]; use Time::HiRes; use Try::Tiny; use Zonemaster::CLI::TestCaseSet; use Zonemaster::Engine::Exception; use Zonemaster::Engine::Logger::Entry; use Zonemaster::Engine::Normalization qw[normalize_name]; use Zonemaster::Engine::Translator; use Zonemaster::Engine::Util qw[parse_hints]; use Zonemaster::Engine::Validation qw[validate_ipv4 validate_ipv6]; use Zonemaster::Engine; use Zonemaster::LDNS; our %numeric = Zonemaster::Engine::Logger::Entry->levels; our $JSON = JSON::XS->new->allow_blessed->convert_blessed->canonical; our $SCRIPT = $0; Readonly our $EXIT_SUCCESS => 0; Readonly our $EXIT_GENERIC_ERROR => 1; Readonly our $EXIT_USAGE_ERROR => 2; Readonly our $DS_RE => qr/^(?:[[:digit:]]+,){3}[[:xdigit:]]+$/; STDOUT->autoflush( 1 ); sub my_pod2usage { my ( %opts ) = @_; pod2usage( -input => $SCRIPT, -output => $opts{output}, -verbose => $opts{verbosity}, -exitcode => 'NOEXIT', ); return; } # Returns an integer representing an OS exit status. sub run { my ( $class, @argv ) = @_; my $opt_count = 0; my @opt_ds = (); my $opt_dump_profile = 0; my $opt_elapsed = 0; my $opt_encoding = undef; my $opt_help = 0; my $opt_hints; my $opt_ipv4 = undef; my $opt_ipv6 = undef; my $opt_json = undef; my $opt_json_stream = 0; my $opt_json_translate = undef; my $opt_level = 'NOTICE'; my $opt_list_tests = 0; my $opt_locale = undef; my @opt_ns = (); my $opt_nstimes = 0; my $opt_profile; my $opt_progress = undef; my $opt_raw; my $opt_restore; my $opt_save; my $opt_show_level = 1; my $opt_show_module = 0; my $opt_show_testcase = 0; my $opt_sourceaddr4; my $opt_sourceaddr6; my $opt_stop_level = ''; my @opt_test = (); my $opt_time = 1; my $opt_version = 0; { local $SIG{__WARN__} = sub { print STDERR $_[0] }; GetOptionsFromArray( \@argv, 'count!' => \$opt_count, 'ds=s' => \@opt_ds, 'dump-profile!' => \$opt_dump_profile, 'dump_profile!' => \$opt_dump_profile, 'elapsed!' => \$opt_elapsed, 'encoding=s' => \$opt_encoding, 'hints=s' => \$opt_hints, 'help|h|usage|?!' => \$opt_help, 'ipv4!' => \$opt_ipv4, 'ipv6!' => \$opt_ipv6, 'json!' => \$opt_json, 'json-stream!' => \$opt_json_stream, 'json_stream!' => \$opt_json_stream, 'json-translate!' => \$opt_json_translate, 'json_translate!' => \$opt_json_translate, 'level=s' => \$opt_level, 'list-tests!' => \$opt_list_tests, 'list_tests!' => \$opt_list_tests, 'locale=s' => \$opt_locale, 'ns=s' => \@opt_ns, 'nstimes!' => \$opt_nstimes, 'profile=s' => \$opt_profile, 'progress!' => \$opt_progress, 'raw!' => \$opt_raw, 'restore=s' => \$opt_restore, 'save=s' => \$opt_save, 'show-level!' => \$opt_show_level, 'show_level!' => \$opt_show_level, 'show-module!' => \$opt_show_module, 'show_module!' => \$opt_show_module, 'show-testcase!' => \$opt_show_testcase, 'show_testcase!' => \$opt_show_testcase, 'sourceaddr4=s' => \$opt_sourceaddr4, 'sourceaddr6=s' => \$opt_sourceaddr6, 'stop-level=s' => \$opt_stop_level, 'stop_level=s' => \$opt_stop_level, 'test=s' => \@opt_test, 'time!' => \$opt_time, 'version!' => \$opt_version, ) or do { my_pod2usage( verbosity => 0, output => \*STDERR ); return 2; }; } if ( $opt_help ) { my_pod2usage( verbosity => 1, output => \*STDOUT ); say "Severity levels from highest to lowest:"; say " CRITICAL, ERROR, WARNING, NOTICE, INFO, DEBUG, DEBUG2, DEBUG3"; return 0; } $opt_level = uc $opt_level; $opt_stop_level = uc $opt_stop_level; my @accumulator; my %counter; my $printed_something; if ( $opt_locale ) { undef $ENV{LANGUAGE}; $ENV{LC_ALL} = $opt_locale; } # Set LC_MESSAGES and LC_CTYPE separately # (https://www.gnu.org/software/gettext/manual/html_node/Triggering.html#Triggering) if ( not defined setlocale( LC_MESSAGES, "" ) ) { my $locale = ( $ENV{LANGUAGE} || $ENV{LC_ALL} || $ENV{LC_MESSAGES} ); say STDERR __x( "Warning: setting locale category LC_MESSAGES to {locale} failed -- is it installed on this system?", locale => $locale ) . "\n\n"; } if ( not defined setlocale( LC_CTYPE, "" ) ) { my $locale = ( $ENV{LC_ALL} || $ENV{LC_CTYPE} ); say STDERR __x( "Warning: setting locale category LC_CTYPE to {locale} failed -- is it installed on this system?", locale => $locale ) . "\n\n"; } if ( $opt_version ) { print_versions(); return $EXIT_SUCCESS; } if ( $opt_list_tests ) { print_test_list(); return $EXIT_SUCCESS; } # errors and warnings if ( defined $opt_encoding ) { say STDERR __( "Warning: deprecated --encoding, simply remove it from your usage." ); } if ( $opt_json_stream and defined $opt_json and not $opt_json ) { say STDERR __( "Error: --json-stream and --no-json cannot be used together." ); return $EXIT_USAGE_ERROR; } if ( defined $opt_json_translate ) { unless ( $opt_json or $opt_json_stream ) { printf STDERR __( "Warning: --json-translate has no effect without either --json or --json-stream." ) . "\n"; } if ( $opt_json_translate ) { printf STDERR __( "Warning: deprecated --json-translate, use --no-raw instead." ) . "\n"; } else { printf STDERR __( "Warning: deprecated --no-json-translate, use --raw instead." ) . "\n"; } } # align values $opt_json = 1 if $opt_json_stream; $opt_raw //= defined $opt_json_translate ? !$opt_json_translate : 0; # Filehandle for diagnostics output my $fh_diag = ( $opt_json or $opt_raw or $opt_dump_profile ) ? *STDERR # Structured output mode (e.g. JSON) : *STDOUT; # Human readable output mode my $show_progress = $opt_progress // !!-t STDOUT && !$opt_json && !$opt_raw; if ( $opt_profile ) { say $fh_diag __x( "Loading profile from {path}.", path => $opt_profile ); my $json = read_file( $opt_profile ); my $foo = Zonemaster::Engine::Profile->from_json( $json ); my $profile = Zonemaster::Engine::Profile->default; $profile->merge( $foo ); Zonemaster::Engine::Profile->effective->merge( $profile ); } if ( defined $opt_sourceaddr4 ) { local $@; eval { Zonemaster::Engine::Profile->effective->set( q{resolver.source4}, $opt_sourceaddr4 ); 1; } or do { say STDERR __x( "Error: invalid value for --sourceaddr4: {reason}", reason => $@ ); return $EXIT_USAGE_ERROR; }; } if ( defined $opt_sourceaddr6 ) { local $@; eval { Zonemaster::Engine::Profile->effective->set( q{resolver.source6}, $opt_sourceaddr6 ); 1; } or do { say STDERR __x( "Error: invalid value for --sourceaddr6: {reason}", reason => $@ ); return $EXIT_USAGE_ERROR; }; } { my %all_methods = Zonemaster::Engine->all_methods; my $cases = Zonemaster::CLI::TestCaseSet->new( # Zonemaster::Engine::Profile->effective->get( q{test_cases} ), \%all_methods, ); for my $test ( @opt_test ) { my @modifiers = Zonemaster::CLI::TestCaseSet->parse_modifier_expr( $test ); while ( @modifiers ) { my $op = shift @modifiers; my $term = shift @modifiers; if ( !$cases->apply_modifier( $op, $term ) ) { say STDERR __x( "Error: unrecognized term '{term}' in --test.", term => $term ) . "\n"; return $EXIT_USAGE_ERROR; } } } Zonemaster::Engine::Profile->effective->set( q{test_cases}, [ $cases->to_list ] ), } # These two must come after any profile from command line has been loaded # to make any IPv4/IPv6 option override the profile setting. if ( defined( $opt_ipv4 ) ) { Zonemaster::Engine::Profile->effective->set( q{net.ipv4}, $opt_ipv4 ); } if ( defined( $opt_ipv6 ) ) { Zonemaster::Engine::Profile->effective->set( q{net.ipv6}, $opt_ipv6 ); } if ( $opt_dump_profile ) { do_dump_profile(); return $EXIT_SUCCESS; } if ( $opt_stop_level and not defined( $numeric{$opt_stop_level} ) ) { say STDERR __x( "Failed to recognize stop level '{level}'.", level => $opt_stop_level ); return $EXIT_USAGE_ERROR; } if ( not defined $numeric{$opt_level} ) { say STDERR __( "--level must be one of CRITICAL, ERROR, WARNING, NOTICE, INFO, DEBUG, DEBUG2 or DEBUG3." ); return $EXIT_USAGE_ERROR; } if ( $opt_restore ) { Zonemaster::Engine->preload_cache( $opt_restore ); } my $level_width = 0; foreach ( keys %numeric ) { if ( $numeric{$opt_level} <= $numeric{$_} ) { my $width_l10n = length( decode_utf8( translate_severity( $_ ) ) ); $level_width = $width_l10n if $width_l10n > $level_width; } } my $translator; my %field_width = ( seconds => 7, level => $level_width, module => 12, testcase => 14 ); my %header_names = (); my %remaining_space = (); # Callback defined here so it closes over the setup above. # But we can’t use it right now because the translator isn’t initialized. my $message_printer = sub { my ( $entry ) = @_; print_spinner() if $show_progress; my $entry_level = $entry->level; $counter{ uc $entry_level } += 1; if ( $numeric{ uc $entry_level } >= $numeric{$opt_level} ) { $printed_something = 1; if ( $opt_json and $opt_json_stream ) { my %r; $r{timestamp} = $entry->timestamp if $opt_time; $r{module} = $entry->module if $opt_show_module; $r{testcase} = $entry->testcase if $opt_show_testcase; $r{tag} = $entry->tag; $r{level} = $entry_level if $opt_show_level; $r{args} = $entry->args if $entry->args; $r{message} = $translator->translate_tag( $entry ) unless $opt_raw; say $JSON->encode( \%r ); } elsif ( $opt_json and not $opt_json_stream ) { # Don't do anything } else { my $prefix = q{}; if ( $opt_time ) { $prefix .= sprintf "%*.2f ", ${ field_width { seconds } }, $entry->timestamp; } if ( $opt_show_level ) { $prefix .= $opt_raw ? $entry->level : translate_severity( $entry->level ); my $space_l10n = ${ field_width { level } } - length( decode_utf8( translate_severity( $entry_level ) ) ) + 1; $prefix .= ' ' x $space_l10n; } if ( $opt_show_module ) { $prefix .= sprintf "%-*s ", ${ field_width { module } }, $entry->module; } if ( $opt_show_testcase ) { $prefix .= sprintf "%-*s ", ${ field_width { testcase } }, $entry->testcase; } if ( $opt_raw ) { $prefix .= $entry->tag; my $message = $entry->argstr; my @lines = split /\n/, $message; printf "%s%s %s\n", $prefix, ' ', @lines ? shift @lines : ''; for my $line ( @lines ) { printf "%s%s %s\n", $prefix, '>', $line; } } else { if ( $entry_level eq q{DEBUG3} and scalar( keys %{ $entry->args } ) == 1 and defined $entry->args->{packet} ) { my $packet = $entry->args->{packet}; my $padding = q{ } x length $prefix; $entry->args->{packet} = q{}; printf "%s%s\n", $prefix, $translator->translate_tag( $entry ); foreach my $line ( split /\n/, $packet ) { printf "%s%s\n", $padding, $line; } } else { printf "%s%s\n", $prefix, $translator->translate_tag( $entry ); } } } ## end else [ if ( $opt_json and $opt_json_stream)] } ## end if ( $numeric{ uc $entry_level...}) if ( $opt_stop_level and $numeric{ uc $entry->level } >= $numeric{$opt_stop_level} ) { die( Zonemaster::Engine::Exception::NormalExit->new( { message => "Saw message at level " . $entry->level } ) ); } }; # Instead, hold early messages in a temporary queue and switch to the # actual callback when we are ready. my @held_messages; Zonemaster::Engine->logger->callback( sub { my ( $entry ) = @_; push @held_messages, @_; } ); if ( @argv > 1 ) { say STDERR __( "Only one domain can be given for testing. Did you forget to prepend an option with '--