Unified diff python parsing/metadata extraction library
Simple Python library to parse and interact with unified diff data.
.. image:: https://travis-ci.org/matiasb/python-unidiff.svg?branch=master :target: https://travis-ci.org/matiasb/python-unidiff
$ pip install unidiff
>>> import urllib.request >>> from unidiff import PatchSet >>> diff = urllib.request.urlopen('https://github.com/matiasb/python-unidiff/pull/3.diff') >>> encoding = diff.headers.get_charsets() >>> patch = PatchSet(diff, encoding=encoding) >>> patch , , ]> >>> patch >>> patch.is_added_file True >>> patch.added 6 >>> patch >>> patch.added, patch.removed (20, 11) >>> len(patch) 6 >>> patch >>> patch >>> print(patch) diff --git a/unidiff/utils.py b/unidiff/utils.py index eae63e6..29c896a 100644 --- a/unidiff/utils.py +++ b/unidiff/utils.py @@ -37,4 +37,3 @@ # - deleted line # \ No newline case (ignore) RE_HUNK_BODY_LINE = re.compile(r'^([- \+\\])') -
Load unified diff data by instantiating :code:
PatchSetwith a file-like object as argument, or using :code:
PatchSet.from_filenameclass method to read diff from file.
PatchSetis a list of files updated by the given patch. For each :code:
PatchedFileyou can get stats (if it is a new, removed or modified file; the source/target lines; etc), besides having access to each hunk (also like a list) and its respective info.
At any point you can get the string representation of the current object, and that will return the unified diff data of it.
As a quick example of what can be done, check bin/unidiff file.
Also, once installed, unidiff provides a command-line program that displays information from diff data (a file, or stdin). For example:
$ git diff | unidiff Summary ------- README.md: +6 additions, -0 deletions
1 modified file(s), 0 added file(s), 0 removed file(s) Total: 6 addition(s), 0 deletion(s)
To instantiate :code:
PatchSetfrom a local file, you can use:
>>> from unidiff import PatchSet >>> patch = PatchSet.from_filename('tests/samples/bzr.diff', encoding='utf-8') >>> patch , , ]>
Notice the (optional) :code:
encodingparameter. If not specified, unicode input will be expected. Or alternatively:
>>> import codecs >>> from unidiff import PatchSet >>> with codecs.open('tests/samples/bzr.diff', 'r', encoding='utf-8') as diff: ... patch = PatchSet(diff) ... >>> patch , , ]>
Finally, you can also instantiate :code:
PatchSetpassing any iterable (and encoding, if needed):
>>> from unidiff import PatchSet >>> with open('tests/samples/bzr.diff', 'r') as diff: ... data = diff.readlines() ... >>> patch = PatchSet(data) >>> patch , , ]>
If you don't need to be able to rebuild the original unified diff input, you can pass :code:
metadata_only=True(defaults to :code:
False), which should help making the parsing more efficient:
>>> from unidiff import PatchSet >>> patch = PatchSet.from_filename('tests/samples/bzr.diff', encoding='utf-8', metadata_only=True)