seanfisk / python-project-template

A template Python project with a focus on best practices.
Other
543 stars 168 forks source link

Upgrade to Setuptools. #16

Closed seanfisk closed 11 years ago

seanfisk commented 11 years ago

Distribute and Setuptools have merged into Setuptools, so it looks like Setuptools is the future. We should upgrade.

bitmensch commented 11 years ago

@seanfisk Could you give a short high-level overview about the impacts of this change. What would need to be changed to upgrade to setuptools?

Doing a simple grep for the word distribute does not show up any dependencies to me, only some comments and link to Distribute.

Is Distribute currently really a requirement we have? Did I miss something?

seanfisk commented 11 years ago

The confusing thing about Distribute is that it masquerades under the package name setuptools. Distribute was created as an updated (and maintained) version of Setuptools as was envisioned to function as a drop-in replacement, hence the identical package name. People have moved on to using Distribute by default (e.g., virtualenv), so Setuptools was kind of forgotten. I'm not sure if the merge reduces confusion or adds more of it.

We do have somewhat hard dependencies on Distribute. In setup.py.tpl:4, this import actually refers to Distribute. In addition, the last three keywords of setup_dict are Distribute-specific. Specifically, we use Distribute for the following:

I am hoping that "upgrading" to Setuptools will only require a few minor documentation changes, with some possible small code changes. Does that answer your question?

bitmensch commented 11 years ago

@seanfisk Yes, this answers my question. Thanks for clarifying.

seanfisk commented 11 years ago

Finished.