Class: Discorb::ThreadChannel Abstract

Inherits:
Channel show all
Includes:
Messageable
Defined in:
lib/discorb/channel.rb

Overview

This class is abstract.

Represents a thread.

Direct Known Subclasses

Private, Public

Defined Under Namespace

Classes: Member, Private, Public

Class Attribute Summary collapse

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods included from Messageable

#fetch_message, #fetch_messages, #post, #typing

Methods inherited from Channel

#==, #type

Methods inherited from DiscordModel

#==, #eql?, #hash

Class Attribute Details

.channel_type -> Object (readonly)

Returns the value of attribute channel_type.



987
988
989
 
# File 'lib/discorb/channel.rb', line 987

def channel_type
  @channel_type
end

Instance Attribute Details

#archived -> Boolean (readonly) Also known as: archived?

Returns Whether the thread is archived or not.

Returns:

  • (Boolean) —

    Whether the thread is archived or not.



821
822
823
 
# File 'lib/discorb/channel.rb', line 821

def archived
  @archived
end

#archived_timestamp -> Time? (readonly) Also known as: archived_at

Returns:

  • (Time) —

    The time the thread was archived.

  • (nil) —

    If the thread is not archived.



815
816
817
 
# File 'lib/discorb/channel.rb', line 815

def archived_timestamp
  @archived_timestamp
end

#auto_archive_duration -> Integer (readonly) Also known as: archive_in

Returns Auto archive duration in seconds.

Returns:

  • (Integer) —

    Auto archive duration in seconds.



818
819
820
 
# File 'lib/discorb/channel.rb', line 818

def auto_archive_duration
  @auto_archive_duration
end

#id -> Discorb::Snowflake (readonly)

Note:

This ID is same as the starter message's ID

Returns The ID of the channel.

Returns:



798
799
800
 
# File 'lib/discorb/channel.rb', line 798

def id
  @id
end

#member_count -> Integer (readonly) Also known as: recipient_count

Note:

This will stop counting at 50.

Returns The number of recipients in the thread.

Returns:

  • (Integer) —

    The number of recipients in the thread.



806
807
808
 
# File 'lib/discorb/channel.rb', line 806

def member_count
  @member_count
end

#members -> Array<Discorb::ThreadChannel::Member> (readonly)

Returns The members of the thread.

Returns:



812
813
814
 
# File 'lib/discorb/channel.rb', line 812

def members
  @members
end

#message_count -> Integer (readonly)

Note:

This will stop counting at 50.

Returns The number of messages in the thread.

Returns:

  • (Integer) —

    The number of messages in the thread.



803
804
805
 
# File 'lib/discorb/channel.rb', line 803

def message_count
  @message_count
end

#name -> String (readonly)

Returns The name of the thread.

Returns:

  • (String) —

    The name of the thread.



800
801
802
 
# File 'lib/discorb/channel.rb', line 800

def name
  @name
end

#rate_limit_per_user -> Integer (readonly) Also known as: slowmode

Returns The rate limit per user (slowmode) in the thread.

Returns:

  • (Integer) —

    The rate limit per user (slowmode) in the thread.



809
810
811
 
# File 'lib/discorb/channel.rb', line 809

def rate_limit_per_user
  @rate_limit_per_user
end

Instance Method Details

#add_member(member = :me) -> Object Also known as: join 



947
948
949
950
951
952
953
954
955
 
# File 'lib/discorb/channel.rb', line 947

def add_member(member = :me)
  Async do
    if member == :me
      @client.internet.post("/channels/#{@id}/thread-members/@me").wait
    else
      @client.internet.post("/channels/#{@id}/thread-members/#{Utils.try(member, :id)}").wait
    end
  end
end

#archive(reason: nil) -> self

Helper method to archive the thread.

Parameters:

  • reason (String) (defaults to: nil) —

    The reason of archiving the thread.

Returns:

  • (self) —

    The archived thread.



880
881
882
 
# File 'lib/discorb/channel.rb', line 880

def archive(reason: nil)
  edit(archived: true, reason: reason)
end

#edit(name: :unset, archived: :unset, auto_archive_duration: :unset, archive_in: :unset, locked: :unset, reason: nil) -> self

Note:

This is an asynchronous method, it will return a Async::Task object. Use Async::Task#wait to get the result.

Note:

This method calls HTTP request.

Note:

