Metadata-Version: 1.0
Name: smisk
Version: 1.1.6
Summary: High-performance web service framework
Home-page: http://python-smisk.org/
Author: Rasmus Andersson
Author-email: rasmus@flajm.com
License: Copyright (c) 2007-2009 Rasmus Andersson

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.
Description: 
        Smisk
        +++++
        
        .. contents ::
        
        Summary
        =======
        
        Smisk is a simple, high-performance and scalable web service framework
        written in C, but controlled by Python.
        
        It is designed to widen the common bottle necks in heavy-duty web services.
        
        More information at the `Smisk website <http://python-smisk.org/>`_
        
        
        Getting Started
        ===============
        
        * Install with ``easy_install smisk``, download from
        `PyPI <http://pypi.python.org/pypi/smisk>`_ or
        `use a Debian package <http://python-smisk.org/downloads>`_
        
        * Have a look at a few `examples <http://python-smisk.org/examples>`_
        
        
        Examples
        ========
        
        This is a minimal Smisk service::
        
        from smisk.core import Application
        class MyApp(Application):
        def service(self):
        self.response.headers = ['Content-Type: text/plain']
        self.response("Hello World!")
        
        MyApp().run()
        
        And here we have a WSGI compatible application::
        
        from smisk.wsgi import *
        def hello_app(env, start_response):
        start_response("200 OK", [('Content-Type', 'text/plain')])
        return ["Hello, World!"]
        
        main(hello_app)
        
        More examples `available here... <http://python-smisk.org/examples>`_
        
        
        Authors & Contributors
        ======================
        * `Rasmus Andersson <http://hunch.se/>`_ rasmus-flajm.com
        * `Eric Moritz <http://themoritzfamily.com/>`_ eric-themoritzfamily.com
        * Ludvig Strigeus
        
        Changes
        =======
        
        1.1.6
        -----
        
        * Handle requests with filename extensions which are actually not filename
        extensions but rather format-less but leet.haxxor kinda dot notation of the
        regular path component.
        
        * Fixed 304 Not Modified response status not to set Location header nor include
        a message-body.
        
        * smisk.util.main.daemonize() does no longer call exit hooks while detaching
        (calling os._exit instead of sys.exit in dead forks).
        
        * Fixed bug in smisk.util.main.control_process_runloop() where signals where
        not correctly forwarded to children.
        
        * When core fail to decode text data from user input (form data and query
        string) it will try to decode the text data using a fallback charset, defined
        by SMISK_FALLBACK_CHARSET in config.h, which is set to "ISO-8859-1" in
        accordance with HTTP 1.1 (RFC 2616), sect. 19.3 "Tolerant Applications".
        
        * MVC applications respond with "400 Bad Request" when user input text can not
        be decoded using app.charset (or iso-8859-1 if app.tolerant is True).
        
        * core.Application has a new boolean property "tolerant". When True (default)
        user input will be processed in a tolerant manner. I.e. if a query string
        encoded in iso-8859-1 is sent to an application with app.charset of utf-8,
        the query string will still be decoded using the HTTP 1.1 (RFC 2616) fallback
        encoding iso-8859-1, which is able do decode any byte. If tolerant where
        False, a UnicodeDecodeError would be raised.
        
        * Static method core.URL.decompose_query() accepts a new boolean argument
        "tolerant" which if True, charset argument is set and can not be used to
        decode the first argument, causes decoding using the iso-8859-1 charset.
        
        * mvc.Response have two new members: The property "charsets" which is a list of
        acceptable charsets. The method "accepts_charset" which return True if the
        first argument is acceptable according to the "charsets" list.
        
        * MVC applications retain the content type used to find a valid serializer or
        template and uses that content type in the response, if appropriate. Previous
        behaviour was to send responses with the (per serializer or template)
        canonical content type.
        
        1.1.5
        -----
        
        * Fixed a bug with Python 2.5 where PyEval_InitThreads had to be called (even
        though the documentation suggests otherwise)
        
        1.1.4
        -----
        
        * Fixed serious integer overflow bugs in smisk.core where return values from
        PyObject_CallMethod was never decrefed, leading to incorrect number of
        decrefs later on thus causing seemingly random segfaults. Thanks to Ludde.
        
        * Removed the bsddb module -- the smisk.ipc.bsddb module still exist, but
        required an external bsddb module to be installed.
        
        * Fixed a bug in smisk.ipc.memcached where creation of dict cash key tried to
        concatenate a str and int.
        
        * Fixed a bug in smisk.mvc request parsing code where a text payload with an
        explicit character encoding was not properly handled.
        
        * The smisk.serialization.json module now uses the standard library
        (Python >=2.6) json module when cjson is not available.
        
        * The smisk.serialization.json serializer explicitly specifies the character
        encoding (which always is UTF-8)
        
        * The smisk.serialization.php_serial serializer now uses "sphp" as the primary
        filename extension. (updated to align with evolving standards)
        
        * Fixed some issues with storage defined in both header file and source file,
        leading to problems with compilation of Python 2.4 version of smisk.core.
        
        * Higher performance codec in smisk.core.xml now also supporting
        decoding/unescaping.
        
        
        1.1.3
        -----
        
        * Fixed a bug with parameter keys not being normalized to unicode.
        
        * Reworked Elixir/SQLAlchemy handling of sessions during HTTP transactions.
        
        * Only a subset of the built-in serializers are loaded by default, rather than
        all. There's a new module called smisk.serialization.all which can be
        imported in order to load all built-in serializers.
        
        * Serializers now need to excplicitly specify their read/write capabilities
        using two boolean attributes: can_serialize and can_unserialize.
        BaseSerializer defines both of these as False.
        
        * plist serializer reworked to use plistlib, which has been modified to support
        serialization of Elixir Entities (database objects).
        
        * New generic XML serializer smisk.serialization.xmlgeneric (not loaded by
        default).
        
        * smisk.mvc.Request instances have a new attribute called cn_url. The value is
        a smisk.core.URL instance which is guaranteed *not* to include any filename
        extension. cn_url is a copy of Request.url if the request was made without
        the canonical path (i.e. not including filename extension. "/foo/bar" instead
        of "/foo/bar.json"). Otherwise cn_url is a modified copy of url. This is
        useful for building paths based on the request path wihout having to know if
        there's a filename extension involved or not.
        
        * Leaf filters can now be created as pythonic decorators using the aiding
        decorator leaf_filter, found in smisk.mvc.decorators. See
        http://python-smisk.org/docs/1.1.3/library/smisk.mvc.html#leaf-filters
        for more information.
        
        * The previously built-in crash reporter is no longer built by default. Can be
        enabled by defining the macro SMISK_ENABLE_CRASH_REPORTING 1 (more info in
        src/config.h).
        
        * Major documentation update.
        
        * Various minor fixes.
        
        
        1.1.2
        -----
        
        * Inter-process communication module smisk.ipc, providing a shared dictionary
        which can be concurrently manipulated by a set of processes.
        
        * Berkely DB module smisk.core.bsddb
        
        * Benchmark utility module smisk.util.benchmark exposes an iterator which can
        be used to easily benchmark snippets of code.
        
        * The key-value store example application now uses the shared dictionary
        provided by smisk.ipc.
        
        * smisk.core.Request have two soft limits -- max_multipart_size and
        max_formdata_size -- for limiting automatically handled input data size. These
        soft limits can also be used to disable the automated parsing of Smisk.
        
        * smisk.util.cache has a new function -- app_shared_key -- returning a byte
        string which can be used to uniqely identify the application. The key is
        based on the entry file (the python file in which __name__ == "__main__").
        
        * smisk.util.type exposes MutableMapping -- in Python >=2.6 this is
        collections.MutableMapping, in Python >=2.3 it is UserDict.DictMixin.
        
        * Serializers no longer emit warning.warn-messages when no suiting
        implementations are available. Now they are simply not registered whitout as
        much as a whisper.
        
        * In the C library, the macro SMISK_PyString_Check has changed name to
        SMISK_STRING_CHECK (however it still does the exact same thing as before,
        just that in preparation for porting Smisk to Python 3, we need to sort out
        the different meanings of "bytes strings" and "character strings")
        
        * In the C library, we use PyBytes instead of PyString and NUMBER_* instead of
        some PyInt-functions, having macros for Python <2.5. This is a step toward
        the Python 3 port.
        
        * smisk.core is now stored as _smisk and imported by smisk/core/__init__.py.
        This follows the naming custom of other machine-native modules as well as
        provides better name (i.e. _smisk.so instead of core.so) in various listings.
        
        * Fixed a bug in smisk.core where a www-form-urlencoded request with incorrect
        content length and the first key was longer than the provided content length,
        smisk would induce strange errors (because trying to set NULL into a python
        dict).
        
        
        1.1.1
        -----
        
        * Fully unicode on the inside -- request.get, .post, .cookies, etc return
        unicode values and where dictionary keys are used, which have been translated
        from the outside world, they are guranteeded to be encoded as UTF-8.
        (Dictionary keys used as keyword arguments must be str in Python <=2.5)
        
        * YAML read/write-serialization #21 [a72dc2f0855b]
        
        * Handles and reconnects dead MySQL-connections. #23 [49cb2034a8b1]
        
        * No longer stores empty parts as None from multipart messages. #15
        [d9920fb75ca2]
        
        * Makes full use of HTTP 1.1 request methods (OPTIONS, GET, HEAD, PUT, POST,
        DELETE). See example application: examples/mvc/key-value-store/
        
        * smisk.mvc.model no longer disposes SA/Elixir sessions for each request, but
        tries to reuse a session as long as no error occur.
        
        * redirect_to() respects and retains explicit request format, denoted by path
        extension in the original request.
        
        * smisk.test.live introduces "live" tests, running a server and a client,
        measuring communication and effects.
        
        
        1.1.0
        -----
        
        * MVC module -- smisk.mvc.
        
        * Better unicode support.
        
        * Compatible with Debian Etch.
        
        * Host server URL rewrites now propagating correctly.
        
        
        1.0.1
        -----
        
        * Full WSGI support -- passes the wsgiref validation tests.
        
        * Iterable request makes reading input data simple.
        
        * Stream implements writelines for optimized sending of chunks of strings.
        
        * Response implements a Stream.writelines proxy, automatically calling
        begin().
        
        * Callable response makes responses simpler. Based on writelines.
        
        * Fixed a bug where smisk_multipart_parse_file would try to fclose a
        uninitialized fd. [11c4ffae718f]
        
        
        1.0.0
        -----
        
        * First stable version
        
        License
        =======
        Copyright (c) 2007-2009 Rasmus Andersson
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in
        all copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
        THE SOFTWARE.
        
        Download
        ========
        
Platform: ALL
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: POSIX
Classifier: Operating System :: Unix
Classifier: Programming Language :: C
Classifier: Programming Language :: Python
Classifier: Natural Language :: English
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Development Status :: 4 - Beta
