#pragma once #include "types.hh" #include "hash.hh" #include "path.hh" #include "attrs.hh" #include "url.hh" #include namespace nix { class Store; } namespace nix::fetchers { struct Tree { Path actualPath; StorePath storePath; }; struct InputScheme; /* The Input object is generated by a specific fetcher, based on the * user-supplied input attribute in the flake.nix file, and contains * the information that the specific fetcher needs to perform the * actual fetch. The Input object is most commonly created via the * "fromURL()" or "fromAttrs()" static functions which are provided * the url or attrset specified in the flake file. */ struct Input { friend struct InputScheme; std::shared_ptr scheme; // note: can be null Attrs attrs; bool locked = false; bool direct = true; /* path of the parent of this input, used for relative path resolution */ std::optional parent; public: static Input fromURL(const std::string & url); static Input fromURL(const ParsedURL & url); static Input fromAttrs(Attrs && attrs); ParsedURL toURL() const; std::string toURLString(const std::map & extraQuery = {}) const; std::string to_string() const; Attrs toAttrs() const; /* Check whether this is a "direct" input, that is, not one that goes through a registry. */ bool isDirect() const { return direct; } /* Check whether this is a "locked" input, that is, one that contains a commit hash or content hash. */ bool isLocked() const { return locked; } bool hasAllInfo() const; bool operator ==(const Input & other) const; bool contains(const Input & other) const; /* Fetch the input into the Nix store, returning the location in the Nix store and the locked input. */ std::pair fetch(ref store) const; Input applyOverrides( std::optional ref, std::optional rev) const; void clone(const Path & destDir) const; std::optional getSourcePath() const; void markChangedFile( std::string_view file, std::optional commitMsg) const; std::string getName() const; StorePath computeStorePath(Store & store) const; // Convenience functions for common attributes. std::string getType() const; std::optional getNarHash() const; std::optional getRef() const; std::optional getRev() const; std::optional getRevCount() const; std::optional getLastModified() const; }; /* The InputScheme represents a type of fetcher. Each fetcher * registers with nix at startup time. When processing an input for a * flake, each scheme is given an opportunity to "recognize" that * input from the url or attributes in the flake file's specification * and return an Input object to represent the input if it is * recognized. The Input object contains the information the fetcher * needs to actually perform the "fetch()" when called. */ struct InputScheme { virtual ~InputScheme() { } virtual std::optional inputFromURL(const ParsedURL & url) = 0; virtual std::optional inputFromAttrs(const Attrs & attrs) = 0; virtual ParsedURL toURL(const Input & input); virtual bool hasAllInfo(const Input & input) = 0; virtual Input applyOverrides( const Input & input, std::optional ref, std::optional rev); virtual void clone(const Input & input, const Path & destDir); virtual std::optional getSourcePath(const Input & input); virtual void markChangedFile(const Input & input, std::string_view file, std::optional commitMsg); virtual std::pair fetch(ref store, const Input & input) = 0; }; void registerInputScheme(std::shared_ptr && fetcher); struct DownloadFileResult { StorePath storePath; std::string etag; std::string effectiveUrl; }; DownloadFileResult downloadFile( ref store, const std::string & url, const std::string & name, bool locked, const Headers & headers = {}); std::pair downloadTarball( ref store, const std::string & url, const std::string & name, bool locked, const Headers & headers = {}); }