digdigdig3 0.1.9

//! Integration tests for Futu connector
//!
//! **NOTE**: These tests are disabled because Futu uses TCP + Protocol Buffers,
//! not standard HTTP REST APIs. The connector is not functional without either:
//! 1. PyO3 bridge to Python SDK
//! 2. Native Rust Protocol Buffer client
//! 3. External REST adapter service
//!
//! See research/RECOMMENDATIONS.md for implementation options.

#![cfg(test)]

use super::*;
use crate::core::types::{Symbol, AccountType};

#[tokio::test]
#[ignore] // Disabled - requires Protocol Buffer implementation
async fn test_futu_returns_unsupported() {
    let connector = FutuConnector::new();
    let symbol = Symbol::new("AAPL", "USD");

    // All methods should return UnsupportedOperation
    let result = connector.get_price(&symbol, AccountType::Spot).await;
    assert!(result.is_err());

    match result {
        Err(crate::core::types::ExchangeError::UnsupportedOperation(msg)) => {
            assert!(msg.contains("TCP") || msg.contains("Protocol Buffers"));
            println!("✓ Correctly returns UnsupportedOperation: {}", msg);
        }
        _ => panic!("Expected UnsupportedOperation error"),
    }
}

#[test]
fn test_futu_documentation_exists() {
    // Verify research documentation is present
    let research_path = std::path::Path::new(env!("CARGO_MANIFEST_DIR"))
        .join("src/stocks/china/futu/research");

    assert!(research_path.exists(), "Research directory should exist");

    // Check for key research files
    let key_files = vec![
        "ARCHITECTURE_ANALYSIS.md",
        "INTEGRATION_OPTIONS.md",
        "RECOMMENDATIONS.md",
    ];

    for file in key_files {
        let file_path = research_path.join(file);
        assert!(
            file_path.exists(),
            "Research file {} should exist",
            file
        );
    }

    println!("✓ All research documentation present");
}

#[test]
fn test_futu_stub_message() {
    // This test documents why Futu is disabled
    let reason = "Futu OpenAPI uses TCP + Protocol Buffers (not HTTP REST)";
    let solution = "See research/RECOMMENDATIONS.md for implementation options";

    println!("\n=== FUTU CONNECTOR STATUS ===");
    println!("Status: DISABLED (stub only)");
    println!("Reason: {}", reason);
    println!("Solution: {}", solution);
    println!("Research: 42,000+ lines of documentation available");
    println!("Recommendation: PyO3 wrapper (5 days) or skip");
    println!("============================\n");
}