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

docs: update api reference documentation #891

Merged
merged 3 commits into from
Oct 7, 2024

Conversation

dvarasani-crest
Copy link
Contributor

This PR updates API reference documentation as below

  • add missing function implementation and its params.
  • correcting parameters doc for some functions
  • add documentation for cim-compliance-report

Ref: https://splunk.atlassian.net/browse/ADDON-75003

@dvarasani-crest dvarasani-crest marked this pull request as ready for review September 11, 2024 05:55
@dvarasani-crest dvarasani-crest requested a review from a team as a code owner September 11, 2024 05:55

Args:
splunk_search_util (SearchUtil): Object that helps to search on Splunk.
splunk_ingest_data (fixture): Unused but required to ensure data was ingested before running test
Copy link
Contributor

Choose a reason for hiding this comment

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

Can we remove this unused line as we are using it.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Done

splunk_ingest_data (fixture): Unused but required to ensure data was ingested before running test
splunk_setup (fixture): Unused but required to ensure that test environment was set up before running test
splunk_searchtime_cim_fields (fixture): Pytest parameter to test required cim field extraction
record_property (fixture): Document facts of test cases.
Copy link
Contributor

Choose a reason for hiding this comment

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

we can add that we document it provide more info in the test failure reports

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Done

Args:
splunk_ingest_data (fixture): Unused but required to ensure data was ingested before running test
splunk_search_util (SearchUtil): Object that helps to search on Splunk.
splunk_setup (fixture): Unused but required to ensure that test environment was set up before running test
Copy link
Contributor

Choose a reason for hiding this comment

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

same as above

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Updated

@@ -491,6 +513,13 @@ def test_eventtype_mapped_multiple_cim_datamodel(
def test_cim_fields_recommended(
self, splunk_dm_recommended_fields, splunk_searchtime_cim_fields_recommended
):
"""
This test case check that all the recommended cim fields of datamodel mapped with event are exracted.
Copy link
Contributor

Choose a reason for hiding this comment

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

typo

Copy link
Contributor Author

Choose a reason for hiding this comment

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

fixed

@@ -37,6 +46,15 @@ def parse_sample_files(folder_path):


def parse_file(filename):
"""
Parse the xml sample file to get the lisst of events
Copy link
Contributor

Choose a reason for hiding this comment

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

typo

Copy link
Contributor Author

Choose a reason for hiding this comment

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

fixed

@@ -269,11 +363,23 @@ def __init__(self, event_tag):
self.exceptions = self.extract_key_value_xml("exceptions")

def get_transport_type(self):
"""
Function to get the transport type of the evnt
Copy link
Contributor

@harshilgajera-crest harshilgajera-crest Sep 26, 2024

Choose a reason for hiding this comment

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

Please check for small typos for this PR.

Overall looks good, small comments added

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Updated as per the comments and fixed typos.

@dvarasani-crest dvarasani-crest merged commit 28221b4 into main Oct 7, 2024
21 of 22 checks passed
@dvarasani-crest dvarasani-crest deleted the docs/dev-guide-enhancements branch October 7, 2024 07:53
@github-actions github-actions bot locked and limited conversation to collaborators Oct 7, 2024
@srv-rr-github-token
Copy link
Contributor

🎉 This PR is included in version 5.4.1 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants