gitbeaker

mirror of https://github.com/jdalrymple/gitbeaker.git synced 2026-01-18 15:55:30 +00:00

History

Justin Dalrymple 112aed2758

**gitbeaker**

@typescript-eslint/eslint-plugin ^5.60.1 → ^5.61.0
@typescript-eslint/parser ^5.60.1 → ^5.61.0
eslint ^8.43.0 → ^8.44.0
jest ^29.5.0 → ^29.6.1
@swc/core ^1.3.66 → ^1.3.68
lerna ^7.1.0 → ^7.1.1
lint-staged ^13.2.2 → ^13.2.3
typescript ^5.1.3 → ^5.1.6
eslint-plugin-prettier ^4.2.1 → ^5.0.0-alpha.1

**@gitbeaker/cli**

typescript ^5.1.3 → ^5.1.6

**@gitbeaker/core**

@types/node ^20.3.1 → ^20.4.0
typescript ^5.1.3 → ^5.1.6

**@gitbeaker/requester-utils**

@types/node ^20.3.1 → ^20.4.0
typescript ^5.1.3 → ^5.1.6

**@gitbeaker/rest**

@types/node ^20.3.1 → ^20.4.0
typescript ^5.1.3 → ^5.1.6

2023-07-07 20:19:20 -04:00

src

Latest release housekeeping v3 (#3229 )

2023-04-29 14:19:43 -04:00

test

Add support for a query timeout (#3271 )

2023-05-22 00:16:22 -04:00

CHANGELOG.md

Update CHANGELOG.md [skip ci]

2023-06-26 21:04:57 +00:00

jest.config.mjs

Latest release housekeeping v3 (#3229 )

2023-04-29 14:19:43 -04:00

lint-staged.config.mjs

Major Release v36.0.0 - Improved Typing, and API support (16.0) (#2258 )

2023-04-26 12:58:56 -04:00

package.json

Dependency updates (#3341 )

2023-07-07 20:19:20 -04:00

README.md

Update contributors [skip ci]

2023-06-26 23:42:54 +00:00

tsconfig.json

Major Release v36.0.0 - Improved Typing, and API support (16.0) (#2258 )

2023-04-26 12:58:56 -04:00

README.md

^{My open source work is supported by the community}

^{Special thanks to:}

Review merge requests in Slack to merge code faster

_{Improve your code review process by creating an ephemeral channel per merge request.}

A CLI Wrapper for the @gitbeaker/rest SDK.

Usage

Node 18+

Node 18+	Install with `npm install -g @gitbeaker/cli`, or `yarn add -g @gitbeaker/cli` `gitbeaker [service name] [method name] --config_args pos_arg1 pos_argN --opts_arg1 --opts_argN # A shorthand can also be used: gb [service name] [method name] --config_args pos_arg1 pos_argN --opts_arg1 --opts_argN` Where: `service name` is any of the supported API names of the @gitbeaker/rest sdk `method name` is any of the supported commands on that API service (See source for exceptions, but generally all, show, remove, update) `--config_args` is any of general configuration arguments such as your personal token. These are outlined in this table and can also be found by looking at the cli help menu. These arguments must also include a `gb` or `gl` prefix. ie. `# To get all the projects gitbeaker projects all --gb-token="personaltoken"` `pos_arg1 ... pos_argN` are any of the arguments you would normally supply to the function. The names of the args should match the names in the method headers. These positional arguments can also be written as flag arguments: `--pos_arg1 ... --pos_argN`, BUT must be written in the correct order. `--opts_arg1 ...--opts_argN` are any of the optional arguments that you would normally supply to the function. Their names should match what the GitLab API docs request. `# To get all the projects id=2 and optional parameter "search" = "cool" gitbeaker projects all --gb-token="personaltoken" 2 --search="cool"` To reduce the annoyance of having to pass those configuration properties each time, it is also possible to pass the token and host information through environment variables in the form of `GITLAB_[option name]` or `GITBEAKER_[option name]` ie: `GITLAB_HOST=http://example.com GITLAB_TOKEN=personaltoken GITBEAKER_CAMELIZE=true` This could be set globally or using a .env file in the project folder.

Install with npm install -g @gitbeaker/cli, or yarn add -g @gitbeaker/cli

gitbeaker [service name] [method name] --config_args pos_arg1 pos_argN --opts_arg1 --opts_argN

# A shorthand can also be used:
gb [service name] [method name] --config_args pos_arg1 pos_argN --opts_arg1 --opts_argN

Where:

service name is any of the supported API names of the @gitbeaker/rest sdk
method name is any of the supported commands on that API service (See source for exceptions, but generally all, show, remove, update)
--config_args is any of general configuration arguments such as your personal token. These are outlined in this table and can also be found by looking at the cli help menu. These arguments must also include a gb or gl prefix. ie.

# To get all the projects
gitbeaker projects all --gb-token="personaltoken"

pos_arg1 ... pos_argN are any of the arguments you would normally supply to the function. The names of the args should match the names in the method headers. These positional arguments can also be written as flag arguments: --pos_arg1 ... --pos_argN, BUT must be written in the correct order.
--opts_arg1 ...--opts_argN are any of the optional arguments that you would normally supply to the function. Their names should match what the GitLab API docs request.

# To get all the projects id=2 and optional parameter "search" = "cool"
gitbeaker projects all --gb-token="personaltoken" 2 --search="cool"

To reduce the annoyance of having to pass those configuration properties each time, it is also possible to pass the token and host information through environment variables in the form of GITLAB_[option name] or GITBEAKER_[option name] ie:

GITLAB_HOST=http://example.com
GITLAB_TOKEN=personaltoken
GITBEAKER_CAMELIZE=true

This could be set globally or using a .env file in the project folder.

Contributors

This started as a fork from node-gitlab-legacy but I ended up rewriting much of the code. Here are the original work's contributors.

README.md

Table of Contents

Usage

Contributors