Download/checksum/install/uninstall what transaction wants

[cygwin-apps/setup.git] / libsolv.h

/*
 * Copyright (c) 2017 Jon Turney
 *
 *     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.
 *
 *     A copy of the GNU General Public License can be found at
 *     http://www.gnu.org/
 *
 */

#ifndef LIBSOLV_H
#define LIBSOLV_H

#include "solv/pool.h"
#include "solv/repo.h"
#include "solv/solver.h"
#include "PackageSpecification.h"
#include "PackageTrust.h"
#include "package_source.h"
#include "package_depends.h"
#include <map>
#include <vector>

typedef trusts package_stability_t;

typedef enum
{
  package_binary,
  package_source
}
package_type_t;

// ---------------------------------------------------------------------------
// interface to class SolverVersion
//
// a wrapper around a libsolv Solvable
// ---------------------------------------------------------------------------

class SolverPool;
class SolverSolution;

class SolvableVersion
{
 public:
  SolvableVersion() : id(0), pool(0) {};
  SolvableVersion(Id _id, Pool *_pool) : id(_id), pool(_pool) {};

  // converted to a bool, this is true if this isn't the result of the default
  // constructor (an 'empty' version, in some sense)
  explicit operator bool () const { return (id != 0); }

  const std::string Name () const;
  const std::string SDesc () const;
  // In setup-speak, 'Canonical' version means 'e:v-r', the non-decomposed version
  const std::string Canonical_version () const;
  const PackageDepends depends() const;
  bool accessible () const;
  package_type_t Type () const;
  package_stability_t Stability () const;
  // the associated source package, if this is a binary package
  SolvableVersion sourcePackage () const;
  // where this package archive can be obtained from
  packagesource *source() const;

  // utility function to compare package versions
  static int compareVersions(const SolvableVersion &a, const SolvableVersion &b);

  // comparison operators

  // these are somewhat necessary as otherwise we are compared as bool values
  bool operator == (SolvableVersion const &) const;
  bool operator != (SolvableVersion const &) const;

  // these are only well defined for versions of the same package
  bool operator < (SolvableVersion const &) const;
  bool operator <= (SolvableVersion const &) const;
  bool operator > (SolvableVersion const &) const;
  bool operator >= (SolvableVersion const &) const;

 private:
  Id id;
  Pool *pool;

  friend SolverPool;
  friend SolverSolution;
};

// ---------------------------------------------------------------------------
// Helper class SolvRepo
//
// ---------------------------------------------------------------------------

class SolvRepo
{
public:
  Repo *repo;
  Repodata *data;
  bool test;
};

// ---------------------------------------------------------------------------
// interface to class SolverPool
//
// a simplified wrapper for libsolv
// ---------------------------------------------------------------------------

class SolverPool
{
public:
  SolverPool();
  SolvRepo *getRepo(const std::string &name, bool test = false);

  // Utility class for passing arguments to addPackage()
  class addPackageData
  {
  public:
    std::string reponame;
    std::string version;
    std::string vendor;
    std::string sdesc;
    std::string ldesc;
    package_stability_t stability;
    package_type_t type;
    packagesource archive;
    PackageSpecification spkg;
    SolvableVersion spkg_id;
    PackageDepends *requires;
  };

  SolvableVersion addPackage(const std::string& pkgname,
                             const addPackageData &pkgdata);

  void internalize(void);
  void use_test_packages(bool use_test_packages);


private:
  Id makedeps(Repo *repo, PackageDepends *requires);
  Pool *pool;

  typedef std::map<std::string, SolvRepo *> RepoList;
  RepoList repos;

  friend SolverSolution;
};


// ---------------------------------------------------------------------------
// interface to class SolverTaskQueue
//
// This is used to contain a set of package install/uninstall tasks selected via
// the UI to be passed to solver
// ---------------------------------------------------------------------------

class SolverTasks
{
 public:
  enum task
  {
    taskInstall,
    taskUninstall,
    taskReinstall
  };
  void add(const SolvableVersion &v, task t)
  {
    tasks.push_back(taskList::value_type(v, t));
  };
 private:
  typedef std::vector<std::pair<const SolvableVersion &, task>> taskList;
  taskList tasks;

  friend SolverSolution;
};

// ---------------------------------------------------------------------------
// SolverTransactionList
//
// a list of transactions output by the solver
// ---------------------------------------------------------------------------

class SolverTransaction
{
 public:
  typedef enum
  {
    transIgnore,
    transInstall,
    transErase,
  } transType;

  SolverTransaction(SolvableVersion version_, transType type_) :
  version(version_), type(type_) {};

  SolvableVersion version;
  transType type;
};

typedef std::vector<SolverTransaction> SolverTransactionList;

// ---------------------------------------------------------------------------
// interface to class SolverSolution
//
// A wrapper around the libsolv solver
// ---------------------------------------------------------------------------

class SolverSolution
{
 public:
  SolverSolution(SolverPool &_pool) : pool(_pool), solv(NULL) {};
  ~SolverSolution();

  bool update(SolverTasks &tasks, bool update, bool use_test_packages, bool include_source);
  std::string report() const;

  const SolverTransactionList &transactions() const;

 private:
  static SolverTransaction::transType type(Transaction *trans, int pos);

  SolverPool &pool;
  Solver *solv;
  SolverTransactionList trans;
};

#endif // LIBSOLV_H