support check module lua version

Author: CppCXY

Cargo.lock

@@ -1,5 +1,5 @@
 use emmylua_parser::{
-    LuaAstToken, LuaDocAttribute, LuaDocTagAlias, LuaDocTagClass, LuaDocTagEnum, LuaDocTagMeta, LuaDocTagNamespace, LuaDocTagUsing
+    LuaAstNode, LuaAstToken, LuaComment, LuaDocAttribute, LuaDocTag, LuaDocTagAlias, LuaDocTagClass, LuaDocTagEnum, LuaDocTagMeta, LuaDocTagNamespace, LuaDocTagUsing
 };
 use flagset::FlagSet;
 
@@ -138,7 +138,7 @@ pub fn analyze_doc_tag_using(analyzer: &mut DeclAnalyzer, using: LuaDocTagUsing)
     Some(())
 }
 
-pub fn analyze_doc_tag_meta(analyzer: &mut DeclAnalyzer, tag: LuaDocTagMeta) {
+pub fn analyze_doc_tag_meta(analyzer: &mut DeclAnalyzer, tag: LuaDocTagMeta) -> Option<()> {
     let file_id = analyzer.get_file_id();
     analyzer.db.get_meta_file_mut().add_meta_file(file_id);
 
@@ -155,4 +155,32 @@ pub fn analyze_doc_tag_meta(analyzer: &mut DeclAnalyzer, tag: LuaDocTagMeta) {
                 .add_module_by_module_path(file_id, name_token.get_name_text().to_string());
         }
     }
+
+    let comment = tag.get_parent::<LuaComment>()?;
+    let version_tag = comment.get_doc_tags().find_map(|tag| {
+        if let LuaDocTag::Version(version) = tag {
+            Some(version)
+        } else {
+            None
+        }
+    })?;
+
+    let mut visible = false;
+    let current_version = analyzer.emmyrc.runtime.version.to_lua_version_number();
+    for doc_version in version_tag.get_version_list() {
+        let version_condition = doc_version.get_version_condition()?;
+        if version_condition.check(&current_version) {
+            visible = true;
+            break;
+        }
+    }
+
+    if !visible {
+        analyzer
+            .db
+            .get_module_index_mut()
+            .set_module_visibility(file_id, false);
+    }
+
+    Some(())
 }

crates/code_analysis/src/compilation/analyzer/decl/docs.rs

@@ -2,7 +2,10 @@ mod docs;
 mod exprs;
 mod stats;
 
-use crate::db_index::{DbIndex, LuaScopeKind};
+use crate::{
+    db_index::{DbIndex, LuaScopeKind},
+    Emmyrc,
+};
 
 use super::AnalyzeContext;
 use emmylua_parser::{LuaAst, LuaAstNode, LuaChunk, LuaSyntaxKind};
