haiku/headers/os/package/PackageResolvableExpression.h

/*
 * Copyright 2011, Haiku, Inc.
 * Distributed under the terms of the MIT License.
 */
#ifndef _PACKAGE__PACKAGE_RESOLVABLE_EXPRESSION_H_
#define _PACKAGE__PACKAGE_RESOLVABLE_EXPRESSION_H_


#include <String.h>

#include <package/PackageResolvableOperator.h>
#include <package/PackageVersion.h>


namespace BPackageKit {


namespace BHPKG {
	struct BPackageResolvableExpressionData;
}
using BHPKG::BPackageResolvableExpressionData;


class BPackageResolvable;


/*
 * Expresses a constraint on a specific resolvable, either just a name
 * or a name plus a relational operator and a version.
 * Instances of these will be matched against all the BPackageResolvable(s)
 * of individual packages in order to solve a package management request.
 *
 * 		resolvable-expression ::= <name>[<op><version>]
 * 		op                    ::= '<' | '<=' | '==' | '>=' | '>'
 *
 * String examples:
 * 		haiku==r1
 * 		lib:libssl==0.9.8
 * 		subversion>=1.5
 * 		cmd:svn
 */
class BPackageResolvableExpression {
public:
								BPackageResolvableExpression();
								BPackageResolvableExpression(
									const BPackageResolvableExpressionData& data
									);
	explicit					BPackageResolvableExpression(
									const BString& expressionString);
								BPackageResolvableExpression(
									const BString& name,
									BPackageResolvableOperator _operator,
									const BPackageVersion& version);

			status_t			InitCheck() const;

			const BString&		Name() const;
			BPackageResolvableOperator	Operator() const;
			const BPackageVersion& Version() const;

			BString				ToString() const;

			status_t			SetTo(const BString& expressionString);
			void				SetTo(const BString& name,
									BPackageResolvableOperator _operator,
									const BPackageVersion& version);
			void				Clear();

			bool				Matches(const BPackageVersion& version,
									const BPackageVersion& compatibleVersion)
									const;
			bool				Matches(const BPackageResolvable& provides)
									const;

public:
	static	const char*			kOperatorNames[];

private:
			BString				fName;
			BPackageResolvableOperator	fOperator;
			BPackageVersion		fVersion;
};


}	// namespace BPackageKit


#endif	// _PACKAGE__PACKAGE_RESOLVABLE_EXPRESSION_H_