Rename remaining framework packages from "ext" to "instrumentation"

README.md

@@ -63,12 +63,19 @@ pip install opentelemetry-sdk
 ```
 
 The
-[`ext/`](https://github.com/open-telemetry/opentelemetry-python/tree/master/ext)
-directory includes OpenTelemetry integration packages, which can be installed
-separately as:
+[`instrumentation/`](https://github.com/open-telemetry/opentelemetry-python/tree/master/instrumentation)
+directory includes OpenTelemetry instrumentation packages, which can be installed separately as:
 
 ```sh
-pip install opentelemetry-ext-{integration}
+pip install opentelemetry-instrumentation-{instrumentation}
+```
+
+The
+[`exporter/`](https://github.com/open-telemetry/opentelemetry-python/tree/master/exporter)
+directory includes OpenTelemetry exporter packages, which can be installed separately as:
+
+```sh
+pip install opentelemetry-exporter-{exporter}
 ```
 
 To install the development versions of these packages instead, clone or fork
@@ -78,7 +85,7 @@ install](https://pip.pypa.io/en/stable/reference/pip_install/#editable-installs)
 ```sh
 pip install -e ./opentelemetry-api
 pip install -e ./opentelemetry-sdk
-pip install -e ./ext/opentelemetry-ext-{integration}
+pip install -e ./ext/opentelemetry-instrumentation-{instrumentation}
 ```
 
 ## Documentation

docs/conf.py

@@ -37,21 +37,14 @@
     if isdir(join(exp, f))
 ]
 
-ext = "../ext"
-ext_dirs = [
-    os.path.abspath("/".join(["../ext", f, "src"]))
-    for f in listdir(ext)
-    if isdir(join(ext, f))
-]
-
 instr = "../instrumentation"
 instr_dirs = [
     os.path.abspath("/".join(["../instrumentation", f, "src"]))
     for f in listdir(instr)
     if isdir(join(instr, f))
 ]
 
-sys.path[:0] = source_dirs + exp_dirs + ext_dirs + instr_dirs
+sys.path[:0] = source_dirs + exp_dirs + instr_dirs
 
 # -- Project information -----------------------------------------------------
 

docs/examples/opentelemetry-example-app/src/opentelemetry_example_app/grpc/hello_world_client.py

@@ -17,11 +17,11 @@
 
 """The Python implementation of the GRPC helloworld.Greeter client.
 
-Note that you need ``opentelemetry-ext-grpc`` and ``protobuf`` to be installed
+Note that you need ``opentelemetry-instrumentation-grpc`` and ``protobuf`` to be installed
 to run these examples. To run this script in the context of the example app,
 install ``opentelemetry-example-app``::
 
-    pip install -e ext/opentelemetry-ext-grpc/
+    pip install -e ext/opentelemetry-instrumentation-grpc/
     pip install -e docs/examples/opentelemetry-example-app
 
 Then run the server in one shell::
@@ -42,8 +42,8 @@
 import grpc
 
 from opentelemetry import trace
-from opentelemetry.ext.grpc import client_interceptor
-from opentelemetry.ext.grpc.grpcext import intercept_channel
+from opentelemetry.instrumentation.grpc import client_interceptor
+from opentelemetry.instrumentation.grpc.grpcext import intercept_channel
 from opentelemetry.sdk.trace import TracerProvider
 from opentelemetry.sdk.trace.export import (
     ConsoleSpanExporter,

docs/examples/opentelemetry-example-app/src/opentelemetry_example_app/grpc/hello_world_server.py

@@ -17,11 +17,11 @@
 
 """The Python implementation of the GRPC helloworld.Greeter server.
 
-Note that you need ``opentelemetry-ext-grpc`` and ``protobuf`` to be installed
+Note that you need ``opentelemetry-instrumentation-grpc`` and ``protobuf`` to be installed
 to run these examples. To run this script in the context of the example app,
 install ``opentelemetry-example-app``::
 
-    pip install -e ext/opentelemetry-ext-grpc/
+    pip install -e ext/opentelemetry-instrumentation-grpc/
     pip install -e docs/examples/opentelemetry-example-app
 
 Then run the server in one shell::
@@ -42,8 +42,8 @@
 import grpc
 
 from opentelemetry import trace
-from opentelemetry.ext.grpc import server_interceptor
-from opentelemetry.ext.grpc.grpcext import intercept_server
+from opentelemetry.instrumentation.grpc import server_interceptor
+from opentelemetry.instrumentation.grpc.grpcext import intercept_server
 from opentelemetry.sdk.trace import TracerProvider
 from opentelemetry.sdk.trace.export import (
     ConsoleSpanExporter,

docs/examples/opentelemetry-example-app/src/opentelemetry_example_app/grpc/route_guide_client.py

@@ -17,11 +17,11 @@
 
 """The Python implementation of the gRPC route guide client.
 
-Note that you need ``opentelemetry-ext-grpc`` and ``protobuf`` to be installed
+Note that you need ``opentelemetry-instrumentation-grpc`` and ``protobuf`` to be installed
 to run these examples. To run this script in the context of the example app,
 install ``opentelemetry-example-app``::
 
-    pip install -e ext/opentelemetry-ext-grpc/
+    pip install -e ext/opentelemetry-instrumentation-grpc/
     pip install -e docs/examples/opentelemetry-example-app
 
 Then run the server in one shell::
@@ -43,8 +43,8 @@
 import grpc
 
 from opentelemetry import trace
-from opentelemetry.ext.grpc import client_interceptor
-from opentelemetry.ext.grpc.grpcext import intercept_channel
+from opentelemetry.instrumentation.grpc import client_interceptor
+from opentelemetry.instrumentation.grpc.grpcext import intercept_channel
 from opentelemetry.sdk.trace import TracerProvider
 from opentelemetry.sdk.trace.export import (
     ConsoleSpanExporter,

docs/examples/opentelemetry-example-app/src/opentelemetry_example_app/grpc/route_guide_server.py

@@ -18,11 +18,11 @@
 
 """The Python implementation of the gRPC route guide server.
 
-Note that you need ``opentelemetry-ext-grpc`` and ``protobuf`` to be installed
+Note that you need ``opentelemetry-instrumentation-grpc`` and ``protobuf`` to be installed
 to run these examples. To run this script in the context of the example app,
 install ``opentelemetry-example-app``::
 
-    pip install -e ext/opentelemetry-ext-grpc/
+    pip install -e ext/opentelemetry-instrumentation-grpc/
     pip install -e docs/examples/opentelemetry-example-app
 
 Then run the server in one shell::
@@ -45,8 +45,8 @@
 import grpc
 
 from opentelemetry import trace
-from opentelemetry.ext.grpc import server_interceptor
-from opentelemetry.ext.grpc.grpcext import intercept_server
+from opentelemetry.instrumentation.grpc import server_interceptor
+from opentelemetry.instrumentation.grpc.grpcext import intercept_server
 from opentelemetry.sdk.trace import TracerProvider
 from opentelemetry.sdk.trace.export import (
     ConsoleSpanExporter,

docs/examples/opentracing/README.rst

@@ -1,8 +1,8 @@
 OpenTracing Shim Example
 ==========================
 
-This example shows how to use the :doc:`opentelemetry-ext-opentracing-shim
-package <../../ext/opentracing_shim/opentracing_shim>`
+This example shows how to use the :doc:`opentelemetry-instrumentation-opentracing-shim
+package <../../instrumentation/opentracing_shim/opentracing_shim>`
 to interact with libraries instrumented with
 `opentracing-python <https://github.com/opentracing/opentracing-python>`_.
 