@@ -14,11 +17,12 @@ use crate::{
 };
 
 pub(crate) fn analyze(db: &mut DbIndex, context: &mut AnalyzeContext) {
+    let emmyrc = &context.config;
     for in_filed_tree in context.tree_list.iter() {
         db.get_reference_index_mut()
             .create_local_reference(in_filed_tree.file_id);
         let mut analyzer =
-            DeclAnalyzer::new(db, in_filed_tree.file_id, in_filed_tree.value.clone());
+            DeclAnalyzer::new(db, in_filed_tree.file_id, in_filed_tree.value.clone(), &emmyrc);
         analyzer.analyze();
         let decl_tree = analyzer.get_decl_tree();
         db.get_decl_index_mut().add_decl_tree(decl_tree);
@@ -124,15 +128,22 @@ pub struct DeclAnalyzer<'a> {
     root: LuaChunk,
     decl: LuaDeclarationTree,
     scopes: Vec<LuaScopeId>,
+    emmyrc: &'a Emmyrc,
 }
 
 impl<'a> DeclAnalyzer<'a> {
-    pub fn new(db: &'a mut DbIndex, file_id: FileId, tree: LuaChunk) -> DeclAnalyzer<'a> {
+    pub fn new(
+        db: &'a mut DbIndex,
+        file_id: FileId,
+        root: LuaChunk,
+        emmyrc: &'a Emmyrc,
+    ) -> DeclAnalyzer<'a> {
         DeclAnalyzer {
             db,
-            root: tree,
+            root,
             decl: LuaDeclarationTree::new(file_id),
             scopes: Vec::new(),
+            emmyrc,
         }
     }
 

crates/code_analysis/src/compilation/analyzer/decl/mod.rs

@@ -1,3 +1,4 @@
+use emmylua_parser::LuaVersionNumber;
 use schemars::JsonSchema;
 use serde::{Deserialize, Serialize};
 
@@ -33,7 +34,7 @@ impl Default for EmmyrcRuntime {
     }
 }
 
-#[derive(Serialize, Deserialize, Debug, JsonSchema)]
+#[derive(Serialize, Deserialize, Debug, JsonSchema, Clone, Copy)]
 pub enum EmmyrcLuaVersion {
     /// Lua 5.1
     #[serde(rename = "Lua5.1")]
@@ -61,3 +62,15 @@ impl Default for EmmyrcLuaVersion {
     }
 }
 
+impl EmmyrcLuaVersion {
+    pub fn to_lua_version_number(&self) -> LuaVersionNumber {
+        match self {
+            EmmyrcLuaVersion::Lua51 => LuaVersionNumber::new(5, 1, 0),
+            EmmyrcLuaVersion::LuaJIT => LuaVersionNumber::LUA_JIT,
+            EmmyrcLuaVersion::Lua52 => LuaVersionNumber::new(5, 2, 0),
+            EmmyrcLuaVersion::Lua53 => LuaVersionNumber::new(5, 3, 0),
+            EmmyrcLuaVersion::Lua54 => LuaVersionNumber::new(5, 4, 0),
+            EmmyrcLuaVersion::LuaLatest => LuaVersionNumber::new(5, 4, 0),
+        }
+    }
+}

crates/code_analysis/src/config/configs/runtime.rs

@@ -7,10 +7,11 @@ use std::{collections::HashSet, path::PathBuf};
 use crate::{semantic::LuaInferConfig, FileId};
 pub use config_loader::load_configs;
 pub use configs::EmmyrcFilenameConvention;
+pub use configs::EmmyrcLuaVersion;
 use configs::{
     EmmyrcCodeLen, EmmyrcCompletion, EmmyrcDiagnostic, EmmyrcHover, EmmyrcInlayHint,
-    EmmyrcLuaVersion, EmmyrcReference, EmmyrcResource, EmmyrcRuntime, EmmyrcSemanticToken,
-    EmmyrcSignature, EmmyrcStrict, EmmyrcWorkspace,
+    EmmyrcReference, EmmyrcResource, EmmyrcRuntime, EmmyrcSemanticToken, EmmyrcSignature,
+    EmmyrcStrict, EmmyrcWorkspace,
 };
 use emmylua_parser::{LuaLanguageLevel, ParserConfig};
 use rowan::NodeCache;

crates/code_analysis/src/config/mod.rs

@@ -27,8 +27,6 @@ pub enum DiagnosticCode {
     Unused,
     /// Undefined global
     UndefinedGlobal,
-    /// Need import
-    NeedImport,
     /// Deprecated
     Deprecated,
     /// Access invisible member
@@ -69,7 +67,6 @@ pub fn get_default_severity(code: DiagnosticCode) -> DiagnosticSeverity {
         DiagnosticCode::UnreachableCode => DiagnosticSeverity::HINT,
         DiagnosticCode::Unused => DiagnosticSeverity::HINT,
         DiagnosticCode::UndefinedGlobal => DiagnosticSeverity::ERROR,
-        DiagnosticCode::NeedImport => DiagnosticSeverity::WARNING,
         DiagnosticCode::Deprecated => DiagnosticSeverity::HINT,
         DiagnosticCode::AccessInvisibleMember => DiagnosticSeverity::WARNING,
         DiagnosticCode::DiscardReturns => DiagnosticSeverity::WARNING,

crates/code_analysis/src/diagnostic/lua_diagnostic_code.rs

@@ -18,10 +18,11 @@ pub fn add_completion(builder: &mut CompletionBuilder) -> Option<()> {
         .get_parent::<LuaCallExpr>()?
         .get_prefix_expr()?;
 
+    let emmyrc = builder.semantic_model.get_emmyrc();
     match call_expr_prefix {
         LuaExpr::NameExpr(name_expr) => {
             let name = name_expr.get_name_text()?;
-            if !is_require_call(builder.semantic_model.get_emmyrc(), &name) {
+            if !is_require_call(emmyrc, &name) {
                 return None;
             }
         }
@@ -53,7 +54,7 @@ pub fn add_completion(builder: &mut CompletionBuilder) -> Option<()> {
         let child_module_node = db.get_module_index().get_module_node(module_id)?;
         if let Some(child_file_id) = child_module_node.file_ids.first() {
             let child_module_info = db.get_module_index().get_module(*child_file_id)?;
-            if child_module_info.visible {
+            if  child_module_info.visible {
                 let uri = db.get_vfs().get_uri(child_file_id)?;
                 let filter_text = format!("{}{}", prefix, name);
                 let completion_item = CompletionItem {

crates/emmylua_ls/src/handlers/completion/providers/module_path_provider.rs

@@ -1,6 +1,6 @@
 [package]
 name = "emmylua_parser"
-version = "0.8.0"
+version = "0.8.1"
 edition = "2021"
 authors = ["CppCXY"]
 description = "A parser for EmmyLua and luals"

crates/emmylua_parser/Cargo.toml

@@ -53,3 +53,22 @@ impl Ord for LuaVersionNumber {
             .then_with(|| self.patch.cmp(&other.patch))
     }
 }
+
+#[allow(unused)]
+#[derive(Debug, Clone, PartialEq, Eq, Hash)]
+pub enum LuaVersionCondition {
+    Eq(LuaVersionNumber),
+    Gte(LuaVersionNumber),
+    Lte(LuaVersionNumber),
+}
+
+#[allow(unused)]
+impl LuaVersionCondition {
+    pub fn check(&self, version: &LuaVersionNumber) -> bool {
+        match self {
+            LuaVersionCondition::Eq(v) => version == v,
+            LuaVersionCondition::Gte(v) => version >= v,
+            LuaVersionCondition::Lte(v) => version <= v,
+        }
+    }
+}

crates/emmylua_parser/src/kind/lua_version.rs

@@ -1,20 +1,22 @@
+mod lua_language_level;
+mod lua_operator_kind;
+mod lua_syntax_kind;
+mod lua_token_kind;
+mod lua_type_operator_kind;
+mod lua_version;
+mod lua_visibility_kind;
+
 pub use lua_language_level::LuaLanguageLevel;
 pub use lua_operator_kind::{BinaryOperator, UnaryOperator, UNARY_PRIORITY};
 pub use lua_syntax_kind::LuaSyntaxKind;
 pub use lua_token_kind::LuaTokenKind;
 pub use lua_type_operator_kind::{
     LuaTypeBinaryOperator, LuaTypeTernaryOperator, LuaTypeUnaryOperator,
 };
-pub use lua_version::LuaVersionNumber;
+pub use lua_version::{LuaVersionNumber, LuaVersionCondition};
 pub use lua_visibility_kind::VisibilityKind;
 
-mod lua_language_level;
-mod lua_operator_kind;
-mod lua_syntax_kind;
-mod lua_token_kind;
-mod lua_type_operator_kind;
-mod lua_version;
-mod lua_visibility_kind;
+
 
 #[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord, Hash)]
 #[repr(u16)]