@opencodereview/core 1.9.1

package/dist/languages/python/parser.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Python Language Adapter
+ *
+ * Regex-based parser for Python source code. No native AST dependencies needed —
+ * Python's indentation-based syntax is straightforward enough for regex extraction.
+ *
+ * Supports:
+ * - Import extraction (import, from...import, relative imports)
+ * - Function/method call extraction
+ * - Complexity metrics (cyclomatic, cognitive, nesting via indentation)
+ * - Deprecated API detection (via deprecated-apis-python.json)
+ * - Package verification (builtin + common third-party whitelists)
+ *
+ * @since 0.3.0
+ */
+import type { SupportedLanguage } from '../../types.js';
+import type { LanguageAdapter, ASTNode, ImportInfo, CallInfo, PackageVerifyResult, DeprecatedInfo, ComplexityMetrics } from '../types.js';
+/**
+ * Python standard library modules (3.10+).
+ * At least 65 modules covering the most commonly used parts of stdlib.
+ */
+export declare const PYTHON_BUILTIN_MODULES: Set<string>;
+/**
+ * Well-known Python third-party packages from PyPI.
+ * At least 55 packages covering data science, web, testing, tooling, etc.
+ */
+export declare const PYTHON_COMMON_PACKAGES: Set<string>;
+/**
+ * PythonAdapter — LanguageAdapter implementation for Python.
+ *
+ * Covers: .py, .pyi
+ *
+ * Uses regex-based parsing instead of a native AST parser.
+ * Python's syntax (indentation-based nesting, simple import syntax)
+ * is well-suited for regex-based extraction.
+ */
+export declare class PythonAdapter implements LanguageAdapter {
+    readonly id: SupportedLanguage;
+    readonly extensions: string[];
+    /**
+     * Parse Python source code.
+     * Returns a lightweight AST-like structure with lines and source,
+     * sufficient for regex-based detection.
+     */
+    parse(source: string, _filePath: string): Promise<ASTNode>;
+    /**
+     * Extract import statements from Python source.
+     *
+     * Matches:
+     * - import os
+     * - import os.path
+     * - import os, sys
+     * - from os import path
+     * - from os.path import exists, join
+     * - from . import relative
+     * - from ..parent import something
+     * - from __future__ import annotations
+     */
+    extractImports(source: string, _ast?: ASTNode): ImportInfo[];
+    /**
+     * Extract function/method calls from Python source.
+     *
+     * Matches patterns like:
+     * - func()
+     * - obj.method()
+     * - module.submodule.func()
+     * - Class()
+     */
+    extractCalls(source: string, _ast?: ASTNode): CallInfo[];
+    /**
+     * Verify if a Python package exists.
+     *
+     * Phase 2 implementation: checks against builtin modules and
+     * common third-party package whitelists.
+     * Full PyPI verification will be added in a later phase.
+     */
+    verifyPackage(name: string): Promise<PackageVerifyResult>;
+    /**
+     * Check if an API is deprecated.
+     * Searches the deprecated-apis-python.json database.
+     */
+    checkDeprecated(api: string): DeprecatedInfo | null;
+    /**
+     * Compute complexity metrics for Python source code.
+     *
+     * Uses indentation-based nesting detection (Python's natural structure)
+     * and regex matching for decision points.
+     */
+    computeComplexity(source: string, _ast?: ASTNode): ComplexityMetrics;
+}
+//# sourceMappingURL=parser.d.ts.map

package/dist/languages/python/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/languages/python/parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,KAAK,EACV,eAAe,EACf,OAAO,EACP,UAAU,EACV,QAAQ,EACR,mBAAmB,EACnB,cAAc,EACd,iBAAiB,EAClB,MAAM,aAAa,CAAC;AAIrB;;;GAGG;AACH,eAAO,MAAM,sBAAsB,aAkCjC,CAAC;AAIH;;;GAGG;AACH,eAAO,MAAM,sBAAsB,aAgCjC,CAAC;AA2BH;;;;;;;;GAQG;AACH,qBAAa,aAAc,YAAW,eAAe;IACnD,QAAQ,CAAC,EAAE,EAAE,iBAAiB,CAAY;IAC1C,QAAQ,CAAC,UAAU,WAAmB;IAEtC;;;;OAIG;IACG,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQhE;;;;;;;;;;;;OAYG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,UAAU,EAAE;IA+E5D;;;;;;;;OAQG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,EAAE;IAiDxD;;;;;;OAMG;IACG,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA0B/D;;;OAGG;IACH,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAenD;;;;;OAKG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,iBAAiB;CA6DrE"}

