aboutsummaryrefslogtreecommitdiff
path: root/docs/room.pod6
diff options
context:
space:
mode:
authorMatias Linares <matiaslina@gmail.com>2021-01-11 22:48:16 -0300
committerMatias Linares <matiaslina@gmail.com>2021-01-11 22:48:16 -0300
commitf6397392c4fc88d1e9335bbbc4f91d8cb2f29368 (patch)
treedddb106193d48ca078946d2edb403ef75faca9dd /docs/room.pod6
parent14551a46b61a78a55cacf282e0534a1938215467 (diff)
parent289165e26df8830a15b6df1a63321583a2e67499 (diff)
downloadperl6-matrix-client-f6397392c4fc88d1e9335bbbc4f91d8cb2f29368.tar.gz
Merge branch 'documentation'
Diffstat (limited to 'docs/room.pod6')
-rw-r--r--docs/room.pod6175
1 files changed, 0 insertions, 175 deletions
diff --git a/docs/room.pod6 b/docs/room.pod6
deleted file mode 100644
index f186583..0000000
--- a/docs/room.pod6
+++ /dev/null
@@ -1,175 +0,0 @@
-=begin pod
-
-=TITLE class Matrix::Client::Room
-
-=SUBTITLE Room requester
-
- class Matrix::Client::Room does Matrix::Client::Requester {}
-
-The C<Matrix::Client::Room> is a shortcut to all the C</rooms/:id> endpoints. It
-does the role as L<Matrix::Client::Requester> so one can instantiate a Room with
-the one's access token and the room id to make requests directly to this room
-without the need for a L<Matrix::Client>.
-
-=head1 Example
-
- my $room-id = "!pGOClvZafMH:matrix.server.com";
- my $home-server = "https://matrix.server.com";
- my $access-token = "…";
-
- my Matrix::Client::Room $room .= new(
- :$access-token,
- :$home-server,
- :id($room-id)
- );
-
- say $room.name;
-
-=head1 Methods
-
-=head2 name
-
- method name(--> Str)
-
-Returns the name of the room. If no C<m.room.name> was emmited (i.e.: no name
-was set for this room), then an empty string is returned.
-
-=head2 fallback-name
-
- method fallback-name(--> Str)
-
-Return a name for the room with the members of the room. Use this if
-the room doesn't have a name set or in 1-1 chats.
-
-Example:
-
- my $room = Matrix::Client::Room $room .= new(
- :$access-token, :$home-server, :id('#34df12:matrix.org')
- );
- say 'Room name: ' ~ $room.name # OUTPUT: «Room name: »
- say 'Room name: ' ~ $room.fallback-name # OUTPUT: «Room name: Alice and Bob»
-
-=head2 aliases
-
- method aliases(--> List)
-
-Get a list of aliases maintained by the local server for the given room.
-
-=head2 event
-
- method event(Str $event-id --> Matrix::Response::RoomEvent)
-
-Get a single event based on the C<$event-id>. Returns a L<Matrix::Response::RoomEvent>.
-
-=head2 state
-
- multi method state(--> Seq)
- multi method state(Str $event-type, Str $state-key = "")
-
-Get the state events for the current state of a room. it will return a C<Seq>
-for every event on that room.
-
-If an C<$event-type> is passed, the return value will be the value of that
-single event.
-
-C<$state-key> is the key of the state to look up.
-
-=head2 joined-members
-
- method joined-members()
-
-Returns the data for the members of the room.
-
-Example:
-
- my $room = Matrix::Client::Room $room .= new(
- :$access-token, :$home-server, :id('#34df12:matrix.org')
- );
- my $member = $room.joined-members.head;
- # the key is the matrix id
- say $member.key # OUTPUT: «@meeple:matrix.deprecated.org»
- say $member.values<avatar_url> # OUTPUT: «mxc://matrix.deprecated.org/NdSvF..»
- say $member.values<display_name> # OUTPUT: «meeple»
-
-=head2 messages
-
- method messages(
- Str:D :$from!, Str :$to,
- Str :$dir where * eq 'f'|'b' = 'f',
- Int :$limit = 10, :%filter
- --> Matrix::Response::Messages
- )
-
-Return a L<Matrix::Response::Messages> with the messages from
-C<$from>. This token can be obtained from a C<prev_batch> token
-returned for each room by the sync API, or from a C<start> or C<end>
-attributes from L<Matrix::Response::Messages>.
-
-=head2 members
-
- method members(:$at, Str :$membership, Str :$not-membership --> Seq)
-
-Get the list of members for this room. This returns a C<Seq> of
-L<Matrix::Response::MemberEvent>.
-
-=head2 send
-
- method send(Str $body!, Str :$type? = "m.text")
-
-Sends a message to the room. It will return the C<event_id> for this message.
-
-=head2 send-state
-
- method send-state(Str:D $event-type, :$state-key = "", *%args --> Str)
-
-Send a state event to the server. The event will be overwritten if the
-C<$event-type>, C<$state-key> and the arguments all match with a state in the
-server.
-
-It will return the C<event_id> for this state change.
-
-=head2 invite
-
- method invite(Str $user-id)
-
-Invite a user to the room.
-
-=head2 join
-
- method join()
-
-Join the room. As the creation of the C<Matrix::Client::Room> expects
-a room id (C<#032mf90f:matrix.org> for example), you need to use the
-L<join-room> method of C<Matrix::Client> to join by an alias.
-
-=head2 leave
-
- method leave()
-
-Leaves the room.
-
-=head2 forget
-
- method forget()
-
-Stop a user of remembering this particular room.
-
-=head2 kick
-
- method kick(Str $user-id, Str $reason = "")
-
-Kick an user of this room.
-
-=head2 ban
-
- method ban(Str $user-id, $reason = "")
-
-Ban an user of this room.
-
-=head2 unban
-
- method unban(Str $user-id)
-
-Unban a user of this room.
-
-=end pod