Add Typeshare support for Python

README.md

@@ -18,7 +18,7 @@ _And in the darkness, compile them_ 💍
 
 
 Do you like manually managing types that need to be passed through an FFI layer, so that your code doesn't archaically break at runtime? Be honest, nobody does. Typeshare is here to take that burden away from you! Leveraging the power of the `serde` library, Typeshare is a tool that converts your
-Rust types into their equivalent forms in Swift, Go**, Kotlin, Scala and Typescript, keeping
+Rust types into their equivalent forms in Swift, Go**, Python**, Kotlin, Scala and Typescript, keeping
 your cross-language codebase in sync. With automatic implementation for serialization and deserialization on both sides of the FFI, Typeshare does all the heavy lifting for you. It can even handle generics and convert effortlessly between standard libraries in different languages!
 
 **A few caveats. See [here](#a-quick-refresher-on-supported-languages) for more details.
@@ -98,12 +98,13 @@ Are you getting weird deserialization issues? Did our procedural macro throw a c
 - Swift
 - Typescript
 - Go**
+- Python**
 
 If there is a language that you want Typeshare to generate definitions for, you can either:
 1. Open an issue in this repository requesting your language of choice.
 2. Implement support for that language and open a PR with your implementation. We would be eternally grateful! 🙏
 
-** Right now, Go support is experimental. Enable the `go` feature when installing typeshare-cli if you want to use it.
+** Right now, Go and Python support is experimental. Enable the `go` or `python` features, respectively, when installing typeshare-cli if you want to use these.
 
 ## Credits
 

cli/Cargo.toml

@@ -13,6 +13,7 @@ path = "src/main.rs"
 
 [features]
 go = []
+python = []
 
 [dependencies]
 clap = { version = "4.5", features = [

cli/data/tests/mappings_config.toml

@@ -11,4 +11,8 @@
 "DateTime" = "String"
 
 [go.type_mappings]
-"DateTime" = "string"
+"DateTime" = "string"
+
+[python.type_mappings]
+"DateTime" = "datetime"
+"Url" = "AnyUrl"

cli/src/args.rs

@@ -10,6 +10,8 @@ pub enum AvailableLanguage {
     Typescript,
     #[cfg(feature = "go")]
     Go,
+    #[cfg(feature = "python")]
+    Python,
 }
 
 #[derive(clap::Parser)]

cli/src/config.rs

@@ -11,6 +11,13 @@ use std::{
 
 const DEFAULT_CONFIG_FILE_NAME: &str = "typeshare.toml";
 
+#[derive(Default, Serialize, Deserialize, PartialEq, Eq, Debug)]
+#[serde(default)]
+#[cfg(feature = "python")]
+pub struct PythonParams {
+    pub type_mappings: HashMap<String, String>,
+}
+
 #[derive(Default, Serialize, Deserialize, Debug, PartialEq, Eq)]
 #[serde(default)]
 pub struct KotlinParams {
@@ -64,6 +71,8 @@ pub(crate) struct Config {
     pub typescript: TypeScriptParams,
     pub kotlin: KotlinParams,
     pub scala: ScalaParams,
+    #[cfg(feature = "python")]
+    pub python: PythonParams,
     #[cfg(feature = "go")]
     pub go: GoParams,
     #[serde(skip)]
@@ -160,6 +169,11 @@ mod test {
         assert_eq!(config.kotlin.type_mappings["DateTime"], "String");
         assert_eq!(config.scala.type_mappings["DateTime"], "String");
         assert_eq!(config.typescript.type_mappings["DateTime"], "string");
+        #[cfg(feature = "python")]
+        {
+            assert_eq!(config.python.type_mappings["Url"], "AnyUrl");
+            assert_eq!(config.python.type_mappings["DateTime"], "datetime");
+        }
         #[cfg(feature = "go")]
         assert_eq!(config.go.type_mappings["DateTime"], "string");
     }

cli/src/main.rs

@@ -19,13 +19,13 @@ use clap_complete::Generator;
 use ignore::{overrides::OverrideBuilder, types::TypesBuilder, WalkBuilder};
 use log::error;
 use rayon::iter::ParallelBridge;
+use typeshare_core::language::GenericConstraints;
 #[cfg(feature = "go")]
 use typeshare_core::language::Go;
+#[cfg(feature = "python")]
+use typeshare_core::language::Python;
 use typeshare_core::{
-    language::{
-        CrateName, GenericConstraints, Kotlin, Language, Scala, SupportedLanguage, Swift,
-        TypeScript,
-    },
+    language::{CrateName, Kotlin, Language, Scala, SupportedLanguage, Swift, TypeScript},
     parser::ParsedData,
 };
 
@@ -78,6 +78,8 @@ fn main() -> anyhow::Result<()> {
             args::AvailableLanguage::Typescript => SupportedLanguage::TypeScript,
             #[cfg(feature = "go")]
             args::AvailableLanguage::Go => SupportedLanguage::Go,
+            #[cfg(feature = "python")]
+            args::AvailableLanguage::Python => SupportedLanguage::Python,
         },
     };
 
@@ -210,6 +212,15 @@ fn language(
         SupportedLanguage::Go => {
             panic!("go support is currently experimental and must be enabled as a feature flag for typeshare-cli")
         }
+        #[cfg(feature = "python")]
+        SupportedLanguage::Python => Box::new(Python {
+            type_mappings: config.python.type_mappings,
+            ..Default::default()
+        }),
+        #[cfg(not(feature = "python"))]
+        SupportedLanguage::Python => {
+            panic!("python support is currently experimental and must be enabled as a feature flag for typeshare-cli")
+        }
     }
 }
 

cli/src/parse.rs

@@ -61,6 +61,7 @@ fn output_file_name(language_type: SupportedLanguage, crate_name: &CrateName) ->
         SupportedLanguage::Scala => snake_case(),
         SupportedLanguage::Swift => pascal_case(),
         SupportedLanguage::TypeScript => snake_case(),
+        SupportedLanguage::Python => snake_case(),
     }
 }
 

core/Cargo.toml

@@ -14,6 +14,9 @@ thiserror = "1"
 itertools = "0.12"
 lazy_format = "2"
 joinery = "2"
+topological-sort = { version = "0.2.2"}
+once_cell = { version = "1"}
+convert_case = { version = "0.6.0"}
 log.workspace = true
 flexi_logger.workspace = true
 

core/data/tests/anonymous_struct_with_rename/output.py

@@ -0,0 +1,72 @@
+"""
+ Generated by typeshare 1.12.0
+"""
+from __future__ import annotations
+
+from enum import Enum
+from pydantic import BaseModel, ConfigDict, Field
+from typing import List, Union
+
+
+class AnonymousStructWithRenameList(BaseModel):
+    """
+    Generated type representing the anonymous struct variant `List` of the `AnonymousStructWithRename` Rust enum
+    """
+    list: List[str]
+
+
+class AnonymousStructWithRenameLongFieldNames(BaseModel):
+    """
+    Generated type representing the anonymous struct variant `LongFieldNames` of the `AnonymousStructWithRename` Rust enum
+    """
+    model_config = ConfigDict(populate_by_name=True)
+
+    some_long_field_name: str
+    and_: bool
+    but_one_more: List[str]
+
+
+class AnonymousStructWithRenameKebabCase(BaseModel):
+    """
+    Generated type representing the anonymous struct variant `KebabCase` of the `AnonymousStructWithRename` Rust enum
+    """
+    model_config = ConfigDict(populate_by_name=True)
+
+    another_list: List[str] = Field(alias="another-list")
+    camel_case_string_field: str
+    something_else: bool = Field(alias="something-else")
+
+
+class AnonymousStructWithRenameTypes(str, Enum):
+    LIST = "list"
+    LONG_FIELD_NAMES = "longFieldNames"
+    KEBAB_CASE = "kebabCase"
+
+class AnonymousStructWithRename(BaseModel):
+    model_config = ConfigDict(use_enum_values=True)
+    type: AnonymousStructWithRenameTypes
+    content: Union[AnonymousStructWithRenameKebabCase, AnonymousStructWithRenameList, AnonymousStructWithRenameLongFieldNames]
+
+
+    @classmethod
+    def new_anonymous_struct_with_rename_list(cls, list: List[str]):
+        return cls(
+            type=AnonymousStructWithRenameTypes.LIST,
+            content=AnonymousStructWithRenameList(list = list)
+	    )
+
+
+    @classmethod
+    def new_anonymous_struct_with_rename_long_field_names(cls, some_long_field_name: str, and_: bool, but_one_more: List[str]):
+        return cls(
+            type=AnonymousStructWithRenameTypes.LONG_FIELD_NAMES,
+            content=AnonymousStructWithRenameLongFieldNames(some_long_field_name = some_long_field_name, and_ = and_, but_one_more = but_one_more)
+	    )
+
+
+    @classmethod
+    def new_anonymous_struct_with_rename_kebab_case(cls, another_list: List[str], camel_case_string_field: str, something_else: bool):
+        return cls(
+            type=AnonymousStructWithRenameTypes.KEBAB_CASE,
+            content=AnonymousStructWithRenameKebabCase(another_list = another_list, camel_case_string_field = camel_case_string_field, something_else = something_else)
+	    )

core/data/tests/can_apply_prefix_correctly/output.py

@@ -0,0 +1,74 @@
+"""
+ Generated by typeshare 1.12.0
+"""
+from __future__ import annotations
+
+from enum import Enum
+from pydantic import BaseModel, ConfigDict
+from typing import Dict, List, Union
+
+
+class ItemDetailsFieldValue(BaseModel):
+    hello: str
+
+
+class AdvancedColorsTypes(str, Enum):
+    STRING = "String"
+    NUMBER = "Number"
+    NUMBER_ARRAY = "NumberArray"
+    REALLY_COOL_TYPE = "ReallyCoolType"
+    ARRAY_REALLY_COOL_TYPE = "ArrayReallyCoolType"
+    DICTIONARY_REALLY_COOL_TYPE = "DictionaryReallyCoolType"
+
+class AdvancedColors(BaseModel):
+    model_config = ConfigDict(use_enum_values=True)
+    t: AdvancedColorsTypes
+    c: Union[Dict[str, ItemDetailsFieldValue], ItemDetailsFieldValue, List[ItemDetailsFieldValue], List[int], int, str]
+
+
+    @classmethod
+    def new_advanced_colors_string(cls, c : str):
+        return cls(
+            t=AdvancedColorsTypes.STRING,
+            c=c
+        )
+
+
+    @classmethod
+    def new_advanced_colors_number(cls, c : int):
+        return cls(
+            t=AdvancedColorsTypes.NUMBER,
+            c=c
+        )
+
+
+    @classmethod
+    def new_advanced_colors_number_array(cls, c : List[int]):
+        return cls(
+            t=AdvancedColorsTypes.NUMBER_ARRAY,
+            c=c
+        )
+
+
+    @classmethod
+    def new_advanced_colors_really_cool_type(cls, c : ItemDetailsFieldValue):
+        return cls(
+            t=AdvancedColorsTypes.REALLY_COOL_TYPE,
+            c=c
+        )
+
+
+    @classmethod
+    def new_advanced_colors_array_really_cool_type(cls, c : List[ItemDetailsFieldValue]):
+        return cls(
+            t=AdvancedColorsTypes.ARRAY_REALLY_COOL_TYPE,
+            c=c
+        )
+
+
+    @classmethod
+    def new_advanced_colors_dictionary_really_cool_type(cls, c : Dict[str, ItemDetailsFieldValue]):
+        return cls(
+            t=AdvancedColorsTypes.DICTIONARY_REALLY_COOL_TYPE,
+            c=c
+        )