package/dist/languages/python/parser.js

@@ -0,0 +1,375 @@
+/**
+ * Python Language Adapter
+ *
+ * Regex-based parser for Python source code. No native AST dependencies needed —
+ * Python's indentation-based syntax is straightforward enough for regex extraction.
+ *
+ * Supports:
+ * - Import extraction (import, from...import, relative imports)
+ * - Function/method call extraction
+ * - Complexity metrics (cyclomatic, cognitive, nesting via indentation)
+ * - Deprecated API detection (via deprecated-apis-python.json)
+ * - Package verification (builtin + common third-party whitelists)
+ *
+ * @since 0.3.0
+ */
+import { createRequire } from 'node:module';
+// ─── Python Built-in Modules ───
+/**
+ * Python standard library modules (3.10+).
+ * At least 65 modules covering the most commonly used parts of stdlib.
+ */
+export const PYTHON_BUILTIN_MODULES = new Set([
+    // Core
+    'os', 'sys', 're', 'json', 'math', 'random', 'datetime', 'time',
+    'pathlib', 'typing', 'collections', 'functools', 'itertools', 'io',
+    // System & subprocess
+    'subprocess', 'shutil', 'tempfile', 'logging', 'unittest', 'argparse',
+    // Crypto & encoding
+    'hashlib', 'hmac', 'secrets', 'base64',
+    // Network & web
+    'urllib', 'http', 'socket', 'ssl', 'email', 'smtplib',
+    // Data formats
+    'csv', 'sqlite3', 'xml', 'html', 'configparser',
+    // OOP & patterns
+    'abc', 'asyncio', 'concurrent', 'multiprocessing', 'threading', 'queue',
+    // Binary & serialization
+    'struct', 'pickle', 'copy', 'pprint', 'textwrap',
+    // Enums & data
+    'enum', 'dataclasses', 'contextlib', 'warnings', 'traceback',
+    // Introspection
+    'inspect', 'dis', 'ast', 'token', 'tokenize', 'importlib', 'pkgutil',
+    // Archive & compression
+    'zipfile', 'tarfile', 'gzip', 'bz2', 'lzma', 'zipimport',
+    // OS-level
+    'signal', 'ctypes', 'platform',
+    // Additional stdlib
+    'string', 'decimal', 'fractions', 'statistics', 'operator',
+    'array', 'bisect', 'heapq', 'weakref', 'types',
+    'glob', 'fnmatch', 'linecache', 'shelve', 'dbm',
+    'binascii', 'codecs', 'unicodedata',
+    'mmap', 'select', 'selectors',
+    'atexit', 'sched', 'gettext', 'locale',
+    'os.path', 'posixpath', 'ntpath',
+    'pdb', 'profile', 'cProfile', 'timeit',
+    'doctest', 'builtins', '__future__',
+]);
+// ─── Common Third-Party Packages ───
+/**
+ * Well-known Python third-party packages from PyPI.
+ * At least 55 packages covering data science, web, testing, tooling, etc.
+ */
+export const PYTHON_COMMON_PACKAGES = new Set([
+    // Data science & ML
+    'numpy', 'pandas', 'scipy', 'matplotlib', 'seaborn',
+    'sklearn', 'scikit-learn', 'tensorflow', 'torch', 'keras',
+    'xgboost', 'lightgbm', 'transformers',
+    // Web frameworks
+    'flask', 'django', 'fastapi', 'uvicorn', 'gunicorn',
+    'starlette', 'sanic',
+    // Task queues & caching
+    'celery', 'redis', 'kombu',
+    // Database
+    'sqlalchemy', 'alembic', 'pydantic', 'psycopg2', 'pymongo',
+    // HTTP clients
+    'requests', 'httpx', 'aiohttp', 'urllib3',
+    // Scraping & automation
+    'beautifulsoup4', 'bs4', 'scrapy', 'selenium', 'playwright',
+    // Image processing
+    'pillow', 'PIL', 'opencv-python', 'cv2',
+    // Cloud
+    'boto3', 'botocore', 'google-cloud-storage',
+    // Testing
+    'pytest', 'tox', 'coverage', 'mock', 'hypothesis',
+    // Code quality
+    'black', 'isort', 'flake8', 'pylint', 'mypy', 'ruff', 'pre-commit',
+    // Packaging
+    'poetry', 'pipenv', 'setuptools', 'wheel', 'twine', 'pip',
+    // CLI
+    'click', 'typer', 'rich', 'tqdm',
+    // Config & serialization
+    'pyyaml', 'yaml', 'toml', 'tomli', 'python-dotenv', 'dotenv',
+    // Security
+    'cryptography', 'paramiko', 'jwt', 'pyjwt',
+]);
+/** Load deprecated APIs from JSON data file */
+function loadDeprecatedAPIs() {
+    try {
+        const require = createRequire(import.meta.url);
+        return require('../../data/deprecated-apis-python.json');
+    }
+    catch {
+        return [];
+    }
+}
+const PYTHON_DEPRECATED_DB = loadDeprecatedAPIs();
+// ─── Python Adapter ───
+/**
+ * PythonAdapter — LanguageAdapter implementation for Python.
+ *
+ * Covers: .py, .pyi
+ *
+ * Uses regex-based parsing instead of a native AST parser.
+ * Python's syntax (indentation-based nesting, simple import syntax)
+ * is well-suited for regex-based extraction.
+ */
+export class PythonAdapter {
+    id = 'python';
+    extensions = ['.py', '.pyi'];
+    /**
+     * Parse Python source code.
+     * Returns a lightweight AST-like structure with lines and source,
+     * sufficient for regex-based detection.
+     */
+    async parse(source, _filePath) {
+        return {
+            type: 'PythonModule',
+            lines: source.split('\n'),
+            source,
+        };
+    }
+    /**
+     * Extract import statements from Python source.
+     *
+     * Matches:
+     * - import os
+     * - import os.path
+     * - import os, sys
+     * - from os import path
+     * - from os.path import exists, join
+     * - from . import relative
+     * - from ..parent import something
+     * - from __future__ import annotations
+     */
+    extractImports(source, _ast) {
+        const lines = source.split('\n');
+        const imports = [];
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            const trimmed = line.trim();
+            const lineNum = i + 1;
+            // Skip comments and strings
+            if (trimmed.startsWith('#'))
+                continue;
+            // from xxx import yyy, zzz
+            const fromMatch = trimmed.match(/^from\s+(\.{0,3}[\w.]*)\s+import\s+(.+?)(?:\s*#.*)?$/);
+            if (fromMatch) {
+                const modulePath = fromMatch[1];
+                const importedNames = fromMatch[2];
+                const isRelative = modulePath.startsWith('.');
+                // Parse imported bindings: "a, b as c, d"
+                const bindings = [];
+                // Handle star import
+                if (importedNames.trim() === '*') {
+                    bindings.push('*');
+                }
+                else {
+                    // Handle parenthesized imports (single-line): from x import (a, b, c)
+                    const cleaned = importedNames.replace(/[()]/g, '');
+                    for (const part of cleaned.split(',')) {
+                        const name = part.trim().split(/\s+as\s+/).pop()?.trim();
+                        if (name && name !== '\\')
+                            bindings.push(name);
+                    }
+                }
+                // Determine base module name
+                const baseModule = isRelative
+                    ? modulePath
+                    : modulePath.split('.')[0];
+                imports.push({
+                    module: modulePath,
+                    bindings,
+                    line: lineNum,
+                    isRelative,
+                    isBuiltin: !isRelative && PYTHON_BUILTIN_MODULES.has(baseModule),
+                });
+                continue;
+            }
+            // import xxx, yyy.zzz
+            const importMatch = trimmed.match(/^import\s+(.+?)(?:\s*#.*)?$/);
+            if (importMatch) {
+                const moduleList = importMatch[1];
+                // Split comma-separated imports: import os, sys, json
+                for (const part of moduleList.split(',')) {
+                    const asMatch = part.trim().match(/^([\w.]+)(?:\s+as\s+(\w+))?$/);
+                    if (asMatch) {
+                        const fullPath = asMatch[1];
+                        const alias = asMatch[2] || fullPath.split('.').pop();
+                        const baseModule = fullPath.split('.')[0];
+                        imports.push({
+                            module: fullPath,
+                            bindings: [alias],
+                            line: lineNum,
+                            isRelative: false,
+                            isBuiltin: PYTHON_BUILTIN_MODULES.has(baseModule),
+                        });
+                    }
+                }
+            }
+        }
+        return imports;
+    }
+    /**
+     * Extract function/method calls from Python source.
+     *
+     * Matches patterns like:
+     * - func()
+     * - obj.method()
+     * - module.submodule.func()
+     * - Class()
+     */
+    extractCalls(source, _ast) {
+        const lines = source.split('\n');
+        const calls = [];
+        // Python keywords that look like function calls but aren't
+        const pythonKeywords = new Set([
+            'if', 'elif', 'else', 'for', 'while', 'with', 'try', 'except',
+            'finally', 'def', 'class', 'return', 'yield', 'raise', 'import',
+            'from', 'as', 'pass', 'break', 'continue', 'del', 'assert',
+            'lambda', 'global', 'nonlocal', 'async', 'await', 'and', 'or',
+            'not', 'in', 'is', 'True', 'False', 'None',
+        ]);
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            const trimmed = line.trimStart();
+            const lineNum = i + 1;
+            // Skip comments
+            if (trimmed.startsWith('#'))
+                continue;
+            // Skip string-only lines (rough heuristic)
+            if (/^(['"]){3}/.test(trimmed) || /^(['"])/.test(trimmed))
+                continue;
+            // Match calls: word.word.word(  or  word(
+            const callPattern = /(\w+(?:\.\w+)*)\s*\(/g;
+            let match;
+            while ((match = callPattern.exec(line)) !== null) {
+                const callee = match[1];
+                const firstName = callee.split('.')[0];
+                // Skip keywords
+                if (pythonKeywords.has(firstName))
+                    continue;
+                // Skip decorators (they're on lines starting with @)
+                if (trimmed.startsWith('@') && match.index <= line.indexOf(callee))
+                    continue;
+                const isMethodCall = callee.includes('.');
+                calls.push({
+                    name: callee,
+                    line: lineNum,
+                    column: match.index + 1,
+                    isMethodCall,
+                });
+            }
+        }
+        return calls;
+    }
+    /**
+     * Verify if a Python package exists.
+     *
+     * Phase 2 implementation: checks against builtin modules and
+     * common third-party package whitelists.
+     * Full PyPI verification will be added in a later phase.
+     */
+    async verifyPackage(name) {
+        const baseModule = name.split('.')[0];
+        if (PYTHON_BUILTIN_MODULES.has(baseModule) || PYTHON_BUILTIN_MODULES.has(name)) {
+            return {
+                name,
+                exists: true,
+                checkedAt: Date.now(),
+            };
+        }
+        if (PYTHON_COMMON_PACKAGES.has(baseModule) || PYTHON_COMMON_PACKAGES.has(name)) {
+            return {
+                name,
+                exists: true,
+                checkedAt: Date.now(),
+            };
+        }
+        return {
+            name,
+            exists: false,
+            checkedAt: Date.now(),
+        };
+    }
+    /**
+     * Check if an API is deprecated.
+     * Searches the deprecated-apis-python.json database.
+     */
+    checkDeprecated(api) {
+        for (const entry of PYTHON_DEPRECATED_DB) {
+            const regex = new RegExp(entry.pattern);
+            if (regex.test(api)) {
+                return {
+                    api: entry.api,
+                    reason: entry.reason,
+                    replacement: entry.replacement,
+                    since: entry.deprecated_since,
+                };
+            }
+        }
+        return null;
+    }
+    /**
+     * Compute complexity metrics for Python source code.
+     *
+     * Uses indentation-based nesting detection (Python's natural structure)
+     * and regex matching for decision points.
+     */
+    computeComplexity(source, _ast) {
+        const lines = source.split('\n');
+        let cyclomatic = 1; // base complexity
+        let cognitive = 0;
+        let maxNestingDepth = 0;
+        let currentDepth = 0;
+        let functionCount = 0;
+        // Track non-empty, non-comment lines
+        const codeLines = lines.filter(l => {
+            const t = l.trim();
+            return t.length > 0 && !t.startsWith('#');
+        });
+        for (const line of lines) {
+            const trimmed = line.trimStart();
+            if (!trimmed || trimmed.startsWith('#'))
+                continue;
+            // Python uses indentation for nesting
+            const indent = line.length - trimmed.length;
+            // Use 4-space standard, but handle 2-space too
+            currentDepth = indent > 0 ? Math.floor(indent / 4) || Math.floor(indent / 2) : 0;
+            maxNestingDepth = Math.max(maxNestingDepth, currentDepth);
+            // Decision points → cyclomatic complexity
+            if (/^(if|elif)\s+/.test(trimmed)) {
+                cyclomatic++;
+                cognitive += 1 + currentDepth; // nesting adds cognitive load
+            }
+            else if (/^(for|while)\s+/.test(trimmed)) {
+                cyclomatic++;
+                cognitive += 1 + currentDepth;
+            }
+            else if (/^except(\s+|\s*:)/.test(trimmed)) {
+                cyclomatic++;
+                cognitive += 1 + currentDepth;
+            }
+            else if (/^else\s*:/.test(trimmed)) {
+                cognitive += 1; // else doesn't add cyclomatic but adds cognitive
+            }
+            // Logical operators within expressions
+            const logicalOps = (trimmed.match(/\band\b|\bor\b/g) || []).length;
+            cyclomatic += logicalOps;
+            cognitive += logicalOps;
+            // Count function/method definitions
+            if (/^(async\s+)?def\s+\w+/.test(trimmed)) {
+                functionCount++;
+            }
+            // Count class definitions (rough proxy for structure)
+            // Not counted as functions, but noted
+        }
+        return {
+            cyclomatic,
+            cognitive,
+            loc: codeLines.length,
+            functionCount,
+            maxNestingDepth,
+        };
+    }
+}
+//# sourceMappingURL=parser.js.map

package/dist/languages/python/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../../src/languages/python/parser.ts"],"names":[],"mappings":"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"}

package/dist/languages/registry.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Language Registry
+ *
+ * Manages registered LanguageAdapters and auto-selects the appropriate
+ * adapter based on file extension.
+ *
+ * @since 0.3.0
+ */
+import type { SupportedLanguage } from '../types.js';
+import type { LanguageAdapter } from './types.js';
+/**
+ * LanguageRegistry — singleton that maps file extensions to language adapters.
+ *
+ * Usage:
+ *   const registry = LanguageRegistry.getInstance();
+ *   registry.register(new TypeScriptAdapter());
+ *   const adapter = registry.getByExtension('.ts');
+ */
+export declare class LanguageRegistry {
+    private static instance;
+    /** Adapter map by language ID */
+    private adapters;
+    /** Extension → language ID lookup */
+    private extensionMap;
+    private constructor();
+    /** Get the singleton instance */
+    static getInstance(): LanguageRegistry;
+    /**
+     * Reset the singleton (for testing).
+     */
+    static resetInstance(): void;
+    /**
+     * Register a language adapter.
+     * @param adapter The language adapter to register
+     * @throws If an adapter with the same ID is already registered
+     */
+    register(adapter: LanguageAdapter): void;
+    /**
+     * Unregister a language adapter by ID.
+     * @param id Language identifier
+     */
+    unregister(id: string): void;
+    /**
+     * Get a language adapter by language ID.
+     * @param id Language identifier (e.g. 'typescript')
+     * @returns The adapter, or undefined if not registered
+     */
+    getById(id: string): LanguageAdapter | undefined;
+    /**
+     * Get a language adapter by file extension.
+     * @param ext File extension including dot (e.g. '.ts')
+     * @returns The adapter, or undefined if no adapter matches
+     */
+    getByExtension(ext: string): LanguageAdapter | undefined;
+    /**
+     * Get a language adapter for a file path.
+     * Extracts the extension and looks up the adapter.
+     * @param filePath File path
+     * @returns The adapter, or undefined if no adapter matches
+     */
+    getByFilePath(filePath: string): LanguageAdapter | undefined;
+    /**
+     * Detect the language for a file path.
+     * @param filePath File path
+     * @returns The language identifier, or undefined
+     */
+    detectLanguage(filePath: string): SupportedLanguage | undefined;
+    /**
+     * Get all registered language IDs.
+     */
+    getRegisteredLanguages(): string[];
+    /**
+     * Get all supported extensions.
+     */
+    getSupportedExtensions(): string[];
+    /**
+     * Check if a file extension is supported.
+     */
+    isSupported(extOrPath: string): boolean;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/languages/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/languages/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;;;;;;GAOG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAiC;IAExD,iCAAiC;IACjC,OAAO,CAAC,QAAQ,CAAsC;IAEtD,qCAAqC;IACrC,OAAO,CAAC,YAAY,CAA6B;IAEjD,OAAO;IAEP,iCAAiC;IACjC,MAAM,CAAC,WAAW,IAAI,gBAAgB;IAOtC;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,IAAI;IAI5B;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAUxC;;;OAGG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAU5B;;;;OAIG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAIhD;;;;OAIG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAQxD;;;;;OAKG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAQ5D;;;;OAIG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAS/D;;OAEG;IACH,sBAAsB,IAAI,MAAM,EAAE;IAIlC;;OAEG;IACH,sBAAsB,IAAI,MAAM,EAAE;IAIlC;;OAEG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;CAOxC"}