wishthis/node_modules/@octokit/rest/README.md

68 lines
1.9 KiB
Markdown
Raw Normal View History

2022-01-21 08:28:41 +00:00
# rest.js
> GitHub REST API client for JavaScript
[![@latest](https://img.shields.io/npm/v/@octokit/rest.svg)](https://www.npmjs.com/package/@octokit/rest)
[![Build Status](https://github.com/octokit/rest.js/workflows/Test/badge.svg)](https://github.com/octokit/rest.js/actions?query=workflow%3ATest+branch%3Amaster)
2022-01-21 08:28:41 +00:00
## Usage
2022-01-21 08:28:41 +00:00
<table>
<tbody valign=top align=left>
<tr><th>
Browsers
</th><td width=100%>
Load <code>@octokit/rest</code> directly from <a href="https://cdn.skypack.dev">cdn.skypack.dev</a>
```html
<script type="module">
import { Octokit } from "https://cdn.skypack.dev/@octokit/rest";
</script>
2022-01-21 08:28:41 +00:00
```
</td></tr>
<tr><th>
Node
</th><td>
Install with <code>npm install @octokit/rest</code>
2022-01-21 08:28:41 +00:00
```js
const { Octokit } = require("@octokit/rest");
// or: import { Octokit } from "@octokit/rest";
```
</td></tr>
</tbody>
</table>
```js
2022-01-21 08:28:41 +00:00
const octokit = new Octokit();
// Compare: https://docs.github.com/en/rest/reference/repos/#list-organization-repositories
octokit.rest.repos
2022-01-21 08:28:41 +00:00
.listForOrg({
org: "octokit",
type: "public",
2022-01-21 08:28:41 +00:00
})
.then(({ data }) => {
// handle data
});
```
See https://octokit.github.io/rest.js for full documentation.
2022-01-21 08:28:41 +00:00
## Contributing
We would love you to contribute to `@octokit/rest`, pull requests are very welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for more information.
## Credits
`@octokit/rest` was originally created as [`node-github`](https://www.npmjs.com/package/github) in 2012 by Mike de Boer from Cloud9 IDE, Inc. [The original commit](https://github.blog/2020-04-09-from-48k-lines-of-code-to-10-the-story-of-githubs-javascript-sdk/) is from 2010 which predates the npm registry.
2022-01-21 08:28:41 +00:00
It was adopted and renamed by GitHub in 2017. Learn more about it's origin on GitHub's blog: [From 48k lines of code to 10—the story of GitHubs JavaScript SDK](https://github.blog/2020-04-09-from-48k-lines-of-code-to-10-the-story-of-githubs-javascript-sdk/)
2022-01-21 08:28:41 +00:00
## LICENSE
[MIT](LICENSE)