Dist-Zilla-Plugin-Twitter

 view release on metacpan or  search on metacpan

README.mkdn  view on Meta::CPAN


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](https://metacpan.org/pod/CPAN::Meta::Spec) and the "$TYPE DATA" sections of [CPAN::Meta](https://metacpan.org/pod/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

# AVAILABILITY

The latest version of this module is available from the Comprehensive Perl
Archive Network (CPAN). Visit [http://www.perl.com/CPAN/](http://www.perl.com/CPAN/) to find a CPAN
site near you, or see [https://metacpan.org/module/Dist::Zilla::Plugin::Twitter/](https://metacpan.org/module/Dist::Zilla::Plugin::Twitter/).

# SOURCE

The development version is on github at [http://github.com/dagolden/dist-zilla-plugin-twitter](http://github.com/dagolden/dist-zilla-plugin-twitter)
and may be cloned from [git://github.com/dagolden/dist-zilla-plugin-twitter.git](git://github.com/dagolden/dist-zilla-plugin-twitter.git)

# BUGS AND LIMITATIONS

You can make new bug reports, and view existing ones, through the
web interface at [https://github.com/dagolden/dist-zilla-plugin-twitter/issues](https://github.com/dagolden/dist-zilla-plugin-twitter/issues).

# AUTHORS

- David Golden <dagolden@cpan.org>
- Mike Doherty <doherty@cpan.org>

# COPYRIGHT AND LICENSE

This software is Copyright (c) 2014 by David Golden.

This is free software, licensed under:

    The Apache License, Version 2.0, January 2004



( run in 0.872 second using v1.01-cache-2.11-cpan-39bf76dae61 )