You are viewing a plain text version of this content. The canonical link for it is here.
Posted to user@flink.apache.org by Yik San Chan <ev...@gmail.com> on 2021/04/26 12:57:49 UTC
Confusing docs on python.archives
Hi community,
In
https://ci.apache.org/projects/flink/flink-docs-stable/dev/python/python_config.html#python-options
,
> For each archive file, a target directory is specified. If the target
directory name is specified, the archive file will be extracted to a name
can directory with the specified name. Otherwise, the archive file will be
extracted to a directory with the same name of the archive file.
I don't get what does "the archive file will be extracted to a name can
directory with the specified name" mean. Maybe there are typos?
best,
Yik San
Re: Confusing docs on python.archives
Posted by Dian Fu <di...@gmail.com>.
Thank you a lot~
> 2021年4月27日 下午5:38，Yik San Chan <ev...@gmail.com> 写道：
>
> Hi Dian,
>
> As a follow-up, I fix the docs here https://github.com/apache/flink/pull/15783 <https://github.com/apache/flink/pull/15783>
>
> Best,
> Yik San
>
> On Tue, Apr 27, 2021 at 10:20 AM Dian Fu <dian0511.fu@gmail.com <ma...@gmail.com>> wrote:
> For the command line arguments, it’s documented in https://ci.apache.org/projects/flink/flink-docs-release-1.11/ops/cli.html <https://ci.apache.org/projects/flink/flink-docs-release-1.11/ops/cli.html>
>
>> 2021年4月27日 上午10:19，Dian Fu <dian0511.fu@gmail.com <ma...@gmail.com>> 写道：
>>
>> There are multiple ways to specify the target directory depending on how to specify the python archives.
>> 1) API: add_python_archive(“file:///path/to/py_env <>.zip", "myenv"), see [1] for more details,
>> 2) configuration: python.archives, e.g. file:///path/to/py_env.zip#myenv <>
>> 3) command line arguments: -pyarch file:///path/to/py <>_env.zip#myenv
>>
>> You can specify python archives via either of the above options and it will extract py_env.zip into directory myenv during execution.
>>
>> [1] https://ci.apache.org/projects/flink/flink-docs-release-1.12/dev/python/table-api-users-guide/dependency_management.html <https://ci.apache.org/projects/flink/flink-docs-release-1.12/dev/python/table-api-users-guide/dependency_management.html>
>>
>>> 2021年4月27日 上午8:17，Yik San Chan <evan.chanyiksan@gmail.com <ma...@gmail.com>> 写道：
>>>
>>> Hi Dian,
>>>
>>> I wonder where can we specify the target directory?
>>>
>>> Best,
>>> Yik San
>>>
>>> On Mon, Apr 26, 2021 at 9:19 PM Dian Fu <dian0511.fu@gmail.com <ma...@gmail.com>> wrote:
>>> Hi Yik San,
>>>
>>> It should be a typo issue. I guess it should be `If the target directory name is specified, the archive file will be extracted to a directory with the specified name.`
>>>
>>> Regards,
>>> Dian
>>>
>>>> 2021年4月26日 下午8:57，Yik San Chan <evan.chanyiksan@gmail.com <ma...@gmail.com>> 写道：
>>>>
>>>> Hi community,
>>>>
>>>> In https://ci.apache.org/projects/flink/flink-docs-stable/dev/python/python_config.html#python-options <https://ci.apache.org/projects/flink/flink-docs-stable/dev/python/python_config.html#python-options>,
>>>>
>>>> > For each archive file, a target directory is specified. If the target directory name is specified, the archive file will be extracted to a name can directory with the specified name. Otherwise, the archive file will be extracted to a directory with the same name of the archive file.
>>>>
>>>> I don't get what does "the archive file will be extracted to a name can directory with the specified name" mean. Maybe there are typos?
>>>>
>>>> best,
>>>> Yik San
>>>
>>
>
Re: Confusing docs on python.archives
Posted by Yik San Chan <ev...@gmail.com>.
Hi Dian,
As a follow-up, I fix the docs here
https://github.com/apache/flink/pull/15783
Best,
Yik San
On Tue, Apr 27, 2021 at 10:20 AM Dian Fu <di...@gmail.com> wrote:
> For the command line arguments, it’s documented in
> https://ci.apache.org/projects/flink/flink-docs-release-1.11/ops/cli.html
>
> 2021年4月27日 上午10:19，Dian Fu <di...@gmail.com> 写道：
>
> There are multiple ways to specify the target directory depending on how
> to specify the python archives.
> 1) API: add_python_archive(“file:///path/to/py_env.zip", "myenv"), see
> [1] for more details,
> 2) configuration: python.archives, e.g. file:///path/to/py_env.zip#myenv
> 3) command line arguments: -pyarch file:///path/to/py_env.zip#myenv
>
> You can specify python archives via either of the above options and it
> will extract py_env.zip into directory myenv during execution.
>
> [1]
> https://ci.apache.org/projects/flink/flink-docs-release-1.12/dev/python/table-api-users-guide/dependency_management.html
>
> 2021年4月27日 上午8:17，Yik San Chan <ev...@gmail.com> 写道：
>
> Hi Dian,
>
> I wonder where can we specify the target directory?
>
> Best,
> Yik San
>
> On Mon, Apr 26, 2021 at 9:19 PM Dian Fu <di...@gmail.com> wrote:
>
>> Hi Yik San,
>>
>> It should be a typo issue. I guess it should be `If the target directory
>> name is specified, the archive file will be extracted to a directory with
>> the specified name.`
>>
>> Regards,
>> Dian
>>
>> 2021年4月26日 下午8:57，Yik San Chan <ev...@gmail.com> 写道：
>>
>> Hi community,
>>
>> In
>> https://ci.apache.org/projects/flink/flink-docs-stable/dev/python/python_config.html#python-options
>> ,
>>
>> > For each archive file, a target directory is specified. If the target
>> directory name is specified, the archive file will be extracted to a name
>> can directory with the specified name. Otherwise, the archive file will be
>> extracted to a directory with the same name of the archive file.
>>
>> I don't get what does "the archive file will be extracted to a name can
>> directory with the specified name" mean. Maybe there are typos?
>>
>> best,
>> Yik San
>>
>>
>>
>
>
Re: Confusing docs on python.archives
Posted by Dian Fu <di...@gmail.com>.
For the command line arguments, it’s documented in https://ci.apache.org/projects/flink/flink-docs-release-1.11/ops/cli.html
> 2021年4月27日 上午10:19，Dian Fu <di...@gmail.com> 写道：
>
> There are multiple ways to specify the target directory depending on how to specify the python archives.
> 1) API: add_python_archive(“file:///path/to/py_env <file:///path/to/py_env>.zip", "myenv"), see [1] for more details,
> 2) configuration: python.archives, e.g. file:///path/to/py_env.zip#myenv <file:///path/to/py_env.zip#myenv>
> 3) command line arguments: -pyarch file:///path/to/py <file:///path/to/py>_env.zip#myenv
>
> You can specify python archives via either of the above options and it will extract py_env.zip into directory myenv during execution.
>
> [1] https://ci.apache.org/projects/flink/flink-docs-release-1.12/dev/python/table-api-users-guide/dependency_management.html <https://ci.apache.org/projects/flink/flink-docs-release-1.12/dev/python/table-api-users-guide/dependency_management.html>
>
>> 2021年4月27日 上午8:17，Yik San Chan <evan.chanyiksan@gmail.com <ma...@gmail.com>> 写道：
>>
>> Hi Dian,
>>
>> I wonder where can we specify the target directory?
>>
>> Best,
>> Yik San
>>
>> On Mon, Apr 26, 2021 at 9:19 PM Dian Fu <dian0511.fu@gmail.com <ma...@gmail.com>> wrote:
>> Hi Yik San,
>>
>> It should be a typo issue. I guess it should be `If the target directory name is specified, the archive file will be extracted to a directory with the specified name.`
>>
>> Regards,
>> Dian
>>
>>> 2021年4月26日 下午8:57，Yik San Chan <evan.chanyiksan@gmail.com <ma...@gmail.com>> 写道：
>>>
>>> Hi community,
>>>
>>> In https://ci.apache.org/projects/flink/flink-docs-stable/dev/python/python_config.html#python-options <https://ci.apache.org/projects/flink/flink-docs-stable/dev/python/python_config.html#python-options>,
>>>
>>> > For each archive file, a target directory is specified. If the target directory name is specified, the archive file will be extracted to a name can directory with the specified name. Otherwise, the archive file will be extracted to a directory with the same name of the archive file.
>>>
>>> I don't get what does "the archive file will be extracted to a name can directory with the specified name" mean. Maybe there are typos?
>>>
>>> best,
>>> Yik San
>>
>
Re: Confusing docs on python.archives
Posted by Dian Fu <di...@gmail.com>.
There are multiple ways to specify the target directory depending on how to specify the python archives.
1) API: add_python_archive(“file:///path/to/py_env <file:///path/to/py_env>.zip", "myenv"), see [1] for more details,
2) configuration: python.archives, e.g. file:///path/to/py_env.zip#myenv
3) command line arguments: -pyarch file:///path/to/py <file:///path/to/py>_env.zip#myenv
You can specify python archives via either of the above options and it will extract py_env.zip into directory myenv during execution.
[1] https://ci.apache.org/projects/flink/flink-docs-release-1.12/dev/python/table-api-users-guide/dependency_management.html
> 2021年4月27日 上午8:17，Yik San Chan <ev...@gmail.com> 写道：
>
> Hi Dian,
>
> I wonder where can we specify the target directory?
>
> Best,
> Yik San
>
> On Mon, Apr 26, 2021 at 9:19 PM Dian Fu <dian0511.fu@gmail.com <ma...@gmail.com>> wrote:
> Hi Yik San,
>
> It should be a typo issue. I guess it should be `If the target directory name is specified, the archive file will be extracted to a directory with the specified name.`
>
> Regards,
> Dian
>
>> 2021年4月26日 下午8:57，Yik San Chan <evan.chanyiksan@gmail.com <ma...@gmail.com>> 写道：
>>
>> Hi community,
>>
>> In https://ci.apache.org/projects/flink/flink-docs-stable/dev/python/python_config.html#python-options <https://ci.apache.org/projects/flink/flink-docs-stable/dev/python/python_config.html#python-options>,
>>
>> > For each archive file, a target directory is specified. If the target directory name is specified, the archive file will be extracted to a name can directory with the specified name. Otherwise, the archive file will be extracted to a directory with the same name of the archive file.
>>
>> I don't get what does "the archive file will be extracted to a name can directory with the specified name" mean. Maybe there are typos?
>>
>> best,
>> Yik San
>
Re: Confusing docs on python.archives
Posted by Yik San Chan <ev...@gmail.com>.
Hi Dian,
I wonder where can we specify the target directory?
Best,
Yik San
On Mon, Apr 26, 2021 at 9:19 PM Dian Fu <di...@gmail.com> wrote:
> Hi Yik San,
>
> It should be a typo issue. I guess it should be `If the target directory
> name is specified, the archive file will be extracted to a directory with
> the specified name.`
>
> Regards,
> Dian
>
> 2021年4月26日 下午8:57，Yik San Chan <ev...@gmail.com> 写道：
>
> Hi community,
>
> In
> https://ci.apache.org/projects/flink/flink-docs-stable/dev/python/python_config.html#python-options
> ,
>
> > For each archive file, a target directory is specified. If the target
> directory name is specified, the archive file will be extracted to a name
> can directory with the specified name. Otherwise, the archive file will be
> extracted to a directory with the same name of the archive file.
>
> I don't get what does "the archive file will be extracted to a name can
> directory with the specified name" mean. Maybe there are typos?
>
> best,
> Yik San
>
>
>
Re: Confusing docs on python.archives
Posted by Dian Fu <di...@gmail.com>.
Hi Yik San,
It should be a typo issue. I guess it should be `If the target directory name is specified, the archive file will be extracted to a directory with the specified name.`
Regards,
Dian
> 2021年4月26日 下午8:57，Yik San Chan <ev...@gmail.com> 写道：
>
> Hi community,
>
> In https://ci.apache.org/projects/flink/flink-docs-stable/dev/python/python_config.html#python-options <https://ci.apache.org/projects/flink/flink-docs-stable/dev/python/python_config.html#python-options>,
>
> > For each archive file, a target directory is specified. If the target directory name is specified, the archive file will be extracted to a name can directory with the specified name. Otherwise, the archive file will be extracted to a directory with the same name of the archive file.
>
> I don't get what does "the archive file will be extracted to a name can directory with the specified name" mean. Maybe there are typos?
>
> best,
> Yik San