Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/lasuillard/raindrop-client

Axios client built with OpenAPI generator for Raindrop.io ☔
https://github.com/lasuillard/raindrop-client

axios openapi openapi-generator raindrop-io typescirpt

Last synced: 19 days ago
JSON representation

Axios client built with OpenAPI generator for Raindrop.io ☔

Awesome Lists containing this project

README

        

# raindrop-client

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![CI](https://github.com/lasuillard/raindrop-client/actions/workflows/ci.yaml/badge.svg)](https://github.com/lasuillard/raindrop-client/actions/workflows/ci.yaml)
[![codecov](https://codecov.io/gh/lasuillard/raindrop-client/graph/badge.svg?token=bPq2geqXLe)](https://codecov.io/gh/lasuillard/raindrop-client)
[![NPM Version](https://img.shields.io/npm/v/%40lasuillard%2Fraindrop-client)](https://www.npmjs.com/package/@lasuillard/raindrop-client)

Axios client built with OpenAPI generator for Raindrop.io ☔

## ✨ Features

Primary features and goals are:

- Provide unofficial OpenAPI schema for Raindrop.io
- Fill the gap between official documentation and reality(response) with schema testing
- Generated client package for Axios with extra functionalities

## 🚀 Installation

If you wish to use client package, install it:

```bash
$ npm install @lasuillard/raindrop-client
```

## 🛠️ Generate your own client

You can use OpenAPI schema in this repository to generate your own client. Following is example using [openapitools/openapi-generator-cli](https://www.npmjs.com/package/@openapitools/openapi-generator-cli):

```bash
$ yarn global add @openapitools/openapi-generator-cli
$ openapi-generator-cli generate -i https://raw.githubusercontent.com/lasuillard/raindrop-client/main/openapi.yaml -g typescript-axios --skip-validate-spec -o ./out
```

You may need Java installed as openapi-generator-cli uses it.

## 💖 Contributing

Dev Containers configured and ready to use. Detailed installation steps and requirements will not be described here.

## 📜 License

This project is licensed under the terms of the MIT license.