aboutsummaryrefslogtreecommitdiff
path: root/gcc/rust/metadata/rust-export-metadata.h
blob: d87f9bec13329201e4315c3f653bea49161a38d4 (plain)
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
// Copyright (C) 2020-2024 Free Software Foundation, Inc.

// This file is part of GCC.

// GCC is free software; you can redistribute it and/or modify it under
// the terms of the GNU General Public License as published by the Free
// Software Foundation; either version 3, or (at your option) any later
// version.

// GCC is distributed in the hope that it will be useful, but WITHOUT ANY
// WARRANTY; without even the implied warranty of MERCHANTABILITY or
// FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
// for more details.

// You should have received a copy of the GNU General Public License
// along with GCC; see the file COPYING3.  If not see
// <http://www.gnu.org/licenses/>.

#ifndef RUST_EXPORT_METADATA_H
#define RUST_EXPORT_METADATA_H

#include "rust-system.h"
#include "rust-hir-full-decls.h"
#include "rust-hir-map.h"

namespace Rust {
namespace Metadata {

static const char kMagicHeader[4] = {'G', 'R', 'S', 'T'};
static const char kSzDelim[1] = {'$'};

class ExportContext
{
public:
  ExportContext ();

  ~ExportContext ();

  void push_module_scope (const HIR::Module &module);

  const HIR::Module &pop_module_scope ();

  void emit_trait (const HIR::Trait &trait);
  void emit_function (const HIR::Function &fn);

  /**
   * Macros are a bit particular - they only live at the AST level, so we can
   * directly refer to them using their NodeId. There's no need to keep an HIR
   * node for them.
   */
  void emit_macro (NodeId macro);

  const std::string &get_interface_buffer () const;

private:
  Analysis::Mappings *mappings;

  std::vector<std::reference_wrapper<const HIR::Module>> module_stack;
  std::string public_interface_buffer;
};

class PublicInterface
{
public:
  static void Export (HIR::Crate &crate);

  static void ExportTo (HIR::Crate &crate, const std::string &output_path);

  static bool is_crate_public (const HIR::VisItem &item);

  static std::string expected_metadata_filename ();

protected:
  void gather_export_data ();

  void write_to_object_file () const;

  void write_to_path (const std::string &path) const;

private:
  PublicInterface (HIR::Crate &crate);

  HIR::Crate &crate;
  Analysis::Mappings &mappings;
  ExportContext context;
};

} // namespace Metadata
} // namespace Rust

#endif // RUST_EXPORT_METADATA_H