summaryrefslogtreecommitdiff
path: root/docs/faq.rst
blob: fe71198acaba3d516d6e98dc67e4ecf0eb39b0c4 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
###
FAQ
###

I cannot edit the merge request / issue I've just retrieved
    It is likely that you used a ``MergeRequest``, ``GroupMergeRequest``,
    ``Issue`` or ``GroupIssue`` object. These objects cannot be edited. But you
    can create a new ``ProjectMergeRequest`` or ``ProjectIssue`` object to
    apply changes. For example::

        issue = gl.issues.list()[0]
        project = gl.projects.get(issue.project_id, lazy=True)
        editable_issue = project.issues.get(issue.iid, lazy=True)
        # you can now edit the object

    See the :ref:`merge requests example <merge_requests_examples>` and the
    :ref:`issues examples <issues_examples>`.

How can I clone the repository of a project?
    python-gitlab doesn't provide an API to clone a project. You have to use a
    git library or call the ``git`` command.

    The git URI is exposed in the ``ssh_url_to_repo`` attribute of ``Project``
    objects.

    Example::

        import subprocess

        project = gl.projects.create(data)  # or gl.projects.get(project_id)
        print(project.attributes)  # displays all the attributes
        git_url = project.ssh_url_to_repo
        subprocess.call(['git', 'clone', git_url])