fix: correct FeatureUsageFlag to use IntFlag and return str from __str__

[proazr]

Overview

The FeatureUsageFlag enum has two issues that cause runtime errors and prevent proper bitwise operations:

1. __str__ returns int instead of str: The __str__ method returns self.value (an int), violating Python's data model requirement that __str__ must return a string. This causes TypeError: __str__ returned non-string (type int) on all Python versions when calling str() on enum members.

2. Incorrect base class for bit flags: The class inherits from (int, Enum) instead of IntFlag, even though the values are clearly bit flags (powers of 2: 0, 1, 2, 4, 8, 16). This prevents proper bitwise operations - combining flags with | returns plain int instead of FeatureUsageFlag.

Demo

Before (broken):

>>> from msgraph_core._enums import FeatureUsageFlag
>>> str(FeatureUsageFlag.NONE)
TypeError: __str__ returned non-string (type int)

>>> type(FeatureUsageFlag.REDIRECT_HANDLER_ENABLED | FeatureUsageFlag.RETRY_HANDLER_ENABLED)
<class 'int'>  # Lost enum semantics

After (fixed):

>>> from msgraph_core._enums import FeatureUsageFlag
>>> str(FeatureUsageFlag.NONE)
'0'

>>> combined = FeatureUsageFlag.REDIRECT_HANDLER_ENABLED | FeatureUsageFlag.RETRY_HANDLER_ENABLED
>>> type(combined)
<enum 'FeatureUsageFlag'>  # Proper IntFlag behavior
>>> combined.value
3

Notes

• This bug affects all supported Python versions (3.9, 3.10, 3.11, 3.12, 3.13)
• The fix is backward-compatible: IntFlag is a subclass of both int and Enum, so existing isinstance() checks continue to work
• Only FeatureUsageFlag was affected; APIVersion and NationalClouds already work correctly as they inherit from str

Testing Instructions

• Run the new enum tests: pytest tests/test_enums.py -v
• All 15 tests should pass, covering:
  • __str__ returns string type for all enum classes
  • FeatureUsageFlag is an IntFlag subclass
  • Bitwise operations (OR, AND, XOR, invert) return FeatureUsageFlag
  • Combined flags also return string from __str__
  • Flag values are correct powers of 2

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[Copilot]

Pull request overview

This PR fixes msgraph_core._enums.FeatureUsageFlag so it behaves like a proper bit-flag enum and no longer raises a runtime TypeError when converted to a string, aligning it with Python’s data model expectations and enabling correct bitwise semantics across the core middleware feature-usage tracking.

Changes:

• Switch FeatureUsageFlag from (int, Enum) to IntFlag to preserve enum semantics during bitwise operations.
• Fix FeatureUsageFlag.__str__ to return a str (stringified numeric value) instead of an int.
• Add a dedicated tests/test_enums.py suite validating __str__ behavior and IntFlag bitwise operations.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File	Description
src/msgraph_core/_enums.py	Updates FeatureUsageFlag to inherit from IntFlag and ensures __str__ returns a string.
tests/test_enums.py	Adds unit tests covering __str__ return type/value and bitwise behavior for FeatureUsageFlag, plus sanity checks for other enums.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.