#1013092 ITP: sphinx-autosummary-accessors -- sphinx autosummary extension to pandas or xarray accessors

Package:
wnpp
Source:
wnpp
Submitter:
Diane Trout
Date:
2025-11-29 16:51:05 UTC
Severity:
wishlist
#1013092#5
Date:
2022-06-16 20:32:58 UTC
From:
To:
* Package name    : python3-sphinx-autosummary-accessors
  Version         : 2022.4.0-1
  Upstream Author : Justus Magin <keewis@posteo.de>
* URL or Web page : https://github.com/xarray-contrib/sphinx-autosummary-accessors
* License         : MIT
  Description     : sphinx autosummary extension to pandas or xarray accessors

This is a new dependency for building the documentation for dask.

One confusing issue is the project is marked as being MIT licensed, but
includes the pandas BSD-3 license because some of this project was
derived from pandas.

Unfortunately there's nothing that says what files were derived from
pandas.

So my copyright file marks everything as MIT / Expat, but includes the
pandas BSD license block though I don't know what to attach it to.

I was planning on adding this to the debian python team.

Diane Trout
#1013092#10
Date:
2022-06-16 22:32:55 UTC
From:
To:
Quoting Diane Trout (2022-06-16 22:32:58)

I guess that by "MIT / Expat" you mean that you declared the project as
beinge effectively licensed "MIT or Expat".

From your description of the situation, the better approach is to
instead declare it as licensed "MIT and Expat".


 - Jonas
#1013092#15
Date:
2022-06-17 05:12:58 UTC
From:
To:
https://github.com/xarray-contrib/sphinx-autosummary-accessors/blob/main/LICENSE

Which looks like MIT (Expat)
https://www.debian.org/legal/licenses/mit

In reading the history of how this project came to be they say at
https://github.com/xarray-contrib/sphinx-autosummary-accessors

   sphinx.ext.autosummary is able to create summary and object pages
   for objects and their methods, but it doesn't work well with
   accessor styled properties and methods (obj.accessor.attribute).
   pandas has accessor documentation built using sphinx.ext.autosummary
   templates, which xarray recently adopted by copying the templates
   and all related code.

   To avoid even more duplicated code, and to make it easier for
   projects to document their custom accessors, this project aims to
   provide this functionality by way of a sphinx extension.

   Most of the code was adapted from pandas.

Which is why I think the pandas BSD 3 clause license is included.

So perhaps it would be best to say MIT and BSD-3-clause.

Diane
#1013092#20
Date:
2022-06-17 06:33:55 UTC
From:
To:
Quoting Diane Trout (2022-06-17 07:12:58)

Sorry for my complete nonsense: I am baffled that I managed to write a
full email without noticing that I was talking about same license twice,
not two separate licenses.

 - Jonas
#1013092#27
Date:
2022-11-24 06:43:43 UTC
From:
To:
Dear Diane,

This package is also needed for new version of dask.
I'm interested in having it in the archive so I would like to know what
is the status of this package. Do you already have some work done?

Is there anything I can do to help?


kind regards