apple-bindgen 0.3.0

bindgen helper for Apple frameworks
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126

use apple_bindgen::{Builder, DependencyAnalyzer, SdkPath, SdkPathError};
use apple_sdk::Platform;
use clap::{Args, Parser, Subcommand};
use std::str::FromStr;

#[derive(Debug, Clone)]
enum Sdk {
    Name(Platform),
    Path(SdkPath),
}

impl TryFrom<Sdk> for SdkPath {
    type Error = SdkPathError;

    fn try_from(sdk: Sdk) -> Result<Self, Self::Error> {
        Ok(match sdk {
            Sdk::Name(ref platform) => platform.try_into()?,
            Sdk::Path(path) => path,
        })
    }
}

impl FromStr for Sdk {
    type Err = SdkPathError;
    fn from_str(s: &str) -> Result<Self, Self::Err> {
        Ok(match Platform::from_str(s) {
            Ok(name) if !matches!(name, Platform::Unknown(_)) => Sdk::Name(name),
            _ => Sdk::Path(std::path::PathBuf::from(s).try_into()?),
        })
    }
}

/// Generate Rust bindings for Apple frameworks
#[derive(Parser, Debug)]
#[clap(author, version, about, long_about = None)]
struct Cli {
    #[clap(subcommand)]
    command: Command,
}

#[derive(Subcommand, Debug)]
enum Command {
    /// Generate bindings for a framework (default command)
    #[clap(alias = "gen")]
    Generate(GenerateArgs),

    /// Analyze framework dependencies from umbrella header
    AnalyzeDeps(AnalyzeDepsArgs),
}

#[derive(Args, Debug)]
struct GenerateArgs {
    /// e.g. CoreFoundation, UIKit, etc.
    framework: String,

    /// SDK name or path. One of: macosx, iphoneos, iphonesimulator, watchos, appletvos, driverkit
    #[clap(long)]
    sdk: Sdk,

    /// Specify target architecture
    #[clap(long)]
    target: Option<String>,

    /// Print build details
    #[clap(short, long, num_args = 0)]
    verbose: bool,
}

#[derive(Args, Debug)]
struct AnalyzeDepsArgs {
    /// Framework to analyze
    framework: String,

    /// SDK name or path
    #[clap(long)]
    sdk: Sdk,
}

fn main() {
    let cli = Cli::parse();

    match cli.command {
        Command::Generate(args) => cmd_generate(args),
        Command::AnalyzeDeps(args) => cmd_analyze_deps(args),
    }
}

fn cmd_generate(args: GenerateArgs) {
    let mut builder =
        Builder::with_builtin_config(&args.framework, args.sdk).expect("sdk lookup failed");

    if args.verbose {
        eprintln!("config: {:?}", builder);
        eprintln!(
            "bindgen {:?}",
            builder.bindgen_builder().command_line_flags().join(" ")
        );
    }
    if let Some(target) = args.target {
        builder = builder.target(target);
    }
    let out = builder.generate().expect("binding generation failed");
    println!("{}", out);
}

fn cmd_analyze_deps(args: AnalyzeDepsArgs) {
    let sdk_path: SdkPath = args.sdk.try_into().expect("Invalid SDK");
    let analyzer = DependencyAnalyzer::new(sdk_path.path());

    match analyzer.analyze(&args.framework) {
        Ok(deps) => {
            if deps.is_empty() {
                eprintln!("{} has no external dependencies", args.framework);
            } else {
                println!("{} depends on:", args.framework);
                for dep in deps {
                    println!("  - {}", dep);
                }
            }
        }
        Err(e) => {
            eprintln!("Failed to analyze {}: {}", args.framework, e);
            std::process::exit(1);
        }
    }
}