discorb 0.11.3 → 0.12.2

data/lib/discorb/modules.rb

@@ -142,6 +142,48 @@ module Discorb
       end
     end
 
+    #
+    # Fetch the pinned messages in the channel.
+    # @macro async
+    # @macro http
+    #
+    # @return [Async::Task<Array<Discorb::Message>>] The pinned messages in the channel.
+    #
+    def fetch_pins
+      Async do
+        _resp, data = @client.http.get("/channels/#{channel_id.wait}/pins").wait
+        data.map { |pin| Message.new(@client, pin) }
+      end
+    end
+
+    #
+    # Pin a message in the channel.
+    # @macro async
+    # @macro http
+    #
+    # @param [Discorb::Message] message The message to pin.
+    # @param [String] reason The reason of pinning the message.
+    #
+    def pin_message(message, reason: nil)
+      Async do
+        @client.http.put("/channels/#{channel_id.wait}/pins/#{message.id}", {}, audit_log_reason: reason).wait
+      end
+    end
+
+    #
+    # Unpin a message in the channel.
+    # @macro async
+    # @macro http
+    #
+    # @param [Discorb::Message] message The message to unpin.
+    # @param [String] reason The reason of unpinning the message.
+    #
+    def unpin_message(message, reason: nil)
+      Async do
+        @client.http.delete("/channels/#{channel_id.wait}/pins/#{message.id}", audit_log_reason: reason).wait
+      end
+    end
+
     #
     # Trigger the typing indicator in the channel.
     # @macro async

data/lib/discorb/user.rb

@@ -26,6 +26,9 @@ module Discorb
 
     include Discorb::Messageable
 
+    # @!attribute [r] mention
+    #   @return [String] The user's mention.
+
     # @private
     def initialize(client, data)
       @client = client
@@ -43,6 +46,10 @@ module Discorb
       "#{@username}##{@discriminator}"
     end
 
+    def mention
+      "<@#{@id}>"
+    end
+
     alias to_s_user to_s
 
     def inspect

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: discorb
 version: !ruby/object:Gem::Version
-  version: 0.11.3
+  version: 0.12.2
 platform: ruby
 authors:
 - sevenc-nanashi
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2021-10-17 00:00:00.000000000 Z
+date: 2021-10-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: async
@@ -77,11 +77,13 @@ files:
 - ".github/ISSUE_TEMPLATE/bug_report.md"
 - ".github/ISSUE_TEMPLATE/config.yml"
 - ".github/ISSUE_TEMPLATE/feature_request.md"
+- ".github/PULL_REQUEST_TEMPLATE.md"
 - ".github/workflows/build_main.yml"
 - ".github/workflows/build_version.yml"
 - ".github/workflows/package_register.yml"
 - ".gitignore"
 - ".yardopts"
+- CONTRIBUTING.md
 - Changelog.md
 - Gemfile
 - LICENSE.txt
@@ -161,6 +163,11 @@ files:
 - lib/discorb/integration.rb
 - lib/discorb/intents.rb
 - lib/discorb/interaction.rb
+- lib/discorb/interaction/autocomplete.rb
+- lib/discorb/interaction/command.rb
+- lib/discorb/interaction/components.rb
+- lib/discorb/interaction/response.rb
+- lib/discorb/interaction/root.rb
 - lib/discorb/invite.rb
 - lib/discorb/log.rb
 - lib/discorb/member.rb