.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "Lemonldap::NG::Manager::Conf::Parser 3pm"
.TH Lemonldap::NG::Manager::Conf::Parser 3pm 2024-02-07 "perl v5.38.2" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
Lemonldap::NG::Manager::Conf::Parser \- Perl extension for parsing new uploaded
configurations.
.SH SYNOPSIS
.IX Header "SYNOPSIS"
.Vb 10
\&  require Lemonldap::NG::Manager::Conf::Parser;
\&  my $parser = Lemonldap::NG::Manager::Conf::Parser\->new(
\&      { tree => $new, refConf => $self\->currentConf }
\&  );
\&  my $res = { result => $parser\->check };
\&  $res\->{message} = $parser\->{message};
\&  foreach my $t (qw(errors warnings changes)) {
\&      push @{ $res\->{details} }, { message => $t, items => $parser\->$t }
\&        if ( @{$parser\->$t} );
\&  }
.Ve
.SH DESCRIPTION
.IX Header "DESCRIPTION"
Lemonldap::NG::Manager::Conf::Parser checks new configuration
.PP
This package is used by Manager to examine uploaded configuration. It is
currently called using \fBcheck()\fR which return a boolean.
\&\fBcheck()\fR looks if a newConf is available. If not, it builds it from uploaded
JSON (using \fBscanTree()\fR subroutine)
.PP
Messages are stored in \fBerrors()\fR, \fBwarnings()\fR and \fBchanges()\fR as arrays.
.PP
This interface uses Plack to be compatible with CGI, FastCGI,...
.SH "SEE ALSO"
.IX Header "SEE ALSO"
Lemonldap::NG::Manager, <http://lemonldap\-ng.org/>
.SH AUTHORS
.IX Header "AUTHORS"
.IP "LemonLDAP::NG team <http://lemonldap\-ng.org/team>" 4
.IX Item "LemonLDAP::NG team <http://lemonldap-ng.org/team>"
.SH "BUG REPORT"
.IX Header "BUG REPORT"
Use OW2 system to report bug or ask for features:
<https://gitlab.ow2.org/lemonldap\-ng/lemonldap\-ng/issues>
.PP
If you want to report a bug concerning configuration upload, please change
HIGHDEBUG constant value to produce more logs. Then post them in the Gitlab
ticket.
.SH DOWNLOAD
.IX Header "DOWNLOAD"
Lemonldap::NG is available at
<https://lemonldap\-ng.org/download>
.SH "COPYRIGHT AND LICENSE"
.IX Header "COPYRIGHT AND LICENSE"
See COPYING file for details.
.PP
This library 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 2, or (at your option)
any later version.
.PP
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.
.PP
You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.