package pgFormatter::CLI;

use strict;
use warnings;

# UTF8 boilerplace, per http://stackoverflow.com/questions/6162484/why-does-modern-perl-avoid-utf-8-by-default/
use warnings qw( FATAL );
use utf8;
use open   qw( :std :encoding(UTF-8) );
use Encode qw( decode );

=head1 NAME

pgFormatter::CLI - Implementation of command line program to format SQL queries.

=head1 VERSION

Version 5.11

=cut

# Version of pgFormatter
our $VERSION = '5.11';

use autodie;
use pgFormatter::Beautify;
use Getopt::Long qw(:config no_ignore_case bundling);
use File::Basename;

=head1 SYNOPSIS

This module is called by pg_format program, when it detects it is not being
run in CGI environment. In such case all control over flow is passed to this
module by calling:

    my $program = pgFormatter::CLI->new();
    $program->run()

=head1 FUNCTIONS

=head2 new

Object constructor, nothing fancy in here.

=cut

sub new {
	my $class = shift;
	return bless {}, $class;
}

=head2 run

Wraps all work related to pg_format CLI program. This includes calling
methods to read command line parameters, validate them, read query, beautify
it, and output.

=cut

sub run {
	my $self = shift;
	$self->get_command_line_args();

	$self->show_help_and_die( 2,
'can not use -i | --inplace option together with the -o | --output option.'
	) if ( $self->{'cfg'}->{'inplace'} and $self->{'cfg'}->{'output'} );

	my @inputs = @ARGV == 0 ? ('-') : @ARGV;

	foreach my $input (@inputs) {
		$self->{'cfg'}->{'input'} = $input;
		$self->{'cfg'}->{'output'} ||= '-';    # Set output to default value.

		$self->validate_args();
		$self->logmsg(
			'DEBUG',
			'Starting to parse SQL file: %s',
			$self->{'cfg'}->{'input'}
		);
		$self->load_sql();
		$self->logmsg( 'DEBUG', 'Beautifying' );
		$self->beautify();
		if ( $self->{'wrap_limit'} ) {
			$self->logmsg( 'DEBUG', 'Wrap query' );
			$self->wrap_lines( $self->{'wrap_comment'} );
		}
		$self->logmsg( 'DEBUG', 'Writing output' );
		$self->save_output();
	}

	return;
}

=head2 beautify

Actually formats loaded query using pgFormatter::Beautify library. If
necessary runs anonymization.

=cut

