Skip to main content

project_repository

Gets or lists a project_repository resource.

Overview​

Nameproject_repository
TypeResource
Idgitlab.projects.project_repository

Fields​

The following fields are returned by SELECT queries:

GraphQL response envelope

NameDatatypeDescription
branch_countintegerNumber of branches in the repository.
code_owners_pathstringPath to CODEOWNERS file in a ref.
commit_countintegerNumber of commits in the default branch of the repository.
disk_pathstringShows a disk path of the repository.
emptybooleanIndicates repository has no visible content.
exists_booleanIndicates a corresponding Git repository exists on disk.
root_refstringDefault branch of the repository.
tag_countintegerNumber of tags in the repository.

Methods​

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
getselectfull_path, hostGit repository of the project. Generated from the GitLab GraphQL schema field Project.repository (Repository).

Parameters​

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
full_pathstringFull path of the project, for example gitlab-org/gitlab
hoststringGitLab host, with an optional port (default gitlab.com). Resolved from the GITLAB_HOST environment variable when it is set (x-stackQL-envVar); a WHERE host value always takes precedence. Self-managed instances: the provider is generated from the gitlab.com schema, so older instances may reject fields they do not serve. (default: gitlab.com, x-stackQL-envVar: GITLAB_HOST)

SELECT examples​

Git repository of the project. Generated from the GitLab GraphQL schema field Project.repository (Repository).

SELECT
branch_count,
code_owners_path,
commit_count,
disk_path,
empty,
exists_,
root_ref,
tag_count
FROM gitlab.projects.project_repository
WHERE full_path = '{{ full_path }}' -- required
AND host = '{{ host }}' -- required (defaults to gitlab.com; or set GITLAB_HOST)
;