Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Library for management of handles in the EUDAT project.

Project Description


The b2handle Python library is a client library for interaction with a Handle System server, using the native REST interface introduced in Handle System 8. The library offers methods to create, update and delete Handles as well as advanced functionality such as searching over Handles using an additional search servlet and managing multiple location entries per Handle.

The library currently supports Python 2.6, 2.7 and 3.5, and requires at least a Handle System server 8.1. The library requires OpenSSL v1.0.1 or higher.

Test Coverage and Continuous Integration

Test status of the devel branch:

B2Handle has a unit test coverage of approximately 90%. Every addition to the devel branch is automatically unit tested. The test can be found in b2handle/tests and easily run using the command “python”. For the current test coverage, please click on the badge and link above.

In addition to the unit tests, integration tests cover the reading, writing and searching of handles. As these needs credentials and write access to a real server, these are not run on GitHub. However, every user with access to a handle server can add their own credentials and run the integration tests in his/her system (using the command “python testtype write”, or “read”, or “search”, or all three).

Installation and use

Build an egg:

python bdist_egg

Install the library via pip:

pip install <egg file>

For more information on the methods offered by the library, please consult the technical documentation. The documentation also contains information on how to set up correct certificates for the Handle Server so it accepts modification REST requests and how to set up client authentication using public keys.

Docker support

The library can also be used in combination with Docker. The Dockerfile contains instructions for building a Docker image with the B2HANDLE library installed.

Base Docker Image


  1. Install Docker.
  2. Build an image from Dockerfile: docker build -t eudat-b2handle .

Running Python

docker run -it --rm eudat-b2handle python

Python 2.7.9 (default, Mar  1 2015, 12:57:24)
[GCC 4.9.2] on linux2
Type "help", "copyright", "credits" or "license" for more information.
>>> from b2handle.handleclient import EUDATHandleClient

Building the documentation

B2Handle uses Sphinx for documentation, requiring at least version 1.3. Sphinx can be installed via pip. To build HTML documentation locally, then run:

python build_sphinx

Developer team

Machines don’t write software, people do. Please refer to to learn about those who spent effort in creating this product.


Copyright 2015-2016, Deutsches Klimarechenzentrum GmbH, GRNET S.A., SURFsara

The B2Handle library is licensed under the Apache License, Version 2.0 (the “License”); you may not use this product except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Release History

This version
History Node


History Node


History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(186.5 kB) Copy SHA256 Hash SHA256
Egg 2.7 Feb 15, 2017
(188.3 kB) Copy SHA256 Hash SHA256
Egg 3.5 Feb 15, 2017
(65.3 kB) Copy SHA256 Hash SHA256
Source None Feb 15, 2017

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Kabu Creative Kabu Creative UX & Design Google Google Cloud Servers Fastly Fastly CDN StatusPage StatusPage Statuspage DigiCert DigiCert EV Certificate