Packaging of examples as data is deprecated

[ischoegl]

Problem description

Building Cantera produces lengthy warnings about deprecated packaging (one warning per examples folder):

  /opt/hostedtoolcache/Python/3.8.13/x64/lib/python3.8/site-packages/setuptools/command/build_py.py:153: SetuptoolsDeprecationWarning:     Installing 'cantera.examples.kinetics' as data is deprecated, please list it in `packages`.
      !!


      ############################
      # Package would be ignored #
      ############################
      Python recognizes 'cantera.examples.kinetics' as an importable package,
      but it is not listed in the `packages` configuration of setuptools.

      'cantera.examples.kinetics' 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 'cantera.examples.kinetics' 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.


  !!

Following a similar rationale as the proposed resolution of #1258, one approach would be to no longer package examples and move them to the samples folder of the repository where other examples are located. Discussion elsewhere has shown that the recommended access point for examples is the website, as it generally cannot be expected that users are able to locate examples in the Python installation folders.

Steps to reproduce

1. Run scons build

System information

• Cantera version: 3.0.0a2

[bryanwweber]

Just to add some minor context, this warning is produced by recent versions of Setuptools... I forget exactly which version introduced this check