Skip to main content

venvgit2

Github Actions status badge CircleCI status badge

pygit2 is awesome. pygit2 is hard to install.

Installing this package will try to install matched versions of libgit2 and pygit2 to your activated virtualenv.

Requirements

  • cmake

  • python-dev

Installation

$ virtualenv venv
$ . venv/bin/activate
(venv)$ pip install venvgit2

You can put it in a requirements.txt or whatever, as long as you’re in a virtualenv you’re set with pip or easy_install.

Usage

(venv)$ python
>>> import pygit2

Woo hoo if no errors are raised, it is likely that you are set to go!

venvgit2 doesn’t give you anything except a convenient install of matched versions of libgit2 and pygit2. Each project has its own excellent” documentation:

Development

  1. Clone this repository

$ git clone git@github.com:uniphil/venvgit2.git
  1. Grab the submodules

$ git submodule update --init

after the first time, to update submodules it’s just

$ git submodule update

What’s going on

Without venvgit2, you might do this:

$ git clone git@github.com:libgit2/libgit2.git
$ git clone git@github.com:libgit2/pygit2.git
$ virtualenv venv
$ . venv/bin/activate
(venv)$ cd libgit2
(venv)$ git checkout v0.20.0
(venv)$ mkdir build && cd build
(venv)$ cmake .. -DCMAKE_INSTALL_PREFIX=$VIRTUAL_ENV
(venv)$ cmake --build . --target install
(venv)$ cd ../../pygit2
(venv)$ git checkout v0.20.2
(venv)$ export LIBGIT2=$VIRTUAL_ENV
(venv)$ export LDFLAGS="-Wl,-rpath='$LIBGIT2/lib',--enable-new-dtags"
(venv)$ python setup.py build
(venv)$ python setup.py install

That should set you up with pygit2 ready to roll in your virtual environment. This command should not fail:

(venv)$ python
>> import pygit2
>>

It was a big headache for me to get pygit2 built and linked correctly, out of a virtualenv. Also, having to clone full git repos and everything is a pain.

venvgit2 ships with all the sources for a matched pair of libgit2 and pygit2 baked in, so you only have to download what you need, and installation is automated in the setup.py script. Piece of cake.

Versions

Releases of venvgit2 are matched pairs of pygit2, and libgit2. We increment the patch number (major.minor.patch) each time we release a new pair (ie., when either venvgit2 or pygit2 update) or when changes are made to venvgit2 itself. pygit2 has more details for choosing compatible releases, but with venvgit2, pip install... should just work.

License

venvgit2 is provided to the Public Domain. It really doesn’t do much anyway.

The libraries used by venvgit2 have licenses you should be aware of. They are linked here for quick reference:

Metadata

Release files for venvgit2 1.5.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for venvgit2 1.5.0
File Size Uploaded Provenance
venvgit2-1.5.0.tar.gz 1.7 MB Without provenance Details

Release files / venvgit2-1.5.0.tar.gz

Download URL venvgit2-1.5.0.tar.gz
Size 1.7 MB
Tags Source
SHA-256 checksum
How to use checksums
7d3ef0fcc2470a70f20c3a435f2f5f42f1dc173b25d00675b84494cdfaf121d4
BLAKE2b-256 checksum
How to use checksums
2c34f6f9e0826261be0b65605342cd902890b28b711e4c897cc7453a9fccd54c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.4.1 importlib_metadata/3.10.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.59.0 CPython/3.9.2

Security for venvgit2 1.5.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.5.0 This release

1 release file No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page