sphinx docs added

Author: leela

docs/source/fileformat.rst

@@ -0,0 +1,5 @@
+File formatting
+===============
+
+.. automodule:: toolkit.fileformat
+   :members:

docs/source/index.rst

@@ -46,3 +46,4 @@ If you are looking for information on a specific function, class, or method, thi
    imports
    logging
    signals
+   fileformat

docs/source/utils.rst

@@ -147,8 +147,8 @@ Sample code ::
 
 	>>> from toolkit import Signal
 	>>> signal_loggin = Signal("LoggedIn") # Creates a new signal
-	>>> @signal_loggin.connect   
-	... def notify_user(username): # Connect the function to signal named signal_loggin  
+	>>> @signal_loggin.connect
+	... def notify_user(username): # Connect the function to signal named signal_loggin
 	...     print("Notify user about new logging through mail")
 	...
 	>>> signal_loggin.send("test_user") # Send the signal from any where in the system
@@ -171,4 +171,34 @@ Sample Code ::
 	>>> tables = schema.get_tables() # Get all the tables
 	>>> enum_types = schema.get_enum_types() # Get all the enum types
 	>>> table = schema.get_table('t1')  # Get t1 table
-	>>> table.get_indexes()
+	>>> table.get_indexes()
+
+fileformats
+-----------
+validate and transform the given data as per the fileformat specifications.
+
+Given input data is passed through a pipeline of validators. These validators
+can check structure and schema, for example are their blank rows or columns, is the data of right type etc.
+
+In return, the client receives a report on processing performed.
+
+
+Sample code ::
+
+	>>> from toolkit import FileFormat
+	>>> formatter = FileFormat.from_file("fileformats/customer-master.yml")
+	>>> formatter.process_file("master-files/customer-master/customer-master-20200601.csv")
+	<Report:status=ACCEPTED #errors=0>
+
+You can use command line tool as well for the validation (this comes along with the package).
+
+Command line tool ::
+
+	$ validate-fileformat --help
+	Usage: validate-fileformat [OPTIONS] FILE
+	....
+	$ validate-fileformat -f fileformats/customer-master.yml customer-master/customer-master-20200601.csv
+	File validation status: ACCEPTED
+	....
+	$ validate-fileformat -f fileformats/customer-master.yml customer-master/customer-master-20200601.csv -o report.json
+	File validation status: ACCEPTED