test_config_compat.py 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275
  1. import os
  2. import tempfile
  3. import unittest
  4. from config import GatewayConfig
  5. class GatewayConfigCompatTest(unittest.TestCase):
  6. def test_gateway_config_accepts_documented_fms_env_names_when_dotenv_missing(self):
  7. env = {
  8. 'FMS_API_BASE': 'http://gateway.example.test',
  9. 'FMS_CLIENT_TYPE': 'workbuddy',
  10. 'FMS_TIMEOUT_MS': '15000',
  11. 'FMS_LOG_LEVEL': 'debug',
  12. }
  13. config = GatewayConfig.from_env(env, dotenv_path=os.path.join(tempfile.gettempdir(), 'missing-fms-mcp.env'))
  14. self.assertEqual('http://gateway.example.test', config.auth_base_url)
  15. self.assertEqual('http://gateway.example.test', config.tools_base_url)
  16. self.assertEqual('workbuddy', config.client_type)
  17. self.assertEqual(15, config.timeout_seconds)
  18. self.assertEqual('debug', config.log_level)
  19. def test_gateway_config_reads_dotenv_file_when_env_missing(self):
  20. with tempfile.TemporaryDirectory() as tmp_dir:
  21. dotenv_path = os.path.join(tmp_dir, '.env')
  22. with open(dotenv_path, 'w', encoding='utf-8') as file:
  23. file.write('FMS_API_BASE=http://dotenv.example.test\n')
  24. file.write('FMS_CLIENT_TYPE=workbuddy\n')
  25. file.write('FMS_TIMEOUT_SECONDS=12\n')
  26. file.write('FMS_LOG_LEVEL=warning\n')
  27. file.write('FMS_TOKEN_STORE_PATH=.runtime-token.json\n')
  28. config = GatewayConfig.from_env(env={}, dotenv_path=dotenv_path)
  29. self.assertEqual('http://dotenv.example.test', config.auth_base_url)
  30. self.assertEqual('http://dotenv.example.test', config.tools_base_url)
  31. self.assertEqual('workbuddy', config.client_type)
  32. self.assertEqual(12, config.timeout_seconds)
  33. self.assertEqual('warning', config.log_level)
  34. self.assertEqual('.runtime-token.json', config.token_store_path)
  35. def test_gateway_config_prefers_dotenv_over_environment(self):
  36. with tempfile.TemporaryDirectory() as tmp_dir:
  37. dotenv_path = os.path.join(tmp_dir, '.env')
  38. with open(dotenv_path, 'w', encoding='utf-8') as file:
  39. file.write('FMS_AUTH_BASE=http://dotenv-auth.example.test\n')
  40. file.write('FMS_TOOLS_BASE=http://dotenv-tools.example.test\n')
  41. file.write('FMS_CLIENT_TYPE=workbuddy-dotenv\n')
  42. file.write('FMS_TIMEOUT_SECONDS=12\n')
  43. file.write('FMS_LOG_LEVEL=warning\n')
  44. file.write('FMS_TOKEN_STORE_PATH=.dotenv-token.json\n')
  45. config = GatewayConfig.from_env(
  46. env={
  47. 'FMS_AUTH_BASE': 'http://env-auth.example.test',
  48. 'FMS_TOOLS_BASE': 'http://env-tools.example.test',
  49. 'FMS_CLIENT_TYPE': 'workbuddy-env',
  50. 'FMS_TIMEOUT_SECONDS': '30',
  51. 'FMS_LOG_LEVEL': 'debug',
  52. 'FMS_TOKEN_STORE_PATH': '.env-token.json',
  53. },
  54. dotenv_path=dotenv_path,
  55. )
  56. self.assertEqual('http://dotenv-auth.example.test', config.auth_base_url)
  57. self.assertEqual('http://dotenv-tools.example.test', config.tools_base_url)
  58. self.assertEqual('workbuddy-dotenv', config.client_type)
  59. self.assertEqual(12, config.timeout_seconds)
  60. self.assertEqual('warning', config.log_level)
  61. self.assertEqual('.dotenv-token.json', config.token_store_path)
  62. def test_public_gateway_config_reads_session_ttl_and_mode(self):
  63. config = GatewayConfig.from_env(env={
  64. 'FMS_API_BASE': 'https://base.example.com',
  65. 'FMS_GATEWAY_MODE': 'public',
  66. 'FMS_GATEWAY_SESSION_TTL_SECONDS': '600',
  67. 'FMS_REDIS_PREFIX': 'fms:mcp:gateway:',
  68. }, dotenv_path='missing.env')
  69. self.assertEqual('public', config.gateway_mode)
  70. self.assertEqual(600, config.gateway_session_ttl_seconds)
  71. self.assertEqual('fms:mcp:gateway:', config.redis_prefix)
  72. def test_public_gateway_mode_defaults_to_gateway_redis_prefix(self):
  73. config = GatewayConfig.from_env(env={
  74. 'FMS_API_BASE': 'https://base.example.com',
  75. 'FMS_GATEWAY_MODE': 'public',
  76. }, dotenv_path='missing.env')
  77. self.assertEqual('public', config.gateway_mode)
  78. self.assertEqual('fms:mcp:gateway:', config.redis_prefix)
  79. def test_diagnostic_reporter_config_reads_all_operational_limits(self):
  80. config = GatewayConfig.from_env(env={
  81. 'FMS_API_BASE': 'https://base.example.com',
  82. 'MCP_DIAGNOSIS_ENABLED': 'true',
  83. 'MCP_DIAGNOSIS_URL': 'https://support.internal/internal/mcp-diagnostics/events',
  84. 'MCP_DIAGNOSIS_KEY_ID': 'gateway-current',
  85. 'MCP_DIAGNOSIS_SECRET': 's' * 32,
  86. 'MCP_DIAGNOSIS_QUEUE_SIZE': '500',
  87. 'MCP_DIAGNOSIS_BATCH_SIZE': '50',
  88. 'MCP_DIAGNOSIS_TIMEOUT_SECONDS': '0.4',
  89. 'MCP_DIAGNOSIS_INITIAL_BACKOFF_SECONDS': '0.2',
  90. 'MCP_DIAGNOSIS_MAX_BACKOFF_SECONDS': '3.0',
  91. 'MCP_DIAGNOSIS_ALLOW_INSECURE_HTTP': 'true',
  92. }, dotenv_path='missing.env')
  93. self.assertTrue(config.diagnosis_enabled)
  94. self.assertEqual(
  95. 'https://support.internal/internal/mcp-diagnostics/events',
  96. config.diagnosis_url,
  97. )
  98. self.assertEqual('gateway-current', config.diagnosis_key_id)
  99. self.assertEqual('s' * 32, config.diagnosis_secret)
  100. self.assertEqual(500, config.diagnosis_queue_size)
  101. self.assertEqual(50, config.diagnosis_batch_size)
  102. self.assertEqual(0.4, config.diagnosis_timeout_seconds)
  103. self.assertEqual(0.2, config.diagnosis_initial_backoff_seconds)
  104. self.assertEqual(3.0, config.diagnosis_max_backoff_seconds)
  105. self.assertTrue(config.diagnosis_allow_insecure_http)
  106. default_config = GatewayConfig.from_env(env={
  107. 'FMS_API_BASE': 'https://base.example.com',
  108. }, dotenv_path='missing.env')
  109. self.assertFalse(default_config.diagnosis_allow_insecure_http)
  110. def test_timeout_ms_conversion_in_preferred_env(self):
  111. """Test FMS_TIMEOUT_MS conversion in preferred env"""
  112. config = GatewayConfig.from_env(env={
  113. 'FMS_API_BASE': 'https://base.example.com',
  114. 'FMS_TIMEOUT_MS': '5000', # 5000ms = 5 seconds
  115. }, dotenv_path='missing.env')
  116. self.assertEqual(5, config.timeout_seconds)
  117. def test_timeout_ms_minimum_value(self):
  118. """Test that FMS_TIMEOUT_MS converts to at least 1 second"""
  119. config = GatewayConfig.from_env(env={
  120. 'FMS_API_BASE': 'https://base.example.com',
  121. 'FMS_TIMEOUT_MS': '500', # 500ms should become 1 second
  122. }, dotenv_path='missing.env')
  123. self.assertEqual(1, config.timeout_seconds)
  124. def test_invalid_diagnostic_float_uses_default(self):
  125. config = GatewayConfig.from_env(env={
  126. 'FMS_API_BASE': 'https://base.example.com',
  127. 'MCP_DIAGNOSIS_TIMEOUT_SECONDS': 'not-a-number',
  128. }, dotenv_path='missing.env')
  129. self.assertEqual(0.5, config.diagnosis_timeout_seconds)
  130. def test_timeout_resolution_covers_supported_env_keys(self):
  131. cases = (
  132. ({'MCP_TIMEOUT_SECONDS': '11'}, {}, 11),
  133. ({'FMS_TIMEOUT_MS': '2500'}, {}, 2),
  134. ({}, {'FMS_TIMEOUT_SECONDS': '12'}, 12),
  135. )
  136. for preferred, fallback, expected in cases:
  137. with self.subTest(preferred=preferred, fallback=fallback):
  138. self.assertEqual(
  139. expected,
  140. GatewayConfig._resolve_timeout_seconds(
  141. preferred,
  142. fallback,
  143. ),
  144. )
  145. def test_load_dotenv_skips_invalid_lines_and_unquotes_values(self):
  146. with tempfile.TemporaryDirectory() as tmp_dir:
  147. path = os.path.join(tmp_dir, '.env')
  148. with open(path, 'w', encoding='utf-8') as file:
  149. file.write('# comment\n')
  150. file.write('invalid-line\n')
  151. file.write('=ignored\n')
  152. file.write('DOUBLE="double value"\n')
  153. file.write("SINGLE='single value'\n")
  154. values = GatewayConfig._load_dotenv(path)
  155. self.assertEqual({
  156. 'DOUBLE': 'double value',
  157. 'SINGLE': 'single value',
  158. }, values)
  159. class RateLimitConfigTest(unittest.TestCase):
  160. """Tests for _parse_int / _parse_bool helpers and rate limit config parsing."""
  161. def _config_from_env(self, env):
  162. return GatewayConfig.from_env(
  163. env=dict({'FMS_API_BASE': 'http://x.test'}, **env),
  164. dotenv_path='missing.env',
  165. )
  166. # --- _parse_int via OS env var ---
  167. def test_rate_limit_max_requests_reads_from_env(self):
  168. config = self._config_from_env({'FMS_RATE_LIMIT_MAX_REQUESTS': '120'})
  169. self.assertEqual(120, config.rate_limit_max_requests)
  170. def test_rate_limit_window_seconds_reads_from_env(self):
  171. config = self._config_from_env({'FMS_RATE_LIMIT_WINDOW_SECONDS': '30'})
  172. self.assertEqual(30, config.rate_limit_window_seconds)
  173. def test_max_in_flight_per_tool_reads_from_env(self):
  174. config = self._config_from_env({'FMS_MAX_IN_FLIGHT_PER_TOOL': '3'})
  175. self.assertEqual(3, config.max_in_flight_per_tool)
  176. def test_rate_limit_max_requests_os_env_with_inline_comment_does_not_crash(self):
  177. # OS env vars are not processed by _load_dotenv, so inline comments must be
  178. # stripped by _parse_int before int() conversion
  179. config = self._config_from_env({'FMS_RATE_LIMIT_MAX_REQUESTS': '60 # max per window'})
  180. self.assertEqual(60, config.rate_limit_max_requests)
  181. def test_rate_limit_window_seconds_invalid_value_falls_back_to_default(self):
  182. config = self._config_from_env({'FMS_RATE_LIMIT_WINDOW_SECONDS': 'not_a_number'})
  183. self.assertEqual(60, config.rate_limit_window_seconds)
  184. def test_rate_limit_max_requests_empty_falls_back_to_default(self):
  185. config = self._config_from_env({})
  186. self.assertEqual(60, config.rate_limit_max_requests)
  187. # --- _parse_bool via OS env var ---
  188. def test_rate_limit_enabled_default_is_true(self):
  189. config = self._config_from_env({})
  190. self.assertTrue(config.rate_limit_enabled)
  191. def test_rate_limit_enabled_zero_disables(self):
  192. config = self._config_from_env({'FMS_RATE_LIMIT_ENABLED': '0'})
  193. self.assertFalse(config.rate_limit_enabled)
  194. def test_rate_limit_enabled_false_string_disables(self):
  195. config = self._config_from_env({'FMS_RATE_LIMIT_ENABLED': 'false'})
  196. self.assertFalse(config.rate_limit_enabled)
  197. def test_rate_limit_enabled_off_string_disables(self):
  198. config = self._config_from_env({'FMS_RATE_LIMIT_ENABLED': 'off'})
  199. self.assertFalse(config.rate_limit_enabled)
  200. def test_rate_limit_enabled_empty_string_keeps_default_enabled(self):
  201. # empty string → _pick returns '' → _parse_bool returns default=True
  202. config = self._config_from_env({'FMS_RATE_LIMIT_ENABLED': ''})
  203. self.assertTrue(config.rate_limit_enabled)
  204. def test_rate_limit_enabled_one_enables(self):
  205. config = self._config_from_env({'FMS_RATE_LIMIT_ENABLED': '1'})
  206. self.assertTrue(config.rate_limit_enabled)
  207. # --- dotenv inline comment stripping ---
  208. def test_dotenv_inline_comment_stripped_from_int_value(self):
  209. with tempfile.TemporaryDirectory() as tmp:
  210. path = os.path.join(tmp, '.env')
  211. with open(path, 'w') as f:
  212. f.write('FMS_API_BASE=http://x.test\n')
  213. f.write('FMS_RATE_LIMIT_MAX_REQUESTS=45 # requests per window\n')
  214. config = GatewayConfig.from_env(env={}, dotenv_path=path)
  215. self.assertEqual(45, config.rate_limit_max_requests)
  216. def test_dotenv_inline_comment_stripped_from_bool_value(self):
  217. with tempfile.TemporaryDirectory() as tmp:
  218. path = os.path.join(tmp, '.env')
  219. with open(path, 'w') as f:
  220. f.write('FMS_API_BASE=http://x.test\n')
  221. f.write('FMS_RATE_LIMIT_ENABLED=0 # disabled for testing\n')
  222. config = GatewayConfig.from_env(env={}, dotenv_path=path)
  223. self.assertFalse(config.rate_limit_enabled)
  224. if __name__ == '__main__':
  225. unittest.main()