summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorjeff <jeff>2006-02-17 19:12:21 +0000
committerjeff <jeff>2006-02-17 19:12:21 +0000
commitea9bb3b7848dc63d0abce5e77d2f9c58096fa486 (patch)
tree41eb3505adca44b7fa25a6018a52abd224913520
Initial import (0.03)
-rw-r--r--MANIFEST6
-rw-r--r--README72
2 files changed, 78 insertions, 0 deletions
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.