sub beautify {
	my $self = shift;
	my %args;
	$args{'no_comments'}           = 1 if $self->{'cfg'}->{'nocomment'};
	$args{'spaces'}                = $self->{'cfg'}->{'spaces'};
	$args{'uc_keywords'}           = $self->{'cfg'}->{'keyword-case'};
	$args{'uc_functions'}          = $self->{'cfg'}->{'function-case'};
	$args{'uc_types'}              = $self->{'cfg'}->{'type-case'};
	$args{'placeholder'}           = $self->{'cfg'}->{'placeholder'};
	$args{'multiline'}             = $self->{'cfg'}->{'multiline'};
	$args{'separator'}             = $self->{'cfg'}->{'separator'};
	$args{'comma'}                 = $self->{'cfg'}->{'comma'};
	$args{'comma_break'}           = $self->{'cfg'}->{'comma-break'};
	$args{'format'}                = $self->{'cfg'}->{'format'};
	$args{'maxlength'}             = $self->{'cfg'}->{'maxlength'};
	$args{'format_type'}           = $self->{'cfg'}->{'format-type'};
	$args{'wrap_limit'}            = $self->{'cfg'}->{'wrap-limit'};
	$args{'wrap_after'}            = $self->{'cfg'}->{'wrap-after'};
	$args{'space'}                 = $self->{'cfg'}->{'space'};
	$args{'no_grouping'}           = $self->{'cfg'}->{'nogrouping'};
	$args{'numbering'}             = $self->{'cfg'}->{'numbering'};
	$args{'redshift'}              = $self->{'cfg'}->{'redshift'};
	$args{'wrap_comment'}          = $self->{'cfg'}->{'wrap-comment'};
	$args{'no_extra_line'}         = $self->{'cfg'}->{'no-extra-line'};
	$args{'config'}                = $self->{'cfg'}->{'config'};
	$args{'no_rcfile'}             = $self->{'cfg'}->{'no-rcfile'};
	$args{'inplace'}               = $self->{'cfg'}->{'inplace'};
	$args{'keep_newline'}          = $self->{'cfg'}->{'keep-newline'};
	$args{'extra_function'}        = $self->{'cfg'}->{'extra-function'};
	$args{'extra_keyword'}         = $self->{'cfg'}->{'extra-keyword'};
	$args{'no_space_function'}     = $self->{'cfg'}->{'no-space-function'};
	$args{'redundant_parenthesis'} = $self->{'cfg'}->{'redundant-parenthesis'};
	$args{'vertical_align'}        = $self->{'cfg'}->{'vertical-align'};

	# Backward compatibility
	$args{'extra_keyword'} = 'redshift'
	  if ( !$self->{'cfg'}->{'extra-keyword'} && $self->{'cfg'}->{'redshift'} );

	if (
		$self->{'query'}
		&& ( $args{'maxlength'}
			&& length( $self->{'query'} ) > $args{'maxlength'} )
	  )
	{
		$self->{'query'} = substr( $self->{'query'}, 0, $args{'maxlength'} );
	}

	my $beautifier = pgFormatter::Beautify->new(%args);
	if ( $args{'extra_function'} && -e $args{'extra_function'} ) {
		if ( open( my $fh, '<', $args{'extra_function'} ) ) {
			my @fcts = ();
			while ( my $l = <$fh> ) {
				chomp($l);
				push( @fcts, split( /^[\s,;]+$/, $l ) );
			}
			$beautifier->add_functions(@fcts);
			close($fh);
		}
		else {
			warn("WARNING: can not read file $args{ 'extra_function' }\n");
		}
	}
	if (   $args{'extra_keyword'}
		&& $args{'extra_keyword'} ne 'redshift'
		&& -e $args{'extra_keyword'} )
	{
		if ( open( my $fh, '<', $args{'extra_keyword'} ) ) {
			my @fcts = ();
			while ( my $l = <$fh> ) {
				chomp($l);
				push( @fcts, split( /^[\s,;]+$/, $l ) );
			}
			$beautifier->add_keywords(@fcts);
			close($fh);
		}
		else {
			warn("WARNING: can not read file $args{ 'extra_keyword' }\n");
		}
	}
	elsif ( $args{'extra_keyword'} eq 'redshift' or $args{'redshift'} ) {
		$beautifier->add_keywords(
			@{ $beautifier->{'dict'}->{'redshift_keywords'} } );
	}
	$beautifier->query( $self->{'query'} );
	$beautifier->anonymize() if $self->{'cfg'}->{'anonymize'};
	$beautifier->beautify();
	if ( $self->{'cfg'}->{'wrap-limit'} ) {
		$self->logmsg( 'DEBUG', 'Wrap query' );
		$beautifier->wrap_lines( $self->{'cfg'}->{'wrap-comment'} );
	}

	$self->{'ready'} = $beautifier->content();

	return;
}

=head2 save_output

Saves beautified query to whatever is output filehandle

=cut

sub save_output {
	my $self = shift;
	my $fh;

	# Thanks to "autodie" I don't have to check if open() worked.
	if ( $self->{'cfg'}->{'output'} ne '-' ) {
		$self->logmsg( 'DEBUG',
			'Formatted SQL queries will be written to file ' . $self->{'cfg'}->{'output'} );
		open $fh, '>', $self->{'cfg'}->{'output'};
	}
	else {
		$self->logmsg( 'DEBUG',
			'Formatted SQL queries will be written to stdout' );
		$fh = \*STDOUT;
	}
	print $fh $self->{'ready'};
	close $fh if ( $self->{'cfg'}->{'output'} ne '-' );
	return;
}

=head2 logmsg

Display message following the log level

=cut

