mirror of
https://github.com/NixOS/nix
synced 2025-06-30 11:43:15 +02:00
dab0ff4f9e
-----BEGIN PGP SIGNATURE----- iQFHBAABCAAxFiEEtUHVUwEnDgvPFcpdgXC0cm1xmN4FAmfheacTHGVkb2xzdHJh QGdtYWlsLmNvbQAKCRCBcLRybXGY3kt2B/4tQvs6iDXA12d409ClHbVQjr1d0FLP rv8RxZ7Z4+Jaw8r2ra/I+gpr9juI5ULyEJWqfES72hTvbYPjH1Grsrrjak1tx57E +STs21oEPojE8LXsFH1oZamGPPIIpyQdxCvTgZs1N6cqUfCRQ3Jx97X6E6SIGJDR VqBM4ruSXCY57yT36HqwYydTkxzZHiNP5wwABGfSb7u9pYW5x3r8W7+fQ3udTnCw kCRhA5vnfxIQSlxu4j7dJqSCGzOIPnhYB19bXDV4aPhl4sn3pkBCdMZxPBlCWSwx it0ngMITf+TeiMpVl2TtvMBOHtlGrbhusbyKcsqzFYULGyGOC9ngTAY3 =/JzB -----END PGP SIGNATURE----- Merge tag '2.27.1' into detsys-main Tagging release 2.27.1
103 lines
2.5 KiB
C++
103 lines
2.5 KiB
C++
#pragma once
|
||
///@file
|
||
|
||
#include "error.hh"
|
||
#include "types.hh"
|
||
|
||
#include <nlohmann/json_fwd.hpp>
|
||
|
||
namespace nix {
|
||
|
||
/**
|
||
* The list of available experimental features.
|
||
*
|
||
* If you update this, don’t forget to also change the map defining
|
||
* their string representation and documentation in the corresponding
|
||
* `.cc` file as well.
|
||
*/
|
||
enum struct ExperimentalFeature
|
||
{
|
||
CaDerivations,
|
||
ImpureDerivations,
|
||
FetchTree,
|
||
GitHashing,
|
||
RecursiveNix,
|
||
NoUrlLiterals,
|
||
FetchClosure,
|
||
AutoAllocateUids,
|
||
Cgroups,
|
||
DaemonTrustOverride,
|
||
DynamicDerivations,
|
||
ParseTomlTimestamps,
|
||
ReadOnlyLocalStore,
|
||
LocalOverlayStore,
|
||
ConfigurableImpureEnv,
|
||
MountedSSHStore,
|
||
VerifiedFetches,
|
||
PipeOperators,
|
||
BLAKE3Hashes,
|
||
};
|
||
|
||
extern std::set<std::string> stabilizedFeatures;
|
||
|
||
/**
|
||
* Just because writing `ExperimentalFeature::CaDerivations` is way too long
|
||
*/
|
||
using Xp = ExperimentalFeature;
|
||
|
||
/**
|
||
* Parse an experimental feature (enum value) from its name. Experimental
|
||
* feature flag names are hyphenated and do not contain spaces.
|
||
*/
|
||
const std::optional<ExperimentalFeature> parseExperimentalFeature(
|
||
const std::string_view & name);
|
||
|
||
/**
|
||
* Show the name of an experimental feature. This is the opposite of
|
||
* parseExperimentalFeature().
|
||
*/
|
||
std::string_view showExperimentalFeature(const ExperimentalFeature);
|
||
|
||
/**
|
||
* Compute the documentation of all experimental features.
|
||
*
|
||
* See `doc/manual` for how this information is used.
|
||
*/
|
||
nlohmann::json documentExperimentalFeatures();
|
||
|
||
/**
|
||
* Shorthand for `str << showExperimentalFeature(feature)`.
|
||
*/
|
||
std::ostream & operator<<(
|
||
std::ostream & str,
|
||
const ExperimentalFeature & feature);
|
||
|
||
/**
|
||
* Parse a set of strings to the corresponding set of experimental
|
||
* features, ignoring (but warning for) any unknown feature.
|
||
*/
|
||
std::set<ExperimentalFeature> parseFeatures(const std::set<std::string> &);
|
||
|
||
/**
|
||
* An experimental feature was required for some (experimental)
|
||
* operation, but was not enabled.
|
||
*/
|
||
class MissingExperimentalFeature : public Error
|
||
{
|
||
public:
|
||
/**
|
||
* The experimental feature that was required but not enabled.
|
||
*/
|
||
ExperimentalFeature missingFeature;
|
||
|
||
MissingExperimentalFeature(ExperimentalFeature missingFeature);
|
||
};
|
||
|
||
/**
|
||
* Semi-magic conversion to and from json.
|
||
* See the nlohmann/json readme for more details.
|
||
*/
|
||
void to_json(nlohmann::json &, const ExperimentalFeature &);
|
||
void from_json(const nlohmann::json &, ExperimentalFeature &);
|
||
|
||
}
|