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

Fix: Create JSON output file only when there is content #5028

Closed
wants to merge 2 commits into from

Conversation

burnsra
Copy link

@burnsra burnsra commented Feb 1, 2024

With the latest version of the Snyk CLI(v1.1276.0), when specifying json-output-file and no JSON was generated, an empty output file is created. Previous versions of the CLI did not generate an empty file. I have added a check for content before calling the function saveJsonToFileCreatingDirectoryIfRequired.

The risk for this change is LOW

Pull Request Submission

Please check the boxes once done.

The pull request must:

  • Reviewer Documentation
    • follow CONTRIBUTING rules
    • be accompanied by a detailed description of the changes
    • contain a risk assessment of the change (Low | Medium | High) with regards to breaking existing functionality. A change e.g. of an underlying language plugin can completely break the functionality for that language, but appearing as only a version change in the dependencies.
    • highlight breaking API if applicable
    • contain a link to the automatic tests that cover the updated functionality.
    • contain testing instructions in case that the reviewer wants to manual verify as well, to add to the manual testing done by the author.
    • link to the link to the PR for the User-facing documentation
  • User facing Documentation
    • update any relevant documentation in gitbook by submitting a gitbook PR, and including the PR link here
    • ensure that the message of the final single commit is descriptive and prefixed with either feat: or fix: , others might be used in rare occasions as well, if there is no need to document the changes in the release notes. The changes or fixes should be described in detail in the commit message for the changelog & release notes.
  • Testing
    • Changes, removals and additions to functionality must be covered by acceptance / integration tests or smoke tests - either already existing ones, or new ones, created by the author of the PR.

Pull Request Review

All pull requests must undergo a thorough review process before being merged.
The review process of the code PR should include code review, testing, and any necessary feedback or revisions.
Pull request reviews of functionality developed in other teams only review the given documentation and test reports.

Manual testing will not be performed by the reviewing team, and is the responsibility of the author of the PR.

For Node projects: It’s important to make sure changes in package.json are also affecting package-lock.json correctly.

If a dependency is not necessary, don’t add it.

When adding a new package as a dependency, make sure that the change is absolutely necessary. We would like to refrain from adding new dependencies when possible.
Documentation PRs in gitbook are reviewed by Snyk's content team. They will also advise on the best phrasing and structuring if needed.

Pull Request Approval

Once a pull request has been reviewed and all necessary revisions have been made, it is approved for merging into
the main codebase. The merging of the code PR is performed by the code owners, the merging of the documentation PR
by our content writers.

What does this PR do?

Where should the reviewer start?

How should this be manually tested?

Any background context you want to provide?

What are the relevant tickets?

Screenshots

Additional questions

With the latest version of the Snyk CLI(v1.1276.0), when specifying json-output-file and
no JSON was generated, an empty output file is created. Previous versions of the CLI did
not generate an empty file.  I have added a check for content before calling the function
saveJsonToFileCreatingDirectoryIfRequired.
@burnsra burnsra requested a review from a team as a code owner February 1, 2024 02:30
@CLAassistant
Copy link

CLAassistant commented Feb 1, 2024

CLA assistant check
All committers have signed the CLA.

@thisislawatts
Copy link
Member

Thanks for the report @burnsra and proposed fix. Clearly we are missing some tests here to validate that behaviour/contract. I will escalate to the team to address.

@thisislawatts
Copy link
Member

Hey @burnsra would you be able to share a bit more information so we can recreate the situation where you are getting an empty json file?

@burnsra
Copy link
Author

burnsra commented Feb 1, 2024

Hey @burnsra would you be able to share a bit more information so we can recreate the situation where you are getting an empty json file?

Of course @thisislawatts, and thanks in advance for your help with this issue!

Run snyk code test --json-file-output=code.json on a directory which contains valid code projects, but contains no issues.
No issues exist, but an empty code.json file is still created. With previous versions of CLI, the file was not created if it had no content.

Also, I added an additional commit with test cases and logic added to the function to determine if content is empty.

@PeterSchafer
Copy link
Collaborator

Hello @burnsra,

as @thisislawatts said, thank you for bringing this issue to our attention and proposing this fix. We looked into the root cause of the issue and think that a slightly different solution addresses the issue introduced better. Please take a look at our proposal in #5030 . There we added a closed box test to ensure that this behaviour is covered and a future regression would be detected. We will be going forward with #5030 in order to get a fix released as soon as possible.
We really appreciate that you took the time and provided the information to fix this issue!

Thank you for support and have a nice weekend!

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