Revision bd7e6afe2cab8db3bc8a92a757554b044a694d9d authored by Jeremy Low on 28 March 2016, 12:59:17 UTC, committed by Jeremy Low on 28 March 2016, 12:59:17 UTC
Consistency in keyword arguments for "id" parameters
2 parent s 7968856 + 7dcdf61
Raw File
shorten_url.py
#!/usr/bin/env python

# Copyright 2007-2016 The Python-Twitter Developers

# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at

# http://www.apache.org/licenses/LICENSE-2.0

# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

# ----------------------------------------------------------------------
# Change History
#
# 2010-05-16
#   TinyURL example and the idea for this comes from a bug filed by
#   acolorado with patch provided by ghills.  Class implementation
#   was done by @bear.
#
#   Issue #19: http://code.google.com/p/python-twitter/issues/detail?id=19
#
# 2016-02-18
#   Updated example with code to demonstrate passing a status message through
#   a shortener and then off to PostUpdate. Implemenation by @jeremylow from
#   bug filed by @immanuelfactor
#
#   Issue #298: https://github.com/bear/python-twitter/issues/298

# ----------------------------------------------------------------------
# This file demonstrates how to shorten all URLs contained within a Tweet
# by passing the tweet text to a shortener. In this case, we're using TinyURL
# since it does not require any real authentication for our purposes. If you
# are using a different service to shorten URLs, then you will need to modify
# the ShortenURL class to suit your needs.

# Note that this example shortens all URLs contained within the Tweet text.

# To use this example, replace the W/X/Y/Zs with your keys obtained from
# Twitter, or uncomment the lines for getting an environment variable. If you
# are using a virtualenv on Linux, you can set environment variables in the
# ~/VIRTUALENVDIR/bin/activate script.

# If you need assistance with obtaining keys from Twitter, see the instructions
# in doc/getting_started.rst.


import re
try:
    from urllib.request import urlopen
except:
    from urllib2 import urlopen

from twitter import Api
from twitter.twitter_utils import URL_REGEXP


class ShortenURL(object):
    """ A class that defines the default URL Shortener.

    TinyURL is provided as the default and as an example helper class to make
    URL Shortener calls if/when required. """

    def __init__(self,
                 userid=None,
                 password=None):
        """Instantiate a new ShortenURL object. TinyURL, which is used for this
        example, does not require a userid or password, so you can try this
        out without specifying either.

        Args:
            userid:   userid for any required authorization call [optional]
            password: password for any required authorization call [optional]
        """
        self.userid = userid
        self.password = password

    def Shorten(self,
                long_url):
        """ Call TinyURL API and returned shortened URL result.

        Args:
            long_url: URL string to shorten

        Returns:
            The shortened URL as a string

        Note:
            long_url is required and no checks are made to ensure completeness
        """

        result = None
        f = urlopen("http://tinyurl.com/api-create.php?url={0}".format(
            long_url))
        try:
            result = f.read()
        finally:
            f.close()

        # The following check is required for py2/py3 compatibility, since
        # urlopen on py3 returns a bytes-object, and urlopen on py2 returns a
        # string.
        if isinstance(result, bytes):
            return result.decode('utf8')
        else:
            return result


def _get_api():
    # Either specify a set of keys here or use os.getenv('CONSUMER_KEY') style
    # assignment:

    CONSUMER_KEY = 'WWWWWWWW'
    # CONSUMER_KEY = os.getenv("CONSUMER_KEY", None)
    CONSUMER_SECRET = 'XXXXXXXX'
    # CONSUMER_SECRET = os.getenv("CONSUMER_SECRET", None)
    ACCESS_TOKEN = 'YYYYYYYY'
    # ACCESS_TOKEN = os.getenv("ACCESS_TOKEN", None)
    ACCESS_TOKEN_SECRET = 'ZZZZZZZZ'
    # ACCESS_TOKEN_SECRET = os.getenv("ACCESS_TOKEN_SECRET", None)

    return Api(CONSUMER_KEY,
               CONSUMER_SECRET,
               ACCESS_TOKEN,
               ACCESS_TOKEN_SECRET)


def PostStatusWithShortenedURL(status):
    shortener = ShortenURL()
    api = _get_api()

    # Find all URLs contained within the status message. Value of ``urls`` will
    # be a list.
    urls = re.findall(URL_REGEXP, status)

    for url in urls:
        status = status.replace(url, shortener.Shorten(url), 1)

    api.PostUpdate(status)


if __name__ == '__main__':
    PostStatusWithShortenedURL("this is a test: http://www.example.com/tests")
back to top