rename 'wrap' to 'traced'

Seems more intuitive for the function decorator to be `traced`. As in, "my_fn is a traced function".

Example:

@Traced(name='my_fn')
def my_fn():
	pass

Author: tredman

beeline/__init__.py

@@ -164,7 +164,7 @@ def send_all(self):
             self.tracer_impl.finish_span(span)
             span = self.tracer_impl.get_active_span()
 
-    def wrap(self, name, trace_id=None, parent_id=None):
+    def traced(self, name, trace_id=None, parent_id=None):
         def wrapped(fn, *args, **kwargs):
             def inner(*args, **kwargs):
                 with self.tracer(name=name, trace_id=trace_id, parent_id=parent_id):
@@ -518,24 +518,25 @@ def close():
 
     _GBL = None
 
-def wrap(name, trace_id=None, parent_id=None):
+def traced(name, trace_id=None, parent_id=None):
     '''
-    Function decorator to wrap an entire function in a span. If no trace
-    is active, starts a new trace, and the wrapping span will be a root
-    span.
+    Function decorator to wrap an entire function in a trace span. If no trace
+    is active in the current thread, starts a new trace, and the wrapping span
+    will be a root span. If a trace is active, creates a child span of the 
+    existing trace.
 
     Example use:
 
     ```
-    @wrap(name="my_expensive_function")
+    @traced(name="my_expensive_function")
     def my_func(n):
         recursive_fib(n)
 
     my_func(100)
     ```
 
     Args:
-    - `name`: a descriptive name for the this trace span, i.e. "function_name"
+    - `name`: a descriptive name for the this trace span, i.e. "function_name". This is required.
     - `trace_id`: the trace_id to use. If None, will be automatically generated.
         Use this if you want to explicitly resume a trace in this application that was
         initiated in another application, and you have the upstream trace_id.
@@ -553,4 +554,4 @@ def inner(*args, **kwargs):
 
         return wrapped
 
-    return _beeline.wrap(name, trace_id, parent_id)
+    return _beeline.traced(name, trace_id, parent_id)

beeline/test_beeline.py

@@ -164,7 +164,7 @@ def test_trace_wrapper(self):
             m_gbl.return_value = _beeline
             _beeline.tracer_impl._run_hooks_and_send = Mock()
 
-            @beeline.wrap(name="my_sum")
+            @beeline.traced(name="my_sum")
             def my_sum(a, b):
                 return a + b
 
@@ -183,7 +183,7 @@ def setUp(self):
     def test_trace_wrapper(self):
         ''' ensure the trace wrapper doesn't break if the beeline is not initialized '''
         self.assertIsNone(beeline.get_beeline())
-        @beeline.wrap(name="my_sum")
+        @beeline.traced(name="my_sum")
         def my_sum(a, b):
             return a + b