pyqso package

Submodules

pyqso.adif module

class pyqso.adif.ADIF[source]

Bases: object

The ADIF class supplies methods for reading, parsing, and writing log files in the Amateur Data Interchange Format (ADIF). For more information, visit http://adif.org/

is_valid(field_name, data, data_type)[source]

Validate the data in a field with respect to the ADIF specification.

Parameters
  • field_name (str) – The name of the ADIF field.

  • data (str) – The data of the ADIF field to validate.

  • data_type (str) – The type of data to be validated. See http://www.adif.org/304/ADIF_304.htm#Data_Types for the full list with descriptions.

Returns

True or False to indicate whether the data is valid or not.

Return type

bool

parse_adi(text)[source]

Parse some raw text (defined in the ‘text’ argument) for ADIF field data.

Parameters

text (str) – The raw text from the ADIF file to parse.

Returns

A list of dictionaries (one dictionary per QSO). Each dictionary contains the field-value pairs, e.g. {“FREQ”: “145.500”, “BAND”: “2M”, “MODE”: “FM”}.

Return type

list

read(path)[source]

Read an ADIF file and parse it.

Parameters

path (str) – The path to the ADIF file to read.

Returns

A list of dictionaries (one dictionary per QSO), with each dictionary containing field-value pairs, e.g. {FREQ:145.500, BAND:2M, MODE:FM}. If the file cannot be read, the method returns None.

Return type

list

Raises

IOError – If the ADIF file does not exist or cannot be read (e.g. due to lack of read permissions).

write(records, path)[source]

Write an ADIF file containing all the QSOs in the ‘records’ list.

Parameters
  • records (list) – The list of QSO records to write.

  • path (str) – The desired path of the ADIF file to write to.

Returns

None

Raises

IOError – If the ADIF file cannot be written (e.g. due to lack of write permissions).

pyqso.auxiliary_dialogs module

pyqso.awards module

pyqso.blank module

pyqso.cabrillo module

class pyqso.cabrillo.Cabrillo[source]

Bases: object

The Cabrillo class supplies methods for writing log files in the Cabrillo format (v3.0). For more information, visit http://wwrof.org/cabrillo/

write(records, path, contest='', mycall='')[source]

Write a list of QSO records to a file in the Cabrillo format.

Parameters
  • records (list) – The list of QSO records to write.

  • path (str) – The desired path of the Cabrillo file to write to.

  • contest (str) – The name of the contest.

  • mycall (str) – The callsign used during the contest.

Returns

None

Raises

IOError – If the Cabrillo file cannot be written (e.g. due to lack of write permissions).

pyqso.cabrillo_export_dialog module

class pyqso.cabrillo_export_dialog.CabrilloExportDialog(application)[source]

Bases: object

A handler for the Gtk.Dialog through which a user can specify Cabrillo log details.

property contest

Return the name of the contest.

Returns

The name of the contest.

Return type

str

property mycall

Return the callsign used during the contest.

Returns

The callsign used during the contest.

Return type

str

pyqso.calendar_dialog module

class pyqso.calendar_dialog.CalendarDialog(application)[source]

Bases: object

Handler for a simple dialog containing a Gtk.Calendar widget. Using this ensures the date is in the correct YYYYMMDD format required by ADIF.

property date

Return the date from the Gtk.Calendar widget in YYYYMMDD format.

Returns

The date from the calendar in YYYYMMDD format.

Return type

str

pyqso.callsign_lookup module

pyqso.compare module

pyqso.compare.compare_date_and_time(model, row1, row2, user_data)[source]

Compare two rows (let’s call them A and B) in a Gtk.ListStore, and sort by both date and time.

Parameters
  • model (Gtk.TreeModel) – The model used to sort the log data.

  • row1 (Gtk.TreeIter) – The pointer to row A.

  • row2 (Gtk.TreeIter) – The pointer to row B.

  • user_data – The specific column from which to retrieve data for rows A and B.

Returns

-1 if Row B’s date/time is more recent than Row A’s; 0 if both dates and times are the same; 1 if Row A’s date/time is more recent than Row B’s.

Return type

int

pyqso.compare.compare_default(model, row1, row2, user_data)[source]

The default sorting function for all Gtk.ListStore objects.

Parameters
  • model (Gtk.TreeModel) – The model used to sort the log data.

  • row1 (Gtk.TreeIter) – The pointer to row A.

  • row2 (Gtk.TreeIter) – The pointer to row B.

  • user_data – The specific column from which to retrieve data for rows A and B.

Returns

-1 if the value of Row A’s column value is less than Row B’s column value; 0 if both values are the same; 1 if Row A’s column value is greater than Row B’s column value.

Return type

int

pyqso.dx_cluster module

pyqso.grey_line module

pyqso.log module

pyqso.log_name_dialog module

class pyqso.log_name_dialog.LogNameDialog(application, title=None, name=None)[source]

Bases: object

A handler for the Gtk.Dialog through which a user can specify the name of a Log object.

property name

Return the log name specified in the Gtk.Entry box by the user.

Returns

The log’s name.

Return type

str

pyqso.logbook module

pyqso.menu module

pyqso.preferences_dialog module

pyqso.printer module

pyqso.record_dialog module

pyqso.summary module

pyqso.telnet_connection_dialog module

class pyqso.telnet_connection_dialog.TelnetConnectionDialog(application)[source]

Bases: object

A handler for the Gtk.Dialog through which a user can specify Telnet connection details.

property bookmark

Return True if a new bookmark should be created, otherwise return False.

Returns

True if a new bookmark should be created, otherwise False.

Return type

bool

property host

Return the Telnet server’s host name.

Returns

The server’s host name.

Return type

str

property password

Return the user’s password.

Returns

The user’s password.

Return type

str

property port

Return the Telnet server’s port number (as a string).

Returns

The server’s port number (as a string).

Return type

str

property username

Return the user’s username.

Returns

The user’s username.

Return type

str

pyqso.toolbar module

class pyqso.toolbar.Toolbar(application)[source]

Bases: object

The toolbar underneath the menu bar.

set_logbook_button_sensitive(sensitive)[source]

Enable/disable logbook-related toolbar items.

Parameters

sensitive (bool) – If True, enable the ‘new logbook’ and ‘open logbook’ toolbar items. If False, disable them.

set_record_buttons_sensitive(sensitive)[source]

Enable/disable record-related toolbar items.

Parameters

sensitive (bool) – If True, enable all the record-related toolbar items. If False, disable them all.

pyqso.toolbox module

Module contents