[issue24509] Undocumented features of asyncio: call_at, call_later

2015-06-25 Thread Марк Коренберг

Changes by Марк Коренберг socketp...@gmail.com:


--
assignee:  - docs@python
components: +Documentation, asyncio
nosy: +docs@python, gvanrossum, haypo, yselivanov
type:  - enhancement

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue24509
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



[issue24509] Undocumented features of asyncio: call_at, call_later

2015-06-25 Thread Марк Коренберг

New submission from Марк Коренберг:

These function returns handle, so, registered callback can be cancelled.

--
messages: 245803
nosy: mmarkk
priority: normal
severity: normal
status: open
title: Undocumented features of asyncio: call_at, call_later
versions: Python 3.6

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue24509
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



[issue24509] Undocumented features of asyncio: call_at, call_later

2015-06-25 Thread STINNER Victor

STINNER Victor added the comment:

Documentatin of call_soon() and call_later() contain the sentence An instance 
of asyncio.Handle is returned. with a link to Handle which shows the cancel() 
method:

https://docs.python.org/dev/library/asyncio-eventloop.html#asyncio.BaseEventLoop.call_soon

https://docs.python.org/dev/library/asyncio-eventloop.html#asyncio.BaseEventLoop.call_later

Can you please suggest a new sentence to explain that a Handle can be cancelled?

--

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue24509
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



[issue24509] Undocumented features of asyncio: call_at, call_later

2015-06-25 Thread Roundup Robot

Roundup Robot added the comment:

New changeset 3199ec504dbe by Yury Selivanov in branch '3.4':
Issue #24509: Clarify Handle.cancel() and loop.call_* methods.
https://hg.python.org/cpython/rev/3199ec504dbe

New changeset fc69dd6aea55 by Yury Selivanov in branch '3.5':
Merge 3.4 (issue #24509)
https://hg.python.org/cpython/rev/fc69dd6aea55

New changeset 9aad116baee8 by Yury Selivanov in branch 'default':
Merge 3.5 (issue #24509)
https://hg.python.org/cpython/rev/9aad116baee8

--
nosy: +python-dev

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue24509
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



[issue24509] Undocumented features of asyncio: call_at, call_later

2015-06-25 Thread Yury Selivanov

Yury Selivanov added the comment:

Thanks for reporting this Mark!

--
resolution:  - fixed
stage:  - commit review
status: open - closed
versions: +Python 3.4, Python 3.5

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue24509
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



[issue24509] Undocumented features of asyncio: call_at, call_later

2015-06-25 Thread Марк Коренберг

Марк Коренберг added the comment:

For delayed execution methods:

Returned handle is actually timer object. That timer can be deactivated using 
asyncio.Handle.cancel() method, so registered callback won't be called.

For other callback registration methods:

Returned handle may be used to unregister callback using 
asyncio.Handle.cancel(), so registered callback won't be called.


Also:
1. Documentation of .cancel does not say if it is allowed to cancel cancelled 
handle.
2. Documentation does not say if it is allowed to cancel timer, that was 
already fired.

--

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue24509
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com