Remove legacy pip_import (#726)

* Remove legacy pip_import

* Remove legacy pip_import

* Generate docs

Author: groodt

README.md

@@ -231,23 +231,10 @@ For `pip_install` the labels are instead of the form
 
 [requirements-drawbacks]: https://github.com/bazelbuild/rules_python/issues/414
 
-#### 'Extras' requirement consumption
+#### 'Extras' dependencies
 
-When using the legacy `pip_import`, you must specify the extra in the argument to the `requirement` macro. For example:
-
-```python
-py_library(
-    name = "mylib",
-    srcs = ["mylib.py"],
-    deps = [
-        requirement("useful_dep[some_extra]"),
-    ]
-)
-```
-
-If using `pip_install` or `pip_parse`, any extras specified in the requirements file will be automatically
-linked as a dependency of the package so that you don't need to specify the extra. In the example above,
-you'd just put `requirement("useful_dep")`.
+Any 'extras' specified in the requirements lock-file will be automatically added as transitive dependencies of the 
+package. In the example above, you'd just put `requirement("useful_dep")`.
 
 ### Consuming Wheel Dists Directly
 

docs/pip.md

@@ -38,11 +38,6 @@ bazel_integration_test(
     timeout = "long",
 )
 
-bazel_integration_test(
-    name = "py_import_example",
-    timeout = "long",
-)
-
 bazel_integration_test(
     name = "relative_requirements_example",
     timeout = "long",

examples/BUILD

@@ -210,14 +210,3 @@ def pip_parse(requirements_lock, name = "pip_parsed_deps", **kwargs):
         incremental = True,
         **kwargs
     )
-
-def pip_repositories():
-    """
-    Obsolete macro to pull in dependencies needed to use the pip_import rule.
-
-    Deprecated:
-        the pip_repositories rule is obsolete. It is not used by pip_install.
-    """
-
-    # buildifier: disable=print
-    print("DEPRECATED: the pip_repositories rule has been replaced with pip_install, please see rules_python 0.1 release notes")