oxenai 0.36.3__cp312-cp312-win_amd64.whl → 0.36.5__cp312-cp312-win_amd64.whl

oxenai-0.36.5.dist-info/METADATA

@@ -0,0 +1,92 @@
+Metadata-Version: 2.4
+Name: oxenai
+Version: 0.36.5
+Classifier: Programming Language :: Rust
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Topic :: Software Development :: Version Control
+Requires-Dist: fsspec>=2025.7.0
+Requires-Dist: maturin>=1.9.3
+Requires-Dist: pandas>=2.3.1
+Requires-Dist: polars>=1.32.0
+Requires-Dist: pyarrow>=21.0.0
+Requires-Dist: pytest>=8.4.1
+Requires-Dist: pytest-datadir>=1.8.0
+Requires-Dist: requests>=2.32.4
+Requires-Dist: ruff>=0.12.7
+Requires-Dist: toml>=0.10.2
+Requires-Dist: tqdm>=4.67.1
+Summary: Data version control for machine learning
+Keywords: oxen,version control
+License-Expression: Apache-2.0
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Homepage, https://www.oxen.ai/
+Project-URL: Documentation, https://docs.oxen.ai/
+Project-URL: Repository, https://github.com/Oxen-AI/Oxen
+
+# 🐂 🐍 Oxen Python Interface 
+
+The Oxen python interface makes it easy to integrate Oxen datasets directly into machine learning dataloaders or other data pipelines.
+
+## Repositories
+
+There are two types of repositories one can interact with, a `Repo` and a `RemoteRepo`.
+
+
+## Local Repo
+
+To fully clone all the data to your local machine, you can use the `Repo` class.
+
+```python
+import oxen
+
+repo = oxen.Repo("path/to/repository")
+repo.clone("https://hub.oxen.ai/ox/CatDogBBox")
+```
+
+If there is a specific version of your data you want to access, you can specify the `branch` when cloning.
+
+```python
+repo.clone("https://hub.oxen.ai/ox/CatDogBBox", branch="my-pets")
+```
+
+Once you have a repository locally, you can perform the same operations you might via the command line, through the python api.
+
+For example, you can checkout a branch, add a file, commit, and push the data to the same remote you cloned it from.
+
+```python
+import oxen
+
+repo = oxen.Repo("path/to/repository")
+repo.clone("https://hub.oxen.ai/ox/CatDogBBox")
+repo.checkout()
+```
+
+## Remote Repo
+
+If you don't want to download the data locally, you can use the `RemoteRepo` class to interact with a remote repository on OxenHub.
+
+```python
+import oxen 
+
+repo = RemoteRepo("https://hub.oxen.ai/ox/CatDogBBox")
+```
+
+To stage and commit files to a specific version of the data, you can `checkout` an existing branch or create a new one.
+
+```python
+repo.create_branch("dev")
+repo.checkout("dev")
+```
+
+You can then stage files to the remote repository by specifying the file path and destination directory.
+
+```python
+repo.add("new-cat.png", "images") # Stage to images/new-cat.png on remote
+repo.commit("Adding another training image")
+```
+
+Note that no "push" command is required here, since the above code creates a commit directly on the remote branch.
+
+

{oxenai-0.36.3.dist-info → oxenai-0.36.5.dist-info}/RECORD

@@ -15,7 +15,7 @@ oxen/features.py,sha256=hgkj5UjFbRmJvNecLPaacXAy-F9S4kn090ogxplOBvw,1436
 oxen/fs.py,sha256=HvFxquxdZdysAJLhsLErEdDBPJEnh0Dplq1GZxTAFgY,1542
 oxen/init.py,sha256=9V3Le4aGCpnSW3pvnDZtgv6uVrr7Wtf_0USyVhF3l5E,417
 oxen/notebooks.py,sha256=wIFknbpZM0BhfFojVVsSppziCDH0fTr-P3dNqZCQLss,2992
-oxen/oxen.cp312-win_amd64.pyd,sha256=Md-KHiwC1exzScAqCBy19HXPFgHNrch7yvN0S1932Hk,105017856
+oxen/oxen.cp312-win_amd64.pyd,sha256=733P3evGYYgHpZEIE_fC750EUZ2pOzMDwUYwieFw7e4,117981184
 oxen/oxen_fs.py,sha256=nsgPHSOAqjEY2HlmYsZCC6ttMLoHXTkla0tMQaLN4MA,11446
 oxen/providers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 oxen/providers/dataset_path_provider.py,sha256=LmjSDE1ttlStT_FNKPexrfnUcsUCx_P03h_T39FpTzc,700
@@ -27,7 +27,7 @@ oxen/streaming_dataset.py,sha256=hrfQBlUj5EWbTZl_aEaZszfxzrwTUohvyuCvwyQGAHw,822
 oxen/user.py,sha256=IINEakTzrSBXKDqKsF1wjitysEl6TwyOEs2u2PbVgBw,1205
 oxen/util/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 oxen/workspace.py,sha256=DPXq8P9_TldkqWmFOuseGFhniUjIvUUgDaoKTNgGCwg,5735
-oxenai-0.36.3.dist-info/METADATA,sha256=Yrn39Zo5Qv7vcShYN0Y0StQgQsElHbvyHaFZKcykBdo,460
-oxenai-0.36.3.dist-info/WHEEL,sha256=UoHC5NvzY0geoE2r8Mxbl5fR5fYT9OeSzrhPCIC4-kQ,96
-oxenai-0.36.3.dist-info/entry_points.txt,sha256=CvslGiUZsEt-5k6cJ19pRFHGicXb4XrR0CKhrzq1aEU,40
-oxenai-0.36.3.dist-info/RECORD,,
+oxenai-0.36.5.dist-info/METADATA,sha256=PbENTiRAZBR-7UULIfrZNaLM1EOZMniKA6umZR_TaBo,2880
+oxenai-0.36.5.dist-info/WHEEL,sha256=HF3aUMilrtO42xS_fBzOVaPE8OtiNjP_RotLatII7HM,96
+oxenai-0.36.5.dist-info/entry_points.txt,sha256=CvslGiUZsEt-5k6cJ19pRFHGicXb4XrR0CKhrzq1aEU,40
+oxenai-0.36.5.dist-info/RECORD,,

{oxenai-0.36.3.dist-info → oxenai-0.36.5.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: maturin (1.9.2)
+Generator: maturin (1.9.3)
 Root-Is-Purelib: false
 Tag: cp312-cp312-win_amd64

oxenai-0.36.3.dist-info/METADATA

@@ -1,15 +0,0 @@
-Metadata-Version: 2.4
-Name: oxenai
-Version: 0.36.3
-Classifier: Programming Language :: Rust
-Classifier: Programming Language :: Python :: Implementation :: CPython
-Classifier: Programming Language :: Python :: Implementation :: PyPy
-Requires-Dist: fsspec
-Requires-Dist: pandas
-Requires-Dist: polars
-Requires-Dist: pyarrow
-Requires-Dist: requests
-Requires-Dist: toml
-Requires-Dist: tqdm
-Summary: Data version control for machine learning
-Requires-Python: >=3.7