lib_discord 0.1.3 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 57a15b2c5d63537507c03eb8a27b82109dfbb39b896abd2f5f3f99a3efbed9d7
-  data.tar.gz: 20da6149a1f5f5dd9dd4c46c23640a812c1dc2b0491f1d57bfba748e47cd0c45
+  metadata.gz: 6c677b5a4584d13d77314c8c92f7edbeef2a1d95d09e0aa5e3b575d94a0c05c1
+  data.tar.gz: aec4498155ca2ee500e209d4110f3ee3082b86340f079e9e9ec9db606bb72c85
 SHA512:
-  metadata.gz: ac7343653e27eb689a3ae6d336c2256938f002f91913fd8984b54f3ea4966d41ff987e56ab5c839f0a911af70f1dfb4e1646fe9167d80193bba80d6f9d42d3ea
-  data.tar.gz: 29a0bea3585f679e6f39a6c68885fe283cd191e83b22ca45baebaa82433f67449d9eef64bd9e018d9eee61e3dd6413607c681eef30767a726fa3c6d68d289090
+  metadata.gz: 12e1ce987f5151afc5361a23be89fa56fb53f83409cab4fd2d1b39635eedecc573c89b41351caf13a477c22375d32b38f36d99f29d15f3ade3b7363641801997
+  data.tar.gz: 1d7ced417a81d559a71f14ba8295e025a760b449e5810fb352063dfcc8ed3df7690eecd29349ab3c62cbc24c8a3d28933825b5eec0838406362bcb4f99f09619

data/CONTRIBUTING.md