@@ -61,7 +61,7 @@ Alternatively, you can install the Python dependencies separately:
     pip install \
         opentelemetry-api \
         opentelemetry-sdk \
-        opentelemetry-ext-jaeger \
+        opentelemetry-exporter-jaeger \
         opentelemetry-opentracing-shim \
         redis \
         redis_opentracing
@@ -100,6 +100,6 @@ Useful links
 ------------
 
 - OpenTelemetry_
-- :doc:`../../ext/opentracing_shim/opentracing_shim`
+- :doc:`../../instrumentation/opentracing_shim/opentracing_shim`
 
 .. _OpenTelemetry: https://github.com/open-telemetry/opentelemetry-python/

docs/examples/opentracing/main.py

@@ -2,7 +2,7 @@
 
 from opentelemetry import trace
 from opentelemetry.exporter.jaeger import JaegerSpanExporter
-from opentelemetry.ext import opentracing_shim
+from opentelemetry.instrumentation import opentracing_shim
 from opentelemetry.sdk.trace import TracerProvider
 from opentelemetry.sdk.trace.export import SimpleExportSpanProcessor
 from rediscache import RedisCache

docs/getting-started.rst

@@ -122,7 +122,7 @@ for Jaeger, but you can install that as a separate package:
 
 .. code-block:: sh
 
-    pip install opentelemetry-ext-jaeger
+    pip install opentelemetry-exporter-jaeger
 
 Once installed, update your code to import the Jaeger exporter, and use that instead:
 