sub logmsg {
	my $self = shift;
	my ( $level, $str, @args ) = @_;

	return if ( !$self->{'cfg'}->{'debug'} && ( $level eq 'DEBUG' ) );

	printf STDERR "%s: $str\n", $level, @args;
	return;
}

=head2 show_help_and_die

As name suggests - shows help page, with optional error message, and ends
program.

=cut

sub show_help_and_die {
	my $self = shift;
	my ( $status, $format, @args ) = @_;

	if ($format) {
		$format =~ s/\s*$//;
		printf STDERR "Error: $format\n\n", @args;
	}

	my $program_name = basename($0);
	my $help         = qq{
Usage: $program_name [options] file.sql

    PostgreSQL SQL queries and PL/PGSQL code beautifier.

Arguments:

    file.sql can be a file, multiple files or use - to read query from stdin.

    Returning the SQL formatted to stdout or into a file specified with
    the -o | --output option.

Options:

    -a | --anonymize      : obscure all literals in queries, useful to hide
                            confidential data before formatting.
    -b | --comma-start    : in a parameters list, start with the comma (see -e)
    -B | --comma-break    : in insert statement, add a newline after each comma.
    -c | --config FILE    : use a configuration file. Default is to not use
                            configuration file unless files ./.pg_format or
			    \$HOME/.pg_format or the XDG Base Directory file
			    \$XDG_CONFIG_HOME/pg_format/pg_format.conf exist.
    -C | --wrap-comment   : with --wrap-limit, apply reformatting to comments.
    -d | --debug          : enable debug mode. Disabled by default.
    -e | --comma-end      : in a parameters list, end with the comma (default)
    -f | --function-case N: Change the case of the PostgreSQL functions. Default
                            unchanged: 0. Values: 0=>unchanged, 1=>lowercase,
                            2=>uppercase, 3=>capitalize.
    -F | --format STR     : output format: text or html. Default: text.
    -g | --nogrouping     : add a newline between statements in transaction
                            regroupement. Default is to group statements.
    -h | --help           : show this message and exit.
    -i | --inplace        : override input files with formatted content.
    -k | --keep-newline   : preserve empty line in plpgsql code.
    -L | --no-extra-line  : do not add an extra empty line at end of the output.
    -m | --maxlength SIZE : maximum length of a query, it will be cutted above
                            the given size. Default: no truncate.
    -M | --multiline      : enable multi-line search for -p or --placeholder.
    -n | --nocomment      : remove any comment from SQL code.
    -N | --numbering      : statement numbering as a comment before each query.
    -o | --output file    : define the filename for the output. Default: stdout.
    -p | --placeholder RE : set regex to find code that must not be changed.
    -r | --redshift       : add RedShift keyworks to the list of SQL keyworks.
                            Obsolete now, use --extra-keyword 'redshift' instead.
    -s | --spaces size    : change space indent, default 4 spaces.
    -S | --separator STR  : dynamic code separator, default to single quote.
    -t | --format-type    : try another formatting type for some statements.
    -T | --tabs           : use tabs instead of space characters, when used
                            spaces is set to 1 whatever is the value set to -s.
    -u | --keyword-case N : Change the case of the reserved keyword. Default is
                            uppercase: 2. Values: 0=>unchanged, 1=>lowercase,
                            2=>uppercase, 3=>capitalize.
    -U | --type-case N    : Change the case of the data type name. Default is
                            lowercase: 1. Values: 0=>unchanged, 1=>lowercase,
                            2=>uppercase, 3=>capitalize.
    -v | --version        : show pg_format version and exit.
    -w | --wrap-limit N   : wrap queries at a certain length.
    -W | --wrap-after N   : number of column after which lists must be wrapped.
                            Default: puts every item on its own line.
    -X | --no-rcfile      : don't read rc files automatically (./.pg_format or
                            \$HOME/.pg_format or \$XDG_CONFIG_HOME/pg_format).
			    The --config / -c option overrides it.
    --extra-function FILE : file containing a list of functions to use the same
                            formatting as PostgreSQL internal function.
    --extra-keyword FILE  : file containing a list of keywords to use the same
                            formatting as PostgreSQL internal keyword. Use
			    special value 'redshift' for support to Redshift
			    keywords defined internaly in pgFormatter.
    --no-space-function : remove space between function call and the open
                            parenthesis.
    --redundant-parenthesis: do not remove redundant parenthesis in DML.
    --vertical-align      : vertically align CREATE TABLE column definitions and
                            trailing comments.

Examples:

    cat samples/ex1.sql | $0 -
    $0 -n samples/ex1.sql
    $0 -f 2 -n -o result.sql samples/ex1.sql
};

	if ($status) {
		print STDERR $help;
	}
	else {
		print $help;
	}

	exit $status;
}

=head2 load_sql

Loads SQL from input file or stdin.

=cut

sub load_sql {
	my $self = shift;
	local $/ = undef;
	my $fh;
	if ( $self->{'cfg'}->{'input'} ne '-' ) {
		open $fh, '<', $self->{'cfg'}->{'input'};
	}
	else {
		$fh = \*STDIN;
	}
	binmode( $fh, ":encoding(utf8)" );
	$self->{'query'} = <$fh>;
	close $fh if ( $self->{'cfg'}->{'input'} ne '-' );
	return;
}

=head2 get_command_line_args

Parses command line options into $self->{'cfg'}.

=cut

sub get_command_line_args {
	my $self = shift;
	my %cfg;
	my @options = (
		'anonymize|a!',    'comma-start|b!',
		'comma-break|B!',  'config|c=s',
		'no-rcfile|X!',    'wrap-comment|C!',
		'debug|d!',        'comma-end|e!',
		'format|F=s',      'nogrouping|g!',
		'help|h!',         'function-case|f=i',
		'keep-newline|k!', 'no-extra-line|L!',
		'maxlength|m=i',   'multiline|M!',
		'nocomment|n!',    'numbering|N!',
		'output|o=s',      'placeholder|p=s',
		'redshift|r!',     'separator|S=s',
		'spaces|s=i',      'format-type|t!',
		'tabs|T!',         'keyword-case|u=i',
		'type-case|U=i',   'version|v!',
		'wrap-limit|w=i',  'wrap-after|W=i',
		'inplace|i!',      'extra-function=s',
		'extra-keyword=s', 'no-space-function!',
		'redundant-parenthesis!', 'vertical-align!',
	);

	$self->show_help_and_die(1) unless GetOptions( \%cfg, @options );

	$self->show_help_and_die(0) if $cfg{'help'};

	if ( $cfg{'version'} ) {
		printf '%s version %s%s', basename($0), $VERSION, "\n";
		exit 0;
	}

	if ( !$cfg{'no-rcfile'} ) {
		if ( -e ".pg_format" ) {
			$cfg{'config'} //= ".pg_format";
		}
		elsif ( defined $ENV{HOME} && -e "$ENV{HOME}/.pg_format" ) {
			$cfg{'config'} //= "$ENV{HOME}/.pg_format";
		}
		elsif ( defined $ENV{USERPROFILE} && -e "$ENV{USERPROFILE}/.pg_format" )
		{
			$cfg{'config'} //= "$ENV{USERPROFILE}/.pg_format";
		}
		elsif ( defined $ENV{XDG_CONFIG_HOME}
			&& -e "$ENV{XDG_CONFIG_HOME}/pg_format/pg_format.conf" )
		{
			$cfg{'config'} //= "$ENV{XDG_CONFIG_HOME}/pg_format/pg_format.conf";
		}
	}

	if ( defined $cfg{'config'} && -f $cfg{'config'} ) {
		open( my $cfh, '<', $cfg{'config'} )
		  or die "ERROR: can not read file $cfg{ 'config' }\n";
		while ( my $line = <$cfh> ) {
			chomp($line);
			next if ( $line !~ /^[a-z]/ );
			if ( $line =~ /^([^\s=]+)\s*=\s*([^\s]+)/ ) {

				# do not override command line arguments
				next if ( defined $cfg{ lc($1) } );

				if ( $1 eq 'comma' || $1 eq 'format' ) {
					$cfg{ lc($1) } = lc($2);
				}
				else {
					$cfg{ lc($1) } = $2;
				}
			}
		}
	}

	# Set default configuration
	$cfg{'spaces'}        //= 4;
	$cfg{'output'}        //= '';
	$cfg{'function-case'} //= 0;
	$cfg{'keyword-case'}  //= 2;
	$cfg{'type-case'}     //= 1;
	$cfg{'comma'}         //= 'end';
	$cfg{'format'}        //= 'text';
	$cfg{'comma-break'}   //= 0;
	$cfg{'maxlength'}     //= 0;
	$cfg{'format-type'}   //= 0;
	$cfg{'wrap-limit'}    //= 0;
	$cfg{'wrap-after'}    //= 0;
	$cfg{'wrap-comment'}  //= 0;
	$cfg{'space'}         //= ' ';
	$cfg{'numbering'}     //= 0;
	$cfg{'redshift'}      //= 0;
	$cfg{'no-extra-line'} //= 0;
	$cfg{'inplace'}       //= 0;
	$cfg{'extra-keyword'}  //= '';
	$cfg{'vertical-align'} //= 0;
	$cfg{'extra-keyword'} = 'redshift' if ( $cfg{'redshift'} );

	if ( $cfg{'tabs'} ) {
		$cfg{'spaces'} = 1;
		$cfg{'space'}  = "\t";
	}

	if ( !grep( /^$cfg{ 'comma' }$/i, 'end', 'start' ) ) {
		printf 'FATAL: unknown value for comma: %s', $cfg{'comma'}, "\n";
		exit 0;
	}

	if ( !grep( /^$cfg{ 'format' }$/i, 'text', 'html' ) ) {
		printf 'FATAL: unknown output format: %s%s', $cfg{'format'}, "\n";
		exit 0;
	}

	if ( $cfg{'extra-function'} && !-e $cfg{'extra-function'} ) {
		printf 'FATAL: file for extra function list does not exists: %s%s',
		  $cfg{'extra-function'}, "\n";
		exit 0;
	}

	if (   $cfg{'extra-keyword'}
		&& $cfg{'extra-keyword'} ne 'redshift'
		&& !-e $cfg{'extra-keyword'} )
	{
		printf 'FATAL: file for extra keyword list does not exists: %s%s',
		  $cfg{'extra-keyword'}, "\n";
		exit 0;
	}

	$self->{'cfg'} = \%cfg;

	return;
}

