/python-xmlsec

Python bindings for the XML Security Library.

Primary LanguageCMIT LicenseMIT

python-xmlsec

https://travis-ci.org/mehcode/python-xmlsec.png?branch=master

Python bindings for the XML Security Library.

Usage

Check the examples to see various examples of signing and verifying using the library.

Requirements

  • libxml2 >= 2.9.1
  • libxmlsec1 >= 1.2.14

Install

Pre-Install

Linux (Debian)

apt-get install libxml2-dev libxmlsec1-dev libxmlsec1-openssl

Note: There is no required version of libxml2 for ubuntu precise, so need to dowload and install it manually.

wget http://xmlsoft.org/sources/libxml2-2.9.1.tar.gz
tar -xvf libxml2-2.9.1.tar.gz
cd libxml2-2.9.1
./configure && make && make install

Linux (CentOS)

yum install libxml2-devel xmlsec1-devel xmlsec1-openssl-devel libtool-ltdl-devel

Mac

brew install libxml2 libxmlsec1

Automated

  1. xmlsec can be installed through easy_install or pip.
pip install xmlsec

Mac

If you get any fatal errors about missing .h files, update your C_INCLUDE_PATH environment variable to include the appropriate files from the libxml2 and libxmlsec1 libraries.

Manual

  1. Clone the xmlsec repository to your local computer.
git clone git://github.com/mehcode/python-xmlsec.git
  1. Change into the xmlsec root directory.
cd /path/to/xmlsec
  1. Install the project and all its dependencies using pip.
pip install .

Contributing

Setting up your environment

  1. Follow steps 1 and 2 of the [manual installation instructions][].

[manual installation instructions]: #manual

  1. Initialize a virtual environment to develop in. This is done so as to ensure every contributor is working with close-to-identicial versions of packages.
 mkvirtualenv xmlsec


The `mkvirtualenv` command is available from `virtualenvwrapper` which
can be installed by following: http://virtualenvwrapper.readthedocs.org/en/latest/install.html#basic-installation
  1. Install xmlsec in development mode with testing enabled. This will download all dependencies required for running the unit tests.
pip install -r requirements-test.txt
pip install -e "."

Running the test suite

  1. [Set up your environment](#setting-up-your-environment).
  2. Run the unit tests.
py.test tests

Reporting a issue

Please attach the output of following information: version of python-xmlsec version of libxmlsec1 version of libxml2

output from command:

pkg-config --cflags xmlsec1

Versions of python

The following versions of python is supported:

  • python2.7
  • python3.4
  • python3.5 (required libxmlsec1 >= 1.2.18 and libxml2 >= 2.9.1)
  • python3.6 (required libxmlsec1 >= 1.2.18 and libxml2 >= 2.9.1)

License

Unless otherwise noted, all files contained within this project are liensed under the MIT opensource license. See the included file LICENSE or visit opensource.org for more information.