about summary refs log tree commit diff
path: root/third_party/nix/src/nix/command.hh
blob: f7eaeb721620c0655b0dc0873a1b99af31405578 (plain) (blame)
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
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
#pragma once

#include <memory>
#include "libexpr/common-eval-args.hh"
#include "libutil/args.hh"

namespace nix {

extern std::string programPath;

struct Value;
class Bindings;
class EvalState;

/* A command is an argument parser that can be executed by calling its
   run() method. */
struct Command : virtual Args {
  virtual std::string name() = 0;
  virtual void prepare(){};
  virtual void run() = 0;

  struct Example {
    std::string description;
    std::string command;
  };

  typedef std::list<Example> Examples;

  virtual Examples examples() { return Examples(); }

  void printHelp(const std::string& programName, std::ostream& out) override;
};

class Store;

/* A command that require a Nix store. */
struct StoreCommand : virtual Command {
  StoreCommand();
  void run() override;
  ref<Store> getStore();
  virtual ref<Store> createStore();
  virtual void run(ref<Store>) = 0;

 private:
  std::shared_ptr<Store> _store;
};

struct Buildable {
  Path drvPath;  // may be empty
  std::map<std::string, Path> outputs;
};

typedef std::vector<Buildable> Buildables;

struct Installable {
  virtual std::string what() = 0;

  virtual Buildables toBuildables() {
    throw Error("argument '%s' cannot be built", what());
  }

  Buildable toBuildable();

  virtual Value* toValue(EvalState& state) {
    throw Error("argument '%s' cannot be evaluated", what());
  }
};

struct SourceExprCommand : virtual Args, StoreCommand, MixEvalArgs {
  Path file;

  SourceExprCommand();

  /* Return a value representing the Nix expression from which we
     are installing. This is either the file specified by ‘--file’,
     or an attribute set constructed from $NIX_PATH, e.g. ‘{ nixpkgs
     = import ...; bla = import ...; }’. */
  Value* getSourceExpr(EvalState& state);

  ref<EvalState> getEvalState();

 private:
  std::shared_ptr<EvalState> evalState;
  std::shared_ptr<Value> vSourceExpr;
};

enum RealiseMode { Build, NoBuild, DryRun };

/* A command that operates on a list of "installables", which can be
   store paths, attribute paths, Nix expressions, etc. */
struct InstallablesCommand : virtual Args, SourceExprCommand {
  std::vector<std::shared_ptr<Installable>> installables;

  InstallablesCommand() { expectArgs("installables", &_installables); }

  void prepare() override;

  virtual bool useDefaultInstallables() { return true; }

 private:
  std::vector<std::string> _installables;
};

struct InstallableCommand : virtual Args, SourceExprCommand {
  std::shared_ptr<Installable> installable;

  InstallableCommand() { expectArg("installable", &_installable); }

  void prepare() override;

 private:
  std::string _installable;
};

/* A command that operates on zero or more store paths. */
struct StorePathsCommand : public InstallablesCommand {
 private:
  bool recursive = false;
  bool all = false;

 public:
  StorePathsCommand(bool recursive = false);

  using StoreCommand::run;

  virtual void run(ref<Store> store, Paths storePaths) = 0;

  void run(ref<Store> store) override;

  bool useDefaultInstallables() override { return !all; }
};

/* A command that operates on exactly one store path. */
struct StorePathCommand : public InstallablesCommand {
  using StoreCommand::run;

  virtual void run(ref<Store> store, const Path& storePath) = 0;

  void run(ref<Store> store) override;
};

typedef std::map<std::string, ref<Command>> Commands;

/* An argument parser that supports multiple subcommands,
   i.e. ‘<command> <subcommand>’. */
class MultiCommand : virtual Args {
 public:
  Commands commands;

  std::shared_ptr<Command> command;

  MultiCommand(Commands commands);

  void printHelp(const std::string& programName, std::ostream& out) override;

  bool processFlag(Strings::iterator& pos, Strings::iterator end) override;

  bool processArgs(const Strings& args, bool finish) override;
};

/* A helper class for registering commands globally. */
struct RegisterCommand {
  static Commands* commands;

  RegisterCommand(ref<Command> command) {
    if (!commands) {
      commands = new Commands;
    }
    commands->emplace(command->name(), command);
  }
};

std::shared_ptr<Installable> parseInstallable(SourceExprCommand& cmd,
                                              const ref<Store>& store,
                                              const std::string& installable,
                                              bool useDefaultInstallables);

Buildables build(const ref<Store>& store, RealiseMode mode,
                 const std::vector<std::shared_ptr<Installable>>& installables);

PathSet toStorePaths(
    const ref<Store>& store, RealiseMode mode,
    const std::vector<std::shared_ptr<Installable>>& installables);

Path toStorePath(const ref<Store>& store, RealiseMode mode,
                 const std::shared_ptr<Installable>& installable);

PathSet toDerivations(
    const ref<Store>& store,
    const std::vector<std::shared_ptr<Installable>>& installables,
    bool useDeriver = false);

}  // namespace nix