make package importable, update README and LICENSE

Author: Christopher Merrick

LICENSE

@@ -175,28 +175,3 @@
       of your accepting any such warranty or additional liability.
 
    END OF TERMS AND CONDITIONS
-
-   APPENDIX: How to apply the Apache License to your work.
-
-      To apply the Apache License to your work, attach the following
-      boilerplate notice, with the fields enclosed by brackets "[]"
-      replaced with your own identifying information. (Don't include
-      the brackets!)  The text should be enclosed in the appropriate
-      comment syntax for the file format. We also recommend that a
-      file or class name and description of purpose be included on the
-      same "printed page" as the copyright notice for easier
-      identification within third-party archives.
-
-   Copyright [yyyy] [name of copyright owner]
-
-   Licensed under the Apache License, Version 2.0 (the "License");
-   you may not use this file except in compliance with the License.
-   You may obtain a copy of the License at
-
-       http://www.apache.org/licenses/LICENSE-2.0
-
-   Unless required by applicable law or agreed to in writing, software
-   distributed under the License is distributed on an "AS IS" BASIS,
-   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-   See the License for the specific language governing permissions and
-   limitations under the License.

README.md

@@ -3,8 +3,44 @@ stitchstream-python
 
 Writes the stitchstream format from Python
 
-Usage
------
+Use
+---
+
+This library depends on python3 and a to-be-released version of
+`transit-python`. The first step is to setup the python environment
+and manually install the correct version of that library:
+
+```bash
+› mkvirtualenv -p python3 stitch
+```
+
+```bash
+› workon stitch
+› git clone https://github.com/cognitect/transit-python
+› cd transit-python
+› python setup.py install
+```
+
+Next, install this library:
+
+```bash
+› workon stitch
+› git clone http://github.com/stitchstreams/stitchstream-python
+› cd stitchstream-python
+› python setup.py install
+```
+
+Now, from python code within the same `virtualenv`, you can use the
+library:
+
+```python
+import stitchstream as ss
+
+records = [{'id': i, 'value': 'abc'} for i in range(0,10)]
+ss.write_records('my_table', ['id'], records)
+ss.write_bookmark({'my_table': i})
+```
+
 
 License
 -------

stitchstream/__init__.py

@@ -0,0 +1 @@
+from .main import write_records, write_bookmark

stitchstream/main.py

@@ -6,7 +6,8 @@
 _headers_written = False
 
 def _writeline(s):
-    print(s, flush=True)
+    print(s)
+    sys.stdout.flush()
 
 def _write_headers():
     global _headers_written