Have our project have a setup and files for publishing.

Author: carlosalberto

MANIFEST

@@ -0,0 +1 @@
+include VERSION LICENSE

Makefile

@@ -0,0 +1,25 @@
+.PHONY: test install clean clean-build clean-pyc build
+
+install: 
+	python setup.py install
+
+clean: clean-build clean-pyc
+
+clean-build:
+	python setup.py clean
+	rm -fr build/
+	rm -fr dist/
+	rm -fr .eggs/
+	rm -fr .cache/
+	find . -name '*.egg-info' -exec rm -fr {} +
+	find . -name '*.egg' -exec rm -rf {} +
+
+clean-pyc:
+	find . -name '*.pyc' -exec rm -f {} +
+	find . -name '*.pyo' -exec rm -f {} +
+	find . -name '*~' -exec rm -f {} +
+	find . -name '__pycache__' -exec rm -fr {} +
+
+build: 
+	python setup.py build
+

README.rst

@@ -1,3 +1,51 @@
 ######################
 SQLAlchemy Opentracing
 ######################
+
+This package enables OpenTracing support for SQLAlchemy.
+
+Installation
+============
+
+Run the following command::
+
+    $ pip install sqlalchemy_opentracing
+
+Getting started
+===============
+
+Please see the examples directory. Overall, basic usage requires that a tracer gets set, an Engine (or Connection) is registered, and statements get their parent spans assigned (if any):
+
+.. code-block:: python
+
+    import sqlalchemy_opentracing
+
+    sqlalchemy_opentracing.init_tracing(tracer) # A OpenTracing compatible tracer.
+    sqlalchemy_opentracing.register_connectable(engine) # A valid SQLAlchemy Engine object.
+
+    with engine.begin() as conn:
+        sel = select([users])
+        sqlalchemy_opentracing.set_traced(sel)
+        conn.execute(sel)
+
+By default, only statements marked to be traced are taken into account (explicitly through set_traced() or implicitly when registering its parent span through set_parent_span()). Alternatively, you can enable tracing of all queries under the registered Engine/Connection:
+
+.. code-block:: python
+
+    sqlalchemy_opentracing.init_tracing(tracer, trace_all=True)
+    sqlalchemy_opentracing.register_connectable(engine)
+
+    # this statement will be traced too (without a parent span, though)
+    with engine.begin() as conn:
+        sel = select([users])
+        conn.execute(sel)
+
+Further information
+===================
+
+If you’re interested in learning more about the OpenTracing standard, please visit `opentracing.io`_ or `join the mailing list`_. If you would like to implement OpenTracing in your project and need help, feel free to send us a note at `community@opentracing.io`_.
+
+.. _opentracing.io: http://opentracing.io/
+.. _join the mailing list: http://opentracing.us13.list-manage.com/subscribe?u=180afe03860541dae59e84153&id=19117aa6cd
+.. _community@opentracing.io: community@opentracing.io
+

VERSION

@@ -0,0 +1 @@
+0.1.0

examples/child-spans.py

@@ -0,0 +1,50 @@
+import os
+from sqlalchemy import MetaData, Table, Integer, String, Column, create_engine
+from sqlalchemy import select
+from sqlalchemy.schema import CreateTable
+
+import lightstep
+import sqlalchemy_opentracing
+
+DB_LOCATION = '/tmp/simple.db'
+
+tracer = lightstep.Tracer(
+    component_name='sqlalchemy-childspans',
+    access_token='{your_lightstep_token}'
+)
+
+
+if __name__ == '__main__':
+    os.remove(DB_LOCATION) # cleanup
+
+    engine = create_engine('sqlite:///%s' % DB_LOCATION)
+    conn = engine.connect()
+
+    sqlalchemy_opentracing.init_tracing(tracer)
+    sqlalchemy_opentracing.register_connectable(engine)
+
+    span = tracer.start_span('create sample')
+
+    # 1. Create a table
+    metadata = MetaData()
+    users = Table('users', metadata,
+        Column('id', Integer, primary_key=True),
+        Column('name', String),
+    )
+    creat = CreateTable(users)
+    sqlalchemy_opentracing.set_parent_span(creat, span)
+    conn.execute(creat)
+
+    # 2. Insert a single value.
+    ins = users.insert().values(name='John Doe', id=1)
+    sqlalchemy_opentracing.set_parent_span(ins, span)
+    conn.execute(ins)
+
+    # 3. Select the new value.
+    sel = select([users])
+    sqlalchemy_opentracing.set_parent_span(sel, span)
+    print conn.execute(sel).fetchone()
+
+    span.finish()
+    tracer.flush()
+

examples/simple.py

@@ -1,51 +1,30 @@
-import os
 from sqlalchemy import MetaData, Table, Integer, String, Column, create_engine
-from sqlalchemy import select
 from sqlalchemy.schema import CreateTable
 
 import lightstep
 import sqlalchemy_opentracing
 
-DB_LOCATION = '/tmp/simple.db'
-
 tracer = lightstep.Tracer(
     component_name='sqlalchemy-simple',
     access_token='{your_lightstep_token}'
 )
 
-
 if __name__ == '__main__':
-    os.remove(DB_LOCATION) # cleanup
-
-    engine = create_engine('sqlite:///%s' % DB_LOCATION)
-    conn = engine.connect()
+    engine = create_engine('sqlite:///:memory:')
 
     sqlalchemy_opentracing.init_tracing(tracer)
     sqlalchemy_opentracing.register_connectable(engine)
 
-    span = tracer.start_span('create sample')
-
-    # 1. Create a table
     metadata = MetaData()
     users = Table('users', metadata,
         Column('id', Integer, primary_key=True),
         Column('name', String),
     )
-    span = tracer.start_span('create sample')
     creat = CreateTable(users)
-    sqlalchemy_opentracing.set_parent_span(creat, span)
-    conn.execute(creat)
-
-    # 2. Insert a single value.
-    ins = users.insert().values(name='John Doe', id=1)
-    sqlalchemy_opentracing.set_parent_span(ins, span)
-    conn.execute(ins)
+    sqlalchemy_opentracing.set_traced(creat)
 
-    # 3. Select the new value.
-    sel = select([users])
-    sqlalchemy_opentracing.set_parent_span(sel, span)
-    print conn.execute(sel).fetchone()
+    with engine.begin() as conn:
+        conn.execute(creat)
 
-    span.finish()
     tracer.flush()
 

setup.cfg

@@ -0,0 +1,2 @@
+[metadata]
+description-file = README.rst

setup.py

@@ -0,0 +1,27 @@
+from setuptools import setup
+
+version = open('VERSION').read()
+setup(
+    name='sqlalchemy_opentracing',
+    version=version,
+    url='https://github.com/carlosalberto/python-sqlalchemy/',
+    download_url='https://github.com/carlosalberto/python-sqlalchemy/tarball/'+version,
+    license='BSD',
+    author='Carlos Alberto Cortez',
+    author_email='calberto.cortez@gmail.com',
+    description='OpenTracing support for SQLAlchemy',
+    long_description=open('README.rst').read(),
+    packages=['sqlalchemy_opentracing'],
+    platforms='any',
+    install_requires=[
+        'sqlalchemy',
+        'opentracing>=1.1,<1.2'
+    ],
+    classifiers=[
+        'Intended Audience :: Developers',
+        'License :: OSI Approved :: BSD License',
+        'Operating System :: OS Independent',
+        'Programming Language :: Python',
+        'Topic :: Software Development :: Libraries :: Python Modules',
+    ]
+)