Skip to content

Commit 546d70d

Browse files
author
Rajat Arya
committed
added license, README partial badges
1 parent c76e7a3 commit 546d70d

File tree

2 files changed

+49
-18
lines changed

2 files changed

+49
-18
lines changed

LICENSE

+29
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
BSD 3-Clause License
2+
3+
Copyright (c) 2023, XetData
4+
5+
Redistribution and use in source and binary forms, with or without
6+
modification, are permitted provided that the following conditions are met:
7+
8+
1. Redistributions of source code must retain the above copyright notice, this
9+
list of conditions and the following disclaimer.
10+
11+
2. Redistributions in binary form must reproduce the above copyright notice,
12+
this list of conditions and the following disclaimer in the documentation
13+
and/or other materials provided with the distribution.
14+
15+
3. Neither the name of the copyright holder nor the names of its
16+
contributors may be used to endorse or promote products derived from
17+
this software without specific prior written permission.
18+
19+
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
20+
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
21+
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
22+
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
23+
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
24+
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
25+
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
26+
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
27+
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
28+
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
29+

README.md

+20-18
Original file line numberDiff line numberDiff line change
@@ -2,46 +2,48 @@
22
<img src="https://github.com/xetdata/pyxet/blob/0c7608c97f6a2a0cb2c83dd38fb717913c4d7522/docs/images/logo.png" alt="logo" width="400" />
33
</p>
44

5-
# Welcome to pyxet's documentation!
5+
6+
# pyxet - The SDK for XetHub
7+
8+
[![Version](https://img.shields.io/pypi/v/pyxet.svg?style=flat)](https://pypi.python.org/pypi/pyxet/)
9+
[![Python](https://img.shields.io/pypi/pyversions/pyxet.svg?style=flat)](https://pypi.python.org/pypi/pyxet/)
10+
[![License](https://img.shields.io/pypi/l/pyxet.svg?style=flat)](https://github.com/xetdata/pyxet/blob/main/LICENSE)
11+
[![Downloads](https://img.shields.io/pypi/dm/pyxet?style=flat)](https://pypi.python.org/pypi/pyxet/)
12+
[![Discord](https://img.shields.io/discord/1100889165777862807)](https://discord.gg/KCzmjDaDdC)
613

714
pyxet is a Python library that provides a lightweight interface for the [XetHub](https://xethub.com/) platform.
815
XetHub is a blob-store with a filesystem like interface and git capabilities, therefore pyxet implement both.
916

1017
## Features
1118

12-
1. A filesystem interface.
19+
1. A filesystem interface:
1320
* [fsspec](https://filesystem-spec.readthedocs.io)
1421
* copy
1522
* remove
1623
* list
1724
* etc.
1825
* [glob](https://docs.python.org/3/library/glob.html)
1926
* [pathlib.Path](https://docs.python.org/3/library/pathlib.html)(WIP)
20-
2. Mount.
27+
28+
2. Mount:
2129
* Read-only optimize for speed; perfect for data exploration and analysis and building data-apps and model
2230
inference.
23-
* Read-write for data ingestion and preparation; optimal for database backups and training and monitoring logs.
24-
3. Git capabilities:
25-
* add, commit, push
26-
* clone, fork
27-
* merge, rebase
28-
* pull, fetch
29-
* checkout, reset
30-
* stash, diff, log
31-
* status, branch
32-
* submodules
33-
...
34-
4. Integrations:
31+
* Read-write for data ingestion and preparation; optimal for database backups and training and monitoring logs. _(coming soon)_
32+
33+
3. Integrations:
3534
- [x] [GitHub](https://github.com) [submodule](https://git-scm.com/book/en/v2/Git-Tools-Submodules)
3635
- [x] [pandas](https://pandas.pydata.org)
3736
- [x] [polars](https://pola-rs.github.io/polars-book/)
3837
- [x] [pyarrow](https://arrow.apache.org/docs/python/)
3938
- [ ] [duckdb](https://duckdb.org/)
4039
- [ ] [dask](https://dask.org/)
4140
- [ ] [ray](https://ray.io/)
42-
5. CLI: All the features are available through the CLI too under `xet <command>`.
4341

44-
For API documentation and full examples, please see the [documentation](TODO).
42+
For API documentation and full examples, please see the [documentation](https://pyxet.readthedocs.io/en/latest/).
43+
44+
## Getting Started
45+
46+
4547

4648
## Installation
4749

@@ -219,4 +221,4 @@ lazy_df = pl.scan_parquet(ds.dataset("file.parquet",
219221

220222
# Project examples
221223

222-
* [Titanic-app](https://xethub.com/xdssio/titanic-server-example)
224+
* [Titanic-app](https://xethub.com/xdssio/titanic-server-example)

0 commit comments

Comments
 (0)