Merge pull request #2 from mxmzdlv/dbapi_official

Switch to official dbapi

Author: mxmzdlv

README.rst

@@ -1,21 +1,9 @@
-DB-API interface and SQLAlchemy dialect for BigQuery. Inspired by `PyHive <https://github.com/dropbox/PyHive/>`_.
+SQLAlchemy dialect for BigQuery.
 
 
 Usage
 =====
 
-DB-API
-------
-.. code-block:: python
-
-    import bigquery
-    cursor = bigquery.connect('project').cursor()
-    cursor.execute('SELECT * FROM dataset.table LIMIT 10')
-    print(cursor.fetchone())
-    print(cursor.fetchall())
-
-SQLAlchemy
-----------
 .. code-block:: python
 
     from sqlalchemy import *
@@ -25,15 +13,54 @@ SQLAlchemy
     logs = Table('dataset.table', MetaData(bind=engine), autoload=True)
     print(select([func.count('*')], from_obj=logs).scalar())
 
+
+Project
+_______
+`project` in `bigquery://project` is used to instantiate BigQuery client with the specific project ID. To infer project from the environment, use `bigquery://` – without `project`
+
+Table names
+___________
+To query tables from non-default projects, use the following format for the table name: `project.dataset.table`, e.g.:
+
+.. code-block:: python
+
+    sample_table = Table('bigquery-public-data.samples.natality')
+
+Batch size
+__________
+
+By default, `arraysize` is set to `5000`. `arraysize` is used to set the batch size for fetching results. To change it, pass `arraysize` to `create_engine()`:
+
+.. code-block:: python
+
+    engine = create_engine('bigquery://project', arraysize=1000)
+
+
 Requirements
 ============
 
 Install using
 
-- ``pip install git+https://github.com/mxmzdlv/pybigquery.git@master#egg=pybigquery``
+- ``pip install pybigquery``
+
+
+Testing
+============
+
+Load sample tables:
+
+    ./scripts/load_test_data.sh
+
+This will create a dataset `test_pybigquery` with tables named `sample_one_row` and `sample`
+
+Set up an environment and run tests:
+    pyvenv .env
+    source .env/bin/activate
+    pip install -r dev_requirements.txt
+    pytest
+
 
 TODO
 ====
 
 - Support for Record column type
-- Add a test suite

bigquery/__init__.py

@@ -1,2 +1,4 @@
 sqlalchemy>=1.1.9
-google-cloud>=0.25.0
+google-cloud-bigquery>=0.27.0
+
+pytest==3.2.2