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.

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.2.tar.gz (48.5 kB view details)

Uploaded Source

Built Distribution

augpathlib-0.0.2-py2.py3-none-any.whl (45.8 kB view details)

Uploaded Python 2 Python 3

File details

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

File metadata

  • Download URL: augpathlib-0.0.2.tar.gz
  • Upload date:
  • Size: 48.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.21.0 setuptools/41.4.0 requests-toolbelt/0.9.1 tqdm/4.23.3 CPython/3.6.9

File hashes

Hashes for augpathlib-0.0.2.tar.gz
Algorithm Hash digest
SHA256 f3c8b2b704e1699236e570fd9dd4f834978119db16044b9dc685ed4cd33c37aa
MD5 3ff0b2a82dd7b46250f90279c17af018
BLAKE2b-256 c9d6b1bc3b5fa938a31148dcb5d44b4077599e404afa83496c1c18670348ffd5

See more details on using hashes here.

Provenance

File details

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

File metadata

  • Download URL: augpathlib-0.0.2-py2.py3-none-any.whl
  • Upload date:
  • Size: 45.8 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.21.0 setuptools/41.4.0 requests-toolbelt/0.9.1 tqdm/4.23.3 CPython/3.6.9

File hashes

Hashes for augpathlib-0.0.2-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 9a11ab8dd67ed5bad45cd0fb8df9aad51d42221d3dba61c72b14fa7a4603468a
MD5 a8fca20bce980aa73bef48729da7237e
BLAKE2b-256 f50ad95a39390a6ac867fcba5a316e941bae540812345632df6b366a3af7eb8a

See more details on using hashes here.

Provenance

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