From 9bd2b58b32f8ffaedb190b14a917f41dd2281769 Mon Sep 17 00:00:00 2001
From: Ritesh Chitlangi <ritesh@ayravat.com>
Date: Tue, 27 Jul 2021 03:56:34 +0800
Subject: [PATCH] added a markdown README

---
 README.md                    | 94 ++++++++++++++++++++++++++++++++++++
 epp-client-macros/Cargo.toml |  3 ++
 epp-client/Cargo.toml        |  8 +--
 3 files changed, 101 insertions(+), 4 deletions(-)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..9e616e7
--- /dev/null
+++ b/README.md
@@ -0,0 +1,94 @@
+# EPP (Extensible Provisioning Protocol) Library for Domain Registration and Management
+
+## Description
+
+epp-client is a client library written in Rust for Internet domain registration and management for domain registrars.
+
+It supports the following basic Domain, Contact, Host, and Message management calls, with plans to add more calls
+and other EPP extensions in the future, and to eventually be RFC compliant with the EPP protocol.
+
+- Domain Check - `EppDomainCheck`
+- Domain Create - `EppDomainCreate`
+- Domain Info - `EppDomainInfo`
+- Domain Update - `EppDomainUpdate`
+- Domain Delete - `EppDomainDelete`
+- Domain Renew - `EppDomainRenew`
+- Domain Transfer - `EppDomainTransferRequest`
+
+- Contact Check - `EppContactCheck`
+- Contact Create - `EppContactCreate`
+- Contact Info - `EppContactInfo`
+- Contact Update - `EppContactUpdate`
+- Contact Delete - `EppContactDelete`
+
+- Host Check - `EppHostCheck`
+- Host Create - `EppHostCreate`
+- Host Info - `EppHostInfo`
+- Host Update - `EppHostUpdate`
+- Host Delete - `EppHostDelete`
+
+- Message Poll - `EppMessagePoll`
+- Message Ack - `EppMessageAck`
+
+## Prerequisites
+
+To use the library, you must have an `epp-client/epp-client.toml` config file with the relevant registry
+credentials in your default user configuration directory on your OS. For Linux, this is the `XDG user directory`,
+usually located at `$HOME/.config` or defined by the `XDG_CONFIG_HOME` environment variable.
+
+An example config looks like this:
+
+```toml
+[registry.verisign
+host = 'epp.verisign-grs.com'
+port = 700
+username = 'username'
+password = 'password'
+# service extensions
+ext_uris = [
+
+[registry.verisign.tls_files
+# the full client certificate chain in PEM format
+cert_chain = '/path/to/certificate/chain/pemfile'
+# the RSA private key for your certificate
+key = '/path/to/private/key/pemfile'
+```
+
+## Operation
+
+Once the config is set correctly, you can create a mut variable of type [`EppClient`
+with the domain registry
+
+```rust
+use epp_client::EppClient;
+use epp_client::epp::{EppDomainCheck, EppDomainCheckResponse};
+use epp_client::epp::generate_client_tr_id;
+
+#[tokio::main
+async fn main() {
+    // Create an instance of EppClient, specifying the name of the registry as in
+    // the config file
+    let mut client = match EppClient::new("verisign").await {
+        Ok(client) => client,
+        Err(e) => panic!("Failed to create EppClient: {}",  e)
+    };
+
+    // Make a domain check call, which returns an object of type EppDomainCheckResponse
+    // that contains the result of the call
+    let domain_check = EppDomainCheck::new(
+        vec!["eppdev.com", "eppdev.net"
+        generate_client_tr_id(&client).as_str()
+    );
+
+    let response = client.transact::<_, EppDomainCheckResponse>(&domain_check).await.unwrap();
+
+    // print the availability results
+    response.data.res_data.unwrap().check_data.domain_list
+        .iter()
+        .for_each(|chk| println!("Domain: {}, Available: {}", chk.domain.name, chk.domain.available));
+}
+```
+
+## Request
+
+Currently I don't have access to a registry's OT&E account to do extensive testing. I am using [hexonet's EPP Gateway](https://wiki.hexonet.net/wiki/EPP_Gateway) for testing, but access to a registry's OT&E account would be very helpful, so if anyone can help me out with one it would be very helpful!
\ No newline at end of file
diff --git a/epp-client-macros/Cargo.toml b/epp-client-macros/Cargo.toml
index 516397b..74b3100 100644
--- a/epp-client-macros/Cargo.toml
+++ b/epp-client-macros/Cargo.toml
@@ -2,6 +2,9 @@
 name = "epp-client-macros"
 version = "0.1.0"
 edition = "2018"
+license = "MIT"
+authors = ["Ritesh Chitlangi <ritesh@ayravat.com>"]
+description = "Macros for the epp-client Library"
 
 # See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
 
diff --git a/epp-client/Cargo.toml b/epp-client/Cargo.toml
index c71d90c..1757f3f 100644
--- a/epp-client/Cargo.toml
+++ b/epp-client/Cargo.toml
@@ -2,13 +2,13 @@
 name = "epp-client"
 version = "0.1.0"
 edition = "2018"
+license = "MIT"
+authors = ["Ritesh Chitlangi <ritesh@ayravat.com>"]
+description = "EPP (Extensible Provisioning Protocol) Client Library for Domain Registration and Management"
+repository = "https://github.com/masalachai/epp-client"
 
 # See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
 
-[[example]]
-name = "example-client"
-path = "examples/client.rs"
-
 [dependencies]
 epp-client-macros = { path = "../epp-client-macros" }
 bytes = "1"