mxm closed pull request #6761: [FLINK-10279] [documentation] Make jython limitations more obvious in documentation. URL: https://github.com/apache/flink/pull/6761
This is a PR merged from a forked repository. As GitHub hides the original diff on merge, it is displayed below for the sake of provenance: As this is a foreign pull request (from a fork), the diff is supplied below (as it won't show otherwise due to GitHub magic): diff --git a/docs/dev/stream/python.md b/docs/dev/stream/python.md index af9c393b3ea..e7c2fb267ba 100644 --- a/docs/dev/stream/python.md +++ b/docs/dev/stream/python.md @@ -24,6 +24,10 @@ specific language governing permissions and limitations under the License. --> +<span class="label label-danger">Attention</span> *This API is based on Jython, +which is not a full Python replacement and may restrict the libraries you are able +to use with your application (see below for more information).* + Analysis streaming programs in Flink are regular programs that implement transformations on streaming data sets (e.g., filtering, mapping, joining, grouping). The streaming data sets are initially created from certain sources (e.g., by reading files, or from collections). @@ -50,7 +54,12 @@ existing Java streaming APIs. There are two main constraints for using Jython: * The latest Python supported version is 2.7 -* It is not straightforward to use Python C extensions +* It is not straightforward to use Python C extensions, which may prevent use of some libraries + +(For more information please see <https://wiki.python.org/jython/JythonFaq/GeneralInfo>.) + +One possible alternative for streaming that allows for native Python execution would be the [Apache Beam +portability framework](https://beam.apache.org/contribute/portability/) with the Flink runner. Streaming Program Example ------------------------- ---------------------------------------------------------------- This is an automated message from the Apache Git Service. To respond to the message, please log on GitHub and use the URL above to go to the specific comment. For queries about this service, please contact Infrastructure at: us...@infra.apache.org With regards, Apache Git Services