Metadata-Version: 2.4
Name: genome-format-converters
Version: 0.1.2
Summary: A collection of Python scripts for converting common bioinformatics file formats
Author-email: Benjamin Narh-Madey <narhmadey@swisc.edu>
License: MIT
Project-URL: Homepage, https://github.com/K-nie/genome-format-converters
Project-URL: Bug Tracker, https://github.com/K-nie/genome-format-converters/issues
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Scientific/Engineering :: Bio-Informatics
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: biopython>=1.78
Requires-Dist: pandas>=1.0
Requires-Dist: pysam>=0.16
Dynamic: license-file


## Genome Format Converters

### Author: Benjamin Narh-Madey
### Affiliation: Hittinger Lab, Laboratory of Genetics, University of Wisconsin-Madison

![Python 3.6+](https://img.shields.io/badge/python-3.6+-blue.svg)
![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)

A collection of Python scripts for converting common bioinformatics file formats.
Each script follows a simple, uniform interface: you point it to an input directory, and it writes converted files to an output directory.

### Table of Contents
- [Features](#features)
- [Installation](#installation)
- [Usage](#usage)
- [Command Reference](#command-reference)
  - [Annotation Format Conversions](#annotation-format-conversions)
  - [Sequence Format Conversions](#sequence-format-conversions)
  - [Alignment / Mapping Results](#alignment--mapping-results)
  - [Variant Formats (VCF)](#variant-formats-vcf)
  - [Phylogenetic Tree Formats](#phylogenetic-tree-formats)
- [Scripts Overview](#scripts-overview)
- [License](#license)
- [Contributing](#contributing)

### Features
- **Uniform interface**: all scripts accept `--input-dir` and `--output-dir` arguments.
- **Batch processing**: convert all files of a given type in a directory at once.
- **Lightweight**: only requires a few well‑maintained Python libraries.
- **Well tested**: each script has been tested on small example datasets.

### Installation
Clone the repository:
git clone https://github.com/K-nie/genome-format-converters.git
cd genome-format-converters
Install the required dependencies:
pip install -r requirements.txt

Note: For scripts that work with BAM or VCF files, you also need pysam (included in requirements.txt).For BLAST tabular conversion, you need BLAST+ installed separately (optional – only if you generate the input files).

Usage
All scripts are used in the same way. After installing the package (pip install genome-format-converters), users can run the tool from the command line using the gfc command followed by a subcommand. 
The general syntax is:
gfc <subcommand> --input-dir INPUT_DIR --output-dir OUTPUT_DIR [options]
The input directory should contain the files you want to convert. The output directory will be created if it doesn’t exist. Each subcommand processes all files with recognised extensions in the input directory.

### Getting help
Run: gfc --help to see all available subcommands, or gfc <subcommand> --help for detailed options.
Examples: Get help for a specific subcommand (e.g., gff3-to-gtf) type: gfc gff3-to-gtf --help

### Command Reference

### Annotation Format Conversions
### Subcommand	                            Description                                                     Example
1. gff3-to-gtf	--------------------------  Convert GFF3 to GTF	 ------------------------------------------ gfc gff3-to-gtf --input-dir ./gff_files --output-dir ./gtf_output
2. gff3-to-bed	--------------------------  Convert GFF3 to 6‑column BED ---------------------------------- gfc gff3-to-bed --input-dir ./gff_files --output-dir ./bed_output
3. genbank-to-gff3 -----------------------  Convert GenBank to GFF3	  ------------------------------------- gfc genbank-to-gff3 --input-dir ./gbk_files --output-dir ./gff3_output
4. gff3-to-table -------------------------  Convert GFF3 to tab‑separated feature table	 ------------------ gfc gff3-to-table --input-dir ./gff_files --output-dir ./table_output
5. gff3-to-protein	----------------------  Extract protein sequences from GFF3 + FASTA	 ------------------ gfc gff3-to-protein --input-dir ./data --output-dir ./proteins
6. fasta-gff-to-gbk	 ---------------------   Convert paired FASTA and GFF3 files to GenBank	 -------------- gfc fasta-gff-to-gbk --input-dir ./data --output-dir ./gbk_output

### Sequence Format Conversions
### Subcommand	                            Description	                                                    Example
1. fasta-to-fastq ------------------------  FASTA → FASTQ with default quality (I) ------------------------ gfc fasta-to-fastq --input-dir ./fasta --output-dir ./fastq
2. fastq-to-fasta ------------------------  FASTQ → FASTA (drop qualities)	------------------------------- gfc fastq-to-fasta --input-dir ./fastq --output-dir ./fasta
3. fasta-qual-to-fastq	------------------   Combine FASTA + QUAL into FASTQ	--------------------------- gfc fasta-qual-to-fastq --input-dir ./data --output-dir ./fastq
4. fastq-to-fasta-qual	------------------  Split FASTQ into FASTA and QUAL	  ----------------------------- gfc fastq-to-fasta-qual --input-dir ./fastq --output-dir ./split
5. fasta-to-table	----------------------  FASTA → two‑column TSV (id, sequence) ------------------------- gfc fasta-to-table --input-dir ./fasta --output-dir ./tables
6. convert-alignment ---------------------  Convert alignment formats (fasta, phylip, nexus, clustal) ----- gfc convert-alignment --input-dir ./aln --output-dir ./phylip --in-format fasta --out-format phylip

### Alignment / Mapping Results
### Subcommand	                            Description	                                                    Example
1. bam-to-bed	 -------------------------  Convert BAM/SAM to BED6	   ------------------------------------ gfc bam-to-bed --input-dir ./bam_files --output-dir ./bed
2. blast-to-links   ----------------------  Convert BLAST tabular (outfmt 6) to link TSV    --------------- gfc blast-to-links --input-dir ./blast_results --output-dir ./links --min-length 100 --min-identity 30
3. delta-to-tab	   -----------------------  Convert MUMmer .delta to tabular coordinates    --------------- gfc delta-to-tab --input-dir ./delta_files --output-dir ./tables
4. maf-to-xmfa	   -----------------------  Convert MAF to XMFA (progressiveMauve format)	--------------- gfc maf-to-xmfa --input-dir ./maf_files --output-dir ./xmfa

### Variant Formats (VCF)
### Subcommand	                            Description	                                                    Example
1. vcf-to-bed	 -------------------------  Convert VCF to BED intervals	 ------------------------------ gfc vcf-to-bed --input-dir ./vcf_files --output-dir ./bed
2. vcf-to-table	 -------------------------  Convert VCF to tab‑separated table	--------------------------- gfc vcf-to-table --input-dir ./vcf_files --output-dir ./tables
3. vcf-to-consensus	  --------------------  Create consensus FASTA from VCF + reference	  ----------------- gfc vcf-to-consensus --input-dir ./data --output-dir ./consensus

### Phylogenetic Tree Formats
### Subcommand	                            Description	                                                    Example
1. tree-convert	  ------------------------  Convert tree formats (newick, nexus, phyloxml)	--------------- gfc tree-convert --input-dir ./trees --output-dir ./converted --in-format newick --out-format nexus
2. annotate-tree    ----------------------  Add alignment sequences to tree (output NEXUS)	--------------- gfc annotate-tree --tree tree.nwk --aln alignment.fasta --output annotated.nex


### Testing
All scripts have been tested on small example datasets located in the tests/test_data/ directory. These test files cover the basic functionality of each converter. To run the tests yourself, install the package in development mode (pip install -e .) and execute the example commands from the Command Reference using the provided test data. For instance:

### License
This project is licensed under the MIT License – see the LICENSE file for details.

### Contributing
Contributions are welcome! If you have a new converter or an improvement, please open an issue or submit a pull request.
