provide API to list supported language versions (#490)

Closes #363

.changeset/chilled-ways-worry.md

@@ -0,0 +1,5 @@
+---
+"changelog": minor
+---
+
+provide API to list supported language versions

crates/codegen/syntax/src/rust_lib_code_generator.rs

@@ -69,9 +69,10 @@ impl CodeGenerator {
  InvalidProductionVersion(ProductionKind),
  }}
 
+ {versions_array}
+
  impl Language {{
  pub fn new(version: Version) -> Result<Self, Error> {{
- {versions_array}
  if VERSIONS.contains(&version.to_string().as_str()) {{
  Ok(Self {{
  {version_flag_initializers},
@@ -86,6 +87,10 @@ impl CodeGenerator {
  &self.version
  }}
 
+ pub fn supported_versions() -> Vec<Version> {{
+ return VERSIONS.iter().map(|v| Version::parse(v).unwrap()).collect();
+ }}
+
  pub fn parse(&self, production_kind: ProductionKind, input: &str) -> Result<ParseOutput, Error> {{
  let output = match production_kind {{
  {scanner_invocations},
@@ -107,7 +112,7 @@ impl CodeGenerator {
  language_title = &language.title,
  versions_array = {
  let versions = language.versions.iter().map(|v| v.to_string());
- quote! { static VERSIONS: &'static [&'static str] = &[ #(#versions),* ]; }
+ quote! { const VERSIONS: &'static [&'static str] = &[ #(#versions),* ]; }
  },
  version_flag_initializers = self.version_flag_initializers(),
  scanner_invocations = self.scanner_invocations(),

crates/codegen/syntax/src/typescript_lib_code_generator.rs

@@ -80,11 +80,12 @@ impl CodeGenerator {
  }}
  }}
 
+ {versions_array}
+
  #[napi]
  impl Language {{
  #[napi(constructor)]
  pub fn new(version: String) -> Result<Self, napi::Error> {{
- {versions_array}
  let version = Version::parse(&version).map_err(|_| Error::InvalidSemanticVersion(version))?;
  if VERSIONS.contains(&version.to_string().as_str()) {{
  Ok(Self {{
@@ -101,6 +102,11 @@ impl CodeGenerator {
  self.version.to_string()
  }}
 
+ #[napi]
+ pub fn supported_versions() -> Vec<String> {{
+ return VERSIONS.iter().map(|v| v.to_string()).collect();
+ }}
+
  #[napi]
  pub fn parse(&self, production_kind: ProductionKind, input: String) -> Result<ParseOutput, napi::Error> {{
  let input = input.as_str();
@@ -121,7 +127,7 @@ impl CodeGenerator {
  version_flag_declarations = self.version_flag_declarations(),
  versions_array = {
  let versions = language.versions.iter().map(|v| v.to_string());
- quote! { static VERSIONS: &'static [&'static str] = &[ #(#versions),* ]; }
+ quote! { const VERSIONS: &'static [&'static str] = &[ #(#versions),* ]; }
  },
  version_flag_initializers = self.version_flag_initializers(),
  language_title = &language.title,

crates/solidity/outputs/cargo/tests/src/lib.rs

@@ -2,3 +2,5 @@
 mod cst_output;
 #[cfg(test)]
 mod errors;
+#[cfg(test)]
+mod versions;

crates/solidity/outputs/cargo/tests/src/versions/mod.rs

@@ -0,0 +1,11 @@
+use semver::Version;
+use slang_solidity::language::Language;
+
+#[test]
+fn list_supported_versions() {
+ let versions = Language::supported_versions();
+
+ assert_eq!(false, versions.is_empty());
+ assert_eq!(false, versions.contains(&Version::parse("0.0.0").unwrap()));
+ assert_eq!(true, versions.contains(&Version::parse("0.4.11").unwrap()));
+}

crates/solidity/outputs/npm/tests/src/versions.ts

@@ -0,0 +1,10 @@
+import test from "ava";
+import { Language } from "@nomicfoundation/slang/language";
+
+test("list supported versions", (t) => {
+ const versions = Language.supportedVersions();
+
+ t.true(versions.length > 0);
+ t.true(versions.includes("0.4.11"));
+ t.false(versions.includes("0.0.0"));
+});