lemmy-js-client/README.md

53 lines
1.3 KiB
Markdown
Raw Permalink Normal View History

2020-08-19 17:29:37 +00:00
<div align="center">
![GitHub tag (latest SemVer)](https://img.shields.io/github/tag/LemmyNet/lemmy-js-client.svg)
[![GitHub issues](https://img.shields.io/github/issues-raw/LemmyNet/lemmy-js-client.svg)](https://github.com/LemmyNet/lemmy-js-client/issues)
[![License](https://img.shields.io/github/license/LemmyNet/lemmy-js-client.svg)](LICENSE)
![GitHub stars](https://img.shields.io/github/stars/LemmyNet/lemmy-js-client?style=social)
2020-08-19 17:29:37 +00:00
</div>
# lemmy-js-client
2023-06-21 15:40:11 +00:00
A javascript / typescript http client and type system for [Lemmy](https://github.com/LemmyNet/lemmy).
2020-08-19 17:29:37 +00:00
## Installation
`yarn add lemmy-js-client`
## Usage
### HTTP Client
[LemmyHttp docs](https://join-lemmy.org/api/classes/LemmyHttp.html)
2020-08-19 17:29:37 +00:00
```ts
2023-06-21 15:40:11 +00:00
import { LemmyHttp, Login } from 'lemmy-js-client';
let baseUrl = 'https://lemmy.ml';
let client: LemmyHttp = new LemmyHttp(baseUrl, headers?);
2023-06-21 15:40:11 +00:00
let loginForm: Login = {
username_or_email: "my_name",
password: "my_pass",
};
let jwt = await client.login(loginForm).jwt;
```
## Development
You can use [yalc](https://github.com/wclr/yalc) to develop and test changes locally:
```
yarn global add yalc
# Go to lemmy-js-client dir
yalc publish --push
# Go to your client dir
yalc add lemmy-js-client
# To do updates, go back to the lemmy-js-client dir
# This also updates it, in every dir you've added it.
yalc publish --push
```