Metadata-Version: 2.1
Name: simple-s3fs
Version: 0.1.2
Summary: A simple FUSE filesystem for reading files in S3 buckets. Forked from https://github.com/higlass/simple-httpfs and has been adapted to the needs of the 4DN data portal.
Home-page: https://github.com/4dn-dcic/simple-s3fs
Author: Alexander Veit
Author-email: alexander_veit@hms.harvard.edu
License: MIT
Platform: UNKNOWN
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Requires-Dist: fusepy
Requires-Dist: requests
Requires-Dist: diskcache
Requires-Dist: numpy
Requires-Dist: boto3
Requires-Dist: slugid

# simple-s3fs

A simple (read-only) FUSE-based file system for S3 buckets.

## Usage

```
simple-s3fs --aws-profile default -f -l /tmp/s3.log /tmp/s3/<bucket>
less /tmp/s3/<bucket>/folder/file.txt
```

Please note: Folders in buckets cannot have `.` in their names and files must have an extension (i.e. a `.`)


## Unmounting

```
umount /tmp/s3/<bucket>
```

## Development

The recommended way to develop `simple-s3fs` is to use a [conda](https://conda.io/docs/intro.html) environment and
install `simple-s3fs` with develop mode:

```shell
pip install -e .
```


### Important

 This is a FORK of Peter Kerpedjiev's [simple-httpfs](https://github.com/higlass/simple-httpfs)
 package. It was adapted to the needs of projects at the
 [4D Nucleome Data Coordination and Integration Center (4DN-DCIC)](https://github.com/4dn-dcic).


