<div dir="ltr"><div><br></div><div class="gmail_extra"><br><div class="gmail_quote">On Thu, Jun 28, 2018 at 11:26 PM, Alex Walters <span dir="ltr"><<a href="mailto:tritium-list@sdamon.com" target="_blank">tritium-list@sdamon.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">But don't all the users who care about citing modules already use the scientific python packages, with scipy itself at it's center?  Wouldn't those engaging in science or in academia be better stewards of this than systems programmers?  Since you're not asking for anything that can't be done in a third party module, and there is a third party module that most of the target audience of this standard would already have, there is zero reason to take up four names in the python runtime to serve those users.<br>
</blockquote><div> </div><div><br></div><div>Not all scientific software in Python depends on scipy or even numpy. However, it does all depend on Python.</div><div><br></div><div>Although perhaps that argues for a cross-language solution :)</div><div><br></div><div>I still think it would be very nice to have an official standard for citation information in Python packages as codified in a PEP. That would reduce ambiguity and make it much easier for tool-writers who want to parse citation information.<br></div><div><br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div class="HOEnZb"><div class="h5">
> -----Original Message-----<br>
> From: Adrian Price-Whelan <<a href="mailto:adrianmpw@gmail.com">adrianmpw@gmail.com</a>><br>
> Sent: Friday, June 29, 2018 12:16 AM<br>
> To: Alex Walters <<a href="mailto:tritium-list@sdamon.com">tritium-list@sdamon.com</a>><br>
> Cc: Steven D'Aprano <<a href="mailto:steve@pearwood.info">steve@pearwood.info</a>>; <a href="mailto:python-ideas@python.org">python-ideas@python.org</a><br>
> Subject: Re: [Python-ideas] Add a __cite__ method for scientific packages<br>
> <br>
> For me, it's about setting a standard that is endorsed by the<br>
> language, and setting expectations for users. There currently is no<br>
> standard, which is why packages use __citation__, __cite__,<br>
> __bibtex__, etc., and as a user I don't immediately know where to look<br>
> for citation information (without going to the source). My feeling is<br>
> that adopting __citation__ or some dunder name could be implemented on<br>
> classes, functions, etc. with less of a chance of naming conflicts,<br>
> but am open to discussion.<br>
> <br>
> I have some notes here about various ideas for more advanced<br>
> functionality that would support automatically keeping track of<br>
> citation information for imported packages, classes, functions:<br>
> <a href="https://github.com/adrn/CitationPEP/blob/master/NOTES.md" rel="noreferrer" target="_blank">https://github.com/adrn/<wbr>CitationPEP/blob/master/NOTES.<wbr>md</a><br>
> <br>
> On Thu, Jun 28, 2018 at 10:57 PM, Alex Walters <<a href="mailto:tritium-list@sdamon.com">tritium-list@sdamon.com</a>><br>
> wrote:<br>
> > Why not scipy.cite() or scipy.citation()?  I don't see any reason for these<br>
> > functions to ship with standard python at all.<br>
> ><br>
> >> -----Original Message-----<br>
> >> From: Python-ideas <python-ideas-bounces+tritium-<br>
> >> list=<a href="mailto:sdamon.com@python.org">sdamon.com@python.org</a>> On Behalf Of Steven D'Aprano<br>
> >> Sent: Thursday, June 28, 2018 8:17 PM<br>
> >> To: <a href="mailto:python-ideas@python.org">python-ideas@python.org</a><br>
> >> Subject: Re: [Python-ideas] Add a __cite__ method for scientific packages<br>
> >><br>
> >> On Thu, Jun 28, 2018 at 05:25:00PM -0400, Andrei Kucharavy wrote:<br>
> >><br>
> >> > As for the list, reserving a __citation__/__cite__ for packages at the<br>
> > same<br>
> >> > level as __version__ is now reserved and adding a citation()/cite()<br>
> >> > function to the standard library seemed large enough modifications to<br>
> >> > warrant searching a buy-in from the maintainers and the community at<br>
> >> large.<br>
> >><br>
> >> I think that an approach similar to help/quit/exit is warranted. The<br>
> >> cite()/citation() function need not be *literally* built into the<br>
> >> language, it could be an external function written in Python and added<br>
> >> to builtins by the site.py module.<br>
> >><br>
> >><br>
> >><br>
> >><br>
> >> --<br>
> >> Steve<br>
> >> ______________________________<wbr>_________________<br>
> >> Python-ideas mailing list<br>
> >> <a href="mailto:Python-ideas@python.org">Python-ideas@python.org</a><br>
> >> <a href="https://mail.python.org/mailman/listinfo/python-ideas" rel="noreferrer" target="_blank">https://mail.python.org/<wbr>mailman/listinfo/python-ideas</a><br>
> >> Code of Conduct: <a href="http://python.org/psf/codeofconduct/" rel="noreferrer" target="_blank">http://python.org/psf/<wbr>codeofconduct/</a><br>
> ><br>
> > ______________________________<wbr>_________________<br>
> > Python-ideas mailing list<br>
> > <a href="mailto:Python-ideas@python.org">Python-ideas@python.org</a><br>
> > <a href="https://mail.python.org/mailman/listinfo/python-ideas" rel="noreferrer" target="_blank">https://mail.python.org/<wbr>mailman/listinfo/python-ideas</a><br>
> > Code of Conduct: <a href="http://python.org/psf/codeofconduct/" rel="noreferrer" target="_blank">http://python.org/psf/<wbr>codeofconduct/</a><br>
> <br>
> <br>
> <br>
> --<br>
> Adrian M. Price-Whelan<br>
> Lyman Spitzer, Jr. Postdoctoral Fellow<br>
> Princeton University<br>
> <a href="http://adrn.github.io" rel="noreferrer" target="_blank">http://adrn.github.io</a><br>
<br>
______________________________<wbr>_________________<br>
Python-ideas mailing list<br>
<a href="mailto:Python-ideas@python.org">Python-ideas@python.org</a><br>
<a href="https://mail.python.org/mailman/listinfo/python-ideas" rel="noreferrer" target="_blank">https://mail.python.org/<wbr>mailman/listinfo/python-ideas</a><br>
Code of Conduct: <a href="http://python.org/psf/codeofconduct/" rel="noreferrer" target="_blank">http://python.org/psf/<wbr>codeofconduct/</a><br>
</div></div></blockquote></div><br></div></div>