package clif.protos

Get desktop application:
View/edit binary Protocol Buffers messages

AST message - abstract API representation. Is sent in both directions to/from Clang C++ matcher.

• optional string source = 1

• repeated string usertype_includes = 2

• repeated Decl decls = 3

• repeated string extra_init = 4

  C++ code lines for Init() body.

• optional bool catch_exceptions = 5

  C++ code may throw.

• repeated Typemap typemaps = 6

  C++ types and processors for a lang type

• repeated Macro macros = 7

  Macro definitions to pass through.

• repeated Namemap namemaps = 8

  Imported names.

• map<string, string> options = 9

  OPTION statements.

• optional int64 clif_matcher_version_stamp = 10

  The next two are populated from the clif_matcher:

• optional string clif_matcher_argv0 = 11

Used in: Decl

• optional Name name = 1

• repeated Name bases = 2

• repeated Decl members = 3

• optional bool final = 4

  No derived classes allowed.

• optional bool enable_instance_dict = 16

  Add __dict__ to instance.

• optional bool suppress_upcasts = 17

  Set to true if CLIF does not generate upcast for the class.

• optional bool shared = 5

• optional string docstring = 15

• optional bool cpp_has_def_ctor = 6

  C++ class has a default constructor.

• optional bool cpp_has_trivial_defctor = 12

  Set to true if C++ class default ctor is trivial.

• optional bool cpp_has_trivial_dtor = 13

  Set to true if C++ class dtor is trivial.

• optional bool cpp_has_public_dtor = 9

  C++ class can be destroyed.

• optional bool async_dtor = 10

  Release Python GIL while deleting C++ instance.

• optional bool cpp_copyable = 7

  C++ class can be copied.

• optional bool cpp_movable = 14

  C++ class can be moved.

• optional bool cpp_abstract = 8

  C++ class is an abstract base class.

• repeated ClassDecl.Base cpp_bases = 11

  Additional info for C++ base classes.

• optional bool is_cpp_polymorphic = 18

  C++ class contains or inherits a virtual function.

• optional bool suppress_shared_ptr_const_conversion = 19

  Set to true to not generate Clif_PyObj functions for shared_ptr<const T>.

  Next available: 20

Used in: ClassDecl

• optional string name = 1

• optional string namespace = 2

• optional string filename = 3

Used in: Decl

• optional Name name = 1

• optional Type type = 2

• optional string value = 3

Used in: AST, ClassDecl

• optional Decl.Type decltype = 1

• oneof decl

  • ClassDecl class_ = 10

    Workaround for Python protobuf (should be just "class")

  • EnumDecl enum = 11

  • VarDecl var = 12

  • ConstDecl const = 13

  • FuncDecl func = 14

  • ForwardDecl fdecl = 15

• optional string cpp_file = 2

  C++ filename to look that API in.

• optional string not_found = 3

  Placeholder for match errors.

• optional int32 line_number = 4

  Line number of clif source file that produced this decl.

• optional string namespace_ = 5

Used in: Decl

• UNKNOWN = 0

• ENUM = 1

• VAR = 2

• CONST = 3

• FUNC = 4

• TYPE = 5

• CLASS = 6

Used in: Decl

• optional Name name = 1

• repeated Name members = 2

• optional bool enum_class = 3

• optional Type item = 4

  Enum size.

Used in: FuncDecl

• optional string name = 1

• optional bool checked = 2

ForwardDecl describe a C++ name declaration match (only make sense for classes).

Used in: Decl

• optional Name name = 1

Used in: Decl, Type, VarDecl

• optional Name name = 1

• repeated ParamDecl params = 2

• repeated ParamDecl returns = 3

• repeated Exception excepts = 4

• optional string postproc = 5

  Replace results with native postproc(results).

• optional string docstring = 6

• optional bool constructor = 18

  Set to true iff this function is a constructor

• optional bool classmethod = 11

  C++ class static function member.

• optional bool py_keep_gil = 12

  Do not release Python GIL while running C++.

• optional bool virtual = 15

  Set to true to allow override.

