Alois Wohlschlager
21fc0ddce5
Currently, a bunch of documentation is generated by embedding parts of it in the nix executable, getting it out again by running it, and then postprocessing the output. This is bad, since it creates a pointless dependency of the documentation on the executable, and also makes documentation generation impossible when cross-compiling. Instead, both the code and the documentation should be generated from data, see https://git.lix.systems/lix-project/lix/issues/292 . Here we start applying this approach to the experimental and deprecated features, which are done in one go since the technical implementation is very similar. Of course, the actual benefits are not realised yet, since the offending pattern is used in several more places. These will be fixed later. Change-Id: I4c802052cc7e865c61119a34b8f1063c4decc9cb
109 lines
3.2 KiB
C++
109 lines
3.2 KiB
C++
#include "deprecated-features.hh"
|
|
// Required for instances of to_json and from_json for DeprecatedFeature
|
|
#include "deprecated-features-json.hh"
|
|
#include "strings.hh"
|
|
|
|
#include "nlohmann/json.hpp"
|
|
|
|
namespace nix {
|
|
|
|
struct DeprecatedFeatureDetails
|
|
{
|
|
DeprecatedFeature tag;
|
|
std::string_view name;
|
|
std::string_view description;
|
|
};
|
|
|
|
/**
|
|
* If two different PRs both add a deprecated feature, and we just
|
|
* used a number for this, we *woudln't* get merge conflict and the
|
|
* counter will be incremented once instead of twice, causing a build
|
|
* failure.
|
|
*
|
|
* By instead defining this instead as a dummy bottom deprecated
|
|
* feature, we do not have this issue.
|
|
*/
|
|
constexpr size_t numDepFeatures = static_cast<size_t>(Dep::NumDepFeatures);
|
|
|
|
constexpr std::array<DeprecatedFeatureDetails, numDepFeatures> depFeatureDetails = {{
|
|
#include "deprecated-features-impl.gen.inc"
|
|
}};
|
|
|
|
static_assert(
|
|
[]() constexpr {
|
|
for (auto [index, feature] : enumerate(depFeatureDetails))
|
|
if (index != (size_t)feature.tag)
|
|
return false;
|
|
return true;
|
|
}(),
|
|
"array order does not match enum tag order");
|
|
|
|
const std::optional<DeprecatedFeature> parseDeprecatedFeature(const std::string_view & name)
|
|
{
|
|
using ReverseDepMap = std::map<std::string_view, DeprecatedFeature>;
|
|
|
|
static std::unique_ptr<ReverseDepMap> reverseDepMap = []() {
|
|
auto reverseDepMap = std::make_unique<ReverseDepMap>();
|
|
for (auto & depFeature : depFeatureDetails)
|
|
(*reverseDepMap)[depFeature.name] = depFeature.tag;
|
|
return reverseDepMap;
|
|
}();
|
|
|
|
if (auto feature = get(*reverseDepMap, name))
|
|
return *feature;
|
|
else
|
|
return std::nullopt;
|
|
}
|
|
|
|
std::string_view showDeprecatedFeature(const DeprecatedFeature tag)
|
|
{
|
|
assert((size_t)tag < depFeatureDetails.size());
|
|
return depFeatureDetails[(size_t)tag].name;
|
|
}
|
|
|
|
nlohmann::json documentDeprecatedFeatures()
|
|
{
|
|
StringMap res;
|
|
for (auto & depFeature : depFeatureDetails)
|
|
res[std::string { depFeature.name }] =
|
|
trim(stripIndentation(depFeature.description));
|
|
return (nlohmann::json) res;
|
|
}
|
|
|
|
DeprecatedFeatures parseDeprecatedFeatures(const std::set<std::string> & rawFeatures)
|
|
{
|
|
DeprecatedFeatures res{};
|
|
for (auto & rawFeature : rawFeatures)
|
|
if (auto feature = parseDeprecatedFeature(rawFeature))
|
|
res = res | *feature;
|
|
return res;
|
|
}
|
|
|
|
MissingDeprecatedFeature::MissingDeprecatedFeature(DeprecatedFeature feature)
|
|
: Error("Lix feature '%1%' is deprecated and should not be used anymore; use '--extra-deprecated-features %1%' to disable this error", showDeprecatedFeature(feature))
|
|
, missingFeature(feature)
|
|
{}
|
|
|
|
std::ostream & operator <<(std::ostream & str, const DeprecatedFeature & feature)
|
|
{
|
|
return str << showDeprecatedFeature(feature);
|
|
}
|
|
|
|
void to_json(nlohmann::json & j, const DeprecatedFeature & feature)
|
|
{
|
|
j = showDeprecatedFeature(feature);
|
|
}
|
|
|
|
void from_json(const nlohmann::json & j, DeprecatedFeature & feature)
|
|
{
|
|
const std::string input = j;
|
|
const auto parsed = parseDeprecatedFeature(input);
|
|
|
|
if (parsed.has_value())
|
|
feature = *parsed;
|
|
else
|
|
throw Error("Unknown deprecated feature '%s' in JSON input", input);
|
|
}
|
|
|
|
}
|