Skip to main content

Browse the archive

Staging
v0.5.0
https://foss.heptapod.net/mercurial/hgview
21 February 2024, 22:58:43 UTC
Revision a13d9dfe73477485569262ebce6f8e1dd618fa73 authored by Mads Kiilerich on 04 April 2020, 02:09:16 UTC, committed by Mads Kiilerich on 04 April 2020, 02:09:16 UTC 
qt5: simplify Viewer class hierarchy to work better with multiple inheritance of Qt classes
 
Clarify the role of the Viewer stubs in hgviewlib/application.py . It is a mess
to use multiple inheritance and super() and different parameter profiles in
diferent parent/sibling classes. The empty Viewer stubs should thus not be used
as interfaces / purely virtual base classes; they are just an example and
documentation.
1 parent 4b52201
Raw File
Tip revision: a13d9dfe73477485569262ebce6f8e1dd618fa73 authored by Mads Kiilerich on 04 April 2020, 02:09:16 UTC
qt5: simplify Viewer class hierarchy to work better with multiple inheritance of Qt classes
Tip revision: a13d9df
README.rst 
Description
===========

Its purpose is to easily navigate in a Mercurial repository
history. It has been written with efficiency in mind, both in terms
of computational efficiency and user experience efficiency.

It is written in Python.

There are two user interfaces:
    * a graphical interface using PyQt4 and QScintilla, the
    * a text interface: using urwid, pygments and pyinotify

Note that the Qt4 interface is much more complete than the text interface.
The Qt4 interface provides more views on the repository.

hgview intallation notes
========================

hgview can be used either as a hg extension, or as a standalone
application.

The Common library depends on: mercurial (1.0 minimum)
The Qt4 interface depends on PyQt4, QScintilla and PyQScintilla, DocUtils
The Text interfaces depend on urwid (>=0.9.1 for "raw", >=1.0.0 for "curses"),
pygments and pyinotify


Run from the hg repository
--------------------------

You can run ``hgview`` without installing it.

::

  hg clone https://foss.heptapod.net/mercurial/hgview

You may want to add the following to your main .hgrc file::

  [extensions]
  hgext.hgview=path/to/hqgv/hgext/hgview.py

  [hgview]
  # your hgview configs statements like:
  dotradius=6
  interface=qt # or curses or raw
  # type hg qv-config to list available options

Then from any Mercurial repository::

  cd <ANY_HG_REPO>
  hg qv

or::

  export PYTHONPATH=PATH_TO_HGVIEW_DIR:$PYTHONPATH
  PATH_TO_HGVIEW_DIR/bin/hgview

Installing ``hgview``
---------------------

Installing ``hgview`` is simply done using usual ``distutils`` script::

  cd $PATH_TO_HGVIEW_DIR
  python setup.py install --help # for available options
  python setup.py install


More informations
=================

See `hg help hgview` for more informations on available configuration
options.

Acknowledgements
----------------

Hgview is a free software project hosted at https://foss.heptapod.net thanks
to the support of `Clever Cloud <https://clever-cloud.com>`_,
`Octobus <https://octobus.net>`_ and the sponsors of the heptapod project.
back to top