sdivi-lang-python 0.2.16

//! Python language adapter for sdivi-rust.
//!
//! Implements [`sdivi_parsing::adapter::LanguageAdapter`] for `.py` source files
//! using the `tree-sitter-python` grammar.
//!
//! # Thread safety
//!
//! `tree_sitter::Parser` is not `Send`. Parsers are stored in `thread_local!`
//! storage so that `PythonAdapter` itself can be `Send + Sync` and participate
//! in rayon parallel parsing.

mod extract;

use std::cell::RefCell;
use std::path::Path;

use sdivi_parsing::adapter::LanguageAdapter;
use sdivi_parsing::feature_record::FeatureRecord;

use extract::{collect_hints, extract_exports, extract_imports, extract_signatures};

thread_local! {
    static PARSER: RefCell<tree_sitter::Parser> = RefCell::new({
        let mut p = tree_sitter::Parser::new();
        p.set_language(&tree_sitter_python::language())
            .expect("tree-sitter-python grammar failed to load");
        p
    });
}

/// Language adapter for Python source files.
///
/// Parses `.py` files with the `tree-sitter-python` grammar and extracts:
/// - `imports` from `import` and `from … import` statements
/// - `exports` from top-level non-underscore definitions
/// - `signatures` from function and class definitions
/// - `pattern_hints` for the patterns stage
///
/// # Examples
///
/// ```rust
/// use sdivi_lang_python::PythonAdapter;
/// use sdivi_parsing::adapter::LanguageAdapter;
///
/// let adapter = PythonAdapter;
/// assert_eq!(adapter.language_name(), "python");
/// assert!(adapter.file_extensions().contains(&".py"));
/// ```
pub struct PythonAdapter;

impl LanguageAdapter for PythonAdapter {
    fn language_name(&self) -> &'static str {
        "python"
    }

    fn file_extensions(&self) -> &[&'static str] {
        &[".py"]
    }

    /// Parses `content` and returns a [`FeatureRecord`].
    ///
    /// The tree-sitter CST is created, traversed, and **dropped** before this
    /// method returns. No tree-sitter type escapes into the returned record.
    fn parse_file(&self, path: &Path, content: String) -> FeatureRecord {
        let source = content.as_bytes();

        let (imports, exports, signatures, pattern_hints) = PARSER.with(|cell| {
            let mut parser = cell.borrow_mut();
            let tree = parser
                .parse(source, None)
                .expect("tree-sitter-python failed to parse");

            let root = tree.root_node();
            let imports = extract_imports(root, source);
            let exports = extract_exports(root, source);
            let signatures = extract_signatures(root, source);
            let hints = collect_hints(root, source);
            // tree is dropped here — CST does not escape this closure.
            (imports, exports, signatures, hints)
        });

        FeatureRecord {
            path: path.to_path_buf(),
            language: "python".to_string(),
            imports,
            exports,
            signatures,
            pattern_hints,
        }
    }
}