GnomeAutoar.Compressor

g GObject.Object GObject.Object GnomeAutoar.Compressor GnomeAutoar.Compressor GObject.Object->GnomeAutoar.Compressor

Subclasses:None

Methods

Inherited:GObject.Object (37)
Structs:GObject.ObjectClass (5)
class quark ()
  get_completed_files ()
  get_completed_size ()
  get_create_top_level_directory ()
  get_files ()
  get_filter ()
  get_format ()
  get_notify_interval ()
  get_output_file ()
  get_output_is_dest ()
  get_size ()
  set_notify_interval (notify_interval)
  set_output_is_dest (output_is_dest)
  start (cancellable)
  start_async (cancellable)

Virtual Methods

Inherited:GObject.Object (7)

Properties

Name Type Flags Short Description
completed-files int r Number of files has been read
completed-size int r Bytes has read from disk
create-top-level-directory bool r/w/c Whether to create a top level directory
files int r Number of files will be compressed
notify-interval int r/w/c Minimal time interval between progress signal
output-file Gio.File r/w/co Output directory (Gio.File) of created archive
output-is-dest bool r/w/c Whether output file is used as destination
size int r Total bytes will be read from disk
source-files int r/w/co The list of GFiles to be archived

Signals

Inherited:GObject.Object (1)
Name Short Description
cancelled This signal is emitted after archive creating job is cancelled by the Gio.Cancellable.
completed This signal is emitted after the archive creating job is successfully completed.
decide-dest This signal is emitted when the location of the new archive is determined.
error This signal is emitted when error occurs and all jobs should be terminated.
progress This signal is used to report progress of creating archives.

Fields

Inherited:GObject.Object (1)

Class Details

class GnomeAutoar.Compressor(**kwargs)
Bases:GObject.Object
Abstract:No
Structure:GnomeAutoar.CompressorClass
classmethod quark()
Returns:a #GQuark.
Return type:int

Gets the GnomeAutoar.Compressor Error Quark.

get_completed_files()
Returns:number of files has been read
Return type:int

Gets the number of files has been read

get_completed_size()
Returns:file size in bytes has been read
Return type:int

Gets the size in bytes has been read from the source files and directories.

get_create_top_level_directory()
Returns:whether a top level directory will be created
Return type:bool

Gets whether a top level directory will be created in the new archive.

get_files()
Returns:total number of files
Return type:int

Gets the number of files will be read when the operation is completed. This value is currently unset, so calling this function is useless.

get_filter()
Returns:the compression filter
Return type:GnomeAutoar.Filter

Gets the compression filter

get_format()
Returns:the compression format
Return type:GnomeAutoar.Format

Gets the compression format

get_notify_interval()
Returns:the minimal interval in microseconds between the emission of the GnomeAutoar.Compressor ::progress signal.
Return type:int

See GnomeAutoar.Compressor.set_notify_interval().

get_output_file()
Returns:a Gio.File
Return type:Gio.File

If #AutoarCompressor:output_is_dest is False, gets the directory which contains the new archive. Otherwise, gets the the new archive. See GnomeAutoar.Compressor.set_output_is_dest().

get_output_is_dest()
Returns:True if GnomeAutoar.Compressor :output is the location of the new archive.
Return type:bool

See GnomeAutoar.Compressor.set_output_is_dest().

get_size()
Returns:total file size in bytes
Return type:int

Gets the size in bytes will be read when the operation is completed. This value is currently unset, so calling this function is useless.

set_notify_interval(notify_interval)
Parameters:notify_interval (int) – the minimal interval in microseconds

Sets the minimal interval between emission of GnomeAutoar.Compressor ::progress signal. This prevent too frequent signal emission, which may cause performance impact. If you do not want this feature, you can set the interval to 0, so you will receive every progress update.

set_output_is_dest(output_is_dest)
Parameters:output_is_dest (bool) – True if the location of the new archive has been already decided

By default GnomeAutoar.Compressor :output-is-dest is set to False, which means the new archive will be created as a regular file under GnomeAutoar.Compressor :output directory. The name of the new archive will be automatically generated and you will be notified via GnomeAutoar.Compressor ::decide-dest when the name is decided. If you have already decided the location of the new archive, and you do not want GnomeAutoar.Compressor to decide it for you, you can set GnomeAutoar.Compressor :output-is-dest to True. GnomeAutoar.Compressor will use GnomeAutoar.Compressor :output as the location of the new archive, and it will neither check whether the file exists nor create the necessary directories for you. This function should only be called before calling GnomeAutoar.Compressor.start() or GnomeAutoar.Compressor.start_async().

