Skip to content
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

Show toml file location in Figment errors #860

Conversation

josecelano
Copy link
Member

@josecelano josecelano commented May 14, 2024

Before this PR, we loaded the configuration in Figment, always using a Toml string, even if the configuration came from a Toml file. When there is an error, Figment does not show the file location, and that's one of the main advantages of using Figment. All errors point to the primary source of the configuration option.

This commit fixes the problem of Figment not showing the file location when the user provides a file and there is an error.

Sample error:

Loading configuration from default configuration file: `./share/default/config/tracker.development.sqlite3.toml` ...
thread 'main' panicked at src/bootstrap/config.rs:45:32:
called `Result::unwrap()` on an `Err` value: ConfigError { source: LocatedError { source: Error { tag: Tag(Default, 2), profile: Some(Profile(Uncased { string: "default" })), metadata: Some(Metadata { name: "TOML file", source: Some(File("/home/developer/torrust/torrust-tracker/./share/default/config/tracker.development.sqlite3.toml")), provide_location: Some(Location { file: "packages/configuration/src/v1/mod.rs", line: 330, col: 18 }), interpolater:  }), path: [], kind: Message("TOML parse error at line 2, column 15\n  |\n2 | enabled = truee\n  |               ^\nexpected newline, `#`\n"), prev: None }, location: Location { file: "packages/configuration/src/v1/mod.rs", line: 334, col: 41 } } }
note: run with `RUST_BACKTRACE=1` environment variable to display a backtrace

Notice how the file path is included is the error: /home/developer/torrust/torrust-tracker/./share/default/config/tracker.development.sqlite3.toml

Before this commit we loaded configuration in Figment always using a
Toml string even if the configuration cames from a toml file. WHen there
is an error Figment does not show the file location and that's one of
the main advantages of using Figment. All errors point to the primary
source of the configuration option.

This commit fixes that problem leting Figment to load the configuration
from the file when the user provides a file.

Sample error:

```
Loading configuration from default configuration file: `./share/default/config/tracker.development.sqlite3.toml` ...
thread 'main' panicked at src/bootstrap/config.rs:45:32:
called `Result::unwrap()` on an `Err` value: ConfigError { source: LocatedError { source: Error { tag: Tag(Default, 2), profile: Some(Profile(Uncased { string: "default" })), metadata: Some(Metadata { name: "TOML file", source: Some(File("/home/developer/torrust/torrust-tracker/./share/default/config/tracker.development.sqlite3.toml")), provide_location: Some(Location { file: "packages/configuration/src/v1/mod.rs", line: 330, col: 18 }), interpolater:  }), path: [], kind: Message("TOML parse error at line 2, column 15\n  |\n2 | enabled = truee\n  |               ^\nexpected newline, `#`\n"), prev: None }, location: Location { file: "packages/configuration/src/v1/mod.rs", line: 334, col: 41 } } }
note: run with `RUST_BACKTRACE=1` environment variable to display a backtrace
```

Notice how the file path is included is the error: `/home/developer/torrust/torrust-tracker/./share/default/config/tracker.development.sqlite3.toml`
@josecelano josecelano added this to the v3.0.0 milestone May 14, 2024
@josecelano josecelano linked an issue May 14, 2024 that may be closed by this pull request
Copy link

codecov bot commented May 14, 2024

Codecov Report

Attention: Patch coverage is 89.28571% with 6 lines in your changes are missing coverage. Please review.

Project coverage is 78.82%. Comparing base (92408bc) to head (4de5e7d).

Files Patch % Lines
packages/configuration/src/lib.rs 68.42% 6 Missing ⚠️
Additional details and impacted files
@@             Coverage Diff             @@
##           develop     #860      +/-   ##
===========================================
+ Coverage    78.74%   78.82%   +0.08%     
===========================================
  Files          169      169              
  Lines         9304     9325      +21     
===========================================
+ Hits          7326     7350      +24     
+ Misses        1978     1975       -3     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

@josecelano
Copy link
Member Author

ACK 4de5e7d

@josecelano josecelano marked this pull request as ready for review May 14, 2024 09:39
@josecelano josecelano self-assigned this May 14, 2024
@josecelano josecelano merged commit 7938433 into torrust:develop May 14, 2024
17 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Config overhaul: missing toml file location in Figment errors
1 participant