=head2 validate_args

Validates that options parsed from command line have sensible values, opens
input and output files.

=cut

sub validate_args {
	my $self = shift;

	$self->show_help_and_die( 2,
		'function-case can be only one of: 0, 1, 2, or 3.' )
	  unless $self->{'cfg'}->{'function-case'} =~ m{\A[0123]\z};
	$self->show_help_and_die( 2,
		'keyword-case can be only one of: 0, 1, 2, or 3.' )
	  unless $self->{'cfg'}->{'keyword-case'} =~ m{\A[0123]\z};
	$self->show_help_and_die( 2,
		'type-case can be only one of: 0, 1, 2, or 3.' )
	  unless $self->{'cfg'}->{'type-case'} =~ m{\A[0123]\z};

# Force output file to be the same as inout file when the inplace option is used
	if ( $self->{'cfg'}->{'inplace'} ) {
		$self->{'cfg'}->{'output'} = $self->{'cfg'}->{'input'};
	}

	if ( $self->{'cfg'}->{'comma-end'} ) {
		$self->{'cfg'}->{'comma'} = 'end';
	}
	elsif ( $self->{'cfg'}->{'comma-start'} ) {
		$self->{'cfg'}->{'comma'} = 'start';
	}

	return;
}

=head1 AUTHOR

pgFormatter is an original work from Gilles Darold

=head1 BUGS

Please report any bugs or feature requests to: https://github.com/darold/pgFormatter/issues

=head1 COPYRIGHT

Copyright 2012-2026 Gilles Darold. All rights reserved.

=head1 LICENSE

pgFormatter is free software distributed under the PostgreSQL Licence.

A modified version of the SQL::Beautify Perl Module is embedded in pgFormatter
with copyright (C) 2009 by Jonas Kramer and is published under the terms of
the Artistic License 2.0.

=cut

1;
