NAME

Dist::Zilla::Plugin::Twitter - Twitter when you release with Dist::Zilla

VERSION

version 0.007

SYNOPSIS

In your dist.ini:

[Twitter]
hash_tags = #foo

In your .netrc:

machine api.twitter.com
  login YOUR_TWITTER_USER_NAME
  password YOUR_TWITTER_PASSWORD

DESCRIPTION

This plugin will use Net::Twitter with the login and password in your .netrc file to send a release notice to Twitter. By default, it will include a link to your README file as extracted on a fast CPAN mirror. This works very nicely with Dist::Zilla::Plugin::ReadmeFromPod.

The default configuration is as follows:

[Twitter]
tweet_url = http://cpan.cpantesters.org/authors/id/{{$AUTHOR_PATH}}/{{$DIST}}-{{$VERSION}}.readme
tweet = Released {{$DIST}}-{{$VERSION}} {{$URL}}

The tweet_url is shortened with WWW::Shorten::TinyURL and appended to the tweet messsage. The following variables are available for substitution in the URL and message templates:

DIST        # Foo-Bar
VERSION     # 1.23
TARBALL     # Foo-Bar-1.23.tar.gz
AUTHOR_UC   # JOHNDOE
AUTHOR_LC   # johndoe
AUTHOR_PATH # J/JO/JOHNDOE
URL         # TinyURL

You must be using the UploadToCPAN plugin for this plugin to determine your CPAN author ID.

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

AUTHOR

David Golden <dagolden@cpan.org>

COPYRIGHT AND LICENSE

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

This is free software, licensed under:

The Apache License, Version 2.0, January 2004