ru.r2cloud.apt.AptRepository Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of apt-man Show documentation

Library for managing APT repository

There is a newer version: 1.13

package ru.r2cloud.apt;

import java.io.IOException;
import java.util.List;
import java.util.Set;

import ru.r2cloud.apt.model.Architecture;
import ru.r2cloud.apt.model.DebFile;

/**
 * Main entry point to the library. Typical program include:
 *  * {@code
 * GpgSigner signer = new GpgSignerImpl(config);
 * Transport transport = new FileTransport("./apt-basedir/");
 * AptRepository repository = new AptRepositoryImpl(codename, component, signer, transport);
 * repository.saveFiles(Collections.singletonList(new DebFile(new File("some.deb"))));
 * }
 * 
 * 
 * GpgSigner can be empty. In that case no gpg signature will be generated.
 * 
 * @author dernasherbrezon
 *
 */
public interface AptRepository {

	/**
	 * Save multiple .deb files into apt repository. The version, architecture and the package name extracted from the .deb file.
	 * 
	 * @param debFiles - list of .deb files. Create .deb file meta information using DebFile file = new DebFile(new File("some.deb")
	 * @throws IOException - on any error
	 */
	void saveFiles(List debFiles) throws IOException;

	/**
	 * Remove unused files from the repository.
	 * @param keepLast - keep last number of files in each category
	 * @throws IOException - on any error
	 */
	void cleanup(int keepLast) throws IOException;

	/**
	 * Init empty repository for the architectures provided.
	 * @param architectures - one or more architectures
	 * @throws IOException - on any error
	 */
	void init(Architecture ... architectures) throws IOException;
	
	/**
	 * Delete packages and update the index.
	 * 
	 * @param packages - packages to remove
	 * @throws IOException - on any error
	 */
	void deletePackages(Set packages) throws IOException;

}