Metadata-Version: 1.0
Name: memcacheinspector
Version: 0.1.0
Summary: Memcache Inspection Module and Command-Line Utility
Home-page: https://bitbucket.org/jayclassless/memcacheinspector
Author: Jason Simeone
Author-email: jay@classless.net
License: MIT
Description: =================
        memcacheinspector
        =================
        ----------------------------------------------------
        Memcached Inspection Module and Command-Line Utility
        ----------------------------------------------------
        
        Introduction
        ============
        
        This package includes two things:
        
        - A `Python`_ module for extracting keys from `Memcached`_ servers.
        - A command-line utility for exploring, searching, and updating `Memcached`_ items.
        
        This utility make uses of the `Memcached`_ "features" discussed in the `SensePost Blog`_.
        
        
        Installation
        ============
        
        Using `pip`_ (recommended)::
        
        $ pip install memcacheinspector
        
        Or, using easy_install::
        
        $ easy_install memcacheinspector
        
        Or, you can download the source and install it by hand::
        
        $ python setup.py install
        
        Installing the package installs both the memcacheinspector python module as well as the mcinspect command-line utility.
        
        
        Usage
        =====
        
        ::
        
        Usage: mcinspect [options] <action> [<arguments>]
        
        Actions:
        list                    Lists all items stored in the server(s).
        dump                    Dumps all items (including values) stored in the server(s).
        grep <pattern>          Dumps all items (including values) whose key or value matches
        the specified search pattern.
        get <key> [<key> ..]    Retrieves the items with the specified key(s).
        set <key> <value>       Sets the item with the specified key and value.
        incr key                Increments the value of the items with the specified key(s).
        decr key                Decrements the value of the items with the specified key(s).
        delete <key> [<key> ..] Deletes the items with the specified key(s).
        flush                   Expires all items in the server(s).
        stats                   Retrieves statistics from the server(s).
        
        Options:
        --version             show program's version number and exit
        -h, --help            show this help message and exit
        -s SERVERS, --server=SERVERS
        Specifies a server to connect to. Can be used multiple
        times. Defaults to '127.0.0.1:11211'.
        -z MAX_VALUE_SIZE, --max-value-size=MAX_VALUE_SIZE
        The maximum size (in bytes) of a value can be when
        performing a list or dump action. Defaults to no
        limit.
        -d DELTA, --delta=DELTA
        The amount to change the value when using the incr or
        decr actions.
        
        Output Format:
        list:
        <server connection string>|<expiration date>|<size in bytes>|<key>
        
        dump, grep:
        <server connection string>|<expiration date>|<size in bytes>|<key>
        <value>
        
        get, incr, decr:
        <server connection string>|<key>
        <value>
        
        set, delete:
        <server connection string>|<key>
        
        flush:
        <server connection string>
        
        stats:
        <server connection string>|<statistic key>|<value>
        
        
        License
        =======
        
        memcacheinspector is released under the `MIT License`_. See the LICENSE file for full text of the license.
        
        
        Reference
        =========
        
        - _`Python`: http://www.python.org/
        - _`Memcached`: http://memcached.org/
        - _`pip`: http://pip.openplans.org/
        - _`SensePost Blog`: http://www.sensepost.com/blog/4873.html
        - _`MIT License`: http://www.opensource.org/licenses/mit-license.php
        
Keywords: memcache memcached inspector list dump search grep
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: Natural Language :: English
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: License :: OSI Approved :: MIT License
