From: jeff Date: Fri, 17 Feb 2006 19:12:21 +0000 (+0000) Subject: Initial import (0.03) X-Git-Tag: initial~3 X-Git-Url: http://git.freeside.biz/gitweb/?p=Net-OpenSRS.git;a=commitdiff_plain;h=ea9bb3b7848dc63d0abce5e77d2f9c58096fa486 Initial import (0.03) --- ea9bb3b7848dc63d0abce5e77d2f9c58096fa486 diff --git a/MANIFEST b/MANIFEST new file mode 100644 index 0000000..8bbf161 --- /dev/null +++ b/MANIFEST @@ -0,0 +1,6 @@ +Changes +MANIFEST +META.yml # Will be created by "make dist" +Makefile.PL +README +lib/Net/OpenSRS.pm diff --git a/README b/README new file mode 100644 index 0000000..961153b --- /dev/null +++ b/README @@ -0,0 +1,72 @@ +Net-OpenSRS + +DESCRIPTION + +This is a wrapper interface to the DNS portions of the Tucows OpenSRS +HTTPS XML API. + + The client library distributed by OpenSRS can be difficult to + integrate into a custom environment, and their web interface becomes + quickly tedious with heavy usage. This is a clean and relatively + quick library to perform the most common API methods described in the + OpenSRS API documentation. + + For example -- after initial setup, registering a domain can be + completed in one function call. This makes Net::OpenSRS suitable + for easy SRS integration into your own environment. + + +NOTES + + This module requires some setup in the OpenSRS reseller environment + before it will work correctly. + + - You need to have an OpenSRS account, of course. If you aren't an + OpenSRS reseller, this module will be of limited use to you. :) + + - The machine(s) using this module need to have their public IP + addresses added to your 'Script API allow' list in the OpenSRS + web interface. (You only need to do this once.) + + - You need to generate your API keys - also in the the OpenSRS + web interface. (These keys are used for reseller authentication.) + + - For further information, please refer to the pod documentation. + + +INSTALLATION + +To install this module, run the following commands: + + perl Makefile.PL + make + make test + make install + + +SUPPORT AND DOCUMENTATION + +After installing, you can find documentation for this module with the perldoc command. + + perldoc Net::OpenSRS + +You can also look for information at: + + Search CPAN + http://search.cpan.org/dist/Net-OpenSRS + + CPAN Request Tracker: + http://rt.cpan.org/NoAuth/Bugs.html?Dist=Net-OpenSRS + + AnnoCPAN, annotated CPAN documentation: + http://annocpan.org/dist/Net-OpenSRS + + CPAN Ratings: + http://cpanratings.perl.org/d/Net-OpenSRS + +COPYRIGHT AND LICENCE + +Copyright (C) 2006 Mahlon E. Smith + +This program is free software; you can redistribute it and/or modify it +under the same terms as Perl itself.