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

Add API documentation, GitHub Actions for code quality and tests #8

Merged
merged 31 commits into from
Sep 3, 2024

Conversation

ikretz
Copy link
Collaborator

@ikretz ikretz commented Aug 30, 2024

This PR adds support for building API documentation via pdoc as well as two GitHub Actions for enforcing code quality (type checking and linting) and testing on pull request and pushing to main.

Matrix testing is used to ensure compatibility with various versions of pip and npm. This testing revealed that the firewall's current approach to parsing the output of npm dry-run commands is too dependent on this output having a certain format that is in fact only used in recent (i.e., >=10.x) versions of npm, precluding us from supporting more versions. This will need to be addressed in a separate PR. For now, a "disclaimer" has been added to the README regarding npm (and pip) compatibility, informed by these tests.

@ikretz ikretz changed the title Add GitHub Actions for code quality, tests Add API documentation, GitHub Actions for code quality and tests Aug 31, 2024
@ikretz ikretz marked this pull request as ready for review September 1, 2024 12:54
Copy link
Contributor

@sobregosodd sobregosodd left a comment

Choose a reason for hiding this comment

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

I overall did not like the underscore overuse. :-(

Makefile Outdated Show resolved Hide resolved
README.md Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Show resolved Hide resolved
scfw/cli.py Show resolved Hide resolved
scfw/command.py Show resolved Hide resolved
scfw/dd_logger.py Show resolved Hide resolved
@ikretz ikretz merged commit 4a5be9f into main Sep 3, 2024
18 checks passed
@ikretz ikretz deleted the ikretz/github-action branch September 3, 2024 23:05
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