solidity/liblangutil/SemVerHandler.h

115 lines
2.7 KiB
C
Raw Normal View History

2016-08-19 17:57:21 +00:00
/*
This file is part of solidity.
2016-08-19 17:57:21 +00:00
solidity is free software: you can redistribute it and/or modify
2016-08-19 17:57:21 +00:00
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
solidity is distributed in the hope that it will be useful,
2016-08-19 17:57:21 +00:00
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with solidity. If not, see <http://www.gnu.org/licenses/>.
2016-08-19 17:57:21 +00:00
*/
// SPDX-License-Identifier: GPL-3.0
2016-08-19 17:57:21 +00:00
/**
* @author Christian <chris@ethereum.org>
* @date 2016
* Utilities to handle semantic versioning.
*/
#pragma once
#include <liblangutil/Token.h>
#include <libsolutil/Assertions.h>
2020-04-01 03:04:29 +00:00
#include <string>
#include <optional>
2020-04-01 03:04:29 +00:00
#include <utility>
2016-08-19 17:57:21 +00:00
#include <vector>
2019-12-11 16:31:36 +00:00
namespace solidity::langutil
2016-08-19 17:57:21 +00:00
{
class SemVerError: public util::Exception
2016-08-19 17:57:21 +00:00
{
};
#undef major
#undef minor
2016-08-19 17:57:21 +00:00
struct SemVerVersion
{
unsigned numbers[3];
std::string prerelease;
std::string build;
unsigned major() const { return numbers[0]; }
unsigned minor() const { return numbers[1]; }
unsigned patch() const { return numbers[2]; }
bool isPrerelease() const { return !prerelease.empty(); }
2016-08-19 17:57:21 +00:00
explicit SemVerVersion(std::string const& _versionString = "0.0.0");
};
struct SemVerMatchExpression
{
bool matches(SemVerVersion const& _version) const;
bool isValid() const { return !m_disjunction.empty(); }
struct MatchComponent
{
/// Prefix from < > <= >= ~ ^
Token prefix = Token::Illegal;
2016-08-19 17:57:21 +00:00
/// Version, where unsigned(-1) in major, minor or patch denotes '*', 'x' or 'X'
SemVerVersion version;
/// Whether we have 1, 1.2 or 1.2.4
unsigned levelsPresent = 1;
bool matches(SemVerVersion const& _version) const;
};
struct Conjunction
{
std::vector<MatchComponent> components;
bool matches(SemVerVersion const& _version) const;
};
std::vector<Conjunction> m_disjunction;
};
class SemVerMatchExpressionParser
{
public:
SemVerMatchExpressionParser(std::vector<Token> _tokens, std::vector<std::string> _literals);
/// Returns an expression if it was parseable, or nothing otherwise.
std::optional<SemVerMatchExpression> parse();
2016-08-19 17:57:21 +00:00
private:
void reset();
void parseMatchExpression();
SemVerMatchExpression::MatchComponent parseMatchComponent();
unsigned parseVersionPart();
char currentChar() const;
char nextChar();
Token currentToken() const;
2016-08-19 17:57:21 +00:00
void nextToken();
std::vector<Token> m_tokens;
2016-08-19 17:57:21 +00:00
std::vector<std::string> m_literals;
unsigned m_pos = 0;
unsigned m_posInside = 0;
SemVerMatchExpression m_expression;
};
}