intial structure; documentation

10 files changed, 66 insertions, 0 deletions

diff --git a/README b/LICENSE
index e69de29..e69de29 100644
--- a/README
+++ b/LICENSE
diff --git a/README.mkd b/README.mkd
new file mode 100644
index 0000000..e62c67e
--- /dev/null
+++ b/README.mkd
@@ -0,0 +1,65 @@
+Tabbed -- Pythonic Tabular Datasets
+===================================
+
+**Tabbed is under active documentation-driven development.**
+
+Formats supported:
+
+  - JSON
+  - YAML
+  - Excel
+  - CSV
+  - CDL
+
+Please note that this list _purposefully_ excludes XML. And it always will.
+
+
+Features
+--------
+
+Convert data formats:
+
+	tabbed.import(filename='data.csv').export('data.json')
+	
+	
+Populate fresh data files:
+	
+	headers = ('first_name', 'last_name', 'gpa')
+
+	data = [
+		('John', 'Adams', 4.0),
+		('George', 'Washington', 2.6),
+		('Henry', 'Ford', 2.3)
+	]
+
+	
+	data = tabbed.Data(*data, headers=headers)
+
+	# Save data, but no 
+	data.save()
+	# >>> Error: No filename has been established
+	
+	# Establish file location and save
+	data.save('test.xls')
+	
+	data.addRow('Bob', 'Dylan')
+	# >>> Warning: Existing column count is 3
+	
+	print data.headers
+	# >>> ('first_name', 'last_name', 'gpa')
+	
+	print data[0:1]
+	# >>> [('John', 'Adams', 4.0), ('George', 'Washington', 2.6)]
+	
+	print data['first_name']
+	# >>> ['John', 'George', 'Henry']
+	
+	data.delRow(0)
+	print data[0:1]
+	# >>> [('George', 'Washington', 2.6), ('Henry', 'Ford', 2.3)]
+	
+	# Update saved file
+	data.save()
+	
+	# Save copy as CSV
+	data.export('backup.csv')
\ No newline at end of file
diff --git a/setup.py b/setup.py
new file mode 100644
index 0000000..4265cc3
--- /dev/null
+++ b/setup.py
@@ -0,0 +1 @@
+#!/usr/bin/env python
diff --git a/tabbed/__init__.py b/tabbed/__init__.py
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/tabbed/__init__.py
diff --git a/tabbed/core.py b/tabbed/core.py
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/tabbed/core.py
diff --git a/tabbed/exporters/__init__.py b/tabbed/exporters/__init__.py
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/tabbed/exporters/__init__.py
diff --git a/tabbed/exporters/csv.py b/tabbed/exporters/csv.py
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/tabbed/exporters/csv.py
diff --git a/tabbed/exporters/excel.py b/tabbed/exporters/excel.py
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/tabbed/exporters/excel.py
diff --git a/tabbed/exporters/json.py b/tabbed/exporters/json.py
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/tabbed/exporters/json.py
diff --git a/tabbed/exporters/yaml.py b/tabbed/exporters/yaml.py
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/tabbed/exporters/yaml.py