Refactor Configuration API

This MR refactors and stabilizes the configuration system of the codegen module. It adopts much code from pystencils-sfg!2 (merged), and once it is through, pystencils-sfg can be updated to inherit its config system from pystencils.

Closes #116 (closed)

codegen.config

• Introduce Option descriptor for config options with default values, validation, and explicit unsetting
• Introduce ConfigBase class and Category descriptor for safely modelling config objects and correct implementation of their deep-copying
• Clean up the option categories and option validation

backend

• Remove all mention of codegen.config from the backend module, making it exclusive to configuring the codegen driver

Documentation

• Cleanly separate API reference from user manual pages (finally!)
• Add docs for updated config system

changed milestone to %Release 2.0

requested review from @ab04unyc

assigned to @da15siwa

added 1 commit

• 958a499f - fix testsuite

Compare with previous version

added 1 commit

• 3e1cf7b0 - add test_override

Compare with previous version

changed the description

Having the hierarchical structure of all available configs would be beneficial for understanding the codegen configs. E.g.,

ps.CreateKernalConfig()
├── Target
│   ├── CpuConfig
│   │   ├── OpenMpOptions
│   │   ├── VectorizationOptions
│   ├── GpuConfig
│   ├── SycleConfig
├── jit
├── function_name
├── ghost_layers
├── iteration_slice
├── index_field
├── index_dtype
├── default_dtype
├── allow_double_writes
├── skip_independence_check
├── cpu
├── gpu
├── sycle

List is incomplete

MR looks good. I have some minor suggestions, but in general the MR can be merged.

approved this merge request

added 1 commit

• 9c97cccb - some minor code + docs cleanup

Compare with previous version

resolved all threads

mentioned in commit 8c2b59af

merged