Skip to main content

A pathlib-derived interface to Openstack Swift

Project description

🐉 Installation

Install from PyPI:

$ pip install swiftpath

🐉 About

Swift Connection

swiftpath will automatically read environment variables to determine how to connect to a swift instance.

Currently, swiftpath looks for the following environment variables when connecting to swift:

  • OS_USER_ID or OS_USERNAME

  • OS_PASSWORD

  • OS_PROJECT_NAME or OS_TENANT_NAME

  • OS_AUTH_URL or OS_AUTHENTICATION_URL

  • OS_STORAGE_URL

  • OS_REGION_NAME

  • OS_PROJECT_ID

Caveats

Note that the following methods are not provided as they are not available on swift:

  • SwiftPath.cwd()

  • SwiftPath.home()

  • SwiftPath.chmod()

  • SwiftPath.expanduser()

  • SwiftPath.lchmod()

  • SwiftPath.group()

  • SwiftPath.is_block_device()

  • SwiftPath.is_char_device()

  • SwiftPath.lstat()

  • SwiftPath.resolve()

🐉 Usage

To construct a path to a swift instance, simply use the syntax /containername/path/to/key when referencing the object. All pathlib.Path methods that are not explicitly excluded are available on the subsequently created object.

>>> from swiftpath import SwiftPath
>>> path = SwiftPath("/mycontainer/my-file.txt")
>>> path.write_text("hello\n")
>>> path.read_text()
hello

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

swiftpath-0.0.1.dev0.tar.gz (38.8 kB view hashes)

Uploaded Source

Built Distribution

swiftpath-0.0.1.dev0-py2.py3-none-any.whl (17.0 kB view hashes)

Uploaded Python 2 Python 3

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