Net::Vypress::Chat 0.72.1

Net::Vypress::Chat is object oriented module and can only be used this way. What's about recognise() function i tried to stay as consistent as i can, but some values are mixed up. Module has these methods:<br />new()<br /><br />Initialises new instance of module. Sets these variables (if not explained: 0 - off, 1 - on):<br /><br />nick - your nick.<br />autoanswer - auto answer for messages<br />active - current active state. Default: 1<br /><br /> * 0 - not active;<br /> * 1 - active;<br /><br />send_info - automaticaly send info about this client. Default: 1<br />sign_topic - automaticaly sign topic. Default: 1<br />gender - current gender. Is not used, but it is in protocol. Also it seems that Vypress Chat 1.9 has preference for that. Default: 0<br /><br /> * 0 - male<br /> * 1 - female<br /><br />status - current status. Default: 0<br /><br /> * 0 - Active<br /> * 1 - Do Not Disturb<br /> * 2 - Away<br /> * 3 - Offline<br /><br />port - UDP port to bind on. Default: 8167<br />localip - local IP address broadcast to. Used for multihomed hosts. Default: gets current canonical hostname (like my.host.net) and converts it into ip address. If it cannot do that or you don't have canonical hostname set up it will be set to '127.0.0.1'. Note: module cannot function properly in such mode and you will be warned in console. Also $vyc->{bad_ip} variable will be set to 1.<br />host - your hostname. Defaults to: hostname()<br />debug - debug level. Debug messages are printed to STDOUT. Default: 0<br /><br /> * 0 - no debug<br /> * 1 - actions level.<br /> * 2 - protocol level.<br /><br />uc_fail - toggles sending thru broadcast socket when unicast socket fails (ip cannot be found). Default: 1.<br />use_unicast - toggles using unicast. Default: 0 'cause of buggy unicast code for now.<br />coll_avoid - toggle nick collision evasion. If someone changes nick to your nickname modules will prepend number. Default: 1.<br /><br />init_users()<br /><br />Reinitialises userlist, but leaves information about self.<br /><br />E.g.: $vyc->init_users();<br />change_net($port, $localip)<br /><br />Function to change network/port combination on the fly.<br /><br />E.g.: $vyc->change_net(8168, '10.0.0.1');<br />nick($nick)<br /><br />Changes your nickname that is being held in $object->{'nick'}. Truncates it to 20 characters (maximum in protocol) and broadcasts it if module is initialised.<br /><br />E.g.: $vyc->nick("SimpleGuy");<br />num2status($status)<br /><br />Translates numeric status to word status. Mainly used in module itself.<br /><br />E.g.: $vyc->num2status(0) would return Available.<br />num2active($active)<br /><br />Does same as num2status(), but with active state.<br /><br />E.g.: $vyc->num2active(1) would return Active.<br />who()<br /><br />Asks who is here in LAN. Used to build user lists.<br /><br />E.g.: $vyc->who();<br />remote_exec($to, $command, $password)<br /><br />Sends remote execution request.<br /><br />E.g.: $vyc->remote_exec("OtherGuy", "iexplore.exe", "secret");<br />remote_exec_ack($to, $execution_text)<br /><br />Returns execution status to requester.<br /><br />E.g.: $vyc->remote_exec_ack('OtherGuy', 'Some text');<br />sound_req($channel, $filename)<br /><br />Send sound request to channel.<br /><br />E.g.: $vyc->sound_req("#Main", 'clap.wav');<br />me($channel, $chat_string)<br /><br />Send chat string to channel in /me fashion.<br /><br />E.g.: $vyc->me("#Main", "jumps around.");<br />chat($channel, $chat_string)<br /><br />Sends chat string to channel.<br /><br />E.g.: $vyc->chat("#Main", "Hello!");<br />join($channel)<br /><br />Joins channel and adds it to channel list.<br /><br />E.g.: $vyc->join("#Main");<br />part($channel)<br /><br />Parts channel and deletes it from channel list.<br /><br />E.g.: $vyc->part("#Main");<br />topic($channel, $topic)<br /><br />Changes topic on channel. Adds your nick in ().<br /><br />E.g.: $vyc->topic("#Main", "Hi folks") would give this topic - "Hi folks (SimpleGuy)".<br />msg($to, $message)<br /><br />Sends message to person.<br /><br />E.g.: $vyc->msg("John", "Hello there...");<br />mass($message)<br /><br />Sends message to all people in userlist. The message is marked as multi-user message.<br /><br />E.g.: $vyc->mass("Hi everyone, I'm back.");<br />mass_to(@to, $message)<br /><br />Sends message to people in array. The message is marked as multi-user message.<br /><br />E.g.: $vyc->mass(('John', 'Paul'), "Hi everyone, I'm back.");<br />status($status, $autoanswer)<br /><br />Changes your status into one of four states mentioned in new() and sets your autoanswer to messages.<br /><br />E.g.: $vyc->status(0, "I like core dumps (C) zed");<br />active($activity)<br /><br />Sets your activity. See new().<br /><br />E.g.: $vyc->active(1);<br />beep($to)<br /><br />Beeps user.<br /><br />E.g.: $vyc->beep('OtherGuy');<br />chanlist()<br /><br />Requests channel list. Todo: Maybe specification is bad? Don't use it for now.<br /><br />E.g.: $vyc->chanlist();<br />info($user)<br /><br />Asks user to give his information.<br /><br />E.g.: $vyc->info("John");<br />info_ack($to)<br /><br />Sends user your information.<br /><br />E.g.: $vyc->info_ack("John");<br /><br />By default module sends following information automatically whenever requested by another client (see new()):<br /><br />host - see new();<br />user - gets enviroment variable USER;<br />channel list - gets it from $self->{users}{$self->{nick}}{channels};<br />auto answer - gets it from $self->{users}{$self->{nick}}{autoanswer}<br /><br />info_ack($to, $host, $ip, $user, $autoanswer, $channels)<br /><br />If you turn off send_info variable (see new()) module won't send any information automatically. Then you can access this method to generate answer for information request.<br /><br />Channels variable can have these values:<br /><br /> * 1 - send actual channel list<br /> * 0 - send nothing but #Main<br /> * array - array of channels.<br /><br />E.g.: $vyc->info_ack("John", "made.up.host", "user", "1.2.3.4", "autoanswer", ('#Main'));<br />pjoin($user)<br /><br />Joins to private chat.<br /><br />E.g.: $vyc->pjoin("John");<br />ppart($user)<br /><br />Parts private chat.<br /><br />E.g.: $vyc->ppart("John");<br />pchat($user, $text)<br /><br />Sends string to private chat.<br /><br />E.g.: $vyc->pchat("John", "Some message");<br />pme($user, $text)<br /><br />Sends /me action to private chat.<br /><br />E.g.: $vyc->pme("John", "Some action");<br />startup()<br /><br />Initialises two sockets (send and listen) for sending UDP messages and getting them. Also joins channel #Main and requests who list.<br /><br />E.g.: $vyc->startup;<br />shutdown()<br /><br />Ends module job. Exits all channels and closes all sockets.<br /><br />E.g.: $vyc->shutdown();<br />on_chan($channel)<br /><br />Checks if you are on some specific channel.<br /><br />E.g.: $vyc->on_chan("#Main") would return 1.<br />on_chan($nick, $channel)<br /><br />Checks if someone are on some specific channel.<br />on_priv($person)<br /><br />Checks if you are in private chat with someone.<br /><br />E.g.: $vyc->on_priv("John") would return 1 if you were in chat with John.<br />on_userlist($user)<br /><br />Checks if user is in userlist.<br /><br />E.g.: $vyc->on_userlist("Dude") would return 1 if Dude would be logged in.<br />get_chans($nick)<br /><br />Returns array containing all channels user is on.<br /><br />E.g.: @chans = $vyc->get_chans('John');<br />readsock()<br /><br />Reads socket and recognises string it received. Returns array. See recognise().<br /><br />E.g.:<br /><br /> while (my @args = $vyc->readsock()) {<br /> # Remove first array element.<br /> my $packet_type = shift @args;<br /> if ($packet_type eq 'msg') {<br /> my ($from, $message) = @args;<br /> }<br /> }<br /><br />recognise($buffer, $ip)<br /><br />Recognises string in a buffer if it is Vypress Chat protocol command. Returns type of command and its arguments. Also executes actions when needed.<br /><br />Values are returned in array. First value will always be type of command. Other values may differ. Possible values are:<br />who is here<br /><br />Returns: "who", $updater.<br />I am here<br /><br />Returns: "who_ack", $from, $status, $active<br />channel chat<br /><br />Returns: "chat", $chan, $from, $text<br />nick change<br /><br />Returns: "nick", $oldnick, $newnick<br />channel join<br /><br />Returns: "join", $from, $chan, $status<br />channel part<br /><br />Returns: "part", $who, $chan<br />message<br /><br />Returns: "msg", $from, $text<br />mass message<br /><br />Returns: "mass", $from, $text<br />message acknowledgment<br /><br />Returns: "msg_ack", $from, $aa, $status, $gender<br />remote execution<br /><br />Returns: "remote_exec", $who, $command, $password<br />remote execution acknowledgement<br /><br />Returns: "remote_exec_ack", $from_who, $execution_text<br />channel /me<br /><br />Returns: "me", $chan, $fromwho, $text<br />topic change<br /><br />Returns: "topic", $chan, $topic<br />topic send<br /><br />Returns: "topic", $chan, $topic<br />status change<br /><br />Returns: "statuschange", $status, $aa<br />info request<br /><br />Returns: "info", $from<br />info request acknowledgment<br /><br />Returns: "info_ack", $from, $host, $user, $ip, $aa, @chans<br />beep<br /><br />Returns: "beep", $from<br />beep acknowledgement<br /><br />Returns: "beep_ack", $from, $gender<br />sound request<br /><br />Returns: "sound_req", $from, $filename, $channel<br />private chat join<br /><br />Returns: "pjoin", $from<br />private chat leave<br /><br />Returns: "ppart", $from<br />private chat string<br /><br />Returns: "pchat", $from, $text<br />private chat /me<br /><br />Returns: "pme", $from, $text<br />here request<br /><br />Returns: "here", $fromwho, $chan<br />here acknowledgement<br /><br />Returns: "here_ack", $from, $chan, $active<br />activity change<br /><br />Returns: "active", $fromwho, $active

Requirements:	No special requirements
Platforms:	*nix, Linux
Keyword:	Active,  Array,  Changereturns,  Channel,  Chateg,  Command,  Current,  Default,  Execution,  Information,  Message,  Module,  Private,  Protocol,  Return,  Status,  String,  Values,  Variable
Users rating:	0/10