Skip to content

Vassiliy kudryashov/extended settings documentation #1501

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged

Conversation

Vassiliy-Kudryashov
Copy link
Member

Description

This update provides "wider vision" of our settings. After some discussion, we have to accept the concept as documentation or find a better solution to be implemented and then documented.

3. Controls in "Generate" dialog


Properties from 2 and 3 are plugin-specific, and they are automatically persisted in `{projectDir}/.idea/utbot-settings.xml`
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actually not all settings on UI are plugin-specific. They are:

  • Display detected errors on the Problems tool window
  • Test sources root

Most of settings on UI can be used for CLI and CI as well (and they are not used in UtSettings and settings.properties:

  • Generated test language
  • Hanging test timeout
  • Tests with exceptions : Pass/Fail
  • Fuzzing/Symbolic proportion (fuzzingValue)
  • Force mocking static methods
  • Test framework
  • Mocking strategy

in **plugin configuration file** `{projectDir}/.idea/utbot-settings.xml` and nobody is expected to edit this file manually.

At the moment, these two kinds of settings (core and plugin-specific)
have very small intersection (that means some keys of different levels control the same behavior aspects).
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The intersection of settings in global settings.properties file and IDEA UI:

  • Test generation timeout (per execution dialog, not saved in project settings)
  • useFuzzing (influences Test generation method on Settings > Tools)
  • fuzzingTimeoutInMillis (can conflict with fuzzingValue - proportion - saved per project)
  • enable Summaries (saved per project)
  • useCustomJavaDocTags - Javadoc comment style (saved per project)
  • treatOverflowAsError (saved per project)

@Vassiliy-Kudryashov Vassiliy-Kudryashov merged commit d26d257 into main Dec 15, 2022
@Vassiliy-Kudryashov Vassiliy-Kudryashov deleted the Vassiliy-Kudryashov/extended_settings_documentation branch December 15, 2022 12:18
tamarinvs19 pushed a commit that referenced this pull request Dec 21, 2022
* Draft for extended settings documentation

* Extended settings documentation

* Small grammar fixes

* Minor linguistic fixes

Co-authored-by: Olga Naumenko <64418523+olganaumenko@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants