https://github.com/znerol/xslproxy

Xsl transforming reverse proxy based on twisted
https://github.com/znerol/xslproxy

Last synced: 25 days ago
JSON representation

Xsl transforming reverse proxy based on twisted

• Host: GitHub
• URL: https://github.com/znerol/xslproxy
• Owner: znerol
• License: agpl-3.0
• Created: 2020-11-23T14:00:56.000Z (almost 4 years ago)
• Default Branch: main
• Last Pushed: 2022-02-06T13:43:03.000Z (almost 3 years ago)
• Last Synced: 2024-09-22T18:47:59.575Z (about 2 months ago)
• Language: Python
• Size: 37.1 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.rst
  • Changelog: CHANGELOG.rst
  • License: COPYING

Awesome Lists containing this project

README

        
XSL Proxy

=========

.. image:: https://travis-ci.com/znerol/xslproxy.svg?branch=master

    :target: https://travis-ci.com/znerol/xslproxy

Xsl transforming reverse proxy based on twisted_ and lxml_

.. _twisted: https://twistedmatrix.com/

.. _lxml: https://lxml.de/

Installation

------------

::

   python3 -m pip install xslproxy

Usage

-----

::

   Usage: twist [options] plugin [plugin_options] xslproxy [options]

   Options:

         --backend=  Url to backend, no trailing slash [default: http://localhost]

         --help      Display this help and exit.

         --listen=   Listen port (strports syntax) [default: tcp:8080]

         --path=      [default: A directory with xsl files]

         --version   Display Twisted version and exit.

Requests to one of the proxy endpoints will be forwarded to the backend. When a

successful result is returned from the backend, content is transformed using

the specified XSL stylesheets and sent to the client. The following proxy

endpoints are available:

/transform/{XSLPARAMS}

  All stylesheets and parameters specified in XSLPARAMS are applied and to the

  backend response and the result is returned to the client with

  ``Content-Type`` header set to ``application/xml``, ``text/html`` or

  ``text/plain`` according to the ``method`` specified in the ````

  element of the last stylesheet in the chain.

The ``XSLPARAMS`` path segement takes the following ``key=value`` pairs. Each

pair separated by the ampersand (``&``) character:

xsl[]

  Relative path to a stylesheet on the server (without ``.xsl`` or ``.xslt``

  extension). This parameter can be specified multiple times.

xa[stylesheet-key]

  Stylesheet alias. Relative path to a stylesheet on the server (without

  ``.xsl`` or ``.xslt``. This parameter is usefull if the same stylesheet should

  be applied multiple times with different parameters.

xp[stylesheet-key][param-key]

  XPath parameter with the name ``param-key`` for the stylesheet specified in

  ``stylesheet-key``. The latter need to match one of the values specified via

  ``xsl[]`` parameter.

sp[stylesheet-key][param-key]

  String parameter with the name ``param-key`` for the stylesheet specified in

  ``stylesheet-key``. The latter need to match one of the values specified via

  ``xsl[]`` parameter.

License

-------

The software is subject to the AGPLv3_ or later license.

.. _AGPLv3: https://www.gnu.org/licenses/agpl-3.0.en.html