Software that executes Yadis service discovery protocol.
Net::Yadis is a reliable and efficient Perl module that executes the Yadis service discovery protocol and decodes XRDS xml documents. This module offers multiple helpful functionalities that make it a must-have for any developer.
One of its significant features is the 'discover' constructor method that runs discovery protocol on URL and generates a yadis object which decodes the XRDS document for you. However, Yadis dies on errors like HTTP errors, missing Yadis magic, malformed XRDS.
You can also utilize the 'new' constructor method, which allows you to skip the discovery and head straight to xrds parsing. You only need to input the identity URL, xrds url, and XRDS xml as text.
The accessor methods enable you to obtain XML text of the XRDS document, Yadis URL, URL where the XRDS document was found and the Net::Yadis::Service object that represents services publicised in the XRDS file. Moreover, it provides a filter function reference to allow custom XPath queries using the filter_services method.
Net::Yadis module also provides an example to help developers understand how to use the filter_services method.
Lastly, Net::Yadis offers 'services_of_type' and 'service_of_type' that filter service types within the XRDS file. The latter method works as a Perl generator while the former returns service objects that align with the regex pattern used in the filter. However, you must ensure that the type code is identical for every call, or the list will restart from the top. It's also essential to save the yadis object in a session for the 'service_of_type' to function correctly.
In summary, Net::Yadis is an excellent module that provides developers with reliable and efficient functionalities for the Yadis service discovery protocol and XRDS xml document decoding.
One of its significant features is the 'discover' constructor method that runs discovery protocol on URL and generates a yadis object which decodes the XRDS document for you. However, Yadis dies on errors like HTTP errors, missing Yadis magic, malformed XRDS.
You can also utilize the 'new' constructor method, which allows you to skip the discovery and head straight to xrds parsing. You only need to input the identity URL, xrds url, and XRDS xml as text.
The accessor methods enable you to obtain XML text of the XRDS document, Yadis URL, URL where the XRDS document was found and the Net::Yadis::Service object that represents services publicised in the XRDS file. Moreover, it provides a filter function reference to allow custom XPath queries using the filter_services method.
Net::Yadis module also provides an example to help developers understand how to use the filter_services method.
Lastly, Net::Yadis offers 'services_of_type' and 'service_of_type' that filter service types within the XRDS file. The latter method works as a Perl generator while the former returns service objects that align with the regex pattern used in the filter. However, you must ensure that the type code is identical for every call, or the list will restart from the top. It's also essential to save the yadis object in a session for the 'service_of_type' to function correctly.
In summary, Net::Yadis is an excellent module that provides developers with reliable and efficient functionalities for the Yadis service discovery protocol and XRDS xml document decoding.
What's New
Version 1.0: N/A