useblocks / sphinx-simplepdf

A simple PDF builder for Sphinx documentations
https://sphinx-simplepdf.readthedocs.io
MIT License
36 stars 15 forks source link

Warnings during build of python package #33

Closed kreuzberger closed 1 year ago

kreuzberger commented 1 year ago

Building spihnx-simplepdf by calling python3 setup.py build

gives me warnings like:

!!

  check.warn(importable)
/python3.10/site-packages/setuptools/command/build_py.py:202: SetuptoolsDeprecationWarning:     Installing 'sphinx_simplepdf.themes/simplepdf_theme.static.styles.sources' as data is deprecated, please list it in `packages`.
    !!

    ############################
    # Package would be ignored #
    ############################
    Python recognizes 'sphinx_simplepdf.themes/simplepdf_theme.static.styles.sources' as an importable package,
    but it is not listed in the `packages` configuration of setuptools.

    'sphinx_simplepdf.themes/simplepdf_theme.static.styles.sources' has been automatically added to the distribution only
    because it may contain data files, but this behavior is likely to change
    in future versions of setuptools (and therefore is considered deprecated).

    Please make sure that 'sphinx_simplepdf.themes/simplepdf_theme.static.styles.sources' is included as a package by using
    the `packages` configuration field or the proper discovery methods
    (for example by using `find_namespace_packages(...)`/`find_namespace:`
    instead of `find_packages(...)`/`find:`).

    You can read more about "package discovery" and "data files" on setuptools
    documentation page.

!!

How should the package be builded?

kreuzberger commented 1 year ago

Building the package just with pip3 install . like in the newest documentation fixed the warnings