# node-redmine

> node-redmine is a nodejs library which supports 100% features of Redmine's REST API.

Latest version **0.2.2** (published 2020-11-25) · GPL-3.0 license · 0 weekly downloads

## Install

```sh
npm install node-redmine
pnpm add node-redmine
yarn add node-redmine
bun add node-redmine
```

## Health

**Score 23/100 (F)** — status: abandoned.

Positive: has types package; no vulnerabilities; high quality score.

Warnings: low downloads; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.2.2 |
| Published | 2020-11-25 |
| First published | 2016-05-14 |
| Weekly downloads | 0 |
| License | GPL-3.0 |
| TypeScript types | separate (@types/node-redmine) |
| Module format | CommonJS |
| Dependencies | 2 |
| Unpacked size | 65.5 KB |
| Known vulnerabilities | 0 (+1 in 1 direct dependencies) |
| Install scripts | no |
| GitHub stars | 80 |
| Author | wayne@zanran.me |
| Maintainers | zanran |
| Keywords | Redmine, nodejs, REST API |

## Links

- npm: https://www.npmjs.com/package/node-redmine
- Repository: https://github.com/zanran/node-redmine
- Homepage: https://github.com/zanran/node-redmine#readme
- Issues: https://github.com/zanran/node-redmine/issues
- npm.io page: https://npm.io/package/node-redmine

## Dependencies (2)

- [debug](https://npm.io/package/debug.md) ^2.2.0
- [request](https://npm.io/package/request.md) ^2.75.0

## Recent versions

- 0.2.2 (latest) — 2020-11-25
- 0.2.1 — 2018-01-13
- 0.2.0 — 2017-05-26
- 0.1.5 — 2016-12-15
- 0.1.4 — 2016-11-19
- 0.1.3 — 2016-10-30
- 0.1.2 — 2016-10-04
- 0.1.1 — 2016-10-01
- 0.1.0 — 2016-05-14

## README

node-redmine
============

[![Build Status](https://travis-ci.org/zanran/node-redmine.svg?branch=master)](https://travis-ci.org/zanran/node-redmine)
[![npm version](https://img.shields.io/npm/v/node-redmine.svg?style=flat)](https://www.npmjs.com/package/node-redmine)

*[node-redmine](https://github.com/zanran/node-redmine) is a nodejs library that supports 100% the [Redmine's REST API](http://www.redmine.org/projects/redmine/wiki/Rest_api)'s features.*

## Installation

To install node-redmine, simply:

```shell
npm install node-redmine
```

## Usage

```js
var Redmine = require('node-redmine');

// protocol required in Hostname, supports both HTTP and HTTPS
var hostname = process.env.REDMINE_HOST || 'http://redmine.zanran.me';
var config = {
  apiKey: process.env.REDMINE_APIKEY || 'bed1ba0544b681e530c2447341607f423c9c8781'
};

var redmine = new Redmine(hostname, config);

/**
 * Dump issue
 */
var dump_issue = function(issue) {
  console.log('Dumping issue:');
  for (var item in issue) {
    console.log('  ' + item + ': ' + JSON.stringify(issue[item]));
  }
};

redmine.issues({limit: 2}, function(err, data) {
  if (err) throw err;

  for (var i in data.issues) {
    dump_issue(data.issues[i]);
  }

  console.log('total_count: ' + data.total_count);
});
```

## Supported features for Redmine REST API

| Resource            | Status    | Availability | Supported |
|:--------------------|:----------|-------------:|:---------:|
| Issues              | Stable    |          1.0 |     ✓     |
| Projects            | Stable    |          1.0 |     ✓     |
| Project Memberships | Alpha     |          1.4 |     ✓     |
| Users               | Stable    |          1.1 |     ✓     |
| Time Entries        | Stable    |          1.1 |     ✓     |
| News                | Prototype |          1.1 |     ✓     |
| Issue Relations     | Alpha     |          1.3 |     ✓     |
| Versions            | Alpha     |          1.3 |     ✓     |
| Wiki Pages          | Alpha     |          2.2 |     ✓     |
| Queries             | Alpha     |          1.3 |     ✓     |
| Attachments         | Beta      |          1.3 |     ✓     |
| Issue Statuses      | Alpha     |          1.3 |     ✓     |
| Trackers            | Alpha     |          1.3 |     ✓     |
| Enumerations        | Alpha     |          2.2 |     ✓     |
| Issue Categories    | Alpha     |          1.3 |     ✓     |
| Roles               | Alpha     |          1.4 |     ✓     |
| Groups              | Alpha     |          2.1 |     ✓     |
| Custom Fields       | Alpha     |          2.4 |     ✓     |
| Search              | Alpha     |          3.3 |    N/A    |

## Links

* Redmine wiki page: http://www.redmine.org/projects/redmine/wiki/Rest_api
* NPM package: https://www.npmjs.com/package/node-redmine


## Notice
+ node-redmine only supports using the [JSON](http://en.wikipedia.org/wiki/JSON) format.

---
_Source: https://npm.io/package/node-redmine · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._