# setuptools_hg

Bitbucket is a code hosting site with unlimited public and private repositories. We're also free for small teams!

Close

# setuptools_hg

setuptools_hg is a plugin for setuptools/distribute to enable it to find files under the Mercurial version control system.

It uses the Mercurial Python library by default and falls back to use the command line programm hg(1). That's especially useful inside virtualenvs that don't have access to the system wide installed Mercurial lib (e.g. when created with --no-site-packages).

Note

The setuptools feature

You can read about the hooks used by setuptool_hg in the setuptools or distribute documentation. It basically returns a list of files that are under Mercurial version control when running the setup function, e.g. if you create a source and binary distribution. It's a simple yet effective way of not having to define package data (non-Python files) manually in MANIFEST templates (MANIFEST.in).

## Usage

Here's an example of a setup.py that uses setuptools_hg:

from setuptools import setup, find_packages

setup(
name="HelloWorld",
version="0.1",
packages=find_packages(),
setup_requires=["setuptools_hg"],
)


If you run this setup.py setuptools will automatically download setuptools_hg to the directory where the setup.py is located at (and won't install it anywhere else) to get all package data files from the Mercurial repository.

## Options

Set the HG_SETUPTOOLS_FORCE_CMD environment variable before running setup.py if you want to enforce the use of the hg command. """

# Recent activity

better look for readme, and separated changelog file

better look for readme, and separated changelog file

better look for readme, and separated changelog file

Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.