@templmf/temp-solf-lmf 0.0.109 → 0.0.111

package/gitlab-foss-8-17-stable/doc/api/repositories.md

@@ -1,200 +0,0 @@
-# Repositories
-
-## List repository tree
-
-Get a list of repository files and directories in a project. This endpoint can
-be accessed without authentication if the repository is publicly accessible.
-
-```
-GET /projects/:id/repository/tree
-```
-
-Parameters:
-
-- `id` (required) - The ID of a project
-- `path` (optional) - The path inside repository. Used to get contend of subdirectories
-- `ref_name` (optional) - The name of a repository branch or tag or if not given the default branch
-- `recursive` (optional) - Boolean value used to get a recursive tree (false by default)
-
-```json
-[
-  {
-    "id": "a1e8f8d745cc87e3a9248358d9352bb7f9a0aeba",
-    "name": "html",
-    "type": "tree",
-    "path": "files/html",
-    "mode": "040000"
-  },
-  {
-    "id": "4535904260b1082e14f867f7a24fd8c21495bde3",
-    "name": "images",
-    "type": "tree",
-    "path": "files/images",
-    "mode": "040000"
-  },
-  {
-    "id": "31405c5ddef582c5a9b7a85230413ff90e2fe720",
-    "name": "js",
-    "type": "tree",
-    "path": "files/js",
-    "mode": "040000"
-  },
-  {
-    "id": "cc71111cfad871212dc99572599a568bfe1e7e00",
-    "name": "lfs",
-    "type": "tree",
-    "path": "files/lfs",
-    "mode": "040000"
-  },
-  {
-    "id": "fd581c619bf59cfdfa9c8282377bb09c2f897520",
-    "name": "markdown",
-    "type": "tree",
-    "path": "files/markdown",
-    "mode": "040000"
-  },
-  {
-    "id": "23ea4d11a4bdd960ee5320c5cb65b5b3fdbc60db",
-    "name": "ruby",
-    "type": "tree",
-    "path": "files/ruby",
-    "mode": "040000"
-  },
-  {
-    "id": "7d70e02340bac451f281cecf0a980907974bd8be",
-    "name": "whitespace",
-    "type": "blob",
-    "path": "files/whitespace",
-    "mode": "100644"
-  }
-]
-```
-
-## Raw file content
-
-Get the raw file contents for a file by commit SHA and path. This endpoint can
-be accessed without authentication if the repository is publicly accessible.
-
-```
-GET /projects/:id/repository/blobs/:sha
-```
-
-Parameters:
-
-- `id` (required) - The ID of a project
-- `sha` (required) - The commit or branch name
-- `filepath` (required) - The path the file
-
-## Raw blob content
-
-Get the raw file contents for a blob by blob SHA. This endpoint can be accessed
-without authentication if the repository is publicly accessible.
-
-```
-GET /projects/:id/repository/raw_blobs/:sha
-```
-
-Parameters:
-
-- `id` (required) - The ID of a project
-- `sha` (required) - The blob SHA
-
-## Get file archive
-
-Get an archive of the repository. This endpoint can be accessed without
-authentication if the repository is publicly accessible.
-
-```
-GET /projects/:id/repository/archive
-```
-
-Parameters:
-
-- `id` (required) - The ID of a project
-- `sha` (optional) - The commit SHA to download defaults to the tip of the default branch
-
-## Compare branches, tags or commits
-
-This endpoint can be accessed without authentication if the repository is
-publicly accessible.
-
-```
-GET /projects/:id/repository/compare
-```
-
-Parameters:
-
-- `id` (required) - The ID of a project
-- `from` (required) - the commit SHA or branch name
-- `to` (required) - the commit SHA or branch name
-
-```
-GET /projects/:id/repository/compare?from=master&to=feature
-```
-
-Response:
-
-```json
-
-{
-  "commit": {
-    "id": "12d65c8dd2b2676fa3ac47d955accc085a37a9c1",
-    "short_id": "12d65c8dd2b",
-    "title": "JS fix",
-    "author_name": "Dmitriy Zaporozhets",
-    "author_email": "dmitriy.zaporozhets@gmail.com",
-    "created_at": "2014-02-27T10:27:00+02:00"
-  },
-  "commits": [{
-    "id": "12d65c8dd2b2676fa3ac47d955accc085a37a9c1",
-    "short_id": "12d65c8dd2b",
-    "title": "JS fix",
-    "author_name": "Dmitriy Zaporozhets",
-    "author_email": "dmitriy.zaporozhets@gmail.com",
-    "created_at": "2014-02-27T10:27:00+02:00"
-  }],
-  "diffs": [{
-    "old_path": "files/js/application.js",
-    "new_path": "files/js/application.js",
-    "a_mode": null,
-    "b_mode": "100644",
-    "diff": "--- a/files/js/application.js\n+++ b/files/js/application.js\n@@ -24,8 +24,10 @@\n //= require g.raphael-min\n //= require g.bar-min\n //= require branch-graph\n-//= require highlightjs.min\n-//= require ace/ace\n //= require_tree .\n //= require d3\n //= require underscore\n+\n+function fix() { \n+  alert(\"Fixed\")\n+}",
-    "new_file": false,
-    "renamed_file": false,
-    "deleted_file": false
-  }],
-  "compare_timeout": false,
-  "compare_same_ref": false
-}
-```
-
-## Contributors
-
-Get repository contributors list. This endpoint can be accessed without
-authentication if the repository is publicly accessible.
-
-```
-GET /projects/:id/repository/contributors
-```
-
-Parameters:
-
-- `id` (required) - The ID of a project
-
-Response:
-
-```
-[{
-  "name": "Dmitriy Zaporozhets",
-  "email": "dmitriy.zaporozhets@gmail.com",
-  "commits": 117,
-  "additions": 2097,
-  "deletions": 517
-}, {
-  "name": "Jacob Vosmaer",
-  "email": "contact@jacobvosmaer.nl",
-  "commits": 33,
-  "additions": 338,
-  "deletions": 244
-}]
-```

