From ab6bd56e614101ab87c57c6ee90c7dfc3d7046f9 Mon Sep 17 00:00:00 2001
From: kovacsdanielakos <git@progweb.hu>
Date: Mon, 8 Jun 2020 10:01:45 +0200
Subject: [PATCH] README

---
 README.md | 46 ++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 46 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..c7a1834
--- /dev/null
+++ b/README.md
@@ -0,0 +1,46 @@
+Icecat
+======
+
+Icecat is a PHP library, that assists you in the following 2 procedures:
+* Fetching data from the Icecat database using basic product information.
+* Parsing this data from the Icecat response, and using them in real life applications.
+
+### About Icecat
+[Icecat](http://icecat.biz, "Icecat") is an open catalog, providing free access to thousands of product datasheets.
+In extend, when taking a subscription, the amount of accessible datasheets are increased.
+
+There is a list of [Icecat sponsor brands](http://icecat.co.uk/en/menu/partners/index.html, "Icecat sponsor brands").
+
+
+Installation
+============
+
+The library can be installed using composer:
+
+```
+"progcode/icecat-api": "dev-master"
+```
+
+Usage
+=====
+
+The class library is, in it's current state easy to be used.
+
+### Result
+
+The [Icecat class](https://github.com/progcode/icecat-api/blob/master/src/Icecat/Api.php) is responsible for parsing the data. It includes a few basic methods, but you can easily create your 
+own implementation by implementing the IcecatInterface interface.
+
+```php
+// Use the class.
+use Src\Icecat\Api;
+
+$icecat = new Api(getenv('ICEACAT_USER'), getenv('ICEACAT_PASS'));
+$xml = $icecat->getArticleByMPN('Hewlett Packard Enterprise', '838079-B21', 'HU');
+$productDataArray = $icecat->xml2array($xml);
+
+$productData = $icecat->getProductData($productDataArray);
+
+```
+
+Demo is soon available.