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