package/gitlab-foss-8-17-stable/doc/api/repository_files.md

@@ -1,134 +0,0 @@
-# Repository files
-
-**CRUD for repository files**
-
-**Create, read, update and delete repository files using this API**
-
-## Get file from repository
-
-Allows you to receive information about file in repository like name, size,
-content. Note that file content is Base64 encoded. This endpoint can be accessed
-without authentication if the repository is publicly accessible.
-
-```
-GET /projects/:id/repository/files
-```
-
-```bash
-curl --request GET --header 'PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK' 'https://gitlab.example.com/api/v3/projects/13083/repository/files?file_path=app/models/key.rb&ref=master'
-```
-
-Example response:
-
-```json
-{
-  "file_name": "key.rb",
-  "file_path": "app/models/key.rb",
-  "size": 1476,
-  "encoding": "base64",
-  "content": "IyA9PSBTY2hlbWEgSW5mb3...",
-  "ref": "master",
-  "blob_id": "79f7bbd25901e8334750839545a9bd021f0e4c83",
-  "commit_id": "d5a3ff139356ce33e37e73add446f16869741b50",
-  "last_commit_id": "570e7b2abdd848b95f2f578043fc23bd6f6fd24d"
-}
-```
-
-Parameters:
-
-- `file_path` (required) - Full path to new file. Ex. lib/class.rb
-- `ref` (required) - The name of branch, tag or commit
-
-## Create new file in repository
-
-```
-POST /projects/:id/repository/files
-```
-
-```bash
-curl --request POST --header 'PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK' 'https://gitlab.example.com/api/v3/projects/13083/repository/files?file_path=app/project.rb&branch_name=master&author_email=author%40example.com&author_name=Firstname%20Lastname&content=some%20content&commit_message=create%20a%20new%20file'
-```
-
-Example response:
-
-```json
-{
-  "file_path": "app/project.rb",
-  "branch_name": "master"
-}
-```
-
-Parameters:
-
-- `file_path` (required) - Full path to new file. Ex. lib/class.rb
-- `branch_name` (required) - The name of branch
-- `encoding` (optional) - Change encoding to 'base64'. Default is text.
-- `author_email` (optional) - Specify the commit author's email address
-- `author_name` (optional) - Specify the commit author's name
-- `content` (required) - File content
-- `commit_message` (required) - Commit message
-
-## Update existing file in repository
-
-```
-PUT /projects/:id/repository/files
-```
-
-```bash
-curl --request PUT --header 'PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK' 'https://gitlab.example.com/api/v3/projects/13083/repository/files?file_path=app/project.rb&branch_name=master&author_email=author%40example.com&author_name=Firstname%20Lastname&content=some%20other%20content&commit_message=update%20file'
-```
-
-Example response:
-
-```json
-{
-  "file_path": "app/project.rb",
-  "branch_name": "master"
-}
-```
-
-Parameters:
-
-- `file_path` (required) - Full path to file. Ex. lib/class.rb
-- `branch_name` (required) - The name of branch
-- `encoding` (optional) - Change encoding to 'base64'. Default is text.
-- `author_email` (optional) - Specify the commit author's email address
-- `author_name` (optional) - Specify the commit author's name
-- `content` (required) - New file content
-- `commit_message` (required) - Commit message
-
-If the commit fails for any reason we return a 400 error with a non-specific
-error message. Possible causes for a failed commit include:
-- the `file_path` contained `/../` (attempted directory traversal);
-- the new file contents were identical to the current file contents, i.e. the
-  user tried to make an empty commit;
-- the branch was updated by a Git push while the file edit was in progress.
-
-Currently gitlab-shell has a boolean return code, preventing GitLab from specifying the error.
-
-## Delete existing file in repository
-
-```
-DELETE /projects/:id/repository/files
-```
-
-```bash
-curl --request PUT --header 'PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK' 'https://gitlab.example.com/api/v3/projects/13083/repository/files?file_path=app/project.rb&branch_name=master&author_email=author%40example.com&author_name=Firstname%20Lastname&commit_message=delete%20file'
-```
-
-Example response:
-
-```json
-{
-  "file_path": "app/project.rb",
-  "branch_name": "master"
-}
-```
-
-Parameters:
-
-- `file_path` (required) - Full path to file. Ex. lib/class.rb
-- `branch_name` (required) - The name of branch
-- `author_email` (optional) - Specify the commit author's email address
-- `author_name` (optional) - Specify the commit author's name
-- `commit_message` (required) - Commit message

