Name

       lua-uri-pop - POP URI support for Lua URI library

Description

       The class "uri.pop" is used for URIs with the "pop" scheme.  It inherits from the uri class.

       POP URIs with a non-empty path part are considered invalid.  There are also invalid if there is a
       userinfo part which has an empty POP username or an empty POP 'auth' type.

       The ';auth=' part of a POP URI is normalized so that the word 'auth' is in lowercase, and if the auth
       type is the default '*' value then it is removed altogether, leaving just the username.

       The default port is 110.

Methods

       All the methods defined in lua-uri(3) are supported.  The "userinfo" method will throw an exception if
       the new userinfo would form an invalid POP URI, and will normalize the auth type part if appropriate.
       The "path" method will always return empty strings for POP URIs, and will throw an exception if given a
       new value which is not the empty string.

       The following additional methods are provided:

       uri:pop_user(...)
           Get or set the POP username, which is stored in the userinfo part of the authority.

           The return value will be nil if there is no user information in the URI, or a fully decoded string if
           there is.

           If  the  new  value  is  empty,  and  exception  is thrown.  The user can be set to nil to remove the
           userinfo part from the URI, but this will also  throw  an  exception  if  there  is  an  'auth'  type
           specified.

       uri:pop_auth(...)
           Get  or  set the POP authentication type, which is stored in the userinfo part of the authority after
           the string ';auth='.

           The value returned is just the auth type, not the ';auth=' part, and  will  be  fully  decoded.   The
           value  returned  will never be nil.  If there is no auth type specified then the default value of '*'
           will be returned.

           Setting a new value of nil or the empty string will cause an exception to be thrown.

References

       This class is based on "RFC 2384".

1.1                                                2012-00-00                                     LUA-URI-POP(3)