Skip to content

Commit 3052c56

Browse files
committed
updates to documentation, dependencies, removed Travis config
1 parent 31e1647 commit 3052c56

File tree

8 files changed

+40
-154
lines changed

8 files changed

+40
-154
lines changed

.travis.yml

Lines changed: 0 additions & 118 deletions
This file was deleted.

CONTRIBUTING.md

Lines changed: 17 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,29 +1,28 @@
1-
Contributing to PyEnsembl
2-
==========================
1+
# Contributing to PyEnsembl
32

43
[PyEnsembl](http://www.github.com/hammerlab/pyensembl) is open source software and
54
we welcome your contributions. This document should help you get started
65
contributing to PyEnsembl.
76

8-
Filing Issues
9-
-------------
7+
## Filing Issues
8+
109
If you find any bugs or problems while using PyEnsembl or have any feature requests, please feel free to file an issue against the project. When doing so, please follow the guidelines below:
1110

1211
To report any bugs, issues, or feature requests, please [open an issue](https://github.com/hammerlab/pyensembl/issues)
1312
Please check the [current open issues](https://github.com/hammerlab/pyensembl/issues) to see if the request already exists
1413
If you are filing a bug report, please describe the version of PyEnsembl and Python you are using. If your problem involves a particular gene, transcript, or genomic locus, please include that information (e.g. "Missing transcript sequence for BRCA1-002 for Ensembl release 74").
1514

16-
Coding Guidelines
17-
-----------------
18-
* PyEnsembl is written in Python and adheres to the [PEP8](https://www.python.org/dev/peps/pep-0008/)
19-
style guidelines.
20-
* Contributions should come in the form of GitHub pull requests.
21-
* New features should start with a GitHub issue explaining their scope and rationale.
22-
* If the work is based on an existing issue, please reference the issue in the PR.
23-
* All new code should be accompanied by comprehensive unit tests.
24-
* If the PR fixes or implements an issue, please state "Closes #XYZ" or "Fixes #XYZ", where XYZ is the issue number.
25-
* Please ensure that your code works under both Python 2.7.x and Python >= 3.5.
26-
27-
Licensing
28-
---------
29-
PyEnsembl is licensed under the Apache 2.0 license. Your code is assumed to be as well.
15+
## Coding Guidelines
16+
17+
- PyEnsembl is written in Python and adheres to the [PEP8](https://www.python.org/dev/peps/pep-0008/)
18+
style guidelines.
19+
- Contributions should come in the form of GitHub pull requests.
20+
- New features should start with a GitHub issue explaining their scope and rationale.
21+
- If the work is based on an existing issue, please reference the issue in the PR.
22+
- All new code should be accompanied by comprehensive unit tests.
23+
- If the PR fixes or implements an issue, please state "Closes #XYZ" or "Fixes #XYZ", where XYZ is the issue number.
24+
- Please ensure that your code works under Python >= 3.7.
25+
26+
## Licensing
27+
28+
PyEnsembl is licensed under the Apache 2.0 license. Your code is assumed to be as well.

README.md

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,20 @@
1+
<!--
12
<a href="https://app.travis-ci.com/github/openvax/pyensembl">
23
<img src="https://app.travis-ci.com/openvax/pyensembl.svg?branch=master" alt="Build Status" />
34
</a>
5+
-->
6+
<!--
47
<a href="https://coveralls.io/github/openvax/pyensembl?branch=master">
58
<img src="https://coveralls.io/repos/openvax/pyensembl/badge.svg?branch=master&service=github" alt="Coverage Status" />
69
</a>
10+
-->
711
<a href="https://pypi.python.org/pypi/pyensembl/">
812
<img src="https://img.shields.io/pypi/v/pyensembl.svg?maxAge=1000" alt="PyPI" />
913
</a>
1014

15+
# PyEnsembl
1116

12-
PyEnsembl
13-
=======
14-
PyEnsembl is a Python interface to [Ensembl](http://www.ensembl.org) reference genome metadata such as exons and transcripts. PyEnsembl downloads [GTF](https://en.wikipedia.org/wiki/Gene_transfer_format) and [FASTA](https://en.wikipedia.org/wiki/FASTA_format) files from the [Ensembl FTP server](ftp://ftp.ensembl.org) and loads them into a local database. PyEnsembl can also work with custom reference data specified using user-supplied GTF and FASTA files.
17+
PyEnsembl is a Python interface to [Ensembl](http://www.ensembl.org) reference genome metadata such as exons and transcripts. PyEnsembl downloads [GTF](https://en.wikipedia.org/wiki/Gene_transfer_format) and [FASTA](https://en.wikipedia.org/wiki/FASTA_format) files from the [Ensembl FTP server](ftp://ftp.ensembl.org) and loads them into a local database. PyEnsembl can also work with custom reference data specified using user-supplied GTF and FASTA files.
1518

1619
# Example Usage
1720

@@ -52,6 +55,7 @@ Alternatively, you can create the `EnsemblRelease` object from inside a Python
5255
process and call `ensembl_object.download()` followed by `ensembl_object.index()`.
5356

5457
## Cache Location
58+
5559
By default, PyEnsembl uses the platform-specific `Cache` folder
5660
and caches the files into the `pyensembl` sub-directory.
5761
You can override this default by setting the environment key `PYENSEMBL_CACHE_DIR`
@@ -70,7 +74,7 @@ os.environ['PYENSEMBL_CACHE_DIR'] = '/custom/cache/dir'
7074
# ... PyEnsembl API usage
7175
```
7276

73-
# Usage tips
77+
# Usage tips
7478

7579
## List installed genomes
7680

@@ -142,8 +146,8 @@ gene_names = data.gene_names_at_locus(contig=6, position=29945884)
142146
# API
143147

144148
The `EnsemblRelease` object has methods to let you access all possible
145-
combinations of the annotation features *gene\_name*, *gene\_id*,
146-
*transcript\_name*, *transcript\_id*, *exon\_id* as well as the location of
149+
combinations of the annotation features _gene_name_, _gene_id_,
150+
_transcript_name_, _transcript_id_, _exon_id_ as well as the location of
147151
these genomic elements (contig, start position, end position, strand).
148152

149153
## Genes

RELEASING.md

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,6 @@
22

33
This document explains what do once your [Pull Request](https://www.atlassian.com/git/tutorials/making-a-pull-request/) has been reviewed and all final changes applied. Now you're ready merge your branch into master and release it to the world:
44

5-
0. Make sure that you have `pandoc` and `pypandoc` installed: this is needed for readme markdown on PyPI. (See [here](http://pandoc.org/installing.html) and [here](https://pypi.python.org/pypi/pypandoc), respectively, for instructions.)
6-
1. Bump the [version](http://semver.org/) in `__init__.py`, as part of the PR you want to release.
5+
1. Bump the [version](http://semver.org/) in `version.py`, as part of the PR you want to release.
76
2. Merge your branch into master.
8-
3. Travis has been configured to auto-deploy to PyPI, as long as the tests succeed and the library version is newer than any released.
7+
3. Run `deploy.sh`

pyensembl/database.py

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -206,6 +206,8 @@ def create(self, overwrite=False):
206206
df = self._load_gtf_as_dataframe(
207207
usecols=self.restrict_gtf_columns, features=self.restrict_gtf_features
208208
)
209+
if hasattr(df, "to_pandas"):
210+
df = df.to_pandas()
209211
all_index_groups = self._all_possible_indices(df.columns)
210212

211213
if self.restrict_gtf_features:
@@ -221,7 +223,7 @@ def create(self, overwrite=False):
221223
primary_keys = {}
222224

223225
for feature in feature_names:
224-
df_subset = df[df.feature == feature]
226+
df_subset = df[df["feature"] == feature]
225227
if len(df_subset) == 0:
226228
continue
227229
dataframes[feature] = df_subset

pyensembl/version.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
__version__ = "2.3.4"
1+
__version__ = "2.3.5"

requirements.txt

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
typechecks>=0.0.2,<1.0.0
2-
datacache>=1.1.4,<2.0.0
2+
datacache>=1.4.0,<2.0.0
33
memoized-property>=1.0.2
4-
tinytimer
5-
gtfparse>=2.2.1,<3.0.0
6-
serializable
7-
pylint>=1.4.4
4+
tinytimer>=0.0.0,<1.0.0
5+
gtfparse>=2.4.0,<3.0.0
6+
serializable>=0.2.1,<1.0.0
7+
pylint>=1.4.4,<2.0.0

setup.py

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -47,7 +47,7 @@
4747
setup(
4848
name=package_name,
4949
version=version,
50-
description="Python interface to ensembl reference genome metadata",
50+
description="Python interface to Ensembl reference genome metadata",
5151
author="Alex Rubinsteyn",
5252
author_email="[email protected]",
5353
url=github_url,
@@ -56,7 +56,7 @@
5656
"console_scripts": ["pyensembl = %s.shell:run" % package_name],
5757
},
5858
classifiers=[
59-
"Development Status :: 3 - Alpha",
59+
"Development Status :: 4 - Beta",
6060
"Environment :: Console",
6161
"Operating System :: OS Independent",
6262
"Intended Audience :: Science/Research",

0 commit comments

Comments
 (0)