/*

 * Copyright (C) 2008  Kristian Høgsberg <krh@redhat.com>

 * Copyright (C) 2008  Red Hat, Inc

 *

 * This program is free software; you can redistribute it and/or modify

 * it under the terms of the GNU General Public License as published by

 * the Free Software Foundation; either version 2 of the License, or

 * (at your option) any later version.

 *

 * This program is distributed in the hope that it will be useful,

 * 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 this program; if not, write to the Free Software Foundation, Inc.,

 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.

 */

#ifndef _RAZOR_H_

#define _RAZOR_H_

#define ARRAY_SIZE(a) (sizeof(a) / sizeof((a)[0]))

struct razor_set;

struct razor_package;

struct razor_property;

enum razor_property_type {

	RAZOR_PROPERTY_REQUIRES,

	RAZOR_PROPERTY_PROVIDES,

	RAZOR_PROPERTY_CONFLICTS,

	RAZOR_PROPERTY_OBSOLETES

};

enum razor_version_relation {

	RAZOR_VERSION_LESS,

	RAZOR_VERSION_LESS_OR_EQUAL,

	RAZOR_VERSION_EQUAL,

	RAZOR_VERSION_GREATER_OR_EQUAL,

	RAZOR_VERSION_GREATER

};

extern const char * const razor_version_relations[];

struct razor_set *razor_set_create(void);

struct razor_set *razor_set_open(const char *filename);

void razor_set_destroy(struct razor_set *set);

int razor_set_write_to_fd(struct razor_set *set, int fd);

int razor_set_write(struct razor_set *set, const char *filename);

struct razor_package *

razor_set_get_package(struct razor_set *set, const char *package);

struct razor_package_iterator;

struct razor_package_iterator *

razor_package_iterator_create(struct razor_set *set);

struct razor_package_iterator *

razor_package_iterator_create_for_property(struct razor_set *set,

					   struct razor_property *property);

struct razor_package_iterator *

razor_package_iterator_create_for_file(struct razor_set *set,

				       const char *filename);

int razor_package_iterator_next(struct razor_package_iterator *pi,

				struct razor_package **package,

				const char **name,

				const char **version,

				const char **arch);

void razor_package_iterator_destroy(struct razor_package_iterator *pi);

struct razor_package_query *

razor_package_query_create(struct razor_set *set);

void

razor_package_query_add_package(struct razor_package_query *pq,

				struct razor_package *p);

void

razor_package_query_add_iterator(struct razor_package_query *pq,

				 struct razor_package_iterator *pi);

struct razor_package_iterator *

razor_package_query_finish(struct razor_package_query *pq);

struct razor_property_iterator;

struct razor_property_iterator *

razor_property_iterator_create(struct razor_set *set,

			       struct razor_package *package);

int razor_property_iterator_next(struct razor_property_iterator *pi,

				 struct razor_property **property,

				 const char **name,

				 enum razor_version_relation *relation,

				 const char **version,

				 enum razor_property_type *type);

void

razor_property_iterator_destroy(struct razor_property_iterator *pi);

void razor_set_list_files(struct razor_set *set, const char *prefix);

void razor_set_list_package_files(struct razor_set *set, const char *name);

void razor_set_list_unsatisfied(struct razor_set *set);

typedef void (*razor_package_callback_t)(const char *name,

					 const char *old_version,

					 const char *new_version,

					 const char *arch,

					 void *data);

void

razor_set_diff(struct razor_set *set, struct razor_set *upstream,

	       razor_package_callback_t callback, void *data);

/* Package transactions */

struct razor_transaction *

razor_transaction_create(struct razor_set *system, struct razor_set *upstream);

void razor_transaction_install_package(struct razor_transaction *transaction,

				       struct razor_package *package);

void razor_transaction_remove_package(struct razor_transaction *transaction,

				      struct razor_package *package);

void razor_transaction_update_package(struct razor_transaction *trans,

				      struct razor_package *package);

void razor_transaction_update_all(struct razor_transaction *transaction);

int razor_transaction_resolve(struct razor_transaction *trans);

int razor_transaction_describe(struct razor_transaction *trans);

struct razor_set *razor_transaction_finish(struct razor_transaction *trans);

void razor_transaction_destroy(struct razor_transaction *trans);

/* Temporary helper for test suite. */

int razor_transaction_unsatisfied_property(struct razor_transaction *trans,

					   const char *name,

					   enum razor_version_relation rel,

					   const char *version,

					   enum razor_property_type type);

/* Importer interface; for building a razor set from external sources,

 * like yum, rpmdb or razor package files. */

struct razor_importer;

struct razor_rpm;

struct razor_importer *razor_importer_new(void);

void razor_importer_destroy(struct razor_importer *importer);

void razor_importer_begin_package(struct razor_importer *importer,

				  const char *name,

				  const char *version,

				  const char *arch);

void razor_importer_add_property(struct razor_importer *importer,

				 const char *name,

				 enum razor_version_relation relation,

				 const char *version,

				 enum razor_property_type type);

void razor_importer_add_file(struct razor_importer *importer,

			     const char *name);

void razor_importer_finish_package(struct razor_importer *importer);

int razor_importer_add_rpm(struct razor_importer *importer,

			   struct razor_rpm *rpm);

struct razor_set *razor_importer_finish(struct razor_importer *importer);

void razor_build_evr(char *evr_buf, int size, const char *epoch,

		     const char *version, const char *release);

struct razor_set *razor_set_create_from_yum(void);

struct razor_set *razor_set_create_from_rpmdb(void);

/* RPM functions */

struct razor_rpm *razor_rpm_open(const char *filename);

int razor_rpm_install(struct razor_rpm *rpm, const char *root);

int razor_rpm_close(struct razor_rpm *rpm);

/* Razor root functions. The root data struct encapsulates filesystem

 * conventions and the locking protocol. */

struct razor_root;

#define RAZOR_ROOT_OPEN_WRITE 0x01

int razor_root_create(const char *root);

struct razor_root *razor_root_open(const char *root, int flags);

struct razor_set *razor_root_open_read_only(const char *root);

struct razor_transaction *

razor_root_create_transaction(struct razor_root *image,

			      struct razor_set *upstream);

int razor_root_close(struct razor_root *image);

void razor_root_update(struct razor_root *image, struct razor_set *next);

int razor_root_commit(struct razor_root *image);

void razor_root_diff(struct razor_root *root,

		     razor_package_callback_t callback, void *data);

#endif /* _RAZOR_H_ */