The arguments of this method are defaultly set to :unset. Specify value to set the value, if not don't specify or specify :unset.

Edit the thread.

Parameters:

  • name (String) (defaults to: :unset) —

    The name of the thread.

  • archived (Boolean) (defaults to: :unset) —

    Whether the thread is archived or not.

  • auto_archive_duration (Integer) (defaults to: :unset) —

    The auto archive duration in seconds.

  • archive_in (Integer) (defaults to: :unset) —

    Alias of auto_archive_duration.

  • locked (Boolean) (defaults to: :unset) —

    Whether the thread is locked or not.

  • reason (String) (defaults to: nil) —

    The reason of editing the thread.

Returns:

  • (self) —

    The edited thread.

Raises:

See Also:



860
861
862
863
864
865
866
867
868
869
870
871
 
# File 'lib/discorb/channel.rb', line 860

def edit(name: :unset, archived: :unset, auto_archive_duration: :unset, archive_in: :unset, locked: :unset, reason: nil)
  Async do
    payload = {}
    payload[:name] = name if name != :unset
    payload[:archived] = archived if archived != :unset
    auto_archive_duration ||= archive_in
    payload[:auto_archive_duration] = auto_archive_duration if auto_archive_duration != :unset
    payload[:locked] = locked if locked != :unset
    @client.internet.patch("/channels/#{@id}", payload, audit_log_reason: reason).wait
    self
  end
end

#fetch_members -> Object 



971
972
973
974
975
976
 
# File 'lib/discorb/channel.rb', line 971

def fetch_members
  Async do
    _resp, data = @client.internet.get("/channels/#{@id}/thread-members").wait
    data.map { |d| @members[d[:id]] = Member.new(@client, d) }
  end
end

#guild -> Object 



935
936
937
 
# File 'lib/discorb/channel.rb', line 935

def guild
  @client.guilds[@guild]
end

#inspect -> Object 



943
944
945
 
# File 'lib/discorb/channel.rb', line 943

def inspect
  "#<#{self.class} \"##{@name}\" id=#{@id}>"
end

#joined? -> Boolean

Returns:

  • (Boolean) 


931
932
933
 
# File 'lib/discorb/channel.rb', line 931

def joined?
  @members[@client.user.id]
end

#lock(reason: nil) -> self

Helper method to lock the thread.

Parameters:

  • reason (String) (defaults to: nil) —

    The reason of locking the thread.

Returns:

  • (self) —

    The locked thread.



891
892
893
 
# File 'lib/discorb/channel.rb', line 891

def lock(reason: nil)
  edit(archived: true, locked: true, reason: reason)
end

#me -> Object 



927
928
929
 
# File 'lib/discorb/channel.rb', line 927

def me
  @members[@client.user.id]
end

#owner -> Object 



939
940
941
 
# File 'lib/discorb/channel.rb', line 939

def owner
  guild.members[@owner_id]
end

#parent -> Object Also known as: channel 



919
920
921
922
923
 
# File 'lib/discorb/channel.rb', line 919

def parent
  return nil unless @parent_id

  @client.channels[@parent_id]
end

#remove_member(member = :me) -> Object Also known as: leave 



959
960
961
962
963
964
965
966
967
 
# File 'lib/discorb/channel.rb', line 959

def remove_member(member = :me)
  Async do
    if member == :me
      @client.internet.delete("/channels/#{@id}/thread-members/@me").wait
    else
      @client.internet.delete("/channels/#{@id}/thread-members/#{Utils.try(member, :id)}").wait
    end
  end
end

#unarchive(reason: nil) -> self

Helper method to unarchive the thread.

Parameters:

  • reason (String) (defaults to: nil) —

    The reason of unarchiving the thread.

Returns:

  • (self) —

    The unarchived thread.



902
903
904
 
# File 'lib/discorb/channel.rb', line 902

def unarchive(reason: nil)
  edit(archived: false, reason: reason)
end

#unlock(reason: nil) -> self

Note:

This method won't unarchive the thread. Use #unarchive instead.

Helper method to unlock the thread.

Parameters:

  • reason (String) (defaults to: nil) —

    The reason of unlocking the thread.

Returns:

  • (self) —

    The unlocked thread.



915
916
917
 
# File 'lib/discorb/channel.rb', line 915

def unlock(reason: nil)
  edit(archived: !unarchive, locked: false, reason: reason)
end