Skip to main content

Augmented pathlib. Everything else you could do with a path.

Project description

augpathlib

PyPI version Build Status Coverage Status

Augmented pathlib. Everything else you could do with a path.

Introduction

Do you like pathlib?
Have you ever wanted to see just how far you can push the path abstraction?
Do you like using the division operator in ways that could potentially cause reading from the network or writing to disk?
Then augpathlib is for you!

Details

augpathlib makes extensive use of the pathlib Path object (and friends) by augmenting the base PosixPath object with additional functionality such as getting and setting xattrs, syncing with other mapped paths etc.

In essence there are 3 ways that a Path object can be used: Local, Cache, and Remote. Local paths return data and metadata that are local the the current computer. Cache paths return local metadata about remote objects (such as their remote id). Remote objects provide an interface to remote data that is associated with a path.

Remote paths should be back by another object which is the representation of the remote according to the remote's APIs.

Remote paths are only intended to provide a 1:1 mapping, so list(local.data) == list(remote.data) should always be true if everything is in sync.

If there is additional metadata that is associated with a local path then that is represented in the layer above this one (currently DatasetData, in the future a validation Stage). That said, it does seem like we need a more formal place that can map between all these things rather than always trying to derive the mappings from data embedded (bound) to the derefereced path object.

Installing on MacOS catalina 10.15.5+

If you are getting a failed build for pxattr, please continue reading the following. When using LLVM (9.0.1+) or another 3rd party library for Clang on MacOS, there was an issue that requires a possible reinstall if you getting a failed build for pxattr. See LLVM Issue for details. To reinstall LLVM on brew or anaconda you can use the following examples.

> brew reinstall llvm 

or

> conda install --force-reinstall llvm 

If the reinstall fails to clear the issue consider uninstalling that library and use the default Clang from Xcode. It should be the following version or higher.

> clang -v
Apple clang version 11.0.3 (clang-1103.0.32.62)
Target: x86_64-apple-darwin19.5.0
Thread model: posix
InstalledDir: /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin

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

augpathlib-0.0.25.tar.gz (72.0 kB view details)

Uploaded Source

Built Distribution

augpathlib-0.0.25-py2.py3-none-any.whl (65.4 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file augpathlib-0.0.25.tar.gz.

File metadata

  • Download URL: augpathlib-0.0.25.tar.gz
  • Upload date:
  • Size: 72.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.9.16

File hashes

Hashes for augpathlib-0.0.25.tar.gz
Algorithm Hash digest
SHA256 9631972422a067f50e49b653bfbc2d2bc63c9f28343811743145f0349705434a
MD5 c7e77e39ac54f39cf1c34bd9d755100a
BLAKE2b-256 c02b06c1d9383bb9fab3646e1776f096b02559e18b9c5afda19a6fc9f7331b7e

See more details on using hashes here.

File details

Details for the file augpathlib-0.0.25-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for augpathlib-0.0.25-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 f8673446f4577c6466b7d0d7241a98d2805e3ba08e0edefff616ad2b2fcead20
MD5 c82205f8ba1374d61f98a9a0a2507278
BLAKE2b-256 364ae1d4420dc5b6a5f7f5e0b47de463a4035d00f02dd7ca4263b064c5cfd034

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