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

[py] webkitgtk: log_path -> log_output #14618

Merged
merged 7 commits into from
Oct 28, 2024
Merged

Conversation

Delta456
Copy link
Contributor

@Delta456 Delta456 commented Oct 18, 2024

User description

Thanks for contributing to Selenium!
A PR well described will help maintainers to quickly review and merge it

Before submitting your PR, please check our contributing guidelines.
Avoid large PRs, help reviewers by making them as simple and short as possible.

Description

Changes log_path to log_output because it is an outdated parameter and log_output is the updated parameter

Motivation and Context

super.__init__ still calls log_file which is not there anymore so this PR updates it to log_output.

Types of changes

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to change)

Checklist

  • I have read the contributing document.
  • My change requires a change to the documentation.
  • I have updated the documentation accordingly.
  • I have added tests to cover my changes.
  • All new and existing tests passed.

PR Type

enhancement


Description

  • Changed the parameter name from log_path to log_output in the Service class to reflect updated naming conventions.
  • Modified the constructor to use the new log_output parameter, ensuring compatibility with the updated API.
  • This change addresses the issue where super.__init__ was incorrectly referencing a non-existent log_file.

Changes walkthrough 📝

Relevant files
Enhancement
service.py
Update parameter from `log_path` to `log_output` in Service class

py/selenium/webdriver/webkitgtk/service.py

  • Updated parameter name from log_path to log_output.
  • Modified the initialization to use log_output instead of log_file.
  • Adjusted the constructor to reflect the updated parameter.
  • +4/-4     

    💡 PR-Agent usage: Comment /help "your question" on any pull request to receive relevant information

    Copy link
    Contributor

    PR Reviewer Guide 🔍

    Here are some key observations to aid the review process:

    ⏱️ Estimated effort to review: 2 🔵🔵⚪⚪⚪
    🧪 No relevant tests
    🔒 No security concerns identified
    ⚡ Recommended focus areas for review

    Potential Bug
    The log_output file is always opened, even if it's None. This might cause an error if no log file is specified.

    Resource Management
    The opened file for log_output is not being closed explicitly. This might lead to resource leaks.

    Copy link
    Contributor

    qodo-merge-pro bot commented Oct 18, 2024

    PR Code Suggestions ✨

    Explore these optional code suggestions:

    CategorySuggestion                                                                                                                                    Score
    Possible issue
    ✅ Handle potential None value for log_output to prevent errors when opening the file
    Suggestion Impact:The suggestion was directly implemented by adding a conditional check to handle the case where log_output is None.

    code diff:

    -        log_output = open(log_output, "wb")
    +        log_output = open(log_output, "wb") if log_output else None

    Consider handling the case where log_output is None to avoid potential errors when
    trying to open a file with a None path.

    py/selenium/webdriver/webkitgtk/service.py [45]

    -log_output = open(log_output, "wb")
    +log_output = open(log_output, "wb") if log_output else None
    • Apply this suggestion
    Suggestion importance[1-10]: 9

    Why: This suggestion addresses a potential bug where attempting to open a file with a None path could lead to an error. It ensures that the code handles the case where log_output is None, which is crucial for preventing runtime errors.

    9
    Best practice
    Use a context manager for file handling to ensure proper resource management

    Consider using a context manager or explicitly closing the file to ensure proper
    resource management.

    py/selenium/webdriver/webkitgtk/service.py [45-52]

    -log_output = open(log_output, "wb")
    -super().__init__(
    -    executable_path=executable_path,
    -    port=port,
    -    log_output=log_output,
    -    env=env,
    -    **kwargs,
    -)
    +with open(log_output, "wb") as log_file:
    +    super().__init__(
    +        executable_path=executable_path,
    +        port=port,
    +        log_output=log_file,
    +        env=env,
    +        **kwargs,
    +    )
    • Apply this suggestion
    Suggestion importance[1-10]: 8

    Why: The suggestion to use a context manager for file handling is a best practice that ensures proper resource management and prevents potential file descriptor leaks. It enhances the robustness of the code.

    8

    💡 Need additional feedback ? start a PR chat

    Copy link
    Member

    @AutomatedTester AutomatedTester left a comment

    Choose a reason for hiding this comment

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

    This change is likely to break for people if they are using kwargs. We should add the new one and have the other item deprecated

    @Delta456
    Copy link
    Contributor Author

    Should be done now

    @VietND96 VietND96 added the C-py label Oct 23, 2024
    @A1exKH
    Copy link

    A1exKH commented Oct 26, 2024

    LGTM.

    @diemol diemol merged commit ddfb3d8 into SeleniumHQ:trunk Oct 28, 2024
    12 of 13 checks passed
    @Delta456 Delta456 deleted the webkit_service branch November 6, 2024 10:30
    Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
    Projects
    None yet
    Development

    Successfully merging this pull request may close these issues.

    6 participants