[go: up one dir, main page]

pyo3cls 0.3.0

Proc macros for PyO3 package
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
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153

// Copyright (c) 2017-present PyO3 Project and Contributors
//! This crate declares only the proc macro attributes, as a crate defining proc macro attributes
//! must not contain any other public items.

#![recursion_limit = "1024"]

extern crate proc_macro;
extern crate proc_macro2;
extern crate pyo3_derive_backend;
#[macro_use]
extern crate quote;
extern crate syn;

use syn::buffer::TokenBuffer;
use syn::punctuated::Punctuated;
use syn::token::Comma;

use pyo3_derive_backend::*;

#[proc_macro_attribute]
pub fn mod2init(
    attr: proc_macro::TokenStream,
    input: proc_macro::TokenStream,
) -> proc_macro::TokenStream {
    // Parse the token stream into a syntax tree
    let mut ast: syn::ItemFn = syn::parse(input).expect("#[pymodinit] must be used on a function");

    let modname: syn::Ident;
    if attr.is_empty() {
        modname = ast.ident.clone();
    } else {
        modname = syn::parse(attr).expect("could not parse module name");
    }

    // Process the functions within the module
    module::process_functions_in_module(&mut ast);

    // Create the module initialisation function
    let expanded = module::py2_init(&ast.ident, &modname, utils::get_doc(&ast.attrs, false));

    quote! (
        #ast
        #expanded
    ).into()
}

#[proc_macro_attribute]
pub fn mod3init(
    attr: proc_macro::TokenStream,
    input: proc_macro::TokenStream,
) -> proc_macro::TokenStream {
    // Parse the token stream into a syntax tree
    let mut ast: syn::ItemFn = syn::parse(input).expect("#[pymodinit] must be used on a `fn` block");

    let modname: syn::Ident;
    if attr.is_empty() {
        modname = ast.ident.clone();
    } else {
        modname = syn::parse(attr).expect("could not parse module name");
    }

    // Process the functions within the module
    module::process_functions_in_module(&mut ast);

    // Create the module initialisation function
    let expanded = module::py3_init(&ast.ident, &modname, utils::get_doc(&ast.attrs, false));

    quote! (
        #ast
        #expanded
    ).into()
}

#[proc_macro_attribute]
pub fn pyproto(
    _: proc_macro::TokenStream,
    input: proc_macro::TokenStream,
) -> proc_macro::TokenStream {
    // Parse the token stream into a syntax tree
    let mut ast: syn::ItemImpl =
        syn::parse(input).expect("#[pyproto] must be used on an `impl` block");

    // Build the output
    let expanded = py_proto::build_py_proto(&mut ast);

    quote! (
        #ast
        #expanded
    ).into()
}

#[proc_macro_attribute]
pub fn pyclass(
    attr: proc_macro::TokenStream,
    input: proc_macro::TokenStream,
) -> proc_macro::TokenStream {
    // Parse the token stream into a syntax tree
    let mut ast: syn::ItemStruct = syn::parse(input).expect("#[pyclass] must be used on a `struct`");

    // Parse the macro arguments into a list of expressions
    let args: Vec<syn::Expr> = {
        let buffer = TokenBuffer::new(attr);
        let punc = Punctuated::<syn::Expr, Comma>::parse_terminated(buffer.begin());
        punc.expect("could not parse macro arguments")
            .0
            .into_iter()
            .collect()
    };

    // Build the output
    let expanded = py_class::build_py_class(&mut ast, &args);

    quote! (
        #ast
        #expanded
    ).into()
}

#[proc_macro_attribute]
pub fn pymethods(
    _: proc_macro::TokenStream,
    input: proc_macro::TokenStream,
) -> proc_macro::TokenStream {
    // Parse the token stream into a syntax tree
    let mut ast: syn::ItemImpl =
        syn::parse(input.clone()).expect("#[pymethods] must be used on an `impl` block");

    // Build the output
    let expanded = py_impl::build_py_methods(&mut ast);

    quote! (
        #ast
        #expanded
    ).into()
}

#[proc_macro_attribute]
pub fn pyfunction(
    _: proc_macro::TokenStream,
    input: proc_macro::TokenStream,
) -> proc_macro::TokenStream {
    // Parse the token stream into a syntax tree
    let mut ast: syn::ItemFn = syn::parse(input).expect("#[function] must be used on a `fn` block");

    // Build the output
    let python_name = ast.ident.clone();
    let expanded = module::add_fn_to_module(&mut ast, &python_name, Vec::new());

    quote! (
        #ast
        #expanded
    ).into()
}