<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
</head>
<body text="#000000" bgcolor="#FFFFFF">
On 05.06.2018 3:09, Matthias Bussonnier wrote:<br>
<blockquote type="cite"
cite="mid:CANJQusUOUBgnUkby_4QRZNvMeC2qw6YEDGm0Ui0V-5Y4U+W4UA@mail.gmail.com">
<div dir="ltr">This may even be a bug/feature of IPython,
<div><br>
</div>
<div>I see that inspect.signature(timedelta) fails, so if <span
style="font-family:monospace,monospace">timedelta? says</span></div>
<div><span
style="color:rgb(34,34,34);font-family:monospace,monospace;font-size:13px;font-style:normal;font-variant-ligatures:normal;font-variant-caps:normal;font-weight:400;letter-spacing:normal;text-align:start;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;background-color:rgb(255,255,255);text-decoration-style:initial;text-decoration-color:initial;float:none;display:inline">Init
signature: timedelta(self, /, *args, **kwargs)</span></div>
<div><span
style="color:rgb(34,34,34);font-family:sans-serif;font-size:13px;font-style:normal;font-variant-ligatures:normal;font-variant-caps:normal;font-weight:400;letter-spacing:normal;text-align:start;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;background-color:rgb(255,255,255);text-decoration-style:initial;text-decoration-color:initial;float:none;display:inline">Then
this may be some IPython internal logic. The timedelta class
seem to use __new__ instead of __init__ (not sure why)</span></div>
</div>
</blockquote>
<p>Because it's an immutable type.</p>
<blockquote type="cite"
cite="mid:CANJQusUOUBgnUkby_4QRZNvMeC2qw6YEDGm0Ui0V-5Y4U+W4UA@mail.gmail.com">
<div dir="ltr">
<div><span
style="color:rgb(34,34,34);font-family:sans-serif;font-size:13px;font-style:normal;font-variant-ligatures:normal;font-variant-caps:normal;font-weight:400;letter-spacing:normal;text-align:start;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;background-color:rgb(255,255,255);text-decoration-style:initial;text-decoration-color:initial;float:none;display:inline">
and __new__ have a meaningful signature, </span><br>
</div>
<div><span
style="color:rgb(34,34,34);font-family:sans-serif;font-size:13px;font-style:normal;font-variant-ligatures:normal;font-variant-caps:normal;font-weight:400;letter-spacing:normal;text-align:start;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;background-color:rgb(255,255,255);text-decoration-style:initial;text-decoration-color:initial;float:none;display:inline">So
maybe we should fallback on that during signature
inspection.</span></div>
<div><span
style="color:rgb(34,34,34);font-family:sans-serif;font-size:13px;font-style:normal;font-variant-ligatures:normal;font-variant-caps:normal;font-weight:400;letter-spacing:normal;text-align:start;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;background-color:rgb(255,255,255);text-decoration-style:initial;text-decoration-color:initial;float:none;display:inline"><br>
</span></div>
</div>
</blockquote>
<p>According to
<a class="moz-txt-link-freetext" href="https://stackoverflow.com/questions/4374006/check-for-mutability-in-python">https://stackoverflow.com/questions/4374006/check-for-mutability-in-python</a>
,<br>
there are no reliable tests for mutability.</p>
<blockquote type="cite"
cite="mid:CANJQusUOUBgnUkby_4QRZNvMeC2qw6YEDGm0Ui0V-5Y4U+W4UA@mail.gmail.com">
<div dir="ltr">
<div><span
style="color:rgb(34,34,34);font-family:sans-serif;font-size:13px;font-style:normal;font-variant-ligatures:normal;font-variant-caps:normal;font-weight:400;letter-spacing:normal;text-align:start;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;background-color:rgb(255,255,255);text-decoration-style:initial;text-decoration-color:initial;float:none;display:inline">Feel
free to open an issue on the IPython repo. </span></div>
<div><span
style="color:rgb(34,34,34);font-family:sans-serif;font-size:13px;font-style:normal;font-variant-ligatures:normal;font-variant-caps:normal;font-weight:400;letter-spacing:normal;text-align:start;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;background-color:rgb(255,255,255);text-decoration-style:initial;text-decoration-color:initial;float:none;display:inline"><br>
</span></div>
<div><span
style="color:rgb(34,34,34);font-family:sans-serif;font-size:13px;font-style:normal;font-variant-ligatures:normal;font-variant-caps:normal;font-weight:400;letter-spacing:normal;text-align:start;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;background-color:rgb(255,255,255);text-decoration-style:initial;text-decoration-color:initial;float:none;display:inline">Btw
IPython is uppercase I, and we don't want any troupe with
the fruit giant. </span></div>
<div><span
style="color:rgb(34,34,34);font-family:sans-serif;font-size:13px;font-style:normal;font-variant-ligatures:normal;font-variant-caps:normal;font-weight:400;letter-spacing:normal;text-align:start;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;background-color:rgb(255,255,255);text-decoration-style:initial;text-decoration-color:initial;float:none;display:inline">-- </span></div>
<div><span
style="color:rgb(34,34,34);font-family:sans-serif;font-size:13px;font-style:normal;font-variant-ligatures:normal;font-variant-caps:normal;font-weight:400;letter-spacing:normal;text-align:start;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;background-color:rgb(255,255,255);text-decoration-style:initial;text-decoration-color:initial;float:none;display:inline">M</span></div>
</div>
<br>
<div class="gmail_quote">
<div dir="ltr">On Mon, 4 Jun 2018 at 16:30, Chris Barker via
Python-Dev <<a href="mailto:python-dev@python.org"
moz-do-not-send="true">python-dev@python.org</a>> wrote:<br>
</div>
<blockquote class="gmail_quote" style="margin:0 0 0
.8ex;border-left:1px #ccc solid;padding-left:1ex">
<div dir="ltr">
<div class="gmail_extra">
<div class="gmail_quote">On Mon, Jun 4, 2018 at 3:27 PM,
Victor Stinner <span dir="ltr"><<a
href="mailto:vstinner@redhat.com" target="_blank"
moz-do-not-send="true">vstinner@redhat.com</a>></span>
wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0
.8ex;border-left:1px #ccc solid;padding-left:1ex">For
Argument Clinic, have a look at<br>
<a
href="https://docs.python.org/dev/howto/clinic.html"
rel="noreferrer" target="_blank"
moz-do-not-send="true">https://docs.python.org/dev/howto/clinic.html</a></blockquote>
<div><br>
</div>
<div>Thanks Victor -- scanning that page, it is indeed
where I needed to look.</div>
<div><br>
</div>
<blockquote class="gmail_quote" style="margin:0 0 0
.8ex;border-left:1px #ccc solid;padding-left:1ex">
You can also try to copy/paste code from other files
using Argument<br>
Clinic and then run "make clinic" to regenerate the
generated files.<br>
</blockquote>
<div><br>
</div>
<div>good idea.</div>
<div><br>
</div>
<div>Now to find some time to actually work on this...</div>
<div><br>
</div>
<div>-CHB</div>
<div><br>
</div>
<div><br>
</div>
<div> </div>
<blockquote class="gmail_quote" style="margin:0 0 0
.8ex;border-left:1px #ccc solid;padding-left:1ex">
Victor<br>
<div>
<div class="m_4303805125824697471h5"><br>
2018-06-04 23:45 GMT+02:00 Chris Barker via
Python-Dev <<a
href="mailto:python-dev@python.org"
target="_blank" moz-do-not-send="true">python-dev@python.org</a>>:<br>
> Over on python-ideas, someone is/was
proposing literals for timedeltas.<br>
><br>
> I don't expect that will come to anything,
but it did make me take a look at<br>
> the docstring for datetime.timedelta. I use
iPython's ? a lot for a quick<br>
> overview of how to use a class/function.<br>
><br>
> This is what I get:<br>
><br>
> In [8]: timedelta?<br>
> Init signature: timedelta(self, /, *args,
**kwargs)<br>
> Docstring: Difference between two
datetime values.<br>
> File:
~/miniconda2/envs/py3/lib/python3.6/datetime.py<br>
> Type: type<br>
><br>
><br>
> That is, well, not so useful. I'd like to see
at least the signature:<br>
><br>
> datetime.timedelta(days=0, seconds=0,
microseconds=0, milliseconds=0,<br>
> minutes=0, hours=0, weeks=0<br>
><br>
> And ideally much of the text in the docs.<br>
><br>
> I've noticed similarly minimal docstrings on
a number of builtin functions<br>
> and methods.<br>
><br>
> If I wanted to contribute a PR to enhance
these docstrings, where would they<br>
> go? I've seen mention of "argument clinic",
but really don't know quite<br>
> what that is, or how it works, but it appears
to be related.<br>
><br>
> Anyway -- more comprehensive docstrings on
buildins could really help<br>
> Python's usability for command line usage.<br>
><br>
> Thanks,<br>
> - Chris<br>
><br>
><br>
><br>
><br>
> --<br>
><br>
> Christopher Barker, Ph.D.<br>
> Oceanographer<br>
><br>
> Emergency Response Division<br>
> NOAA/NOS/OR&R (206) 526-6959
voice<br>
> 7600 Sand Point Way NE (206) 526-6329 fax<br>
> Seattle, WA 98115 (206) 526-6317
main reception<br>
><br>
> <a href="mailto:Chris.Barker@noaa.gov"
target="_blank" moz-do-not-send="true">Chris.Barker@noaa.gov</a><br>
><br>
</div>
</div>
> _______________________________________________<br>
> Python-Dev mailing list<br>
> <a href="mailto:Python-Dev@python.org"
target="_blank" moz-do-not-send="true">Python-Dev@python.org</a><br>
> <a
href="https://mail.python.org/mailman/listinfo/python-dev"
rel="noreferrer" target="_blank"
moz-do-not-send="true">https://mail.python.org/mailman/listinfo/python-dev</a><br>
> Unsubscribe:<br>
> <a
href="https://mail.python.org/mailman/options/python-dev/vstinner%40redhat.com"
rel="noreferrer" target="_blank"
moz-do-not-send="true">https://mail.python.org/mailman/options/python-dev/vstinner%40redhat.com</a><br>
><br>
</blockquote>
</div>
<br>
<br clear="all">
<div><br>
</div>
-- <br>
<div class="m_4303805125824697471gmail_signature"
data-smartmail="gmail_signature"><br>
Christopher Barker, Ph.D.<br>
Oceanographer<br>
<br>
Emergency Response Division<br>
NOAA/NOS/OR&R (206) 526-6959 voice<br>
7600 Sand Point Way NE (206) 526-6329 fax<br>
Seattle, WA 98115 (206) 526-6317 main reception<br>
<br>
<a href="mailto:Chris.Barker@noaa.gov" target="_blank"
moz-do-not-send="true">Chris.Barker@noaa.gov</a></div>
</div>
</div>
_______________________________________________<br>
Python-Dev mailing list<br>
<a href="mailto:Python-Dev@python.org" target="_blank"
moz-do-not-send="true">Python-Dev@python.org</a><br>
<a href="https://mail.python.org/mailman/listinfo/python-dev"
rel="noreferrer" target="_blank" moz-do-not-send="true">https://mail.python.org/mailman/listinfo/python-dev</a><br>
Unsubscribe: <a
href="https://mail.python.org/mailman/options/python-dev/bussonniermatthias%40gmail.com"
rel="noreferrer" target="_blank" moz-do-not-send="true">https://mail.python.org/mailman/options/python-dev/bussonniermatthias%40gmail.com</a><br>
</blockquote>
</div>
<!--'"--><br>
<fieldset class="mimeAttachmentHeader"></fieldset>
<br>
<pre wrap="">_______________________________________________
Python-Dev mailing list
<a class="moz-txt-link-abbreviated" href="mailto:Python-Dev@python.org">Python-Dev@python.org</a>
<a class="moz-txt-link-freetext" href="https://mail.python.org/mailman/listinfo/python-dev">https://mail.python.org/mailman/listinfo/python-dev</a>
Unsubscribe: <a class="moz-txt-link-freetext" href="https://mail.python.org/mailman/options/python-dev/vano%40mail.mipt.ru">https://mail.python.org/mailman/options/python-dev/vano%40mail.mipt.ru</a>
</pre>
</blockquote>
<br>
<pre class="moz-signature" cols="72">--
Regards,
Ivan</pre>
</body>
</html>