Metadata-Version: 1.1
Name: Flask-Cors
Version: 2.0.0rc1
Summary: A Flask extension adding a decorator for CORS support
Home-page: https://github.com/corydolphin/flask-cors
Author: Cory Dolphin
Author-email: corydolphin@gmail.com
License: MIT
Description: Flask-CORS
        ==========
        
        |Build Status| |Latest Version| |Downloads| |Supported Python versions|
        |License|
        
        A Flask extension for handling Cross Origin Resource Sharing (CORS),
        making cross-origin AJAX possible.
        
        Installation
        ------------
        
        Install the extension with using pip, or easy\_install.
        
        .. code:: bash
        
            $ pip install -U flask-cors
        
        Usage
        -----
        
        This extension enables CORS support either via a decorator, or a Flask
        extension. There are three examples shown in the
        `examples <https://github.com/corydolphin/flask-cors/tree/master/examples>`__
        directory, showing the major use cases. The suggested configuration is
        the
        `simple\_example.py <https://github.com/corydolphin/flask-cors/tree/master/examples/simple_example.py>`__,
        or the
        `app\_example.py <https://github.com/corydolphin/flask-cors/tree/master/examples/app_based_example.py>`__.
        A full list of options can be found in the
        `documentation <http://flask-cors.readthedocs.org/en/latest/>`__
        
        Simple Usage
        ~~~~~~~~~~~~
        
        In the simplest case, initialize the Flask-Cors extension with default
        arguments in order to allow CORS on all routes.
        
        .. code:: python
        
        
            app = Flask(__name__)
            cors = CORS(app)
        
            @app.route("/")
            def helloWorld():
              return "Hello, cross-origin-world!"
        
        Resource specific CORS
        ^^^^^^^^^^^^^^^^^^^^^^
        
        Alternatively, a list of resources and associated settings for CORS can
        be supplied, selectively enables CORS support on a set of paths on your
        app.
        
        Note: this resources parameter can also be set in your application's
        config.
        
        .. code:: python
        
            app = Flask(__name__)
            cors = CORS(app, resources={r"/api/*": {"origins": "*"}})
        
            @app.route("/api/v1/users")
            def list_users():
              return "user example"
        
        Route specific CORS via decorator
        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
        
        This extension also exposes a simple decorator to decorate flask routes
        with. Simply add ``@cross_origin()`` below a call to Flask's
        ``@app.route(..)`` incanation to accept the default options and allow
        CORS on a given route.
        
        .. code:: python
        
            @app.route("/")
            @cross_origin() # allow all origins all methods.
            def helloWorld():
              return "Hello, cross-origin-world!"
        
        Logging
        ^^^^^^^
        
        Flask-Cors uses standard Python logging, using the logger name
        '``app.logger_name``.cors'. The app's logger name attribute is usually
        the same as the name of the app. You can read more about logging from
        `Flask's
        documentation <http://flask.pocoo.org/docs/0.10/errorhandling/>`__.
        
        .. code:: python
        
            import logging
            # make your awesome app
            logging.basicConfig(level=logging.INFO)
        
        Documentation
        -------------
        
        For a full list of options, please see the full
        `documentation <http://flask-cors.readthedocs.org/en/latest/>`__
        
        Tests
        -----
        
        A simple set of tests is included in ``test/``. To run, install nose,
        and simply invoke ``nosetests`` or ``python setup.py test`` to exercise
        the tests.
        
        Contributing
        ------------
        
        Questions, comments or improvements? Please create an issue on
        `Github <https://github.com/corydolphin/flask-cors>`__, tweet at
        `@corydolphin <https://twitter.com/corydolphin>`__ or send me an email.
        
        Credits
        -------
        
        This Flask extension is based upon the `Decorator for the HTTP Access
        Control <http://flask.pocoo.org/snippets/56/>`__ written by Armin
        Ronacher.
        
        .. |Build Status| image:: https://api.travis-ci.org/corydolphin/flask-cors.svg?branch=master
           :target: https://travis-ci.org/corydolphin/flask-cors
        .. |Latest Version| image:: https://pypip.in/version/Flask-Cors/badge.svg
           :target: https://pypi.python.org/pypi/Flask-Cors/
        .. |Downloads| image:: https://pypip.in/download/Flask-Cors/badge.svg
           :target: https://pypi.python.org/pypi/Flask-Cors/
        .. |Supported Python versions| image:: https://pypip.in/py_versions/Flask-Cors/badge.svg
           :target: https://pypi.python.org/pypi/Flask-Cors/
        .. |License| image:: https://pypip.in/license/Flask-Cors/badge.svg
           :target: https://pypi.python.org/pypi/Flask-Cors/
        
Platform: any
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.1
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Software Development :: Libraries :: Python Modules
