Improve a comment and docstring about memory profiling (DataDog#20643)

* Improve a comment and docstring about memory profiling

* add params, replace docstring with better func name

Author: iliakur

datadog_checks_base/datadog_checks/base/checks/base.py

@@ -1297,7 +1297,7 @@ def run(self):
 
                     enter_pdb(self.check, line=self.init_config['set_breakpoint'], args=(instance,))
                 elif self.should_profile_memory():
-                    # self.init_config.get('profile_memory') could be `/tmp/datadog-agent-memory-profiler*`
+                    # The 'profile_memory' key in self.init_config could be `/tmp/datadog-agent-memory-profiler*`
                     # that is generated by Datadog Agent.
                     # If we use `--m-dir` for `agent check` command, a hidden flag, it should be same as a given value.
                     namespaces = [self.init_config.get('profile_memory')]

datadog_checks_base/tests/base/checks/test_agent_check.py

@@ -1312,14 +1312,11 @@ def test_env_var_logic_preset():
 @pytest.mark.parametrize(
     "should_profile_value, expected_calls",
     [
-        (True, 1),
-        (False, 0),
+        pytest.param(True, 1, id="enabled"),
+        pytest.param(False, 0, id="disabled"),
     ],
 )
-def test_profile_memory(should_profile_value, expected_calls):
-    """
-    Test that profile_memory is called when should_profile_memory is True
-    """
+def test_profile_memory_when_enabled(should_profile_value, expected_calls):
     check = AgentCheck('test', {}, [{}])
     check.should_profile_memory = mock.MagicMock(return_value=should_profile_value)
     check.profile_memory = mock.MagicMock()