# augpathlib
[](https://pypi.org/project/augpathlib/)
[](https://travis-ci.com/tgbugs/augpathlib)
[](https://coveralls.io/github/tgbugs/augpathlib?branch=master)
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](https://github.com/iustin/pyxattr/issues/25) for details. To reinstall LLVM on brew or anaconda you can use the following examples.
```bash
> brew reinstall llvm
```
or
```bash
> 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.
```bash
> 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
```
Raw data
{
"_id": null,
"home_page": "https://github.com/tgbugs/augpathlib",
"name": "augpathlib",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": null,
"keywords": "pathlib path paths",
"author": "Tom Gillespie",
"author_email": "tgbugs@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/38/2f/12c73a1767e7d88a840a7fca2306c795eb6a42cca2742d8228976533848e/augpathlib-0.0.29.tar.gz",
"platform": null,
"description": "# augpathlib\n[](https://pypi.org/project/augpathlib/)\n[](https://travis-ci.com/tgbugs/augpathlib)\n[](https://coveralls.io/github/tgbugs/augpathlib?branch=master)\n\nAugmented pathlib. Everything else you could do with a path.\n\n## Introduction\nDo you like pathlib? \nHave you ever wanted to see just how far you can push the path abstraction? \nDo you like using the division operator in ways that could potentially cause\nreading from the network or writing to disk? \nThen augpathlib is for you!\n\n## Details\naugpathlib makes extensive use of the pathlib Path object (and friends)\nby augmenting the base PosixPath object with additional functionality\nsuch as getting and setting xattrs, syncing with other mapped paths etc.\n\nIn essence there are 3 ways that a Path object can be used: Local, Cache, and Remote.\nLocal paths return data and metadata that are local the the current computer.\nCache paths return local metadata about remote objects (such as their remote id).\nRemote objects provide an interface to remote data that is associated with a path.\n\nRemote paths should be back by another object which is the representation of the\nremote according to the remote's APIs.\n\nRemote paths are only intended to provide a 1:1 mapping, so list(local.data) == list(remote.data)\nshould always be true if everything is in sync.\n\nIf there is additional metadata that is associated with a local path then that is\nrepresented in the layer above this one (currently DatasetData, in the future a validation Stage).\nThat said, it does seem like we need a more formal place that can map between all these\nthings rather than always trying to derive the mappings from data embedded (bound) to\nthe derefereced path object. \n\n## Installing on MacOS catalina 10.15.5+\nIf you are getting a failed build for pxattr, please continue reading the following.\nWhen 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](https://github.com/iustin/pyxattr/issues/25) for details. To reinstall LLVM on brew or anaconda you can use the following examples.\n```bash\n> brew reinstall llvm \n```\nor \n```bash\n> conda install --force-reinstall llvm \n```\nIf 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.\n```bash\n> clang -v\nApple clang version 11.0.3 (clang-1103.0.32.62)\nTarget: x86_64-apple-darwin19.5.0\nThread model: posix\nInstalledDir: /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin\n```\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Augmented pathlib. Everything else you could do with a path.",
"version": "0.0.29",
"project_urls": {
"Homepage": "https://github.com/tgbugs/augpathlib"
},
"split_keywords": [
"pathlib",
"path",
"paths"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "fe620f50ca73c6673f05aad7b4517856370a96a790e1db7efbd39b030df03da7",
"md5": "5e5a78ede873779ea62677bc04d92bf9",
"sha256": "e83d7d97f1590c40ddfa6b7690341cef3a220d8e951b5aa2e0d6a7e41530b1ac"
},
"downloads": -1,
"filename": "augpathlib-0.0.29-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "5e5a78ede873779ea62677bc04d92bf9",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": ">=3.6",
"size": 73445,
"upload_time": "2024-03-26T03:42:19",
"upload_time_iso_8601": "2024-03-26T03:42:19.997271Z",
"url": "https://files.pythonhosted.org/packages/fe/62/0f50ca73c6673f05aad7b4517856370a96a790e1db7efbd39b030df03da7/augpathlib-0.0.29-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "382f12c73a1767e7d88a840a7fca2306c795eb6a42cca2742d8228976533848e",
"md5": "4051faa13728d53acd7535775d6a9dc9",
"sha256": "fc1a836fb1571fda032b13017f63d672b06ec2432e9434654f92287bc45e838b"
},
"downloads": -1,
"filename": "augpathlib-0.0.29.tar.gz",
"has_sig": false,
"md5_digest": "4051faa13728d53acd7535775d6a9dc9",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 80241,
"upload_time": "2024-03-26T03:42:22",
"upload_time_iso_8601": "2024-03-26T03:42:22.101385Z",
"url": "https://files.pythonhosted.org/packages/38/2f/12c73a1767e7d88a840a7fca2306c795eb6a42cca2742d8228976533848e/augpathlib-0.0.29.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-26 03:42:22",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "tgbugs",
"github_project": "augpathlib",
"travis_ci": true,
"coveralls": false,
"github_actions": false,
"lcname": "augpathlib"
}
JSON
