tree b3116ce95f8ebf19d088f3e2cc761c7f44c02058
parent c32d2320d98f5b7633238bfee0c466eab5e703f3
author Ignas Anikevicius <anikevicius@gmail.com> 1692995663 +0900
committer GitHub <noreply@github.com> 1692995663 +0000
gpgsig -----BEGIN PGP SIGNATURE-----
 
 wsBcBAABCAAQBQJk6RBeCRBK7hj4Ov3rIwAA1roIABTWLt25Bf08aWZGoJrQ2G7W
 e+ixLPfZ0WgAG5oTK47Qt1n1BAUqMFpdaVb58DBpRbNakJ4OPDgXqLVljzkOSe/y
 LHlVcpWK5h3xPynEzmAZmRyDM7maB2gyIXRV7tsa5hTUK+Pk2bR/x/KulW0RWC25
 79cB6yNfXrU9bBRPgcyVj2xyKvz9DRg+qOWxjOMWnpzjoVR8jW03d1vGEB8Pt6zl
 6UoVeqbttCHgGOA3CQrBISEK30Ag5Va5dG1NlUReyWpU1d2PYOmu9gIw+dzB2TTp
 sqs4RF5dkliqVkKVBSWZOcjlH1HKIYxpPZ5FlocqCM52mFY7sddkrkNPfc8kh3g=
 =Ej9o
 -----END PGP SIGNATURE-----
 

feat(py_console_script_binary)!: entry points with custom dependencies (#1363)

Add `py_console_script_binary`, a macro/rule that allows better
customization of how
entry points are generated. Notable features of it are:
* It allows passing in additional dependencies, which makes it easier
for plugin
    dependencies to be added to tools such as pylint or sphinx.
* The underlying `py_binary` rule can be passed in, allowing custom
rules,
such as the version-aware rules, to be used for the resulting binary.
* Entry point generation is based upon a wheel's `entry_points.txt`
file. This helps
avoid loading external repositories unless they're actually used, allows
entry
points to have better version-aware support, and allows bzlmod to
provide a
    supportable mechanism for entry points.

Because the expected common use case is an entry point for our pip
generated repos,
there is special logic to make that easy and concisely do. Usage of
`py_console_script_binary` is not tied to our pip code generation,
though, and users can
manually specify dependencies if they need to.

BREAKING CHANGE: This is a breaking change, but only for bzlmod users.
Note that
bzlmod support is still beta. Bzlmod users will need to replace using
`entry_point`
from `requirements.bzl` with loading `py_console_script_binary` and
defining the
entry point locally:

```
load("@rules_python//python/entry_points:py_console_script_binary.bzl, "py_console_script_binary")

py_console_script_binary(name="foo", pkg="@mypip//pylint")
```

For workspace users, this new macro is available to be used, but the old
code is still
present.

Fixes #1362
Fixes #543
Fixes #979
Fixes #1262
Closes #980
Closes #1294
Closes #1055

---------

Co-authored-by: Richard Levasseur <richardlev@gmail.com>