#pragma once #include #include "hash.hh" #include "path.hh" #include "comparator.hh" namespace nix { /* * Content addressing method */ /* We only have one way to hash text with references, so this is a single-value type, mainly useful with std::variant. */ struct TextHashMethod : std::monostate { }; enum struct FileIngestionMethod : uint8_t { Flat = false, Recursive = true }; /* Compute the prefix to the hash algorithm which indicates how the files were ingested. */ std::string makeFileIngestionPrefix(FileIngestionMethod m); /* Just the type of a content address. Combine with the hash itself, and we have a `ContentAddress` as defined below. Combine that, in turn, with info on references, and we have `ContentAddressWithReferences`, as defined further below. */ typedef std::variant< TextHashMethod, FileIngestionMethod > ContentAddressMethod; /* Parse and pretty print the algorithm which indicates how the files were ingested, with the the fixed output case not prefixed for back compat. */ std::string makeContentAddressingPrefix(ContentAddressMethod m); ContentAddressMethod parseContentAddressingPrefix(std::string_view & m); /* Parse and pretty print a content addressing method and hash in a nicer way, prefixing both cases. */ std::string renderContentAddressMethodAndHash(ContentAddressMethod cam, HashType ht); std::pair parseContentAddressMethod(std::string_view caMethod); /* * Mini content address */ struct TextHash { Hash hash; GENERATE_CMP(TextHash, me->hash); }; /// Pair of a hash, and how the file system was ingested struct FixedOutputHash { FileIngestionMethod method; Hash hash; std::string printMethodAlgo() const; GENERATE_CMP(FixedOutputHash, me->method, me->hash); }; /* We've accumulated several types of content-addressed paths over the years; fixed-output derivations support multiple hash algorithms and serialisation methods (flat file vs NAR). Thus, ‘ca’ has one of the following forms: * ‘text:sha256:’: For paths computed by makeTextPath() / addTextToStore(). * ‘fixed:::’: For paths computed by makeFixedOutputPath() / addToStore(). */ typedef std::variant< TextHash, // for paths computed by makeTextPath() / addTextToStore FixedOutputHash // for path computed by makeFixedOutputPath > ContentAddress; std::string renderContentAddress(ContentAddress ca); std::string renderContentAddress(std::optional ca); ContentAddress parseContentAddress(std::string_view rawCa); std::optional parseContentAddressOpt(std::string_view rawCaOpt); Hash getContentAddressHash(const ContentAddress & ca); /* * References set */ struct StoreReferences { StorePathSet others; bool self = false; bool empty() const; size_t size() const; GENERATE_CMP(StoreReferences, me->self, me->others); }; /* * Full content address * * See the schema for store paths in store-api.cc */ // This matches the additional info that we need for makeTextPath struct TextInfo { TextHash hash; // References for the paths, self references disallowed StorePathSet references; GENERATE_CMP(TextInfo, me->hash, me->references); }; struct FixedOutputInfo { FixedOutputHash hash; // References for the paths StoreReferences references; GENERATE_CMP(FixedOutputInfo, me->hash, me->references); }; typedef std::variant< TextInfo, FixedOutputInfo > ContentAddressWithReferences; ContentAddressWithReferences caWithoutRefs(const ContentAddress &); ContentAddressWithReferences contentAddressFromMethodHashAndRefs( ContentAddressMethod method, Hash && hash, StoreReferences && refs); ContentAddressMethod getContentAddressMethod(const ContentAddressWithReferences & ca); Hash getContentAddressHash(const ContentAddressWithReferences & ca); std::string printMethodAlgo(const ContentAddressWithReferences &); }