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

doc: Improve CLI parameters DOCS-180 #92

Merged
merged 2 commits into from
Dec 13, 2022
Merged

Conversation

nicklem
Copy link
Contributor

@nicklem nicklem commented Dec 7, 2022

README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
@nicklem nicklem force-pushed the doc/cli-options-DOCS-180 branch 2 times, most recently from c6fe629 to 22c958b Compare December 7, 2022 13:24
output:
required: false
description: "Send analysis results to an output file"
description: "Path to a file to save the analysis results"
Copy link
Contributor Author

Choose a reason for hiding this comment

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

I tested this and I suspect that this only works for a local CLI analysis with file system access. It seems to timeout on a GitHub workflow.
Should this even be flagged as supported? Are there other options like this one?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Perhaps with the client side tools integration? Haven't tested that one...

Copy link
Contributor

Choose a reason for hiding this comment

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

I'm not sure about this either. 🤔 Let's keep this thread open and we'll check again with some more time later.

Copy link
Contributor

Choose a reason for hiding this comment

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

Now that I had a look at the workflow execution output, I'm thinking that perhaps it was something else that caused the GitHub Action to time out. 🤔

Could you please try running it again and see what happens?

Copy link
Contributor Author

@nicklem nicklem Dec 13, 2022

Choose a reason for hiding this comment

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

It indeed worked this time; it was another issue altogether.
I'm still not seeing the file, although there are mentions (here and here) in the logs. I assume that it's saved in some temporary container storage and then discarded.

Should we mention this?

Copy link
Contributor

Choose a reason for hiding this comment

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

Yes, the file is probably created correctly at the end of the Codacy Analysis CLI run. But I don't think it's necessary to further clarify this, as it isn't even very clear why anyone would want to use this option (save for maybe uploading it as an artifact of the workflow that could then be consulted later for debugging purposes.).

Copy link
Contributor

@prcr prcr left a comment

Choose a reason for hiding this comment

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

Very good proposal and improvements to the descriptions of the input parameters! 🙌

  • Sort action.yml parameters alphabetically

The parameters are ordered in a way that has some logic to it; for example, the first parameters are more "core", while the last ones all have to do with client-side tools. The order can be improved for sure, but by sorting them alphabetically we'll lose this "implicit information" that currently exists.

I left review comments, please address them and then we'll do another pass to settle any remaining details.

README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Show resolved Hide resolved
output:
required: false
description: "Send analysis results to an output file"
description: "Path to a file to save the analysis results"
Copy link
Contributor

Choose a reason for hiding this comment

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

I'm not sure about this either. 🤔 Let's keep this thread open and we'll check again with some more time later.

action.yml Outdated Show resolved Hide resolved
action.yml Outdated Show resolved Hide resolved
action.yml Outdated Show resolved Hide resolved
action.yml Outdated Show resolved Hide resolved
action.yml Outdated Show resolved Hide resolved
Copy link
Contributor

@prcr prcr left a comment

Choose a reason for hiding this comment

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

I left some more small remarks, but it's very close to being ready to be merged. 💪

output:
required: false
description: "Send analysis results to an output file"
description: "Path to a file to save the analysis results"
Copy link
Contributor

Choose a reason for hiding this comment

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

Now that I had a look at the workflow execution output, I'm thinking that perhaps it was something else that caused the GitHub Action to time out. 🤔

Could you please try running it again and see what happens?

@nicklem nicklem marked this pull request as ready for review December 13, 2022 12:08
prcr
prcr previously approved these changes Dec 13, 2022
@nicklem
Copy link
Contributor Author

nicklem commented Dec 13, 2022

@prcr I force-pushed to clean up the commit messages.
Can you approve again?
Thanks!

Copy link
Contributor

@prcr prcr left a comment

Choose a reason for hiding this comment

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

:shipit: 🎉

