Metadata-Version: 2.4
Name: azureml-fsspec
Version: 1.4.0
Summary: Access datastore uri with fsspec
Home-page: https://docs.microsoft.com/python/api/overview/azure/ml/?view=azure-ml-py
Author: Microsoft Corp
License: Proprietary https://aka.ms/azureml-preview-sdk-license 
Keywords: file-system,dask,azure
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Topic :: Scientific/Engineering
Requires-Python: >=3.10,<3.14
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Requires-Dist: azureml-dataprep<5.6.0a,>=5.5.0
Requires-Dist: fsspec<=2023.10.0,>=2021.6.1
Requires-Dist: pytz
Dynamic: author
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: license-file
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# Filesystem interface to Azure Machine Learning defined URIs

## Getting started

This package can be installed using:

```bash
pip install azureml-fsspec
```

## Examples
Accepted uri format is Azure Machcine Learning defined datastore uri: azureml://subscriptions/([^\/]+)/resourcegroups/([^\/]+)/workspaces/([^\/]+)/datastores/([^\/]+)/paths/([^\/]+)

```python
# load parquet file to pandas
import pandas
df = pandas.read_parquet('azureml://subscriptions/{sub_id}/resourcegroups/{rs_group}/workspaces/{ws}
                          /datastores/workspaceblobstore/paths/myfolder/mydata.parquet')

# load csv file to pandas
import pandas
df = pandas.read_csv('azureml://subscriptions/{sub_id}/resourcegroups/{rs_group}/workspaces/{ws}
                          /datastores/workspaceblobstore/paths/myfolder/mydata.csv')

# load parquet file to dask
import dask.dataframe as dd
df = dd.read_parquet('azureml://subscriptions/{sub_id}/resourcegroups/{rs_group}/workspaces/{ws}
                          /datastores/workspaceblobstore/paths/myfolder/mydata.parquet')

# load csv file to dask
import dask.dataframe as dd
df = dd.read_csv('azureml://subscriptions/{sub_id}/resourcegroups/{rs_group}/workspaces/{ws}
                          /datastores/workspaceblobstore/paths/myfolder/mydata.csv')
```


# Release History

## 1.4.0 (04-16-2026)

### Features Added
- added support for python 3.12 and 3.13 

### Bugs Fixed
- Updated azureml-dataprep dependency to 5.4.0 or newer to avoid pkg_resources import failures with recent setuptools versions.

## 1.3.1 (02-05-2024)

### Features Added
- added support for using mlclient for authorization

## 1.3.0 (01-17-2024)

### Features Added
- added registry support for fsspec. 

## 1.2.0 (08-14-2023)

### Features Added
- added auth dict support (SP and managedIdentity) for fsspec. 
- added user exception mapping

## 1.1.0 (06-01-2023)

### Features Added
- upload/download performance improvement

## 1.0.0 (04-07-2023)

### Features Added
- Added upload/download API
- bugfix(root behavior)

## 0.1.0b1

### Features Added
- Initial public preview release of FileSystem for Azure Machine Learning defined datastore uri 

## 0.1.0b2

### Features Added
- Fix release notes


## 0.1.0b3

### Features Added
- Add mode in open API
- Add validation
- Upgrade dataprep to 4.8
