- CONFIGURATION OPTIONS
- COPYRIGHT & LICENSE
App::GitHooks::Plugin::PgBouncerAuthSyntax - Verify that the syntax of PgBouncer auth files is correct.
This plugin verifies that staged PgBouncer authentication files have a proper syntax before allowing the commit to be completed.
See http://pgbouncer.projects.pgfoundry.org/doc/config.html, under the "Authentication File Format" section, for more information about the required syntax.
This plugin supports the following options in the
[PgBouncerAuthSyntax] section of your
[PgBouncerAuthSyntax] file_pattern = /^configs\/pgbouncer\/userlist.txt$/ comments_setting = disallow
A regular expression that will be checked against the path of files that are committed and that indicates a PgBouncer auth file to analyze when it matches.
file_pattern = /^configs\/pgbouncer\/userlist.txt$/
As of version 1.5.4, PgBouncer does not allow comments. This will however change in the next release, thanks to this patch.
Configure this setting accordingly based on your PgBouncer version:
Allow comments anywhere. Use with PgBouncer versions above 1.5.4 (not included).
comments_setting = allow_anywhere
Allow comments at the end of the file only. PgBouncer will stop parsing the auth file as soon as it encounters an incorrectly formatted line, so you can technically add comments at the end of the file. This setting will prevent you from accidentally adding anything but comments once the first comment is seen, to catch errors that are otherwise tricky to debug.
comments_setting = allow_end_only
Don't allow comments at all. The safest setting for PgBouncer versions up to 1.5.4 (included).
comments_setting = disallow
Return a pattern to filter the files this plugin should analyze.
my $file_pattern = App::GitHooks::Plugin::PgBouncerAuthSyntax->get_file_pattern( app => $app, );
Return a description of the check performed on files by the plugin and that will be displayed to the user, if applicable, along with an indication of the success or failure of the plugin.
my $description = App::GitHooks::Plugin::PgBouncerAuthSyntax->get_file_check_description();
Code to execute for each file as part of the pre-commit hook.
my $success = App::GitHooks::Plugin::PgBouncerAuthSyntax->run_pre_commit_file();
Please report any bugs or feature requests through the web interface at https://github.com/guillaumeaubert/App-GitHooks-Plugin-PgBouncerAuthSyntax/issues/new. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.
You can find documentation for this module with the perldoc command.
You can also look for information at:
GitHub's request tracker
AnnoCPAN: Annotated CPAN documentation
<aubertg at cpan.org>.
Copyright 2013-2017 Guillaume Aubert.
This code is free software; you can redistribute it and/or modify it under the same terms as Perl 5 itself.
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 LICENSE file for more details.