Metadata-Version: 2.4
Name: flua
Version: 0.0.1
Summary: A library for structured flu sequence analysis
Project-URL: Homepage, https://github.com/ov3rfit/flua
Project-URL: Repository, https://github.com/ov3rfit/flua
Project-URL: Issues, https://github.com/ov3rfit/flua/issues
Author-email: Sangwook Kim <windaheadjp@gmail.com>
License-Expression: MIT
License-File: LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.11
Requires-Dist: biopython>=1.85
Requires-Dist: pandas>=2.0
Provides-Extra: dev
Requires-Dist: ipykernel>=6.0; extra == 'dev'
Requires-Dist: pre-commit>=4.0; extra == 'dev'
Requires-Dist: pytest-cov>=5.0; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff>=0.8; extra == 'dev'
Description-Content-Type: text/markdown

# flua

> **Note:** This project is under active development. APIs may change without notice.

Influenza A sequence analysis toolkit.

## (Current) Features

- Load and parse influenza A FASTA files
- Automatic sequence type detection (DNA / RNA / Protein)
- Subtype extraction from FASTA headers (e.g. H1N1, H5N1pdm09)
- Segment identification (PB2, PB1, PA, HA, NP, NA, MP, NS)
- Translation with alternative product generation (splicing, frameshift, alt-ORF)
- DataFrame export for multi-sample comparative analysis

## Installation

```bash
pip install -e ".[dev]"
```

## Usage

```python
from flua import load_fasta, groups_to_dataframe, load_multiple_fasta

group = load_fasta("sample.fasta")
print(group.subtype)  # e.g. "H1N1"

groups = load_multiple_fasta(["sample1.fasta", "sample2.fasta"])
df = groups_to_dataframe(groups, value_type="translated")
```

## Development

```bash
pip install -e ".[dev]"
pytest
ruff check src/ tests/
```
