Initialize a new transaction object.

You must close the DB with #close_db after use. Recommended to use RPM.transaction instead.

Run transaction check

Raises exception if check errored.

Free memory needed only for dependency checks and ordering

Closes the opened DB handle

Run the pending transaction, with given callback.

To handle exception, following form will be safe:

e : Exception? = nil
ts.commit do |header, type, amount, total, key|
  # do something here.


rescue ex : Exception
  if e.nil?
    e = ex
  end
  Pointer(Void).null
end
if e
  raise e
end

WARNING: Call order (by type) and content of arguments are very different by RPM version.

Run the pending transaction

If callback is not given, default callback will be used.

Returns true if transaction has been completed successfully, false if transaction has problem(s).

Raises TransactionError if any error(s) occured

Init DB iterator, yield block and cleanup.

Please refer RPM's rpmtsInitIterator() function for more details.

Some examples are:

• For package tag lookup, use RPM::DbiTag::Packages.
• For package name lookup, use RPM::DbiTag::Name.
• For filename (fullpath) lookup, use RPM::DbiTag::BaseNames.
• To lookup by a specific tag, initialize iterator with RPM::DbiTag::Packages, and use #regexp method.

Register given dependency to be deleted

Register given package to be deleted.

Register given package to be deleted (by a name)

Register all matching packages to be deleted.

Note: No package will be rejected (even RPM itself). Exception will be raised when some error occured.

Returns iterator for transaction elements

Iterate over each transaction element

Get transaction flags

Set transaction flags

Create a new package iterator with given tag and val

Please refer RPM's rpmtsInitIterator() function for more details.

Some examples are:

• For package tag lookup, use RPM::DbiTag::Packages.
• For package name lookup, use RPM::DbiTag::Name.
• For filename (fullpath) lookup, use RPM::DbiTag::BaseNames.
• To lookup by a specific tag, initialize iterator with RPM::DbiTag::Packages, and use #regexp method.

Register a package to be installed

key should (must?) be the path of the source package.

Base method of install, upgrade and delete

Determine package order in the transaction according to dependencies

The final order ends up as installed packages followed by removed packages, with packages removed for upgrades immediately following the new package to be installed.

Return transaction problems

If there are no problems, returns nil.

Read RPM package file

For independent use, RPM::Package.open.

Gets rootdir

Optimization NOTE: The rootdir will not be cached. Each time this method is called, this method allocates a new memory space to store the rootdir pathname, and return it.

Sets rootdir

This is possible only while no iterators are bound and no installations and/or deletions are set.

Sets the callback method (for running under running transaction), and yields the given block. Callback is set only while the block is yielded.

For user-friendly way to apply callback, use following form instead:

ts.commit do |header, type, amount, total, key|
  # do something here.
end

WARNING: We notifies rpmtsRun (#commit) may raises an Exception to the compiler, but raising an exception is highly discouraged. It may break the RPM database.

WARNING: Call order (by type) and content of arguments are very different by RPM version.

Returns pointer to rpmts to

Register a package to be upgraded

key should (must?) be the path of the source package.