Dist::Zilla::Plugin::Twitter3pm

Variable interpolation

The following variables are available for substitution in the URL and message templates:

      DIST        # Foo-Bar
      MODULE      # Foo::Bar
      ABSTRACT    # Foo-Bar is a module that FooBars
      VERSION     # 1.23
      TRIAL       # -TRIAL if is_trial, empty string otherwise.
      TARBALL     # Foo-Bar-1.23.tar.gz
      AUTHOR_UC   # JOHNDOE
      AUTHOR_LC   # johndoe
      AUTHOR_PATH # J/JO/JOHNDOE
      URL         # http://tinyurl.com/...

DISTMETA INTERPOLATION

Resources information available in the META.* files of the distribution can be accessed via "<META{key}{subkey}[1]">. You may mix-and-match "{...}" to access hashref elements and "[\d]" to access arrayref elements. You're responsible for making sure you are accessing the right part of the META data structure, and treating it as the right type of data. See CPAN::Meta::Spec and the "$TYPE DATA" sections of CPAN::Meta in particular.

The "META{...}" replacement may also have one of two modifiers, which are prefixed directly before "META":

"!" - URL shortening

Providing an exclamation point ("!META{...}") will URL-shorten the value you extract from the distmeta data structure. This will have no effect unless the value is a URL to begin with.

"@" - Arrayref stringification

Providing an at-symbol (@META{...}) will include all the elements of the arrayref you specify by joining them with $". So, this is just like doing "@{ $your_array_ref }".

So, for example, to use the GitHub home of the project instead of its metacpan page, one can do:

    [Twitter]
    tweet = Released {{$DIST}}-{{$VERSION}}{{$TRIAL}} !META{resource}{repository}{web}
    url_shortener = TinyURL

Or, to include the authors in your tweet:

    [Twitter]
    tweet = @META{author} released {{$MODULE}} {{$VERSION}}: {{$URL}}

Pauseid

You must be using the "UploadToCPAN" or "FakeRelease" plugin for this plugin to determine your PAUSEID.

Hashtags

You can use the "hash_tags" option to append hash tags (or anything, really) to the end of the message generated from "tweet".

    [Twitter]
    hash_tags = #perl #cpan #foo