Lite, typed, python utilities for Git, SVN, Mercurial, etc.
Project description
libvcs · 
libvcs is a lite, typed, pythonic tool box for
detection and parsing of URLs, commanding, and syncing with git, hg, and svn. Powers
vcspull.
Overview
Key Features
- URL Detection and Parsing: Validate and parse Git, Mercurial, and Subversion URLs.
- Command Abstraction: Interact with VCS systems through a Python API.
- Repository Synchronization: Clone and update repositories locally via Python API.
- py.test fixtures: Create temporary local repositories and working copies for testing for unit tests.
Supports Python 3.9 and above, Git (including AWS CodeCommit), Subversion, and Mercurial.
To get started, see the quickstart guide for more information.
$ pip install --user libvcs
URL Detection and Parsing
Easily validate and parse VCS URLs using the
libvcs.url module:
Validate URLs
>>> from libvcs.url.git import GitURL
>>> GitURL.is_valid(url='https://github.com/vcs-python/libvcs.git')
True
Parse and adjust Git URLs:
>>> from libvcs.url.git import GitURL
>>> git_location = GitURL(url='git@github.com:vcs-python/libvcs.git')
>>> git_location
GitURL(url=git@github.com:vcs-python/libvcs.git,
user=git,
hostname=github.com,
path=vcs-python/libvcs,
suffix=.git,
rule=core-git-scp)
Switch repo libvcs -> vcspull:
>>> from libvcs.url.git import GitURL
>>> git_location = GitURL(url='git@github.com:vcs-python/libvcs.git')
>>> git_location.path = 'vcs-python/vcspull'
>>> git_location.to_url()
'git@github.com:vcs-python/vcspull.git'
# Switch them to gitlab:
>>> git_location.hostname = 'gitlab.com'
# Export to a `git clone` compatible URL.
>>> git_location.to_url()
'git@gitlab.com:vcs-python/vcspull.git'
See more in the parser document.
Command Abstraction
Abstracts CLI commands for git(1), hg(1), svn(1) via a lightweight subprocess wrapper.
Run Git Commands
import pathlib
from libvcs.cmd.git import Git
git = Git(path=pathlib.Path.cwd() / 'my_git_repo')
git.clone(url='https://github.com/vcs-python/libvcs.git')
Above: libvcs.cmd.git.Git using
Git.clone().
Repository Synchronization
Synchronize your repositories using the
libvcs.sync module.
Clone and Update Repositories
import pathlib
from libvcs.sync.git import GitSync
repo = GitSync(
url="https://github.com/vcs-python/libvcs",
path=pathlib.Path().cwd() / "my_repo",
remotes={
'gitlab': 'https://gitlab.com/vcs-python/libvcs'
}
)
# Update / clone repo:
>>> repo.update_repo()
# Get revision:
>>> repo.get_revision()
u'5c227e6ab4aab44bf097da2e088b0ff947370ab8'
Above: libvcs.sync.git.GitSync repository
object using
GitSync.update_repo()
and
GitSync.get_revision().
Pytest plugin: Temporary VCS repositories for testing
libvcs pytest plugin provides py.test fixtures to swiftly create local VCS repositories and working repositories to test with. Repositories are automatically cleaned on test teardown.
Use temporary, local VCS in py.test
import pathlib
from libvcs.pytest_plugin import CreateRepoPytestFixtureFn
from libvcs.sync.git import GitSync
def test_repo_git_remote_checkout(
create_git_remote_repo: CreateRepoPytestFixtureFn,
tmp_path: pathlib.Path,
projects_path: pathlib.Path,
) -> None:
git_server = create_git_remote_repo()
git_repo_checkout_dir = projects_path / "my_git_checkout"
git_repo = GitSync(path=str(git_repo_checkout_dir), url=f"file://{git_server!s}")
git_repo.obtain()
git_repo.update_repo()
assert git_repo.get_revision() == "initial"
assert git_repo_checkout_dir.exists()
assert pathlib.Path(git_repo_checkout_dir / ".git").exists()
Under the hood: fixtures bootstrap a temporary $HOME environment in a
TmpPathFactory
for automatic cleanup and pytest-xdist compatibility..
Donations
Your donations fund development of new features, testing and support. Your money will go directly to maintenance and development of the project. If you are an individual, feel free to give whatever feels right for the value you get out of the project.
See donation options at https://www.git-pull.com/support.html.
More information
- Python support: 3.9+, pypy
- VCS supported: git(1), svn(1), hg(1)
- Source: https://github.com/vcs-python/libvcs
- Docs: https://libvcs.git-pull.com
- Changelog: https://libvcs.git-pull.com/history.html
- APIs for git, hg, and svn:
libvcs.url: URL Parserlibvcs.cmd: Commandslibvcs.sync: Clone and update
- Issues: https://github.com/vcs-python/libvcs/issues
- Test Coverage: https://codecov.io/gh/vcs-python/libvcs
- pypi: https://pypi-hypernode.com/pypi/libvcs
- Open Hub: https://www.openhub.net/p/libvcs
- License: MIT.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file libvcs-0.32.3.tar.gz.
File metadata
- Download URL: libvcs-0.32.3.tar.gz
- Upload date:
- Size: 452.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.1 CPython/3.12.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 3713f8255449194c7410a44fbae072b04b57eb9089b766d0040ea1710c7187ad |
|
| MD5 | 6e9df23f935c5f3b928ea6f603b64615 |
|
| BLAKE2b-256 | 2aa042bd84fb6ce32e5ed6cac7582a635504bce80ecf5e18e0578855d707d45a |
Provenance
File details
Details for the file libvcs-0.32.3-py3-none-any.whl.
File metadata
- Download URL: libvcs-0.32.3-py3-none-any.whl
- Upload date:
- Size: 76.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.1 CPython/3.12.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 641544afddd56b55ab310f718dffc577863b4e511446d4749db747fd77701b7d |
|
| MD5 | a8dec49d87b844ebb346792d1c02fb09 |
|
| BLAKE2b-256 | 2fc2cb4fdcb39ca64124348e7de58b1004eb93c7daa09b30096d4a8cc141f846 |
