---
title: "wsdiff"
external_links:
    - name: Sources
      url: "https://git.jaseg.de/wsdiff.git"
    - name: Issues
      url: "https://github.com/jaseg/wsdiff/issues"
    - name: PyPI
      url: "https://pypi.org/project/wsdiff"
summary: >
    wsdiff is a command-line utility that produces self-contained, syntax-highlighted, HTML-formatted diffs that support
    both unified and side-by-side diffs from a single source file using nothing but CSS magic.
---

wsdiff is a python script that produces a diff of two files or directories as a single, self-contained HTML file. The
resulting diff works without Javascript and will automatically switch between inline and side-by-side formats depending
on available screen space.

Installation
============

.. code:: sh

    $ pip install wsdiff

Usage
=====

::

    usage: wsdiff [-h] [-b] [-s SYNTAX_CSS] [-l LEXER] [-L] [-t PAGETITLE]
                        [-o OUTPUT] [--header] [--content]
                        [old] [new]

    Given two source files or directories this application creates an html page
    that highlights the differences between the two.

    positional arguments:
      old                   source file or directory to compare ("before" file)
      new                   source file or directory to compare ("after" file)

    options:
      -h, --help            show this help message and exit
      -b, --open            Open output file in a browser
      -s SYNTAX_CSS, --syntax-css SYNTAX_CSS
                            Path to custom Pygments CSS file for code syntax
                            highlighting
      -l LEXER, --lexer LEXER
                            Manually select pygments lexer (default: guess from
                            filename, use -L to list available lexers.)
      -L, --list-lexers     List available lexers for -l/--lexer
      -t PAGETITLE, --pagetitle PAGETITLE
                            Override page title of output HTML file
      -o OUTPUT, --output OUTPUT
                            Name of output file (default: stdout)
      --header              Only output HTML header with stylesheets and stuff,
                            and no diff
      --content             Only output HTML content, without header

Example Output
==============

.. image:: latest.png