Skip to main content

Python3 bindings for Gfal2

Project description

Gfal2-Python

gfal2-python is a C++ library offering a thin layer of Python wrappers via PyBoost. We recommend installing it via RPMs, but it is also available on PyPI/gfal2-python <https://pypi.org/project/gfal2-python/>__.

Using the Gfal2 Python Bindings

The Gfal2 Python bindings are intended to be easy to use.

Pre-requisites ^^^^^^^^^^^^^^

Before jumping into usage, ensure you have a proxy certificate available in the default location (/tmp/x509up_u$(id -u)).

Optionally, you may want to install relevant Gfal2 protocol plugins. Our example will use HTTP protocol, so we must ensure we have the Gfal2 HTTP plugin installed:

.. code:: bash

$ dnf install -y gfal2-plugin-http

Examples ^^^^^^^^

Example of stating a file location:

.. code:: python

import gfal2

ctx = gfal2.creat_context() ctx.stat("https://eospublic.cern.ch/eos/opstest/dteam/file.test")

Example of copying a file from local to remote:

.. code:: python

import gfal2

ctx = gfal2.creat_context() ctx.filecopy("file:///tmp/file.test", "https://eospublic.cern.ch/eos/opstest/dteam/file.test") ctx.stat("https://eospublic.cern.ch/eos/opstest/dteam/file.test")

Example of copying the file from remote to local (with custom transfer parameters):

.. code:: python

import gfal2

ctx = gfal2.creat_context() params = ctx.transfer_parameters() params.set_checksum = ("both", "adler32", None) params.overwrite = True

ctx.filecopy("https://eospublic.cern.ch/eos/opstest/dteam/file.test", "file:///tmp/file.test") ctx.checksum("file:///tmp/file.test", "adler32")

Further code examples can be found in the example/python/ <https://github.com/cern-fts/gfal2-python/tree/v1.12.2/example/python>__ source directory.

Installing via Pip

Installing the package via pip install gfal2-python will reproduce the compilation process, hence why you need to make sure you have all the right dependencies. This guide details the steps needed to get all the dependencies, starting from a blank machine.

This guide assumes you have the EPEL repositories installed (epel-release package). In this example, the build platform is Alma9 and we will use v1.12.2, but the same process applies for other versions or build platforms.

.. code:: bash

Clone the gfal2-python repository with the desired version (example for v1.12.2)

$ git clone --branch v1.12.2 https://github.com/cern-fts/gfal2-python.git $ cd gfal2-python/

Install standard set of build packages

$ ./ci/fedora-packages.sh

Build the source RPM and install dependencies

$ cd packaging/ $ make srpm $ dnf builddep -y gfal2-python-*.src.rpm

Ready to install now from PyPI

$ pip install gfal2-python

Useful links

Enjoy using the Gfal2 Python bindings!

Project details


Download files

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

Source Distribution

gfal2-python-1.13.0.tar.gz (42.7 kB view details)

Uploaded Source

File details

Details for the file gfal2-python-1.13.0.tar.gz.

File metadata

  • Download URL: gfal2-python-1.13.0.tar.gz
  • Upload date:
  • Size: 42.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.9.18

File hashes

Hashes for gfal2-python-1.13.0.tar.gz
Algorithm Hash digest
SHA256 5be42cc894fa20af3d6f6dbb30dfd4d29ab49bd5f15b3e3e754aa25c5ed17997
MD5 a7c51a3add595b94cdb5eed7bcb39997
BLAKE2b-256 6b88335f56f3286bff5fde448d92eede5b6fe192f4b25a6fe829bededb4136c5

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page