/* This Source Code Form is subject to the terms of the Mozilla Public * License, v. 2.0. If a copy of the MPL was not distributed with this * file, You can obtain one at http://mozilla.org/MPL/2.0/. */ //! Generate foreign language bindings for a uniffi component. //! //! This module contains all the code for generating foreign language bindings, //! along with some helpers for executing foreign language scripts or tests. use anyhow::{bail, Result}; use camino::Utf8Path; use serde::{Deserialize, Serialize}; use crate::interface::ComponentInterface; use crate::MergeWith; pub mod kotlin; pub mod python; pub mod ruby; pub mod swift; /// Enumeration of all foreign language targets currently supported by this crate. /// /// The functions in this module will delegate to a language-specific backend based /// on the provided `TargetLanguage`. For convenience of calling code we also provide /// a few `TryFrom` implementations to help guess the correct target language from /// e.g. a file extension of command-line argument. #[derive(Copy, Clone, Eq, PartialEq, Hash)] pub enum TargetLanguage { Kotlin, Swift, Python, Ruby, } impl TryFrom<&str> for TargetLanguage { type Error = anyhow::Error; fn try_from(value: &str) -> Result { Ok(match value.to_ascii_lowercase().as_str() { "kotlin" | "kt" | "kts" => TargetLanguage::Kotlin, "swift" => TargetLanguage::Swift, "python" | "py" => TargetLanguage::Python, "ruby" | "rb" => TargetLanguage::Ruby, _ => bail!("Unknown or unsupported target language: \"{}\"", value), }) } } impl TryFrom<&std::ffi::OsStr> for TargetLanguage { type Error = anyhow::Error; fn try_from(value: &std::ffi::OsStr) -> Result { match value.to_str() { None => bail!("Unreadable target language"), Some(s) => s.try_into(), } } } impl TryFrom for TargetLanguage { type Error = anyhow::Error; fn try_from(value: String) -> Result { TryFrom::try_from(value.as_str()) } } #[derive(Debug, Clone, Default, Serialize, Deserialize)] pub struct Config { #[serde(default)] kotlin: kotlin::Config, #[serde(default)] swift: swift::Config, #[serde(default)] python: python::Config, #[serde(default)] ruby: ruby::Config, } impl From<&ComponentInterface> for Config { fn from(ci: &ComponentInterface) -> Self { Config { kotlin: ci.into(), swift: ci.into(), python: ci.into(), ruby: ci.into(), } } } impl MergeWith for Config { fn merge_with(&self, other: &Self) -> Self { Config { kotlin: self.kotlin.merge_with(&other.kotlin), swift: self.swift.merge_with(&other.swift), python: self.python.merge_with(&other.python), ruby: self.ruby.merge_with(&other.ruby), } } } /// Generate foreign language bindings from a compiled `uniffi` library. pub fn write_bindings( config: &Config, ci: &ComponentInterface, out_dir: &Utf8Path, language: TargetLanguage, try_format_code: bool, ) -> Result<()> { match language { TargetLanguage::Kotlin => { kotlin::write_bindings(&config.kotlin, ci, out_dir, try_format_code)? } TargetLanguage::Swift => { swift::write_bindings(&config.swift, ci, out_dir, try_format_code)? } TargetLanguage::Python => { python::write_bindings(&config.python, ci, out_dir, try_format_code)? } TargetLanguage::Ruby => ruby::write_bindings(&config.ruby, ci, out_dir, try_format_code)?, } Ok(()) }