• optional bool ignore_return_value = 16

  Set to true if C++ function return will be ignored.

• optional bool cpp_void_return = 13

  Set to true iff C++ function returns void.

• optional bool cpp_noexcept = 14

  Set to true if C++ func is noexcept(true).

• optional bool cpp_opfunction = 17

  Invoke C++ operator function.

• optional bool cpp_const_method = 19

  Set to true if C++ func is const.

• optional bool is_extend_method = 20

  Set to true if ClassName__extend__method_name.

• optional bool is_pure_virtual = 21

  Set to true if C++ func is a pure virtual function.

• optional bool is_overloaded = 22

  Set to true if C++ func is overloaded.

• optional string mangled_name = 23

• optional int32 cpp_num_params = 24

  Number of parameters of C++ func.

• optional bool marked_non_raising = 25

  Set to true if @non_raising decorator is present.

• optional FuncDecl.ReturnValuePolicy return_value_policy = 26

  Next available: 27

Used in: FuncDecl

• AUTOMATIC = 0

  Please keep in sync with `enum class return_value_policy` in pybind11/detail/common.h

• AUTOMATIC_REFERENCE = 1

• TAKE_OWNERSHIP = 2

• COPY = 3

• MOVE = 4

• REFERENCE = 5

• REFERENCE_INTERNAL = 6

• RETURN_AS_BYTES = 7

Used in: AST

• optional string name = 1

• optional bytes definition = 2

Type describe a C++ name match.

Used in: ClassDecl, ConstDecl, EnumDecl, ForwardDecl, FuncDecl, ParamDecl, VarDecl

• optional string native = 1

  Target language name.

• optional string cpp_name = 2

• optional string cpp_canonical_type = 3

  An unique identifier used by pybind11 code generator to do topological sort.

Used in: AST

• optional string name = 1

  e.g. 'A' in `from full.module import A`.

• optional string fq_name = 2

  FQName. e.g. full.module.A.

Used in: FuncDecl

• optional Name name = 1

• optional Type type = 2

  Matcher set deduced mutable type here.

• optional string cpp_exact_type = 4

  Set to exact C++ type (good for override).

• optional string default_value = 3

  if has_default_value(), this parameter is optional.

  Next available: 5

Type describe a C++ type match. ... If cpp_raw_pointer==true, matcher match only raw pointer params (Foo* for input and Foo** for output), if false - matcher set it true if matched parameter is a raw pointer.

Used in: ConstDecl, EnumDecl, ParamDecl, VarDecl

• optional string lang_type = 1

  Target language-specific typename.

• optional string cpp_type = 2

  Placeholder to fill in found concrete C++ type.

• repeated Type params = 3

  For containers, a parsed tree

• optional FuncDecl callable = 4

  For lambda it has params and returns.

• optional bool cpp_has_def_ctor = 5

  true iff the type has a default constructor

• optional bool cpp_copyable = 6

  true if the type is copyable.

• optional bool cpp_movable = 12

  C++ class can be moved.

• optional bool cpp_raw_pointer = 7

  true iff is a C++ raw pointer type.

• optional bool cpp_toptr_conversion = 8

  true iff there is a Lang to T* conversion.

• optional bool cpp_touniqptr_conversion = 11

  true iff there is a Lang to unique_ptr<T> conversion.

• optional bool cpp_abstract = 9

  true iff the type is a C++ abstract class.

• optional bool cpp_has_public_dtor = 10

  C++ class can be destroyed.

• optional bool implicitly_converted = 13

  true if the parameter needs implicit conversion to match the cpp function definition.

Language-specific mapping from native type to C++ types.

• repeated Typemap typemaps = 1

Used in: AST, TypeTable

• optional string lang_type = 1

  Target language-specific typename.

• repeated string cpp_type = 2

  C++ types to try (the order is important).

• optional string postconversion = 3

  C++ func to apply on C++ -> lang path

Used in: Decl

• optional Name name = 1

• optional Type type = 2

• optional FuncDecl cpp_get = 3

  Property getter name.

• optional FuncDecl cpp_set = 4

  Property setter name.

• optional bool is_extend_variable = 5