fix: propagate missing params in module-level wrapper functions

[dustinbyrne]

Problem

The module-level convenience functions in posthog/__init__.py (e.g. posthog.group_identify(), posthog.get_all_flags()) were missing parameters that the underlying Client methods accept:

• group_identify: missing distinct_id — callers couldn't specify a stable distinct ID, causing a random UUID to be generated on every call. This creates a garbage person record in the backend on each invocation.
• get_all_flags: missing flag_keys_to_evaluate — callers couldn't limit evaluation to a subset of flags.
• get_all_flags_and_payloads: same missing flag_keys_to_evaluate.

Changes

• Added distinct_id parameter to group_identify() wrapper and forwarded it to the client.
• Added flag_keys_to_evaluate parameter to get_all_flags() and get_all_flags_and_payloads() wrappers and forwarded them to the client.
• Added tests in test_module.py verifying all three params are propagated correctly (value forwarding + default-to-None).

[github-actions]

posthog-python Compliance Report

Date: 2026-04-07 16:49:04 UTC
Duration: 193ms

✅ All Tests Passed!

0/0 tests passed

---

[greptile-apps]

Comments Outside Diff (1)

1. posthog/__init__.py, line 619-628 (link)

   New flag_keys_to_evaluate param missing from docstring

   The newly added flag_keys_to_evaluate parameter is not documented in the Args section of get_all_flags's docstring. Consider adding an entry:

   Prompt To Fix With AI

   This is a comment left during a code review.
   Path: posthog/__init__.py
   Line: 619-628
   
   Comment:
   **New `flag_keys_to_evaluate` param missing from docstring**
   
   The newly added `flag_keys_to_evaluate` parameter is not documented in the `Args` section of `get_all_flags`'s docstring. Consider adding an entry:
   
   
   
   How can I resolve this? If you propose a fix, please make it concise.

Prompt To Fix All With AI

This is a comment left during a code review.
Path: posthog/test/test_module.py
Line: 71-95

Comment:
**Prefer parameterised tests for duplicate test cases**

The four tests covering `get_all_flags` and `get_all_flags_and_payloads` are structurally identical — the only difference is which function is called. The project's convention (used in `test_utils.py`, `test_client.py`, etc.) is to use `@parameterized.expand` to avoid this duplication. For example:

```python
from parameterized import parameterized

@parameterized.expand([
    ("get_all_flags", posthog.get_all_flags, "get_all_flags"),
    ("get_all_flags_and_payloads", posthog.get_all_flags_and_payloads, "get_all_flags_and_payloads"),
])
def test_flag_keys_to_evaluate_propagated(self, _name, fn, client_method_name):
    fn("user_123", flag_keys_to_evaluate=["flag-1", "flag-2"])
    call_kwargs = getattr(self.mock_client, client_method_name).call_args[1]
    self.assertEqual(call_kwargs["flag_keys_to_evaluate"], ["flag-1", "flag-2"])

@parameterized.expand([
    ("get_all_flags", posthog.get_all_flags, "get_all_flags"),
    ("get_all_flags_and_payloads", posthog.get_all_flags_and_payloads, "get_all_flags_and_payloads"),
])
def test_flag_keys_defaults_to_none(self, _name, fn, client_method_name):
    fn("user_123")
    call_kwargs = getattr(self.mock_client, client_method_name).call_args[1]
    self.assertIsNone(call_kwargs["flag_keys_to_evaluate"])
```

How can I resolve this? If you propose a fix, please make it concise.

---

This is a comment left during a code review.
Path: posthog/__init__.py
Line: 619-628

Comment:
**New `flag_keys_to_evaluate` param missing from docstring**

The newly added `flag_keys_to_evaluate` parameter is not documented in the `Args` section of `get_all_flags`'s docstring. Consider adding an entry:

```suggestion
    """
    Get all flags for a given user.

    Args:
        distinct_id: The user's distinct ID
        groups: Groups mapping
        person_properties: Person properties
        group_properties: Group properties
        only_evaluate_locally: Whether to evaluate only locally
        disable_geoip: Whether to disable GeoIP lookup
        flag_keys_to_evaluate: Optional list of flag keys to limit evaluation to a subset of flags
```

How can I resolve this? If you propose a fix, please make it concise.

_{Reviews (1): Last reviewed commit: "fix: propagate missing params in module-..." | Re-trigger Greptile}

[marandaneto]

missing changeset otherwise LGTM