@nicklem nicklem merged commit c4be364 into master Dec 13, 2022
@nicklem nicklem deleted the doc/cli-options-DOCS-180 branch December 13, 2022 14:52
gsuquet referenced this pull request in gsuquet/workflows Jul 19, 2024
…114)

This PR contains the following updates:

| Package | Type | Update | Change |
|---|---|---|---|
|
[codacy/codacy-analysis-cli-action](https://github.com/codacy/codacy-analysis-cli-action)
| action | patch | `v4.4.1` -> `v4.4.4` |

---

### Release Notes

<details>
<summary>codacy/codacy-analysis-cli-action
(codacy/codacy-analysis-cli-action)</summary>

###
[`v4.4.4`](https://github.com/codacy/codacy-analysis-cli-action/releases/tag/v4.4.4)

[Compare
Source](https://github.com/codacy/codacy-analysis-cli-action/compare/v4.4.3...v4.4.4)

#### What's Changed

- update cli version to 7.9.11 by
[@&#8203;hjrocha](https://github.com/hjrocha) in
[https://github.com/codacy/codacy-analysis-cli-action/pull/132](https://github.com/codacy/codacy-analysis-cli-action/pull/132)

###
[`v4.4.3`](https://github.com/codacy/codacy-analysis-cli-action/releases/tag/v4.4.3)

[Compare
Source](https://github.com/codacy/codacy-analysis-cli-action/compare/v4.4.2...v4.4.3)

#### What's Changed

- fix registry-address default value by
[@&#8203;hjrocha](https://github.com/hjrocha) in
[https://github.com/codacy/codacy-analysis-cli-action/pull/131](https://github.com/codacy/codacy-analysis-cli-action/pull/131)

###
[`v4.4.2`](https://github.com/codacy/codacy-analysis-cli-action/releases/tag/v4.4.2)

[Compare
Source](https://github.com/codacy/codacy-analysis-cli-action/compare/v4.4.1...v4.4.2)

#### What's Changed

- Fixed some broken links by
[@&#8203;mushlih-almubarak](https://github.com/mushlih-almubarak) in
[https://github.com/codacy/codacy-analysis-cli-action/pull/77](https://github.com/codacy/codacy-analysis-cli-action/pull/77)
- bump: Bump codacy-analysis-cli to 7.6.4 CY-6112 by
[@&#8203;lolgab](https://github.com/lolgab) in
[https://github.com/codacy/codacy-analysis-cli-action/pull/80](https://github.com/codacy/codacy-analysis-cli-action/pull/80)
- feature: Introduce new versioning scheme `vX.X.X` by
[@&#8203;lolgab](https://github.com/lolgab) in
[https://github.com/codacy/codacy-analysis-cli-action/pull/81](https://github.com/codacy/codacy-analysis-cli-action/pull/81)
- doc: Mention setting up the Go environment DOCS-380 by
[@&#8203;prcr](https://github.com/prcr) in
[https://github.com/codacy/codacy-analysis-cli-action/pull/83](https://github.com/codacy/codacy-analysis-cli-action/pull/83)
- \[SE-140] Add max-tool-memory flag by
[@&#8203;heliocodacy](https://github.com/heliocodacy) in
[https://github.com/codacy/codacy-analysis-cli-action/pull/86](https://github.com/codacy/codacy-analysis-cli-action/pull/86)
- Bump gosec to v2.13.1 CY-6239 by
[@&#8203;stefanvacareanu7](https://github.com/stefanvacareanu7) in
[https://github.com/codacy/codacy-analysis-cli-action/pull/87](https://github.com/codacy/codacy-analysis-cli-action/pull/87)
- Fix typo by [@&#8203;pSub](https://github.com/pSub) in
[https://github.com/codacy/codacy-analysis-cli-action/pull/82](https://github.com/codacy/codacy-analysis-cli-action/pull/82)
- doc: Bump supported Go version to 1.19.1 CY-6239 by
[@&#8203;prcr](https://github.com/prcr) in
[https://github.com/codacy/codacy-analysis-cli-action/pull/88](https://github.com/codacy/codacy-analysis-cli-action/pull/88)
- Update supported languages count by
[@&#8203;nicklem](https://github.com/nicklem) in
[https://github.com/codacy/codacy-analysis-cli-action/pull/91](https://github.com/codacy/codacy-analysis-cli-action/pull/91)
- doc: Improve CLI parameters DOCS-180 by
[@&#8203;nicklem](https://github.com/nicklem) in
[https://github.com/codacy/codacy-analysis-cli-action/pull/92](https://github.com/codacy/codacy-analysis-cli-action/pull/92)
- doc: Flag
[@&#8203;codacy/techwriters](https://github.com/codacy/techwriters) as
owners of README.md DOCS-483 by
[@&#8203;nicklem](https://github.com/nicklem) in
[https://github.com/codacy/codacy-analysis-cli-action/pull/93](https://github.com/codacy/codacy-analysis-cli-action/pull/93)
- added github_token in all requests to github api in action.yml by
[@&#8203;DMarinhoCodacy](https://github.com/DMarinhoCodacy) in
[https://github.com/codacy/codacy-analysis-cli-action/pull/96](https://github.com/codacy/codacy-analysis-cli-action/pull/96)
- removed github-token from action.yaml file by
[@&#8203;DMarinhoCodacy](https://github.com/DMarinhoCodacy) in
[https://github.com/codacy/codacy-analysis-cli-action/pull/100](https://github.com/codacy/codacy-analysis-cli-action/pull/100)
- changed staticcheck URL using github api to artifact TS-214 by
[@&#8203;DMarinhoCodacy](https://github.com/DMarinhoCodacy) in
[https://github.com/codacy/codacy-analysis-cli-action/pull/102](https://github.com/codacy/codacy-analysis-cli-action/pull/102)
- updated Clang-Tidy URL to artifact by
[@&#8203;DMarinhoCodacy](https://github.com/DMarinhoCodacy) in
[https://github.com/codacy/codacy-analysis-cli-action/pull/103](https://github.com/codacy/codacy-analysis-cli-action/pull/103)
- doc: Mention turning on and configuring the client-side tool by
[@&#8203;prcr](https://github.com/prcr) in
[https://github.com/codacy/codacy-analysis-cli-action/pull/106](https://github.com/codacy/codacy-analysis-cli-action/pull/106)
- moved gosec and fauxpas to artifact by
[@&#8203;DMarinhoCodacy](https://github.com/DMarinhoCodacy) in
[https://github.com/codacy/codacy-analysis-cli-action/pull/107](https://github.com/codacy/codacy-analysis-cli-action/pull/107)
- fix installation staticcheck using official binary by
[@&#8203;DMarinhoCodacy](https://github.com/DMarinhoCodacy) in
[https://github.com/codacy/codacy-analysis-cli-action/pull/108](https://github.com/codacy/codacy-analysis-cli-action/pull/108)
- feature: allow skipping container engine check IO-423 by
[@&#8203;pedrocodacy](https://github.com/pedrocodacy) in
[https://github.com/codacy/codacy-analysis-cli-action/pull/110](https://github.com/codacy/codacy-analysis-cli-action/pull/110)
- close if statement properly by
[@&#8203;bjarkebm](https://github.com/bjarkebm) in
[https://github.com/codacy/codacy-analysis-cli-action/pull/114](https://github.com/codacy/codacy-analysis-cli-action/pull/114)
- bump cli version by
[@&#8203;pedrocodacy](https://github.com/pedrocodacy) in
[https://github.com/codacy/codacy-analysis-cli-action/pull/116](https://github.com/codacy/codacy-analysis-cli-action/pull/116)
- doc: Update Codacy logo DOCS-594 by
[@&#8203;nicklem](https://github.com/nicklem) in
[https://github.com/codacy/codacy-analysis-cli-action/pull/119](https://github.com/codacy/codacy-analysis-cli-action/pull/119)
- action: prevent globbing with double quotes by
[@&#8203;ljmf00](https://github.com/ljmf00) in
[https://github.com/codacy/codacy-analysis-cli-action/pull/68](https://github.com/codacy/codacy-analysis-cli-action/pull/68)
- Bump cli, staticheck, gosec versions TCE-614 by
[@&#8203;stefanvacareanu7](https://github.com/stefanvacareanu7) in
[https://github.com/codacy/codacy-analysis-cli-action/pull/124](https://github.com/codacy/codacy-analysis-cli-action/pull/124)
- TCE-937 add condition to setup go only if the user wants to run
staticcheck by
[@&#8203;DMarinhoCodacy](https://github.com/DMarinhoCodacy) in
[https://github.com/codacy/codacy-analysis-cli-action/pull/126](https://github.com/codacy/codacy-analysis-cli-action/pull/126)
- feat: \[TCE-1039] Add parameter 'registry-address' in order to support
alternative registry addresses by
[@&#8203;heliocodacy](https://github.com/heliocodacy) in
[https://github.com/codacy/codacy-analysis-cli-action/pull/129](https://github.com/codacy/codacy-analysis-cli-action/pull/129)

#### New Contributors

- [@&#8203;mushlih-almubarak](https://github.com/mushlih-almubarak)
made their first contribution in
[https://github.com/codacy/codacy-analysis-cli-action/pull/77](https://github.com/codacy/codacy-analysis-cli-action/pull/77)
- [@&#8203;stefanvacareanu7](https://github.com/stefanvacareanu7) made
their first contribution in
[https://github.com/codacy/codacy-analysis-cli-action/pull/87](https://github.com/codacy/codacy-analysis-cli-action/pull/87)
- [@&#8203;pSub](https://github.com/pSub) made their first
contribution in
[https://github.com/codacy/codacy-analysis-cli-action/pull/82](https://github.com/codacy/codacy-analysis-cli-action/pull/82)
- [@&#8203;nicklem](https://github.com/nicklem) made their first
contribution in
[https://github.com/codacy/codacy-analysis-cli-action/pull/91](https://github.com/codacy/codacy-analysis-cli-action/pull/91)
- [@&#8203;DMarinhoCodacy](https://github.com/DMarinhoCodacy) made
their first contribution in
[https://github.com/codacy/codacy-analysis-cli-action/pull/96](https://github.com/codacy/codacy-analysis-cli-action/pull/96)
- [@&#8203;bjarkebm](https://github.com/bjarkebm) made their first
contribution in
[https://github.com/codacy/codacy-analysis-cli-action/pull/114](https://github.com/codacy/codacy-analysis-cli-action/pull/114)
- [@&#8203;ljmf00](https://github.com/ljmf00) made their first
contribution in
[https://github.com/codacy/codacy-analysis-cli-action/pull/68](https://github.com/codacy/codacy-analysis-cli-action/pull/68)

**Full Changelog**:
codacy/codacy-analysis-cli-action@4.0.2...v4.4.2

</details>

---

### Configuration

📅 **Schedule**: Branch creation - At any time (no schedule defined),
Automerge - At any time (no schedule defined).

🚦 **Automerge**: Disabled by config. Please merge this manually once you
are satisfied.

♻ **Rebasing**: Whenever PR is behind base branch, or you tick the
rebase/retry checkbox.

🔕 **Ignore**: Close this PR and you won't be reminded about this update
again.

---

- [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check
this box

---

This PR has been generated by [Renovate
Bot](https://github.com/renovatebot/renovate).

<!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiIzNy40MjAuMSIsInVwZGF0ZWRJblZlciI6IjM3LjQyMC4xIiwidGFyZ2V0QnJhbmNoIjoibWFpbiIsImxhYmVscyI6WyJyZW5vdmF0ZSJdfQ==-->

Signed-off-by: Renovate Bot <bot@renovateapp.com>
Co-authored-by: renovate-gsuquet[bot] <173481049+renovate-gsuquet[bot]@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.

2 participants