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

Guidelines: Add the entry about one-off scripts #9089

Merged
merged 5 commits into from
Jul 15, 2022

Conversation

evgenyz
Copy link
Member

@evgenyz evgenyz commented Jul 2, 2022

Description:

  • We don't want one-off stray scripts to lay around.

Rationale:

  • They litter the project space. In rare cases when a script could be useful again,
    it could be retrieved from the history.

@evgenyz evgenyz added the Documentation Update in project documentation. label Jul 2, 2022
@github-actions
Copy link

github-actions bot commented Jul 2, 2022

Start a new ephemeral environment with changes proposed in this pull request:

Fedora Environment
Open in Gitpod

Oracle Linux 8 Environment
Open in Gitpod

Copy link
Member

@ggbecker ggbecker left a comment

Choose a reason for hiding this comment

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

We could find such scripts and delete them from the project as well. For example, the csv to rule migration tool is obsolete and if anyone would still require it, they can obtain from an older release.

https://github.com/ComplianceAsCode/content/blob/master/utils/migrate_template_csv_to_rule.py

@matejak
Copy link
Member

matejak commented Jul 4, 2022

Files utils/rule_dir_diff.py and utils/rule_dir_stats.py have questionable architecture / code quality, and I am not sure whether they are used - they at least haven't been updated for a couple of years.

Other files don't seem to be a particularly significant pain, and they are also quite recent.

@evgenyz evgenyz force-pushed the doc_guide_no_one-off branch 3 times, most recently from e33b62a to 82d0ea0 Compare July 12, 2022 22:27
@evgenyz
Copy link
Member Author

evgenyz commented Jul 13, 2022

The more I'm trying to fix mdl errors, the more errors I get (even from unrelated files). I'd say that it is good enough, since there is no more problems in the Style Guilde file.

@matejak
Copy link
Member

matejak commented Jul 15, 2022

The more I'm trying to fix mdl errors, the more errors I get (even from unrelated files). I'd say that it is good enough, since there is no more problems in the Style Guilde file.

I agree, thank you for the PR! Could you please just rebase, so the failing test starts to pass as well?

@matejak matejak self-assigned this Jul 15, 2022
the entry about one-off scripts

We don't want one-off stray scripts to lay around. They litter
the project space. In rare cases when a script could be useful again,
it could be retrieved from the history.
Blank lines around headers, lists, code-blocks.
Ignore line lengths. It is more important to have easily-redact-able
sentences.
utils/migrate_template_csv_to_rule.py
utils/rule_dir_diff.py
utils/rule_dir_stats.py
Set lists indentation to 4 instead of default 2.
@codeclimate
Copy link

codeclimate bot commented Jul 15, 2022

Code Climate has analyzed commit c2789f3 and detected 40 issues on this pull request.

Here's the issue category breakdown:

Category Count
Style 40

The test coverage on the diff in this pull request is 100.0% (50% is the threshold).

This pull request will bring the total coverage in the repository to 42.7% (0.0% change).

View more on Code Climate.

@matejak
Copy link
Member

matejak commented Jul 15, 2022

Thanks, fail on rawhide during dependency install is OK.

@matejak matejak merged commit 7d2be2c into ComplianceAsCode:master Jul 15, 2022
@Mab879 Mab879 added this to the 0.1.63 milestone Jul 15, 2022
@evgenyz evgenyz deleted the doc_guide_no_one-off branch July 16, 2022 07:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Documentation Update in project documentation.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

4 participants