webdav4


Namewebdav4 JSON
Version 0.10.0 PyPI version JSON
download
home_pageNone
SummaryWebDAV client library with an fsspec-based filesystem and a CLI
upload_time2024-07-13 19:42:42
maintainerNone
docs_urlNone
authorNone
requires_python>=3.8
licenseNone
keywords fsspec webdav webdav-cli webdav-client
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # webdav4
[![PyPi](https://img.shields.io/pypi/v/webdav4.svg)](https://pypi.org/project/webdav4)
[![Conda](https://img.shields.io/conda/v/conda-forge/webdav4.svg?label=conda&logo=conda-forge)](https://anaconda.org/conda-forge/webdav4)
[![Status](https://img.shields.io/pypi/status/webdav4.svg)](https://pypi.org/project/webdav4)
[![Python Version](https://img.shields.io/pypi/pyversions/webdav4)](https://pypi.org/project/webdav4)
![ci](https://github.com/skshetry/webdav4/workflows/CI/badge.svg)

Webdav API with an (optional) [fsspec](#fsspec) implementation and a [CLI](#cli).

## Installation

```console
$ pip install webdav4
```

### Usage

#### webdav4 Client
```python
from webdav4.client import Client

client = Client("https://webdav.com", auth=("username", "password"))
client.exists("Documents/Readme.md")

client.ls("Photos", detail=False)
client.upload_file("Gorilla.jpg", "Photos/Gorilla.jpg")
```

Check out [Client API](docs/reference/client.md) reference for more information.



#### fsspec

[`fsspec`](https://filesystem-spec.readthedocs.io) tries to provide a
consistent APIs to different storage backends, by defining standard
interfaces, so that other code using them could operate without depending
on the implementations of the backends. This package, in the same way,
wraps the above [webdav client](#webdav4-client) with a consistent file-system API.


To use it, you need to install `fsspec` additionally which you can do as
follows:

```console
$ pip install webdav4[fsspec]
```

```python
from webdav4.fsspec import WebdavFileSystem

fs = WebdavFileSystem("https://webdav.com", auth=("username", "password"))
fs.exists("Documents/Readme.md")

fs.ls("Photos", detail=False)
```

Check out [WebdavFileSystem API](docs/reference/fsspec.md) reference for more information.


#### CLI

webdav4 also provides a CLI similar to `aws s3` to make it easier to work with webdav servers.
![cli-usage](docs/_static/usage.png)

Please checkout [CLI Usage](docs/reference/cli.md) for more information.

### Contributing

Contributions are welcome. Please take a look at
[Contributing Guide](CONTRIBUTING.md) for more details.

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "webdav4",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": null,
    "keywords": "fsspec, webdav, webdav-cli, webdav-client",
    "author": null,
    "author_email": "Saugat Pachhai <suagatchhetri@outlook.com>",
    "download_url": "https://files.pythonhosted.org/packages/08/3d/d604f9d5195689e578f124f196a5d7e80f3106c8404f5c19b2181691de19/webdav4-0.10.0.tar.gz",
    "platform": null,
    "description": "# webdav4\n[![PyPi](https://img.shields.io/pypi/v/webdav4.svg)](https://pypi.org/project/webdav4)\n[![Conda](https://img.shields.io/conda/v/conda-forge/webdav4.svg?label=conda&logo=conda-forge)](https://anaconda.org/conda-forge/webdav4)\n[![Status](https://img.shields.io/pypi/status/webdav4.svg)](https://pypi.org/project/webdav4)\n[![Python Version](https://img.shields.io/pypi/pyversions/webdav4)](https://pypi.org/project/webdav4)\n![ci](https://github.com/skshetry/webdav4/workflows/CI/badge.svg)\n\nWebdav API with an (optional) [fsspec](#fsspec) implementation and a [CLI](#cli).\n\n## Installation\n\n```console\n$ pip install webdav4\n```\n\n### Usage\n\n#### webdav4 Client\n```python\nfrom webdav4.client import Client\n\nclient = Client(\"https://webdav.com\", auth=(\"username\", \"password\"))\nclient.exists(\"Documents/Readme.md\")\n\nclient.ls(\"Photos\", detail=False)\nclient.upload_file(\"Gorilla.jpg\", \"Photos/Gorilla.jpg\")\n```\n\nCheck out [Client API](docs/reference/client.md) reference for more information.\n\n\n\n#### fsspec\n\n[`fsspec`](https://filesystem-spec.readthedocs.io) tries to provide a\nconsistent APIs to different storage backends, by defining standard\ninterfaces, so that other code using them could operate without depending\non the implementations of the backends. This package, in the same way,\nwraps the above [webdav client](#webdav4-client) with a consistent file-system API.\n\n\nTo use it, you need to install `fsspec` additionally which you can do as\nfollows:\n\n```console\n$ pip install webdav4[fsspec]\n```\n\n```python\nfrom webdav4.fsspec import WebdavFileSystem\n\nfs = WebdavFileSystem(\"https://webdav.com\", auth=(\"username\", \"password\"))\nfs.exists(\"Documents/Readme.md\")\n\nfs.ls(\"Photos\", detail=False)\n```\n\nCheck out [WebdavFileSystem API](docs/reference/fsspec.md) reference for more information.\n\n\n#### CLI\n\nwebdav4 also provides a CLI similar to `aws s3` to make it easier to work with webdav servers.\n![cli-usage](docs/_static/usage.png)\n\nPlease checkout [CLI Usage](docs/reference/cli.md) for more information.\n\n### Contributing\n\nContributions are welcome. Please take a look at\n[Contributing Guide](CONTRIBUTING.md) for more details.\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "WebDAV client library with an fsspec-based filesystem and a CLI",
    "version": "0.10.0",
    "project_urls": {
        "Bug Tracker": "https://github.com/skshetry/webdav4/issues",
        "Documentation": "https://skshetry.github.io/webdav4",
        "Source Code": "https://github.com/skshetry/webdav4"
    },
    "split_keywords": [
        "fsspec",
        " webdav",
        " webdav-cli",
        " webdav-client"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "60021b77232297fa52f7bedcf70f3ebe3817e9295f302389fb57dd0e6c077329",
                "md5": "3bfd8f817a74ccbb7e0106b08a07a867",
                "sha256": "8f915d72483e572089a3af0a2ad20c7e12d04eee9b9134eb718dbfa37af221d8"
            },
            "downloads": -1,
            "filename": "webdav4-0.10.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "3bfd8f817a74ccbb7e0106b08a07a867",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 36350,
            "upload_time": "2024-07-13T19:42:41",
            "upload_time_iso_8601": "2024-07-13T19:42:41.087316Z",
            "url": "https://files.pythonhosted.org/packages/60/02/1b77232297fa52f7bedcf70f3ebe3817e9295f302389fb57dd0e6c077329/webdav4-0.10.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "083dd604f9d5195689e578f124f196a5d7e80f3106c8404f5c19b2181691de19",
                "md5": "28695af107788db18db7e0a1f48183f6",
                "sha256": "387da6f0ee384e77149dddd9bcfd434afa155882f6c440a529a7cb458624407f"
            },
            "downloads": -1,
            "filename": "webdav4-0.10.0.tar.gz",
            "has_sig": false,
            "md5_digest": "28695af107788db18db7e0a1f48183f6",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 229195,
            "upload_time": "2024-07-13T19:42:42",
            "upload_time_iso_8601": "2024-07-13T19:42:42.593082Z",
            "url": "https://files.pythonhosted.org/packages/08/3d/d604f9d5195689e578f124f196a5d7e80f3106c8404f5c19b2181691de19/webdav4-0.10.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-07-13 19:42:42",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "skshetry",
    "github_project": "webdav4",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "webdav4"
}
        
Elapsed time: 4.56068s