Metadata-Version: 1.1
Name: outpost
Version: 0.2.2
Summary: Anti cors javascript application development server
Home-page: http://www.nive.co
Author: Arndt Droullier, Nive GmbH
Author-email: info@nive.co
License: BSD 3
Description: 
        # Outpost 
        
        ### local-javascript-application development server 
        
        Outpost is a file server with integrated proxy, filter options and 
        debugging tools. 
        
        It is meant to be used for local javascript application development 
        in combination with remote web api services. The build in proxy
        prevents browsers `Cross Origin Resource Scripting` restrictions
        by routing all requests through a single (local) address.
        
        Static files can be run through filters before being send to the browser.
        
        Implemented in pure python; with the pyramid web framework.
        
        Please refer to Github for source codes: https://github.com/nive/outpost
        
        ## Features
        
        - Serves static files from a directory
        - Routes webservice requests through the proxy
        - Insert html snippets in served files
        - Interactive request hacking and tracing
        - Several logging and debugging tools
        - Filter support
        - Easy installation, runs on any os
        
        ## Configuration 
        
        (See server.ini)
        
        the directory to be served. Either a python module asset path, relative path 
        or absolute path 
        
            server.directory = {{root}}
            server.defaultfile = index.html
            server.log_notfound = True
            server.content_type = text/html; charset=UTF-8
        
        Activate interactive commandline request tracing in python debugger. 
        Allows you to modify and pause requests before being returned to the browser.
        Takes a regular expression as parameter, the server breaks only if the re matches.
        e.g. \.html for html files.
        
            server.trace = 
        
        filter configuration. filters are loaded based on file extensions. `empty` means 
        files without extension are filtered, too.
        
            filter.extensions = .html <empty>
        
        Points to a file and inserts the contents at the end of the html-head
        section of the served file. e.g. `files/header.html` 
        
            filter.appendhead = 
        
        Points to a file and inserts the contents at the end of the html-body
        section of the served file. e.g. `files/body.html` 
        
            filter.appendbody = 
        
        string replacement directive in json (can also be a list of directives):  
        e.g. {"str": "old string", "new": "new string", "codepage": "utf-8"}
        
            filter.replacestr = 
        
        The url prefix used to route request through the proxy. By default
        urls starting with `http://127.0.0.1:5556/__proxy/` will be handled by the 
        proxy
          
            proxy.route = __proxy
        
        Activate interactive commandline request tracing in python debugger. 
        Allows you to modify and pause calls to the webservice. Takes a regular
        expression as parameter, the server breaks only if the re matches.
        e.g. datastore/api/setItem.
        
            proxy.trace = 
        
        ## Installation
        
        Short installation description:
        
        - Install Python 
        - Install Python setuptools and virtualenv
        - Create a virtual environment (virtualenv) directory named ‘outpost’ (or use your projects name)
          ``virtualenv outpost``
        - Install outpost from pypi.python.org ``bin/pip install outpost``
        - Create a new project by using the scaffold ``bin/pcreate -t default myApp``
        - Start the web server ``bin/pserve myApp/server.ini`` 
        
        If you are using a relative directory please make sure you start the webserver from the right
        working directory.
        
        ## Release
        
        This is a beta release, though stable. And it is not meant to run as production server.
        
Keywords: server proxy development cors web pyramid
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: Framework :: Pyramid
Classifier: Topic :: Internet :: WWW/HTTP :: HTTP Servers
Classifier: Topic :: Software Development :: Testing
Classifier: Development Status :: 3 - Alpha
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.3
Classifier: License :: OSI Approved :: BSD License
