#pragma once #include #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 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 getStore(); virtual ref createStore(); virtual void run(ref) = 0; private: std::shared_ptr _store; }; struct Buildable { Path drvPath; // may be empty std::map outputs; }; using Buildables = std::vector; 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 getEvalState(); private: std::shared_ptr evalState; std::shared_ptr 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> installables; InstallablesCommand() { expectArgs("installables", &_installables); } void prepare() override; virtual bool useDefaultInstallables() { return true; } private: std::vector _installables; }; struct InstallableCommand : virtual Args, SourceExprCommand { std::shared_ptr 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, Paths storePaths) = 0; void run(ref 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, const Path& storePath) = 0; void run(ref store) override; }; using Commands = std::map>; /* An argument parser that supports multiple subcommands, i.e. ‘ ’. */ class MultiCommand : virtual Args { public: Commands commands; std::shared_ptr 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) { if (!commands) { commands = new Commands; } commands->emplace(command->name(), command); } }; std::shared_ptr parseInstallable(SourceExprCommand& cmd, const ref& store, const std::string& installable, bool useDefaultInstallables); Buildables build(const ref& store, RealiseMode mode, const std::vector>& installables); PathSet toStorePaths( const ref& store, RealiseMode mode, const std::vector>& installables); Path toStorePath(const ref& store, RealiseMode mode, const std::shared_ptr& installable); PathSet toDerivations( const ref& store, const std::vector>& installables, bool useDeriver = false); } // namespace nix