# gff

> A GFF (general feature format) parser

Latest version **0.1.7** (published 2015-02-13) · 0 weekly downloads

## Install

```sh
npm install gff
pnpm add gff
yarn add gff
bun add gff
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.1.7 |
| Published | 2015-02-13 |
| First published | 2015-02-13 |
| Weekly downloads | 0 |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 2 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | greenify |
| Maintainers | greenify |
| Keywords | io, gff, parser, feature |

## Links

- npm: https://www.npmjs.com/package/gff
- Repository: https://github.com/greenify/biojs-io-gff
- Issues: https://github.com/greenify/biojs-io-gff/issues
- npm.io page: https://npm.io/package/gff

## Dependencies (2)

- [gulp](https://npm.io/package/gulp.md) ^3.8.10
- [nets](https://npm.io/package/nets.md) ^1.0.0

## Alternatives

- [babylon](https://npm.io/package/babylon.md) — 5.1M weekly downloads
- [csscolorparser](https://npm.io/package/csscolorparser.md) — 3.7M weekly downloads
- [expr-eval-fork](https://npm.io/package/expr-eval-fork.md) — 1.5M weekly downloads
- [@leeoniya/ufuzzy](https://npm.io/package/@leeoniya/ufuzzy.md) — 247.7K weekly downloads
- [xml-parser](https://npm.io/package/xml-parser.md) — 78.4K weekly downloads

## Recent versions

- 0.1.7 (latest) — 2015-02-13

## README

# biojs-io-gff

[![Build Status](https://secure.travis-ci.org/greenify/biojs-io-gff.png?branch=master)](http://travis-ci.org/greenify/biojs-io-gff)
[![NPM version](https://badge-me.herokuapp.com/api/npm/biojs-io-gff.png)](http://badges.enytc.com/for/npm/biojs-io-gff) 

> A GFF (general feature format) parser

[Official Spec](https://www.sanger.ac.uk/resources/software/gff/spec.html)

```
<seqname> <source> <feature> <start> <end> <score> <strand> <frame> [attributes] [comments]
```

Short [description about the formats](https://github.com/greenify/biojs-vis-msa/wiki/Annotation-Features).

## Supported formats

* [GFF 3](http://www.sequenceontology.org/gff3.shtml)
* [Jalview feature format](http://www.jalview.org/help/html/features/featuresFormat.html)

## Getting Started
Install the module with: `npm install biojs-io-gff`

```javascript
var gff = require('biojs-io-gff');
```

## Documentation

#### .parse(file)

**Parameter**: `GFF file`
**Type**: `String`
**Example**: `SEQ1  EMBL  atg  103  105  .  +  0`

The 'parse' method converts a GFF into its JSON representation.

How to use this method

```javascript
gff.parse('SEQ1  EMBL  atg  103  105  .  +  0');
```

__Result__

```
{ "features":
	[{ seqname: 'SEQ1',
    	source: 'EMBL',
    	feature: 'atg',
    	start: 103,
    	end: 105,
    	strand: '+',
    	frame: 0,
    	attributes: {} } ],
  "config": {
	type: "gff3"
  }
}
```

#### .parseSeqs(file)

**Parameter**: `GFF file`
**Type**: `String`
**Example**: `SEQ1  EMBL  atg  103  105  .  +  0`

Returns a dictionary of all sequences. Each sequences is an array of its features.

```javascript
gff.parseSeqs('SEQ1  EMBL  atg  103  105  .  +  0');
```

__Result__

```
{ "seqs":
  { "SEQ1": 
		[ { seqname: 'SEQ1',
		    source: 'EMBL',
		    feature: 'atg',
		    start: 103,
	    	end: 105,
	    	strand: '+',
	    	frame: 0,
	    	attributes: {} } ]
  },
  "config": {
	type: "gff3"
  }
}
```

#### .exportLines(lines)

Return the textual GFF representation for the given lines

#### .exportSeqs(seqs)

Return the textual GFF representation for the given seqs

#### .parseLine(line)

**Parameter**: `GFF line`
**Type**: `String`
**Example**: `SEQ1  EMBL  atg  103  105  .  +  0`

The 'parseLine' method converts a GFF line into its JSON representation.


```javascript
gff.parseLine('SEQ1  EMBL  atg  103  105  .  +  0');
```

## Gotchas

* undefined properties (dots) are removed (checking for undefined is native)

## Contributing

Please submit all issues and pull requests to the [greenify/biojs-io-gff](http://github.com/greenify/biojs-io-gff) repository!

## Support
If you have any problem or suggestion please open an issue [here](https://github.com/greenify/biojs-io-gff/issues).

## License 


This software is licensed under the Apache 2 license, quoted below.

Copyright (c) 2014, greenify

Licensed under the Apache License, Version 2.0 (the "License"); you may not
use this file except in compliance with the License. You may obtain a copy of
the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
License for the specific language governing permissions and limitations under
the License.

---
_Source: https://npm.io/package/gff · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._