GitHunt
MR

mr-mixas/NDTools

Command line tools for nested structures

package App::NDTools;

use strict;
use warnings;

=head1 NAME

App::NDTools - Command line tools for nested structures

=begin html

CI
Coverage Status
CPAN version

=end html

=head1 VERSION

Version 0.6.3

=cut

our $VERSION = "0.6.3";

=head1 DESCRIPTION

Diff, patch, process, query JSON and YAML with ease.

=head1 TOOLS

=over 4

=item B<L>

Human friendly and machine readable diffs.

=item B<L>

Apply diff to the structure.

=item B<L>

Process structure using rules and modules.

Available modules:

Insert           Insert value into structure
JsonMergePatch   Apply JSON Merge Patch (rfc7396) patches
JsonPatch        Apply JSON Patch (rfc6902) patches
Merge            Merge structures according provided rules
Patch            Apply nested diff to the structure
Pipe             Modify structure using external process
Remove           Remove specified parts from structure

=item B<L>

Examine structure and dump it's parts.

=back

=head1 INSTALL

From CPAN:

cpanm App::NDTools

Build deb package:

git clone https://github.com/mr-mixas/NDTools.git
cd NDTools
DEBUILD_OPTS="--no-lintian -uc -us -b" make -C dist deb

Use without installation:

git clone https://github.com/mr-mixas/NDTools.git
cd NDTools
source ./SOURCEME # install depends to the current directory and set ENV

=head1 LIMITATIONS

LYAML::XS should be additionally installed for YAML support. LYAML::XS
C<0.67> or later and LJSON::PP required for correct booleans dump; C<1> for
true and C<0> for false used for earlier LYAML::XS versions.

=head1 AUTHOR

Michael Samoglyadov, C<< >>

=head1 BUGS

Sure, report them using Lhttps://github.com/mr-mixas/NDTools/issues

=head1 SEE ALSO

L<jq|https://stedolan.github.io/jq/>,
L<json-delta|https://json-delta.readthedocs.io/en/latest/>

LStruct::Diff, LStruct::Path, LStruct::Path::PerlStyle

=head1 LICENSE AND COPYRIGHT

Copyright 2016-2019 Michael Samoglyadov

This program is free software: you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation, either version 3 of the License, or (at your option) any later
version.

This program is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program. If not, see Lhttp://www.gnu.org/licenses/.

=cut

Contributors

GNU General Public License v3.0
Created March 27, 2016
Updated November 9, 2024