Metadata-Version: 1.0
Name: PipeTK
Version: 0.1.2
Summary: Collection of small scripts that modify input received via shell pipe
Home-page: http://blog.worlddomination.be/pipetk
Author: Laurent Peuch
Author-email: cortex@worlddomination.be
License: GPLv3+
Description: Pipe Tool Kit
        =============
        
        This tool kit is an attempt to compile a set of tools I've created to solve
        problems for La Quadrature du Net. Those tools are designed to works with unix
        shell pipe. They follow the unix philosophy and aim to stay simple.
        
        I'm going to try to keep them at least a bit documented but since I'm always in
        an hurry I can't guaranteed this will always be the case.
        
        You can have an idea of the power of this kind of problems solving approach
        here: http://blog.worlddomination.be/microblogging/ (this tuto doesn't features
        those tools for the moment).
        
        For organisation reason all the commands starts with the letter "p".
        
        There is place for a LOTS of ameliorations, most of those tools are very
        simplistic and could be generalised (for example pdetinyfy or purltitle could
        be apply to each urls of a sentence, purls could use regex and could be
        generalised for anything by accepting regex as an argument).
        
        It's possible I'm reinventing the wheel for some of those commands. Don't
        hesitate to tell me if it's the case.
        
        Current tools
        =============
        
        * pipetk: list the available commands with the informations bellow.
        
        * puniq: eliminate duplications in real time via a shell unix pipe.(| sort |
          uniq waits for the full stream to be completed and also sort it, therefor it,
          for example, won't works between a rsstail|feedstail and an ii file).
          Example:
        
          ::
        
            $ feedstail -u http://reddit.com/.rss | puniq
        
        * pmerge: open a named pipe and write to stdout everything written in the named
          pipe. The first argument given is the name of the named pipe. It doesn't
          managed in any way the possible conflicts between multiple process that write
          on that pipe at the same time.
          Silly example:
        
          ::
        
            $ pmerge PIPE > irc.freenode.net/#laquadrature & echo "pouet" > PIPE
        
        * purls: really simple url extracting tools. It split each line it receives by
          white space then display on a new line each words that starts with either
          "http" or "https".
          Example:
        
          ::
        
            $ echo "there is 2 urls in this sentence: this one http://blog.worlddomination.be and this one http://laquadrature.net" | purls
            http://blog.worlddomination.be
            http://laquadrature.net
        
        * pdetinyfy: get the real url of a shortened url. Works only by receiving one
          url per line.
          Example:
        
          ::
        
            $ echo "http://ur1.ca/4110r" | pdetinyfy
            http://laquadrature.net
            echo "foo http://ur1.ca/4110r bar" | pdetinyfy # won't work
            echo "foo http://ur1.ca/4110r bar" | purls | pdetinyfy # use this instead
            http://laquadrature.net
        
        * purltitle: get an url in input and output the url followed by it's title.
          Works only by receiving one url per line. For the moment will miserably fail
          if it doesn't managed to connect to the website.
          Example:
        
          ::
        
            $ echo "http://laquadrature.net" | purltitle
            http://laquadrature.net La Quadrature du Net | Internet et Libertés
        
        * plag: slow down the displaying of a stream by sleeping a give time beetwen each line
          Can have the number of seconds the sleep as arg (accept float value).
          Example:
        
          ::
        
            dmseg | plag
        
          or:
        
          ::
        
            dmesg | plag 60
        
        
        Licence
        =======
        
        All those tools are released under the `GNU General Public License v3`_ or later.
        
        .. _GNU General Public License v3 : http://www.gnu.org/licenses/gpl-3.0.html
        
        Feedback
        ========
        
        For any feedback you can contact me at <cortex at worlddomination dot be>.
        
        Laurent Peuch
        
Keywords: sh bash shell pipe stream cli
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: GNU General Public License (GPL)
Classifier: Programming Language :: Python
