Matthew Wang 4f3690eef8 Clean up test targets преди 11 години
img document update; images преди 11 години
tests Script and make targets for profiling преди 11 години
.gitignore Script and make targets for profiling преди 11 години
.travis.yml clean up for travis CI преди 11 години
CHANGES - Fixed incorrect yield on diff missing eof - Fixed a bug in diff format probe - Handle keyboard interrupt and large diffs in non-color mode - Code clean up преди 11 години
LICENSE Read version from source code; add --version; try protect my email from spambot преди 11 години
MANIFEST.in Use wrapper `cdiff` instead of symlink for future unit test; doc update преди 11 години
Makefile Clean up test targets преди 11 години
README.rst - Fixed incorrect yield on diff missing eof - Fixed a bug in diff format probe - Handle keyboard interrupt and large diffs in non-color mode - Code clean up преди 11 години
cdiff Better patch parser; support svn log --diff преди 11 години
cdiff.py More clear logic with _fit_with_marker_mix() преди 11 години
setup.py Remove unused imports преди 11 години

README.rst

Cdiff
=====

.. image:: https://travis-ci.org/ymattw/cdiff.png?branch=master
:target: https://travis-ci.org/ymattw/cdiff
:alt: Build status

Term based tool to view **colored**, **incremental** diff in *Git/Mercurial/Svn*
workspace, given patch or two files, or from stdin, with **side by side** and
**auto pager** support. Requires python (>= 2.5.0) and ``less``.

.. image:: http://ymattw.github.com/cdiff/img/default.png
:alt: default
:align: center

.. image:: http://ymattw.github.com/cdiff/img/side-by-side.png
:alt: side by side
:align: center
:width: 900 px

Installation
------------

Install with pip
~~~~~~~~~~~~~~~~

Cdiff is already listed on `PyPI `_, you can
install with ``pip`` if you have the tool.

.. code:: sh

pip install --upgrade cdiff

Install with setup.py
~~~~~~~~~~~~~~~~~~~~~

You can also run the setup.py from the source if you don't have ``pip``.

.. code:: sh

git clone https://github.com/ymattw/cdiff.git
cd cdiff
./setup.py install

Download directly
~~~~~~~~~~~~~~~~~

Just save `cdiff.py `_ to
whatever directory which is in your ``$PATH``, for example, ``$HOME/bin`` is in
my ``$PATH``, so I save the script there and name as ``cdiff``.

.. code:: sh

curl -ksS https://raw.github.com/ymattw/cdiff/master/cdiff.py > ~/bin/cdiff
chmod +x ~/bin/cdiff

Usage
-----

Show usage:

.. code:: sh

cdiff -h

Read diff from local modification in a *Git/Mercurial/Svn* workspace:

.. code:: sh

cd proj-workspace
cdiff # view colored incremental udiff
cdiff -s # view side by side
cdiff -s -w 90 # use text width 90 other than default 80

Read the log (e.g. ``git log -p``) in a *Git/Mercurial/Svn* workspace:

.. code:: sh

cd proj-workspace
cdiff -l
cdiff -ls # equivalent to ``cdiff -l -s``
cdiff -ls -w90

Pipe in a diff:

.. code:: sh

git log -p -2 | cdiff -s
git show 15bfa5 | cdiff -s
svn diff -r PREV | cdiff -s

View a diff (patch) file:

.. code:: sh

cdiff foo.patch
cdiff foo.patch -s
cdiff foo.patch -s -w 90

View diff between two files (wrapper of ``diff``):

.. code:: sh

cdiff foo foo.new # equivalent to diff -u foo foo.new | cdiff
cdiff foo foo.new -s

Redirect output to another patch file is safe:

.. code:: sh

svn diff -r PREV | cdiff -s > my.patch

Notes
-----

- Works with python >= 2.5.0 (subprocess.Popen seems not working with PIPE in
2.4.3, maybe you can fix it)
- Only takes unified diff for input
- Side by side mode has alignment problem for wide chars
- Pull requests are very welcome (please run ``make test test3`` to verify)

See also
--------

I have another tool `coderev `_ which
generates side-by-side diff pages for code review from two given files or
directories, I found it's not easy to extend to support git so invented
`cdiff`. Idea of ansi color markup is also from project `colordiff
`_.