From 33ce86d76154b1ebc7863019c212e29d1da40ec7 Mon Sep 17 00:00:00 2001 From: Yuzu Date: Fri, 29 Jul 2022 17:33:26 -0500 Subject: [PATCH] fix: add readme --- README.md | 53 ++++++++++++++++++++++++++++++++++ assets/icon.png | Bin 0 -> 39216 bytes assets/icon.svg | 75 ++++++++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 128 insertions(+) create mode 100644 assets/icon.png create mode 100644 assets/icon.svg diff --git a/README.md b/README.md index e69de29..6e11862 100644 --- a/README.md +++ b/README.md @@ -0,0 +1,53 @@ +# biscuit + +## A brand new bleeding edge non bloated Discord library + +biscuit + +### Install (for [node18](https://nodejs.org/en/download/)) + +```sh-session +npm install @biscuitland/core +yarn add @biscuitland/core +``` + +for further reading join our [Discord](https://discord.gg/zmuvzzEFz2) + +### Most importantly, biscuit is: + +- A wrapper to interface the Discord api +- A bleeding edge API to contact Discord + +Biscuit is primarily inspired by Discord.js and Discordeno but it does not include a cache layer by default, we believe +that you should not make software that does things it is not supposed to do. + +### Why biscuit?: + +- [Minimal](https://en.wikipedia.org/wiki/Unix_philosophy), non feature-rich! +- Scalable + +### Example bot (TS/JS) + +```js +import { Session, GatewayIntents } from '@biscuitland/core'; + +const intents = GatewayIntents.MessageContent | GatewayIntents.Guilds | GatewayIntents.GuildMessages; +const session = new Session({ token: 'your token', intents }); + +session.events.on('ready', ({ user }) => { + console.log('Logged in as:', user.username); +}); + +session.events.on('messageCreate', (message) => { + if (message.content.startsWith('!ping')) { + message.reply({ content: 'pong!' }); + } +}); + +session.start(); +``` + +### Known issues: +- node18 is required to run the library, however --experimental-fetch flag should work on node16+ +- redis cache (wip) +- no optimal way to deliver a webspec bun version to the registry (#50) diff --git a/assets/icon.png b/assets/icon.png new file mode 100644 index 0000000000000000000000000000000000000000..f122d29aee59edfb1bc8709143c11f1188cf71c6 GIT binary patch literal 39216 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⩔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 KPy-8hi1 + + + + + + + + + + + + + + + +