Rawger

<h1 align="center">rawger</h1> <p align="center"> <strong>⚔ rawg.io api client ⚔</strong><br /> <small>An easy to use client with built-in caching</small> </p> <p align="center"> <a href="https://www.npmjs.com/package/rawger"> <img src="https://img.shields.io/npm/v/rawger.svg?style=flat-square" /> </a> <a href="https://www.npmjs.com/package/rawger"> <img src="https://img.shields.io/npm/dm/rawger.svg?style=flat-square" /> </a> <a href="https://snyk.io/test/github/orels1/rawger?targetFile=package.json"> <img src="https://snyk.io/test/github/orels1/rawger/badge.svg?targetFile=package.json&style=flat-square" alt="Known Vulnerabilities" data-canonical-src="https://snyk.io/test/github/orels1/rawger?targetFile=package.json" style="max-width:100%;"> </a> <img src="https://img.shields.io/badge/100%25-unofficial-blue.svg?style=flat-square" /> </p> <p align="center"> _{Built with ❤︎ by <a href="https://twitter.com/orels1_">orels1</a>} </p>

Installation

# with npm
npm i --save rawger

#with yarn
yarn add rawger

Documentation

Full documentation is available here

Usage Examples

Check examples folder for more usage examples

Unauthenticated client

const Rawger = require('rawger');

// initialize rawger with default 60s cache
// you can supply a different timeout (check examples folder)
// or use rawger.purgeCache(); to force-clear the cache altogether
// ⚠ starting with v1.1 you need to always await the init process
const rawger = await Rawger();
const { users } = rawger;

// get "Currently Playing" games for user
const playing = (await users('orels1').games('playing')).get();

// get count of owned games
const owned = (await users('orels1').games('owned')).count();

// get raw api response object for "Want to Play" games
const raw = (await users('orels1').games('toplay')).raw();

// get user profile
const profile = (await users('orels1').profile()).get();

Authenticated client

You can also initialize an authenticated client to perform such actions as game status updates, reviews publishing and so on.

const Rawger = require('rawger');

// make sure to `await` the init process
const rawger = await Rawger({
  email: 'some@email.com',
  password: 'do-not-share-this'
});
const { users } = rawger;

// set FarCry 5 to "Currently Playing" for current account
await users('orels1').update().game('23585', { status: 'playing'});