@@ -0,0 +1,88 @@
+# CONTRIBUTING
+
+[project]: https://sr.ht/~komidore64/lib_discord
+[sources]: https://sr.ht/~komidore64/lib_discord/sources
+[mailing lists]: https://sr.ht/~komidore64/lib_discord/lists
+[bug tracker]: https://todo.sr.ht/~komidore64/lib_discord
+
+Bug reports and patch submissions are welcome on SourceHut via the [bug
+tracker] and [mailing lists], respectively.
+
+## Code of Conduct
+
+Everyone interacting in the lib_discord project's codebases, bug trackers, chat
+rooms, and mailing lists is expected to follow the [code of
+conduct](https://git.sr.ht/~komidore64/lib_discord/tree/main/item/CODE_OF_CONDUCT.md).
+
+## Necessary Development Tools
+
+### Ruby Runtime
+
+lib_discord is written in Ruby. A Ruby runtime is required. Our recommendation
+is to use [asdf](https://asdf-vm.com/) and
+[asdf-ruby](https://github.com/asdf-vm/asdf-ruby) to manage your local ruby
+installation.
+
+## Code Style
+
+This project adheres to [Standard Ruby](https://github.com/standardrb/standard)
+style rules.
+
+Additionally, we strive for an 80 character line length, but it's not a
+hard-and-fast rule. There are occasions where breaking an expression across
+multiple lines makes it more difficult to understand. In these instances the
+line breaks do nothing more than appease a linter. As such, there is no
+automated tooling to enforce an 80 character line length. Favor readability.
+
+## Submitting Patches
+
+We respect the intellectual property rights of others and want to ensure all
+incoming contributions are attributed and licensed. The DCO is a declaration
+attached to every contribution made by every developer. In the commit message,
+the developer adds a `Signed-off-by` trailer ([`git commit -s`]) to sign that
+they agree to the DCO. The contents of the agreement can be found below, or at
+[DeveloperCertificate.org](https://developercertificate.org/).
+
+[`git commit -s`]: https://git-scm.com/docs/git-commit#Documentation/git-commit.txt--s
+
+```
+Developer Certificate of Origin
+Version 1.1
+
+Copyright (C) 2004, 2006 The Linux Foundation and its contributors.
+
+Everyone is permitted to copy and distribute verbatim copies of this
+license document, but changing it is not allowed.
+
+
+Developer's Certificate of Origin 1.1
+
+By making a contribution to this project, I certify that:
+
+(a) The contribution was created in whole or in part by me and I
+    have the right to submit it under the open source license
+    indicated in the file; or
+
+(b) The contribution is based upon previous work that, to the best
+    of my knowledge, is covered under an appropriate open source
+    license and I have the right under that license to submit that
+    work with modifications, whether created in whole or in part
+    by me, under the same open source license (unless I am
+    permitted to submit under a different license), as indicated
+    in the file; or
+
+(c) The contribution was provided directly to me by some other
+    person who certified (a), (b) or (c) and I have not modified
+    it.
+
+(d) I understand and agree that this project and the contribution
+    are public and that a record of the contribution (including all
+    personal information I submit with it, including my sign-off) is
+    maintained indefinitely and may be redistributed consistent with
+    this project or the open source license(s) involved.
+```
+
+We require that every contribution to lib_discord is signed with a Developer
+Certificate of Origin. Please use your real name or a pseudonym, and an email
+address at which you may be contacted in the future if the (unlikely) need
+arises. Patches submitted without a signed DCO **will not be accepted**.

data/README.md

@@ -5,26 +5,26 @@
 [mailing lists]: https://sr.ht/~komidore64/lib_discord/lists
 [bug tracker]: https://todo.sr.ht/~komidore64/lib_discord
 
-Unfancy Ruby-bindings to interact with Discord's HTTPS/REST web API.
+Straightforward Ruby-bindings for Discord's Web API
 
 [project] -- [sources] -- [mailing lists] -- [bug tracker]
 
+[![Please don't upload to GitHub](https://nogithub.codeberg.page/badge.svg)](https://nogithub.codeberg.page)
 [![builds.sr.ht status](https://builds.sr.ht/~komidore64/lib_discord/commits/main/.build.yml.svg)](https://builds.sr.ht/~komidore64/lib_discord/commits/main/.build.yml)
 [![Gem Version](https://badge.fury.io/rb/lib_discord.svg)](https://rubygems.org/gems/lib_discord)
 
 ## Installation
 
 `lib_discord` requires an installed [Ruby runtime](https://www.ruby-lang.org/)
-`>= 3.2`.
+`>= 3.3`.
 
-Install the gem and add to the application's Gemfile by executing:
+Install the gem and add it to your application's Gemfile:
 
 ```sh
 bundle add lib_discord
 ```
 
-If bundler is not being used to manage dependencies, install the gem by
-executing:
+If bundler is not being used to manage dependencies, install the gem with:
 
 ```sh
 gem install lib_discord
@@ -32,91 +32,64 @@ gem install lib_discord
 
 ## Usage
 
+Use the Client for communicating with Discord's web endpoints
+
 ```ruby
 require "lib_discord"
-client = LibDiscord::Client.new("Bot my.amazing.bot.token")
+
+client = LibDiscord.client("Bot my.amazing.bot.token") # => LibDiscord::Client
+resp = client.create_message("<channel_id>", {content: "Hi, Mom!"}) # => LibDiscord::Response
+resp.success? # => true
 ```
 
-Access resource types with `#[]` syntax:
+Compare permissions:
 
 ```ruby
-client.keys
-# =>
-# ["application",
-#  "application_command",
-#  "application_role_connection_metadata",
-#  "audit_log",
-#  "auto_moderation",
-#  "channel",
-#  "emoji",
-#  "guild",
-#  "guild_scheduled_event",
-#  "guild_template",
-#  "interaction",
-#  "invite",
-#  "poll",
-#  "stage_instance",
-#  "sticker",
-#  "user",
-#  "voice",
-#  "webhook"]
-
-client["application"]
-# => #<LibDiscord::Application: ... >
-```
+p = LibDiscord.permissions # => Hash
 
-Use resources to make requests to Discord's API. LibDiscord resources are
-mapped to the "Resources" described in [Discord's developer documentation].
+my_permissions = p[:SEND_MESSAGES] + p[:ADD_REACTIONS] # => 2112
 
-```ruby
-resp = client["guild"].get_guild_channels(guild_id: "12345678901234567890")
+# Check for permission flags that are set.
+my_permissions & p[:SEND_MESSAGES] == p[:SEND_MESSAGES] # => true
 
-resp.code
-# => 200
+# Check for permission flags that are not set.
+my_permissions & p[:KICK_MEMBERS] == p[:KICK_MEMBERS] # => false
+```
+
+Use maps for Discord's encoded values:
 
-resp.headers
-# => Hash of HTTP response headers
+```ruby
+aco_types = LibDiscord.maps[:ApplicationCommand][:OptionTypes] # => Hash
+aco_types[:CHANNEL] # => 7
+```
 
-resp.body_parsed
-# => JSON body deserialized to a Hash
+Format Discord specific objects to render in messages:
 
-resp.body_raw
-# => raw response body in String form
+```ruby
+fmt = LibDiscord.formatter
+fmt.user(12345678) # => "<@12345678>"
 ```
 
-[Discord's developer documentation]: https://discord.com/developers/docs
+See [documentation](https://rdoc.info/gems/lib_discord) for more details.
 
 ## Getting help
 
-Please use the [mailing lists] if you have questions or need help.
+Please use the [mailing lists] if you have questions or need assistance.
 
 ## Contributing
 
 Bug reports and patch submissions are welcome on SourceHut via the [bug
 tracker] and [mailing lists], respectively. This project is intended to be a
-safe, welcoming space for collaboration, and contributors are expected to
-adhere to the [code of conduct].
-
-[code of conduct]: https://git.sr.ht/~komidore64/lib_discord/tree/main/item/CODE_OF_CONDUCT.md
-
-### Code style
-
-This project adheres to [Standard Ruby] style rules.
+safe and welcoming space for collaboration. All participants are expected to
+adhere to the [code of
+conduct](https://git.sr.ht/~komidore64/lib_discord/tree/main/item/CODE_OF_CONDUCT.md).
 
-Additionally, we strive for an 80 character line length, but it's not a
-hard-and-fast rule. There are occasions where breaking an expression across
-multiple lines decreases readability for no benefit other than to appease a
-linter. As such, there is no tool to enforce an 80 character line length.
-
-[Standard Ruby]: https://github.com/standardrb/standard
-
-## Code of Conduct
-
-Everyone interacting in the `lib_discord` project's codebase, bug trackers,
-chat rooms, and mailing lists is expected to follow the [code of conduct].
+See
+[CONTRIBUTING.md](https://git.sr.ht/~komidore64/lib_discord/tree/main/item/CONTRIBUTING.md)
+for more details.
 
 ## Licenses
 
-See files in the [LICENSES] directory.
-
-[LICENSES]: https://git.sr.ht/~komidore64/lib_discord/tree/main/item/LICENSES/
+See files in the
+[LICENSES/](https://git.sr.ht/~komidore64/lib_discord/tree/main/item/LICENSES)
+directory.