File perl-Devel-DumpTrace.spec of Package perl-Devel-DumpTrace

Overview Repositories Revisions Requests Users Attributes Meta

File perl-Devel-DumpTrace.spec of Package perl-Devel-DumpTrace

#
# spec file for package perl-Devel-DumpTrace
#
# Copyright (c) 2019 SUSE LINUX GmbH, Nuernberg, Germany.
#
# All modifications and additions to the file contributed by third parties
# remain the property of their copyright owners, unless otherwise agreed
# upon. The license for this file, and modifications and additions to the
# file, is the same license as for the pristine package itself (unless the
# license for the pristine package is not an Open Source License, in which
# case the license is the MIT License). An "Open Source License" is a
# license that conforms to the Open Source Definition (Version 1.9)
# published by the Open Source Initiative.

# Please submit bugfixes or comments via https://bugs.opensuse.org/
#

Name:           perl-Devel-DumpTrace
Version:        0.29
Release:        0
%define cpan_name Devel-DumpTrace
Summary:        Evaluate and print out each line before it is executed
License:        Artistic-1.0 OR GPL-1.0-or-later
Group:          Development/Libraries/Perl
Url:            https://metacpan.org/release/%{cpan_name}
Source0:        https://cpan.metacpan.org/authors/id/M/MO/MOB/%{cpan_name}-%{version}.tar.gz
BuildArch:      noarch
BuildRoot:      %{_tmppath}/%{name}-%{version}-build
BuildRequires:  perl
BuildRequires:  perl-macros
BuildRequires:  perl(Hash::SafeKeys) >= 0.01
BuildRequires:  perl(PadWalker) >= 1.5
Requires:       perl(Hash::SafeKeys) >= 0.01
Requires:       perl(PadWalker) >= 1.5
%{perl_requires}

%description
Similar to Devel::Trace, this module will cause a message to be printed to
standard error for each line of source code that is executed. In addition,
this module will attempt to identify variable names in the source code and
substitute the values of those variables. In this way you can see the path
of execution through your program as well as the value of variables at each
step of the program.

For example, if your program looks like this:

#!/usr/bin/perl
    # a demonstration of Devel::DumpTrace
    $a = 1;
    $b = 3;
    $c = 2 * $a + 7 * $b;
    @d = ($a, $b, $c + $b);

then the 'DumpTrace' output will look like:

$ perl -d:DumpTrace demo.pl
    >>>>> demo.pl:3:        $a:1 = 1;
    >>>>> demo.pl:4:        $b:3 = 3;
    >>>>> demo.pl:5:        $c:23 = 2 * $a:1 + 7 * $b:3;
    >>>>> demo.pl:6:        @d:(1,3,26) = ($a:1, $b:3, $c:23 + $b:3);

There are also more _verbose_ modes which will produce even more detailed
output:

$ perl -d:DumpTrace=verbose demo.pl
    >>  demo.pl:3:
    >>>              $a = 1;
    >>>>>            1 = 1;
    -------------------------------------------
    >>  demo.pl:4:
    >>>              $b = 3;
    >>>>>            3 = 3;
    -------------------------------------------
    >>  demo.pl:5:
    >>>              $c = 2 * $a + 7 * $b;
    >>>>             $c = 2 * 1 + 7 * 3;
    >>>>>            23 = 2 * 1 + 7 * 3;
    -------------------------------------------
    >>  demo.pl:6:
    >>>              @d = ($a, $b, $c + $b);
    >>>>             @d = (1, 3, 23 + 3);
    >>>>>            (1,3,26) = (1, 3, 23 + 3);
    -------------------------------------------

See '$Devel::DumpTrace::TRACE' under the "VARIABLES" section for more
details about the different levels of verbosity.

This distribution comes with both a basic parser and a PPI-based parser
(which relies on PPI to understand your source code). The PPI version has
more features and fewer limitations than the basic parser. If the PPI
module is installed on your system, then this module will automatically use
the PPI-based parser to analyze the traced code. You can force this module
to use the basic parser by running with the '-d:DumpTrace::noPPI' argument
or by setting the 'DUMPTRACE_NOPPI' environment variable:

# use PPI if available, otherwise use basic parser
    $ perl -d:DumpTrace program.pl

# use PPI, fail if it is not available
    $ perl -d:DumpTrace::PPI program.pl

# always uses basic parser
    $ perl -d:DumpTrace::noPPI program.pl
    $ DUMPTRACE_NOPPI=1 perl -d:DumpTrace program.pl

See the "BUGS AND LIMITATIONS" section for important, er, limitations of
this module, especially for the basic parser.

%prep
%setup -q -n %{cpan_name}-%{version}

%build
perl Makefile.PL INSTALLDIRS=vendor
make %{?_smp_mflags}

%check
make test

%install
%perl_make_install
%perl_process_packlist
%perl_gen_filelist

%files -f %{name}.files
%defattr(-,root,root,755)
%doc Changes README

%changelog

Places

File perl-Devel-DumpTrace.spec of Package perl-Devel-DumpTrace

Places