Metadata-Version: 1.1
Name: linkscrubber
Version: 1.1.0
Summary: pinboard.in bookmark cleaner
Home-page: https://github.com/dhellmann/link_scrubber
Author: Doug Hellmann
Author-email: doug@doughellmann.com
License: UNKNOWN
Description: =================================================
         Link Scrubber -- a pinboard.in bookmark cleaner
        =================================================
        
        With the `announcement that Google Reader is being shuttered`_, I
        decided I needed to go through my `pinboard.in`_ bookmarks and update
        any that point to a ``feedproxy.google.com`` URL while their
        redirecting service is still online. This script does that
        automatically.
        
        .. _announcement that Google Reader is being shuttered: http://googleblog.blogspot.com/2013/03/a-second-spring-of-cleaning.html
        .. _pinboard.in: http://pinboard.in
        
        What does it do?
        ================
        
        ``link_scrubber`` processes all of your bookmarks, looking for those
        that redirect. It adds a new bookmark with the target of the redirect
        and all the same metadata from the original link. By default, only
        URLs from ``feedproxy.google.com`` are processed, but there are
        command line options to process all redirects or to add more
        individual sites.
        
        The links are processed in small batches to reduce the load of
        individual calls against the pinboard API server, so it can take a
        while to process. Once a batch of links is fetched, it is checked in
        parallel to speed things up a little.
        
        Installing
        ==========
        
        Install via pip::
        
          $ pip install git+http://github.com/mgan59/python-pinboard.git#egg=python-pinboard
          $ pip install linkscrubber
        
        .. note:: 
        
          Unfortunately, python-pinboard does not have a PyPI release, yet, so
          it needs to be installed first.
        
        Running
        =======
        
        To use it, pass your pinboard.in user token to the ``-t`` option, or
        use your username and password with the ``--user`` and ``--password``
        options.
        
        ::
        
          $ linkscrubber -t token
        
        or
        
        ::
        
          $ linkscrubber -u username -p password
        
        or, leave off the password and you will be prompted
        
        ::
        
          $ linkscrubber -u username
          Password: 
        
        To see what would be changed, without making any changes, use the
        ``--dry-run`` option.
        
        ::
        
          $ linkscrubber --dry-run -t token
        
        For the full list of options, use::
        
          $ linkscrubber -h
        
        Disclaimer
        ==========
        
        You should back up your account before running the script. I have done
        some testing, but only against one account. Yours might behave
        differently.
        
        Reporting Bugs
        ==============
        
        Use the github bug tracker at
        https://github.com/dhellmann/link_scrubber to report problems.
        
        
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Environment :: Console
