How to setup home-page in pyproject.toml

[se7enXF]

I follow this guide and code my pyproject.toml like this:

...
[project]
name='[package_name]'
...
urls = {'home-page' = 'xxx.xxx'} 

When I install the package and show info of package by using pip show [package_name], there is empty after Home-page:.
There is no example in core-metadata for setup home-page in pyproject.toml. Am I missing something?

[abravalheri]

Hi @se7enXF, which version of setuptools are you using?

Until recently setuptools would backfill Homepage automatically based on url.homepage (home-page/Home-page/Homepage etc...), but then some users provided feedback about this behaviour not being desirable (You can follow the discussion here: pypi/warehouse#11220, and have a look on the patch here: 1cfa27c).

Some part of the community understands that Project-URL: Homepage, http://... is equivalent to Home-page: http://..., and that Home-page: ... should be deprecated.

[se7enXF]

Thank you @abravalheri. I wish the setuptools guidance notes would include relevant examples. The examples now cover too limited content. I can't figure out the relationship between the keyword in setup() and the section in pyproject.toml. And the Dynamic method is not very clear to me.

[abravalheri]

Hi @se7enXF, for the time being only the [project] table is considered stable, we are reserving [tool.setuptools] as experimental so we can still evolve our configuration.

The relationship between [project] with the previous keyworks is listed in PEP 621.

url is an special case since we don't have a PEP that officially deprecates Home-page. It is a recent change mostly discussed in pypa/warehouse (the official souce code for PyPI).

Indeed, the dynamic key is a very difficult to understand, even in the original standard specification. I tried to add the 2 examples that I think are the more useful in the docs (version and readme): https://setuptools.pypa.io/en/latest/userguide/pyproject_config.html#dynamic-metadata.

If you have any suggestions on how to improve the documentation, please feel free to submit a PR, it would be very appreciated!

[wimglenn]

@se7enXF For the relationship between the keyword in setup() and the section in pyproject.toml, I have a table on https://github.com/wimglenn/setuptools-ext landing page that might be helpful