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

Google test documentation update #10608

Open
wants to merge 3 commits into
base: master
Choose a base branch
from

Conversation

VivianNK
Copy link
Contributor

Description

Break off UnitTestFrameworkPkg ReadMe unit test implementation details into different markdown files.
Add details to GoogleTest file to include newer details in creating mocks for non-libraries.

  • Breaking change?
    • Breaking change - Does this PR cause a break in build or boot behavior?
    • Examples: Does it add a new library class or move a module to a different repo.
  • Impacts security?
    • Security - Does this PR have a direct security impact?
    • Examples: Crypto algorithm change or buffer overflow fix.
  • Includes tests?
    • Tests - Does this PR include any explicit test code?
    • Examples: Unit tests or integration tests.

How This Was Tested

CI

Integration Instructions

N/A

@VivianNK VivianNK force-pushed the googleTestDocumentationUpdate_v1 branch from 2984a72 to 3177ec2 Compare January 10, 2025 22:26
@@ -687,6 +726,8 @@ declarations as shown in the below table.
| Global Table (e.g. gRT, gBS, etc.) | gRT->GetVariable | gRT_GetVariable |
| Protocol | UsbIoProtocol->UsbPortReset | UsbIoProtocol_UsbPortReset |

__Note__ the naming convention for global tables and protocols is currently being discussed. Points of discussion include removing the use of underscores, use of "Efi," and including the use case, e.g. `Protocol` in the mock function name.
Copy link
Contributor Author

Choose a reason for hiding this comment

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

@mdkinney Here is a note on the naming convention

Split the ReadMe.md into the base file, and the two supporting files.
The two files are dedicated to unit test implementation details for
Framework and GoogleTest.

Signed-off-by: Vivian Nowka-Keane <[email protected]>
@VivianNK VivianNK force-pushed the googleTestDocumentationUpdate_v1 branch from 3177ec2 to 15c42e9 Compare January 10, 2025 22:34
VivianNK and others added 2 commits January 10, 2025 15:01
Update the ReadMe files.

Signed-off-by: Vivian Nowka-Keane <[email protected]>
Include updated information on mocking protocols and PPIs.

Signed-off-by: Vivian Nowka-Keane <[email protected]>
@VivianNK VivianNK force-pushed the googleTestDocumentationUpdate_v1 branch from 15c42e9 to efedb15 Compare January 10, 2025 23:01
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.

1 participant