From 92103eda377f612caf854b754f1d5e1757ce5259 Mon Sep 17 00:00:00 2001 From: "Michael R. Crusoe" Date: Thu, 11 Jun 2015 15:07:09 -0700 Subject: [PATCH] v0.9 release notes --- doc/dev/release-checklist.rst | 6 +-- doc/release-notes/RELEASE-0.9.md | 41 ++++++++++++++++++ doc/release-notes/RELEASE-0.9.rst | 72 +++++++++++++++++++++++++++++++ 3 files changed, 116 insertions(+), 3 deletions(-) create mode 100644 doc/release-notes/RELEASE-0.9.md create mode 100644 doc/release-notes/RELEASE-0.9.rst diff --git a/doc/dev/release-checklist.rst b/doc/dev/release-checklist.rst index 2c86fb5..4ea4317 100644 --- a/doc/dev/release-checklist.rst +++ b/doc/dev/release-checklist.rst @@ -75,15 +75,15 @@ Getting Started make install nosetests screed --attr '!known_failing' make test - python -c 'import screed; print screed.__version__' # double-check - version number + python -c 'import screed; print screed.__version__' # double-check version number # Test via pip cd ../../testenv2 source bin/activate pip install nose - pip install -e git+https://github.com/dib-lab/screed.git@v${new_version}-${rc}#egg=screed + pip install -e \ + git+https://github.com/dib-lab/screed.git@v${new_version}-${rc}#egg=screed cd src/screed make dist make install diff --git a/doc/release-notes/RELEASE-0.9.md b/doc/release-notes/RELEASE-0.9.md new file mode 100644 index 0000000..ffac7e6 --- /dev/null +++ b/doc/release-notes/RELEASE-0.9.md @@ -0,0 +1,41 @@ + +# Release v0.9 + +We are pleased to announce the release of Screed v0.9. Screed is a database +engine capable of storing and retrieving short-read sequence data and is +designed to be fast and adaptable to different sequence file formats. + +This version of Screed features Python 3 syntax with compatibility with Python 2. Additional changes have broken backwards compatibility in several small ways in preparation for our 1.0 release and adoption of strict semantic versioning from there on out. + +It is also the first release since our move to the University of Davis, California and also under our new name, the Lab for Data Intensive Biology. + +Documentation is available at http://screed.readthedocs.org/en/v0.9/ + +## New items of note: + +- Now a primarily Python 3 codebase with Python 2 compatibility. https://github.com/dib-lab/screed/pull/41 @luizirber & @mr-c + +- Tests now correctly run using temporary directories and the test data is now shipped allowing the tests to be run after installation. https://github.com/dib-lab/screed/pull/30 @bocajnotnef https://github.com/dib-lab/screed/pull/40 @mr-c +- The private method `screed/screedRecord._screed_record_dict()` has been renamed to `screed.screedRecord.Record()`. This is **not** a backwards compatible change. https://github.com/dib-lab/screed/pull/35 @sguermond +- `screed.open()` now accepts `-` as a synonym for STDIN and is now an (optional) context manager. It no longer defaults to parsing out a separate description from the name. The description field will br removed altogether from the next release. This is **not** a backwards compatible change. https://github.com/dib-lab/screed/pull/36 @anotherthomas https://github.com/dib-lab/screed/pull/39 https://github.com/dib-lab/screed/pull/41 @luizirber https://github.com/dib-lab/screed/pull/43 @ctb +- The FASTQ parser was improved and it no longer hangs in the presence of empty lines. https://github.com/dib-lab/screed/pull/38 @proteasome +- Screed records now slice correctly https://github.com/dib-lab/screed/pull/41 @wrightmhw @luizirber + + +## Other bugs fixed/issues closed: + +- Release notes are now a part of the documentation. https://github.com/dib-lab/screed/pull/33 @bocajnotnef +- A test was made more robust to prevent hangs. https://github.com/dib-lab/screed/pull/37 @anotherthomas + +## Known Issues + +These are all pre-existing + + - Screed does not support gzip file streaming. This is an issue with Python 2.x and will likely *not* be fixed in future releases. This is being tracked in ged-lab/khmer#700 + - Screed is overly tolerant of spaces in fast{a,q} which is against spec. This is being tracked in ged-lab/khmer#108 + +## Contributors + +@luizirber @mr-c @bocajnotnef @ctb \*@proteasome \*@anotherthomas \*@sguermond + +\* Indicates new contributors diff --git a/doc/release-notes/RELEASE-0.9.rst b/doc/release-notes/RELEASE-0.9.rst new file mode 100644 index 0000000..61ed94b --- /dev/null +++ b/doc/release-notes/RELEASE-0.9.rst @@ -0,0 +1,72 @@ +Release v0.9 +============ + +We are pleased to announce the release of Screed v0.9. Screed is a +database engine capable of storing and retrieving short-read sequence +data and is designed to be fast and adaptable to different sequence file +formats. + +This version of Screed features Python 3 syntax with compatibility with +Python 2. Additional changes have broken backwards compatibility in +several small ways in preparation for our 1.0 release and adoption of +strict semantic versioning from there on out. + +It is also the first release since our move to the University of Davis, +California and also under our new name, the Lab for Data Intensive +Biology. + +Documentation is available at http://screed.readthedocs.org/en/v0.9/ + +New items of note: +------------------ + +- Now a primarily Python 3 codebase with Python 2 compatibility. + https://github.com/dib-lab/screed/pull/41 @luizirber & @mr-c + +- Tests now correctly run using temporary directories and the test data + is now shipped allowing the tests to be run after installation. + https://github.com/dib-lab/screed/pull/30 @bocajnotnef + https://github.com/dib-lab/screed/pull/40 @mr-c +- The private method ``screed/screedRecord._screed_record_dict()`` has + been renamed to ``screed.screedRecord.Record()``. This is **not** a + backwards compatible change. + https://github.com/dib-lab/screed/pull/35 @sguermond +- ``screed.open()`` now accepts ``-`` as a synonym for STDIN and is now + an (optional) context manager. It no longer defaults to parsing out a + separate description from the name. The description field will br + removed altogether from the next release. This is **not** a backwards + compatible change. https://github.com/dib-lab/screed/pull/36 + @anotherthomas https://github.com/dib-lab/screed/pull/39 + https://github.com/dib-lab/screed/pull/41 @luizirber + https://github.com/dib-lab/screed/pull/43 @ctb +- The FASTQ parser was improved and it no longer hangs in the presence + of empty lines. https://github.com/dib-lab/screed/pull/38 @proteasome +- Screed records now slice correctly + https://github.com/dib-lab/screed/pull/41 @wrightmhw @luizirber + +Other bugs fixed/issues closed: +------------------------------- + +- Release notes are now a part of the documentation. + https://github.com/dib-lab/screed/pull/33 @bocajnotnef +- A test was made more robust to prevent hangs. + https://github.com/dib-lab/screed/pull/37 @anotherthomas + +Known Issues +------------ + +These are all pre-existing + +- Screed does not support gzip file streaming. This is an issue with + Python 2.x and will likely *not* be fixed in future releases. This is + being tracked in ged-lab/khmer#700 +- Screed is overly tolerant of spaces in fast{a,q} which is against + spec. This is being tracked in ged-lab/khmer#108 + +Contributors +------------ + +@luizirber @mr-c @bocajnotnef @ctb \*@proteasome \*@anotherthomas +\*@sguermond + +\* Indicates new contributors