start(cancellable)
Parameters:cancellable (Gio.Cancellable or None) – optional Gio.Cancellable object, or None to ignore

Runs the archive creating work. All callbacks will be called in the same thread as the caller of this functions.

start_async(cancellable)
Parameters:cancellable (Gio.Cancellable or None) – optional Gio.Cancellable object, or None to ignore

Asynchronously runs the archive creating work. You should connect to GnomeAutoar.Compressor ::cancelled, GnomeAutoar.Compressor ::error, and GnomeAutoar.Compressor ::completed signal to get notification when the work is terminated. All callbacks will be called in the main thread, so you can safely manipulate GTK+ widgets in the callbacks.

Signal Details

GnomeAutoar.Compressor.signals.cancelled(compressor)
Signal Name:cancelled
Flags:RUN_LAST
Parameters:compressor (GnomeAutoar.Compressor) – The object which received the signal

This signal is emitted after archive creating job is cancelled by the Gio.Cancellable.

GnomeAutoar.Compressor.signals.completed(compressor)
Signal Name:completed
Flags:RUN_LAST
Parameters:compressor (GnomeAutoar.Compressor) – The object which received the signal

This signal is emitted after the archive creating job is successfully completed.

GnomeAutoar.Compressor.signals.decide_dest(compressor, destination)
Signal Name:

decide-dest

Flags:

RUN_LAST

Parameters:

This signal is emitted when the location of the new archive is determined.

GnomeAutoar.Compressor.signals.error(compressor, error)
Signal Name:

error

Flags:

RUN_LAST

Parameters:

This signal is emitted when error occurs and all jobs should be terminated. Possible error domains are %AUTOAR_COMPRESSOR_ERROR, %G_IO_ERROR, and %AUTOAR_LIBARCHIVE_ERROR, which represent error occurs in GnomeAutoar.Compressor, GIO, and libarchive, respectively. The GLib.Error is owned by GnomeAutoar.Compressor and should not be freed.

GnomeAutoar.Compressor.signals.progress(compressor, completed_size, completed_files)
Signal Name:

progress

Flags:

RUN_LAST

Parameters:
  • compressor (GnomeAutoar.Compressor) – The object which received the signal
  • completed_size (int) – bytes has been read from source files and directories
  • completed_files (int) – number of files and directories has been read

This signal is used to report progress of creating archives. The value of completed_size and completed_files are the same as the #AutoarCompressor:completed_size and #AutoarCompressor:completed_files properties, respectively.

Property Details

GnomeAutoar.Compressor.props.completed_files
Name:completed-files
Type:int
Default Value:0
Flags:READABLE

Number of files has been read

GnomeAutoar.Compressor.props.completed_size
Name:completed-size
Type:int
Default Value:0
Flags:READABLE

Bytes has read from disk

GnomeAutoar.Compressor.props.create_top_level_directory
Name:create-top-level-directory
Type:bool
Default Value:False
Flags:READABLE, WRITABLE, CONSTRUCT

Whether to create a top level directory

GnomeAutoar.Compressor.props.files
Name:files
Type:int
Default Value:0
Flags:READABLE

Number of files will be compressed

GnomeAutoar.Compressor.props.notify_interval
Name:notify-interval
Type:int
Default Value:100000
Flags:READABLE, WRITABLE, CONSTRUCT

Minimal time interval between progress signal

GnomeAutoar.Compressor.props.output_file
Name:output-file
Type:Gio.File
Default Value:None
Flags:READABLE, WRITABLE, CONSTRUCT_ONLY

Output directory (Gio.File) of created archive

GnomeAutoar.Compressor.props.output_is_dest
Name:output-is-dest
Type:bool
Default Value:False
Flags:READABLE, WRITABLE, CONSTRUCT

Whether output file is used as destination

GnomeAutoar.Compressor.props.size
Name:size
Type:int
Default Value:0
Flags:READABLE

Total bytes will be read from disk

GnomeAutoar.Compressor.props.source_files
Name:source-files
Type:int
Default Value:None
Flags:READABLE, WRITABLE, CONSTRUCT_ONLY

The list of GFiles to be archived