@@ -228,7 +228,7 @@ For our Python application, we will need to install an exporter specific to Prom
 
 .. code-block:: sh
 
-    pip install opentelemetry-ext-prometheus
+    pip install opentelemetry-exporter-prometheus
 
 
 And use that instead of the `ConsoleMetricsExporter`:
@@ -284,15 +284,3 @@ Start the docker container:
         -v /tmp/otel-collector-config.yaml:/etc/otel-collector-config.yaml \
         omnition/opentelemetry-collector-contrib:latest \
         --config=/etc/otel-collector-config.yaml
-
-Install the OpenTelemetry Collector exporter:
-
-.. code-block:: sh
-
-    pip install opentelemetry-ext-otcollector
-
-And execute the following script:
-
-.. literalinclude:: getting_started/otcollector_example.py
-    :language: python
-    :lines: 15-

docs/index.rst

@@ -26,9 +26,11 @@ The API and SDK packages are available on PyPI, and can installed via pip:
 
 In addition, there are several extension packages which can be installed separately as::
 
-    pip install opentelemetry-ext-{integration}
+    pip install opentelemetry-exporter-{exporter}
+    pip install opentelemetry-instrumentation-{instrumentation}
 
-The extension packages can be found in :scm_web:`ext/ directory of the repository <ext/>`.
+These are for exporter and instrumentation packages respectively.
+The packages can be found in :scm_web:`instrumentation/ directory of the repository <ext/>`.
 
 Extensions
 ----------
@@ -51,7 +53,7 @@ install <https://pip.pypa.io/en/stable/reference/pip_install/#editable-installs>
     cd opentelemetry-python
     pip install -e ./opentelemetry-api
     pip install -e ./opentelemetry-sdk
-    pip install -e ./ext/opentelemetry-ext-{integration}
+    pip install -e ./instrumentation/opentelemetry-instrumentation-{instrumentation}
 
 
 .. toctree::
@@ -86,14 +88,6 @@ install <https://pip.pypa.io/en/stable/reference/pip_install/#editable-installs>
 
     instrumentation/**
 
-.. toctree::
-    :maxdepth: 2
-    :caption: OpenTelemetry Integrations
-    :name: integrations
-    :glob:
-
-    ext/**
-
 .. toctree::
     :maxdepth: 1
     :caption: Examples

docs/ext/botocore/botocore.rst → docs/instrumentation/boto/boto.rst

@@ -1,7 +1,7 @@
-OpenTelemetry Botocore Integration
+OpenTelemetry Boto Instrumentation
 ==================================
 
-.. automodule:: opentelemetry.ext.botocore
+.. automodule:: opentelemetry.instrumentation.boto
     :members:
     :undoc-members:
     :show-inheritance:

docs/instrumentation/botocore/botocore.rst

@@ -0,0 +1,7 @@
+OpenTelemetry Botocore Instrumentation
+======================================
+
+.. automodule:: opentelemetry.instrumentation.botocore
+    :members:
+    :undoc-members:
+    :show-inheritance:

docs/ext/celery/celery.rst → docs/instrumentation/celery/celery.rst

@@ -1,7 +1,7 @@
 OpenTelemetry Celery Instrumentation
 ====================================
 
-.. automodule:: opentelemetry.ext.celery
+.. automodule:: opentelemetry.instrumentation.celery
     :members:
     :undoc-members:
     :show-inheritance:

docs/ext/grpc/grpc.rst → docs/instrumentation/grpc/grpc.rst

@@ -4,7 +4,7 @@ OpenTelemetry gRPC Instrumentation
 Module contents
 ---------------
 
-.. automodule:: opentelemetry.ext.grpc
+.. automodule:: opentelemetry.instrumentation.grpc
    :members:
    :undoc-members:
    :show-inheritance:

docs/ext/jinja2/jinja2.rst → docs/instrumentation/jinja2/jinja2.rst

@@ -1,7 +1,7 @@
 OpenTelemetry Jinja2 Instrumentation
 ====================================
 
-.. automodule:: opentelemetry.ext.jinja2
+.. automodule:: opentelemetry.instrumentation.jinja2
     :members:
     :undoc-members:
     :show-inheritance:

docs/ext/opentracing_shim/opentracing_shim.rst → docs/instrumentation/opentracing_shim/opentracing_shim.rst

@@ -1,5 +1,5 @@
 OpenTracing Shim for OpenTelemetry
 ==================================
 
-.. automodule:: opentelemetry.ext.opentracing_shim
+.. automodule:: opentelemetry.instrumentation.opentracing_shim
    :no-show-inheritance: