FILESTRUCTURE.md

This is an explanation of the file structure that the cookiecutter generated for you:

• Python source files:
  • The Python package source files are located in the project_W_runner directory.
  • The file project_W_runner.__main__.py defines a command line interface that is accessible both as the command project_W_runner and via python -m project_W_runner.
  • tests/test_cli.py contains rudimentary testing of this CLI.
  • tests/test_project_W_runner.py contains the unit tests for the package.
  • tests/conftest.py contains testing setup and configuration for pytest
• Markdown files with meta information on the project. Markdown is a good language for these files, as it is easy to write and rendered into something beautiful by your git repository hosting provider.
  • README.md is the file that users will typically see first when discovering your project.
  • COPYING.md provides a list of copyright holders.
  • LICENSE.md contains the license you selected.
  • TODO.md contains a list of TODOs after running the cookiecutter. Following the instructions in that file will give you a fully functional repository with a lot of integration into useful web services activated and running.
  • FILESTRUCTURE.md describes the generated files. Feel free to remove this from the repository if you do not need it.
• Python build system files
  • pyproject.toml is the central place for configuration of your Python package. It contains the project metadata, setuptools-specific information and the configuration for your toolchain (like e.g. pytest).
  • setup.py is still required for editable builds, but you should not need to change it. In the future, setuptools will support editable builds purely from pyproject.toml configuration.
• Configuration for CI/Code Analysis and documentation services
  • .github/workflows/ci.yml describes the Github Workflow for Continuous integration. For further reading on workflow files, we recommend the introduction into Github Actions and the reference of available options.
  • .github/dependabot.yml configures the DependaBot integration on GitHub that allows you to automatically create pull requests for updates of the used actions in .github/workflows/ci.yml.
  • .gitlab-ci.yml describes the configuration for Gitlab CI. For further reading, we recommend Gitlabs quick start guide and the Gitlab CI configuration reference
  • .readthedocs.yml configures the documentation build process at ReadTheDocs. To customize your build, you can have a look at the available options.