bionic (3) lua-uri-ftp.3.gz

Name

       lua-uri-ftp - FTP URI support for Lua URI library

Description

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

       FTP URIs with a missing authority part or an empty host part are considered to be invalid.  An empty path
       is always normalized to '/'.  The default port is 21.

Methods

       All the methods defined in lua-uri(3) and lua-uri-_login(3) are supported, in addition to the following:

       uri:ftp_typecode(...)
           Mutator for the 'type' parameter at the end of the path.  If the optional argument is supplied then a
           new type is set, replacing the existing one, or causing the type parameter to be added to the path if
           it isn't there already.

               local uri = assert(URI:new("ftp://host/path"))
               uri:ftp_typecode("a")   -- ftp://host/path;type=a
               uri:ftp_typecode(nil)   -- ftp://host/path

           Passing in an empty string has the same effect as nil, removing the parameter.  An empty type
           parameter will be returned as nil, the same as if the parameter was missing.

References

       This class is based on "RFC 1738 section 3.2".  Unfortunately there isn't currently an RFC for FTP URIs
       based on the more up to date "RFC 3986".