Metadata-Version: 2.1
Name: last-shout
Version: 0.7.0
Summary: A program to post Last.fm statistics to Twitter and/or Mastodon
Home-page: https://github.com/bpepple/last-shout
Author: Brian Pepple
Author-email: bdpepple@gmail.com
License: GPLv3
Description: ==========
        Last-Shout
        ==========
        
        
        .. image:: https://img.shields.io/pypi/v/last-shout.svg
            :target: https://pypi.org/project/last-shout/
        
        .. image:: https://img.shields.io/pypi/pyversions/last-shout.svg
            :target: https://pypi.org/project/last-shout/
        
        .. image:: https://codecov.io/gh/bpepple/last-shout/branch/master/graph/badge.svg
            :target: https://codecov.io/gh/bpepple/last-shout
            :alt: Code coverage Status
        
        .. image:: https://travis-ci.org/bpepple/last-shout.svg?branch=master
            :target: https://travis-ci.org/bpepple/last-shout
        
        .. image:: https://img.shields.io/badge/code%20style-black-000000.svg
            :target: https://github.com/psf/black
        
        Quick Description
        -----------------
        
        A command line tool to tweet a user's top artist statistics from Last.fm to Twitter and Mastodon.
        
        Installation
        ------------
        
        PyPi
        ~~~~
        
        Install it yourself:
        
        .. code:: bash
        
          $ pip install --user last-shout
        
        GitHub
        ~~~~~~
        
        Installing the latest version from Github:
        
        .. code:: bash
        
          $ git clone https://github.com/bpepple/last-shout.git
          $ cd last-shout
          $ python3 setup.py install
        
        Getting started
        ---------------
        
        In order to use Last-Shout, you need at a minimum to get authentication keys for Twitter_ and Last.fm_.
        
        - To get the necessary authenticaton keys for **Twitter**, refer to the documentation here_.
        
        - To get the necessary authentication keys for **Last.fm**, refer to their documentation_.
        
        .. _Twitter: https://twitter.com
        
        .. _Last.fm: https://www.last.fm
        
        .. _here: https://python-twitter.readthedocs.io/en/latest/getting_started.html
        
        .. _documentation: https://python-twitter.readthedocs.io/en/latest/getting_started.html
        
        Help
        ----
        
        ::
        
          usage: main.py [-h] [-u USER] [--last-access-key LAST_ACCESS_KEY]
                         [--set-lastfm] [-n NUMBER] [-p PERIOD] [-t]
                         [--consumer-key CONSUMER_KEY]
                         [--consumer-secret CONSUMER_SECRET] [--access-key ACCESS_KEY]
                         [--access-secret ACCESS_SECRET] [--set-twitter]
                         [--create-mastodon-app] [--create-mastodon-user] [--toot]
                         [--version]
        
          A program to post last.fm statistics to Twitter and/or Mastodon.
        
          optional arguments:
            -h, --help            show this help message and exit
            -u USER, --user USER  Last.fm username (default: None)
            --last-access-key LAST_ACCESS_KEY
                                  Last.fm access key (default: None)
            --set-lastfm          Set Last.fm credentials (default: False)
            -n NUMBER, --number NUMBER
                                  Number of last.fm top artists (default: 10)
            -p PERIOD, --period PERIOD
                                  The time period over which to retrieve top artists.
                                  Options are: overall | 7day | 1month | 3month | 6month
                                  | 12month (default: 7day)
            -t, --tweet           Post Last.fm stats to Twitter (default: False)
            --consumer-key CONSUMER_KEY
                                  Twitter consumer key (default: None)
            --consumer-secret CONSUMER_SECRET
                                  Twitter consumer secret (default: None)
            --access-key ACCESS_KEY
                                  Twitter access token key (default: None)
            --access-secret ACCESS_SECRET
                                  Twitter access secret (default: None)
            --set-twitter         Set Twitter credentials (default: False)
            --create-mastodon-app
                                  Create mastodon application (default: False)
            --create-mastodon-user
                                  Create Mastodon user token (default: False)
            --toot                Post Last.fm stats to Mastodon (default: False)
            --version             Show the version number and exit
        
Keywords: lastfm,twitter,python,music,mastodon
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Topic :: Utilities
Classifier: Topic :: Other/Nonlisted Topic
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: POSIX
Classifier: Operating System :: POSIX :: BSD
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: Microsoft :: Windows
Requires-Python: >=3.6
Description-Content-Type: text/x-rst
