Metadata-Version: 2.4 Name: vcfpy Version: 0.13.8 Summary: Python 3 VCF library with good support for both reading and writing Home-page: https://github.com/bihealth/vcfpy Author: Manuel Holtgrewe Author-email: manuel.holtgrewe@bih-charite.de License: MIT license Keywords: vcfpy Classifier: Development Status :: 2 - Pre-Alpha Classifier: Intended Audience :: Developers Classifier: License :: OSI Approved :: MIT License Classifier: Natural Language :: English Classifier: Programming Language :: Python :: 3 Classifier: Programming Language :: Python :: 3.8 Classifier: Programming Language :: Python :: 3.9 Classifier: Programming Language :: Python :: 3.10 Classifier: Programming Language :: Python :: 3.11 Classifier: Programming Language :: Python :: 3.12 Description-Content-Type: text/markdown License-File: LICENSE License-File: AUTHORS.rst Requires-Dist: pysam>=0.10.0 Dynamic: author Dynamic: author-email Dynamic: classifier Dynamic: description Dynamic: description-content-type Dynamic: home-page Dynamic: keywords Dynamic: license Dynamic: license-file Dynamic: requires-dist Dynamic: summary [![pypi](https://img.shields.io/pypi/v/vcfpy.svg)](https://pypi.python.org/pypi/vcfpy) [![bioconda](https://img.shields.io/conda/dn/bioconda/vcfpy.svg?label=Bioconda)](https://bioconda.github.io/recipes/vcfpy/README.html) [![CI](https://github.com/bihealth/vcfpy/actions/workflows/main.yml/badge.svg)](https://github.com/bihealth/vcfpy/actions/workflows/main.yml) [![Documentation Status](https://readthedocs.org/projects/vcfpy/badge/?version=latest)](https://vcfpy.readthedocs.io/en/latest/?badge=latest) [![Publication in The Journal of Open Source Software](http://joss.theoj.org/papers/edae85d90ea8a49843dbaaa109e47cba/status.svg)](http://joss.theoj.org/papers/10.21105/joss.00085) # VCFPy Python 3 VCF library with good support for both reading and writing - Free software: MIT license - Documentation: . ## Features - Support for reading and writing VCF v4.3 - Interface to `INFO` and `FORMAT` fields is based on `OrderedDict` allows for easier modification than PyVCF (also I find this more pythonic) - Read (and jump in) and write BGZF files just using `vcfpy` ## Why another VCF parser for Python! I've been using PyVCF with quite some success in the past. However, the main bottleneck of PyVCF is when you want to modify the per-sample genotype information. There are some issues in the tracker of PyVCF but none of them can really be considered solved. I tried several hours to solve these problems within PyVCF but this never got far or towards a complete rewrite... For this reason, VCFPy was born and here it is! ## What's the State? VCFPy is the result of two full days of development plus some maintenance work later now (right now). I'm using it in several projects but it is not as battle-tested as PyVCF. ## Why Python 3 Only? As I'm only using Python 3 code, I see no advantage in carrying around support for legacy Python 2 and maintaining it. At a later point when VCFPy is known to be stable, Python 2 support might be added if someone contributes a pull request. # Changelog ## [0.13.8](https://github.com/bihealth/vcfpy/compare/v0.13.7...v0.13.8) (2024-01-10) ### Bug Fixes * fixing manifest for changelog ([#169](https://github.com/bihealth/vcfpy/issues/169)) ([83c5b8e](https://github.com/bihealth/vcfpy/commit/83c5b8e6cd1199245673cc0d8deb2d6f3646d183)) ## [0.13.7](https://github.com/bihealth/vcfpy/compare/v0.13.6...v0.13.7) (2024-01-10) ### Bug Fixes * remove versioneer Python 3.12 compatibility ([#160](https://github.com/bihealth/vcfpy/issues/160)) ([5e2860e](https://github.com/bihealth/vcfpy/commit/5e2860e22042aa794304c8805ca716a39c88f24e)) ## [0.13.6](https://github.com/bihealth/vcfpy/compare/v0.13.5...v0.13.6) (2022-11-28) - Fixing bug in `setup.py` that prevented `pysam` dependency to be loaded (#150). ## v0.13.5 (2022-11-13) - Treat `.bgz` files the same as `.gz` (#145, \#149) ## v0.13.4 (2022-04-13) - Switching to Github Actions for CI - Fix INFO flag raises TypeError (#146) ## v0.13.3 (2020-09-14) - Adding `Record.update_calls`. - Making `Record.{format,calls}` use list when empty ## v0.13.2 (2020-08-20) - Adding `Call.set_genotype()`. ## v0.13.1 (2020-08-20) - Fixed `Call.ploidy`. - Fixed `Call.is_variant`. ## v0.13.0 (2020-07-10) - Fixing bug in case `GT` describes only one allele. - Proper escaping of colon and semicolon (or the lack of escaping) in `INFO` and `FORMAT`. ## v0.12.2 (2020-04-29) - Fixing bug in case `GT` describes only one allele. ## v0.12.1 (2019-03-08) - Not warning on `PASS` filter if not defined in header. ## v0.12.0 (2019-01-29) - Fixing tests for Python \>=3.6 - Fixing CI, improving tox integration. - Applying `black` formatting. - Replacing Makefile with more minimal one. - Removing some linting errors from flake8. - Adding support for reading VCF without `FORMAT` or any sample column. - Adding support for writing headers and records without `FORMAT` and any sample columns. ## v0.11.2 (2018-04-16) - Removing `pip` module from `setup.py` which is not recommended anyway. ## v0.11.1 (2018-03-06) - Working around problem in HTSJDK output with incomplete `FORMAT` fields (#127). Writing out `.` instead of keeping trailing empty records empty. ## v0.11.0 (2017-11-22) - The field `FORMAT/FT` is now expected to be a semicolon-separated string. Internally, we will handle it as a list. - Switching from warning helper utility code to Python `warnings` module. - Return `str` in case of problems with parsing value. ## v0.10.0 (2017-02-27) - Extending API to allow for reading subsets of records. (Writing for sample subsets or reordered samples is possible through using the appropriate `names` list in the `SamplesInfos` for the `Writer`). - Deep-copying header lines and samples infos on `Writer` construction - Using `samples` attribute from `Header` in `Reader` and `Writer` instead of passing explicitely ## 0.9.0 (2017-02-26) - Restructuring of requirements.txt files - Fixing parsing of no-call `GT` fields ## 0.8.1 (2017-02-08) - PEP8 style adjustments - Using versioneer for versioning - Using `requirements*.txt` files now from setup.py - Fixing dependency on cyordereddict to be for Python \<3.6 instead of \<3.5 - Jumping by samtools coordinate string now also allowed ## 0.8.0 (2016-10-31) - Adding `Header.has_header_line` for querying existence of header line - `Header.add_*_line` return a `bool` no indicating any conflicts - Construction of Writer uses samples within header and no extra parameter (breaks API) ## 0.7.0 (2016-09-25) - Smaller improvements and fixes to documentation - Adding Codacy coverage and static code analysis results to README - Various smaller code cleanup triggered by Codacy results - Adding `__eq__`, `__neq__` and `__hash__` to data types (where applicable) ## 0.6.0 (2016-09-25 - Refining implementation for breakend and symbolic allele class - Removing `record.SV_CODES` - Refactoring parser module a bit to make the code cleaner - Fixing small typos and problems in documentation ## 0.5.0 (2016-09-24) - Deactivating warnings on record parsing by default because of performance - Adding validation for `INFO` and `FORMAT` fields on reading (#8) - Adding predefined `INFO` and `FORMAT` fields to `pyvcf.header` (#32) ## 0.4.1 (2016-09-22) - Initially enabling codeclimate ## 0.4.0 (2016-09-22) - Exporting constants for encoding variant types - Exporting genotype constants `HOM_REF`, `HOM_ALT`, `HET` - Implementing `Call.is_phased`, `Call.is_het`, `Call.is_variant`, `Call.is_phased`, `Call.is_hom_ref`, `Call.is_hom_alt` - Removing `Call.phased` (breaks API, next release is 0.4.0) - Adding tests, fixing bugs for methods of `Call` ## 0.3.1 (2016-09-21) - Work around `FORMAT/FT` being a string; this is done so in the Delly output ## 0.3.0 (2016-09-21) - `Reader` and `Writer` can now be used as context manager (with `with`) - Including license in documentation, including Biopython license - Adding support for writing bgzf files (taken from Biopython) - Adding support for parsing arrays in header lines - Removing `example-4.1-bnd.vcf` example file because v4.1 tumor derival lacks `ID` field - Adding `AltAlleleHeaderLine`, `MetaHeaderLine`, `PedigreeHeaderLine`, and `SampleHeaderLine` - Renaming `SimpleHeaderFile` to `SimpleHeaderLine` - Warn on missing `FILTER` entries on parsing - Reordered parameters in `from_stream` and `from_file` (#18) - Renamed `from_file` to `from_stream` (#18) - Renamed `Reader.jump_to` to `Reader.fetch` - Adding `header_without_lines` function - Generally extending API to make it esier to use - Upgrading dependencies, enabling pyup-bot - Greatly extending documentation ## 0.2.1 (2016-09-19) - First release on PyPI