package/gitlab-foss-8-17-stable/doc/api/runners.md

@@ -1,322 +0,0 @@
-# Runners API
-
-> [Introduced][ce-2640] in GitLab 8.5
-
-[ce-2640]: https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/2640
-
-## List owned runners
-
-Get a list of specific runners available to the user.
-
-```
-GET /runners
-GET /runners?scope=active
-```
-
-| Attribute | Type    | Required | Description         |
-|-----------|---------|----------|---------------------|
-| `scope`   | string  | no       | The scope of specific runners to show, one of: `active`, `paused`, `online`; showing all runners if none provided |
-
-```
-curl --header "PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK" "https://gitlab.example.com/api/v3/runners"
-```
-
-Example response:
-
-```json
-[
-    {
-        "active": true,
-        "description": "test-1-20150125",
-        "id": 6,
-        "is_shared": false,
-        "name": null
-    },
-    {
-        "active": true,
-        "description": "test-2-20150125",
-        "id": 8,
-        "is_shared": false,
-        "name": null
-    }
-]
-```
-
-## List all runners
-
-Get a list of all runners in the GitLab instance (specific and shared). Access
-is restricted to users with `admin` privileges.
-
-```
-GET /runners/all
-GET /runners/all?scope=online
-```
-
-| Attribute | Type    | Required | Description         |
-|-----------|---------|----------|---------------------|
-| `scope`   | string  | no       | The scope of runners to show, one of: `specific`, `shared`, `active`, `paused`, `online`; showing all runners if none provided |
-
-```
-curl --header "PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK" "https://gitlab.example.com/api/v3/runners/all"
-```
-
-Example response:
-
-```json
-[
-    {
-        "active": true,
-        "description": "shared-runner-1",
-        "id": 1,
-        "is_shared": true,
-        "name": null
-    },
-    {
-        "active": true,
-        "description": "shared-runner-2",
-        "id": 3,
-        "is_shared": true,
-        "name": null
-    },
-    {
-        "active": true,
-        "description": "test-1-20150125",
-        "id": 6,
-        "is_shared": false,
-        "name": null
-    },
-    {
-        "active": true,
-        "description": "test-2-20150125",
-        "id": 8,
-        "is_shared": false,
-        "name": null
-    }
-]
-```
-
-## Get runner's details
-
-Get details of a runner.
-
-```
-GET /runners/:id
-```
-
-| Attribute | Type    | Required | Description         |
-|-----------|---------|----------|---------------------|
-| `id`      | integer | yes      | The ID of a runner  |
-
-```
-curl --header "PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK" "https://gitlab.example.com/api/v3/runners/6"
-```
-
-Example response:
-
-```json
-{
-    "active": true,
-    "architecture": null,
-    "description": "test-1-20150125",
-    "id": 6,
-    "is_shared": false,
-    "contacted_at": "2016-01-25T16:39:48.066Z",
-    "name": null,
-    "platform": null,
-    "projects": [
-        {
-            "id": 1,
-            "name": "GitLab Community Edition",
-            "name_with_namespace": "GitLab.org / GitLab Community Edition",
-            "path": "gitlab-ce",
-            "path_with_namespace": "gitlab-org/gitlab-ce"
-        }
-    ],
-    "token": "205086a8e3b9a2b818ffac9b89d102",
-    "revision": null,
-    "tag_list": [
-        "ruby",
-        "mysql"
-    ],
-    "version": null
-}
-```
-
-## Update runner's details
-
-Update details of a runner.
-
-```
-PUT /runners/:id
-```
-
-| Attribute     | Type    | Required | Description         |
-|---------------|---------|----------|---------------------|
-| `id`          | integer | yes      | The ID of a runner  |
-| `description` | string  | no       | The description of a runner |
-| `active`      | boolean | no       | The state of a runner; can be set to `true` or `false` |
-| `tag_list`    | array   | no       | The list of tags for a runner; put array of tags, that should be finally assigned to a runner |
-
-```
-curl --request PUT --header "PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK" "https://gitlab.example.com/api/v3/runners/6" --form "description=test-1-20150125-test" --form "tag_list=ruby,mysql,tag1,tag2"
-```
-
-Example response:
-
-```json
-{
-    "active": true,
-    "architecture": null,
-    "description": "test-1-20150125-test",
-    "id": 6,
-    "is_shared": false,
-    "contacted_at": "2016-01-25T16:39:48.066Z",
-    "name": null,
-    "platform": null,
-    "projects": [
-        {
-            "id": 1,
-            "name": "GitLab Community Edition",
-            "name_with_namespace": "GitLab.org / GitLab Community Edition",
-            "path": "gitlab-ce",
-            "path_with_namespace": "gitlab-org/gitlab-ce"
-        }
-    ],
-    "token": "205086a8e3b9a2b818ffac9b89d102",
-    "revision": null,
-    "tag_list": [
-        "ruby",
-        "mysql",
-        "tag1",
-        "tag2"
-    ],
-    "version": null
-}
-```
-
-## Remove a runner
-
-Remove a runner.
-
-```
-DELETE /runners/:id
-```
-
-| Attribute | Type    | Required | Description         |
-|-----------|---------|----------|---------------------|
-| `id`      | integer | yes      | The ID of a runner  |
-
-```
-curl --request DELETE --header "PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK" "https://gitlab.example.com/api/v3/runners/6"
-```
-
-Example response:
-
-```json
-{
-    "active": true,
-    "description": "test-1-20150125-test",
-    "id": 6,
-    "is_shared": false,
-    "name": null,
-}
-```
-
-## List project's runners
-
-List all runners (specific and shared) available in the project. Shared runners
-are listed if at least one shared runner is defined **and** shared runners
-usage is enabled in the project's settings.
-
-```
-GET /projects/:id/runners
-```
-
-| Attribute | Type    | Required | Description         |
-|-----------|---------|----------|---------------------|
-| `id`      | integer | yes      | The ID of a project |
-
-```
-curl --header "PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK" "https://gitlab.example.com/api/v3/projects/9/runners"
-```
-
-Example response:
-
-```json
-[
-    {
-        "active": true,
-        "description": "test-2-20150125",
-        "id": 8,
-        "is_shared": false,
-        "name": null
-    },
-    {
-        "active": true,
-        "description": "development_runner",
-        "id": 5,
-        "is_shared": true,
-        "name": null
-    }
-]
-```
-
-## Enable a runner in project
-
-Enable an available specific runner in the project.
-
-```
-POST /projects/:id/runners
-```
-
-| Attribute   | Type    | Required | Description         |
-|-------------|---------|----------|---------------------|
-| `id`        | integer | yes      | The ID of a project |
-| `runner_id` | integer | yes      | The ID of a runner  |
-
-```
-curl --request POST --header "PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK" "https://gitlab.example.com/api/v3/projects/9/runners" --form "runner_id=9"
-```
-
-Example response:
-
-```json
-{
-    "active": true,
-    "description": "test-2016-02-01",
-    "id": 9,
-    "is_shared": false,
-    "name": null
-}
-```
-
-## Disable a runner from project
-
-Disable a specific runner from the project. It works only if the project isn't
-the only project associated with the specified runner. If so, an error is
-returned. Use the [Remove a runner](#remove-a-runner) call instead.
-
-```
-DELETE /projects/:id/runners/:runner_id
-```
-
-| Attribute   | Type    | Required | Description         |
-|-------------|---------|----------|---------------------|
-| `id`        | integer | yes      | The ID of a project |
-| `runner_id` | integer | yes      | The ID of a runner  |
-
-```
-curl --request DELETE --header "PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK" "https://gitlab.example.com/api/v3/projects/9/runners/9"
-```
-
-Example response:
-
-```json
-{
-    "active": true,
-    "description": "test-2016-02-01",
-    "id": 9,
-    "is_shared": false,
-    "name": null
-}
-```