NAME

vcardtidy - normalize the format of VCARD files

VERSION

1.0.1 (2022-10-05)

SYNOPSIS

  usage: vcardtidy [FILES...] [OPTIONS...]

    Synopsis:
      tidy (normalize) VCARD contact files

    Arguments:
      FILES         Str   file to tidy (default is stdin)

    Options:
      --filter,  -f PERL  Perl filter(s) to run against $_ first
      --help,    -h       print a Help message and exit
      --no-rev,  -R       do not update REV value
      --version, -V       print version information and exit

DESCRIPTION

vcardtidy formats VCARD files, using Text::vCard::Addressbook to normalize field order and capitalization.

By default vcardtidy acts like a filter, reading from stdin and writing to stdout. Any file names given as arguments will be tidied up in place.

GLOBAL OPTIONS

--filter, -f PERL

Before tidying, evaluate the PERL string with $_ set to the input text. Can be used multiple times.

You can easily achieve the same effect with tools like sed(1), awk(1) or even perl(1) itself. But --filter ensures that you still have a valid VCARD afterwards, allowing you to easily iterate while you develop your change.

To add an additional or missing category for example:

        $ vcardtidy \
       -f '$_ .= "\nCATEGORIES:\n" unless m/^CATEGORIES:/m' \
       -f 's/^(CATEGORIES:\S+)(\s+)$/$1,$2/m' \
       -f 's/^(CATEGORIES:.*)(\s+)$/${1}NewCat$2/m'

--help, -h

Print the full usage message and exit.

--no-rev, -R

By default vcardtidy sets a new "REV" timestamp. Use this flag to prevent that.

--version, -V

Print the version and exit.

SUPPORT

This tool is managed via github:

    https://github.com/mlawren/vcardtidy

SEE ALSO

githook-perltidy(1)

AUTHOR

Mark Lawrence <nomad@null.net>

COPYRIGHT AND LICENSE

Copyright 2022 Mark Lawrence <nomad@null.net>

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.