Metadata-Version: 2.1
Name: mafio
Version: 0.6
Summary: A package for maf files io
Home-page: https://github.com/zeyad-kay/mafio
Author: Zeyad Khaled
License: UNKNOWN
Project-URL: Bug Tracker, https://github.com/zeyad-kay/mafio/issues
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
License-File: LICENSE

# MAFIO

A minimalist Python package for reading and writing [MAF](https://docs.gdc.cancer.gov/Data/File_Formats/MAF_Format/#:~:text=Mutation%20Annotation%20Format%20(MAF)%20is,(or%20open-access).) files.

# Installation
Package can be installed using pip.
```sh
> pip install mafio
```
# Usage

## Read
```py
from mafio import MAFReader

reader = MAFReader("test.maf")

# for reading compressed file
reader = MAFReader("test.maf", compression='gzip')

data = reader.read()

print(reader.headers) # ['col1', 'col2', 'col3']
print(next(data)) # [[1,2,3], [4,5,6], [7,8,9]]

# return only certain columns
data = reader.read(use_cols=['col1','col3'])

print(reader.headers) # ['col1', 'col3']
print(next(data)) # [[1,3], [4,6], [7,9]]

# for big files use chunks
data = reader.read(chunk_size=2)

print(next(data)) #[[1,2,3], [4,5,6]]
print(next(data)) #[[7,8,9]]

```
## Write
```py
from mafio import write

cols = ['col1', 'col2', 'col3']
row1 = [1,2,3]
row2 = [4,5,6]
row3 = [7,8,9]
data = [cols, row1, row2, row3]

# Creates file if not exists
write("test.maf", data)

# Appending the file instead of overwriting
write("test.maf", data, append=True)

# pass a 
write("test.maf.gz", data)
```

# Tests
Clone the library.
```sh
> git clone https://github.com/zeyad-kay/mafio.git
```
Install test dependencies.
```sh
pip install -r test-requirements.txt
```
Run tests.
```sh
> pytest mafio/tests
```

