78 lines
2.6 KiB
Python
78 lines
2.6 KiB
Python
# -*- coding: utf-8 -*-
|
|
#
|
|
# Copyright 2010-2014 The pygit2 contributors
|
|
#
|
|
# This file is free software; you can redistribute it and/or modify
|
|
# it under the terms of the GNU General Public License, version 2,
|
|
# as published by the Free Software Foundation.
|
|
#
|
|
# In addition to the permissions in the GNU General Public License,
|
|
# the authors give you unlimited permission to link the compiled
|
|
# version of this file into combinations with other programs,
|
|
# and to distribute those combinations without any restriction
|
|
# coming from the use of this file. (The General Public License
|
|
# restrictions do apply in other respects; for example, they cover
|
|
# modification of the file, and distribution when not linked into
|
|
# a combined executable.)
|
|
#
|
|
# This file is distributed in the hope that it will be useful, but
|
|
# WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
# General Public License for more details.
|
|
#
|
|
# You should have received a copy of the GNU General Public License
|
|
# along with this program; see the file COPYING. If not, write to
|
|
# the Free Software Foundation, 51 Franklin Street, Fifth Floor,
|
|
# Boston, MA 02110-1301, USA.
|
|
|
|
# Import from the future
|
|
from __future__ import absolute_import
|
|
|
|
# Low level API
|
|
import _pygit2
|
|
from _pygit2 import *
|
|
|
|
# High level API
|
|
from .repository import Repository
|
|
from .version import __version__
|
|
|
|
|
|
def init_repository(path, bare=False):
|
|
"""
|
|
Creates a new Git repository in the given *path*.
|
|
|
|
If *bare* is True the repository will be bare, i.e. it will not have a
|
|
working copy.
|
|
"""
|
|
_pygit2.init_repository(path, bare)
|
|
return Repository(path)
|
|
|
|
|
|
def clone_repository(
|
|
url, path, bare=False, ignore_cert_errors=False,
|
|
remote_name="origin", checkout_branch=None):
|
|
"""
|
|
Clones a new Git repository from *url* in the given *path*.
|
|
|
|
**bare** indicates whether a bare git repository should be created.
|
|
|
|
**remote_name** is the name given to the "origin" remote.
|
|
The default is "origin".
|
|
|
|
**checkout_branch** gives the name of the branch to checkout.
|
|
None means use the remote's *HEAD*.
|
|
|
|
Returns a Repository class pointing to the newly cloned repository.
|
|
|
|
If you wish to use the repo, you need to do a checkout for one of
|
|
the available branches, like this:
|
|
|
|
>>> repo = repo.clone_repository("url", "path")
|
|
>>> repo.checkout(branch) # i.e.: refs/heads/master
|
|
|
|
"""
|
|
|
|
_pygit2.clone_repository(
|
|
url, path, bare, ignore_cert_errors, remote_name, checkout_branch)
|
|
return Repository(path)
|