@gitbeaker/requester-utils

What is @gitbeaker/requester-utils?

@gitbeaker/requester-utils is a utility package designed to facilitate HTTP requests, particularly in the context of interacting with GitLab's API. It provides a set of tools to simplify the process of making authenticated requests, handling responses, and managing configurations.

What are @gitbeaker/requester-utils's main functionalities?

Authenticated Requests

This feature allows you to create a requester function that automatically includes authentication headers in your HTTP requests. The code sample demonstrates how to create a requester and make a GET request to fetch projects.

const { createRequesterFn } = require('@gitbeaker/requester-utils');

const requester = createRequesterFn({
  host: 'https://gitlab.example.com',
  token: 'your_access_token',
});

requester.get('/projects')
  .then(response => console.log(response))
  .catch(error => console.error(error));

Custom Request Configurations

This feature allows you to customize various request configurations such as timeout settings. The code sample shows how to set a custom request timeout.

const { createRequesterFn } = require('@gitbeaker/requester-utils');

const requester = createRequesterFn({
  host: 'https://gitlab.example.com',
  token: 'your_access_token',
  requestTimeout: 5000,
});

requester.get('/projects')
  .then(response => console.log(response))
  .catch(error => console.error(error));

Handling Responses

This feature provides a way to handle responses and errors effectively. The code sample demonstrates how to check the response status and handle errors.

const { createRequesterFn } = require('@gitbeaker/requester-utils');

const requester = createRequesterFn({
  host: 'https://gitlab.example.com',
  token: 'your_access_token',
});

requester.get('/projects')
  .then(response => {
    if (response.status === 200) {
      console.log('Projects:', response.data);
    } else {
      console.error('Error:', response.statusText);
    }
  })
  .catch(error => console.error('Request failed:', error));

Other packages similar to @gitbeaker/requester-utils

axios

Axios is a popular promise-based HTTP client for the browser and Node.js. It provides similar functionalities such as making HTTP requests, handling responses, and managing configurations. Compared to @gitbeaker/requester-utils, Axios is more general-purpose and widely used across various projects.

node-fetch

Node-fetch is a lightweight module that brings `window.fetch` to Node.js. It is used for making HTTP requests and handling responses. While it offers similar functionalities, it is more minimalistic compared to @gitbeaker/requester-utils, which is tailored for GitLab API interactions.

request

Request is a simplified HTTP client for Node.js with a user-friendly API. It provides functionalities for making HTTP requests and handling responses. Although it is similar in purpose, it is more feature-rich and flexible compared to @gitbeaker/requester-utils.

README

^{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.}

---

Utility for creating custom wrappers around the @gitbeaker/core GitLab SDK.

Table of Contents

• Usage
• Testing
• FAQ
• Contributors
• Changelog

Usage

Browsers	Load @gitbeaker/requester-utils directly from esm.sh <script type="module"> import { RequesterUtils, BaseResource } from 'https://esm.sh/@gitbeaker/requester-utils'; </script>
Deno	Load @gitbeaker/requester-utils directly from esm.sh import { RequesterUtils, BaseResource } from 'https://esm.sh/@gitbeaker/requester-utils?dts';
Node 18+	Install with npm install @gitbeaker/requester-utils, or yarn add @gitbeaker/requester-utils import { RequesterUtils, BaseResource } from '@gitbeaker/requester-utils';

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.

Changelog

39.24.0 (Fri Nov 17 2023)

:tada: This release contains work from a new contributor! :tada:

Thank you, David Claybourne (@Djcd), for all your work!

✨ Feature

• @gitbeaker/core, @gitbeaker/rest
  • Add creation for service accounts on selfhosted instances #3458 (@Djcd)
• @gitbeaker/core
  • Add rotate to PersonalAccessTokens resource #3459 (@Djcd)

↕️ Dependencies

• Bump nx from 17.0.2 to 17.1.2 #3451 (@dependabot[bot])
• @gitbeaker/cli, @gitbeaker/core, @gitbeaker/requester-utils, @gitbeaker/rest
  • Dependencies #3457 (@jdalrymple)

⚠️ Pushed to main

• @gitbeaker/cli
  • Updating image url (@jdalrymple)
• @gitbeaker/cli, @gitbeaker/core, @gitbeaker/requester-utils, @gitbeaker/rest
  • Merge branch 'docs/updating-readme' into main (@jdalrymple)
  • Updating contributors settings and the readme image url (@jdalrymple)

🚨 Tests

• @gitbeaker/rest
  • Add service account API test updates #3460 (@jdalrymple)

Authors: 3

• @dependabot[bot]
• David Claybourne (@Djcd)
• Justin Dalrymple (@jdalrymple)

---