feat: import from bitbucket server

I'd like to use this libary to automate importing Bitbucket Server
repositories into GitLab.  There is a [GitLab API
endpoint](https://docs.gitlab.com/ee/api/import.html#import-repository-from-bitbucket-server)
to do this, but it is not exposed through this library.

* Add an `import_bitbucket_server` method to the `ProjectManager`.  This
  method calls this GitLab API endpoint:
  https://docs.gitlab.com/ee/api/import.html#import-repository-from-bitbucket-server
* Modify `import_gitlab` method docstring for python3 compatibility
* Add a skipped stub test for the existing `import_github` method

1 files changed, 38 insertions, 0 deletions

diff --git a/gitlab/tests/objects/test_projects.py b/gitlab/tests/objects/test_projects.py
index 1e8b8b6..14ab966 100644
--- a/gitlab/tests/objects/test_projects.py
+++ b/gitlab/tests/objects/test_projects.py
@@ -9,6 +9,11 @@ from gitlab.v4.objects import Project
 
 
 project_content = {"name": "name", "id": 1}
+import_content = {
+    "id": 1,
+    "name": "project",
+    "import_status": "scheduled",
+}
 
 
 @pytest.fixture
@@ -37,6 +42,19 @@ def resp_list_projects():
         yield rsps
 
 
+@pytest.fixture
+def resp_import_bitbucket_server():
+    with responses.RequestsMock() as rsps:
+        rsps.add(
+            method=responses.POST,
+            url="http://localhost/api/v4/import/bitbucket_server",
+            json=import_content,
+            content_type="application/json",
+            status=201,
+        )
+        yield rsps
+
+
 def test_get_project(gl, resp_get_project):
     data = gl.projects.get(1)
     assert isinstance(data, Project)
@@ -50,6 +68,21 @@ def test_list_projects(gl, resp_list_projects):
     assert projects[0].name == "name"
 
 
+def test_import_bitbucket_server(gl, resp_import_bitbucket_server):
+    res = gl.projects.import_bitbucket_server(
+        bitbucket_server_project="project",
+        bitbucket_server_repo="repo",
+        bitbucket_server_url="url",
+        bitbucket_server_username="username",
+        personal_access_token="token",
+        new_name="new_name",
+        target_namespace="namespace",
+    )
+    assert res["id"] == 1
+    assert res["name"] == "project"
+    assert res["import_status"] == "scheduled"
+
+
 @pytest.mark.skip(reason="missing test")
 def test_list_user_projects(gl):
     pass
@@ -223,3 +256,8 @@ def test_project_pull_mirror(gl):
 @pytest.mark.skip(reason="missing test")
 def test_project_snapshot(gl):
     pass
+
+
+@pytest.mark.skip(reason="missing test")
+def test_import_github(gl):
+    pass