Существует масса способов поместить свои данные в своё приложение. Когда вы пишите пользовательский интерфейс, вы часто будете попадать ситуацию, в которой требуется пользовательских настроек. Вы можете использовать простую базу данных вроде SQLite или файл конфигурации. В данном примере мы сделаем выбор в пользу файла конфигурации. В Python встроена удобная библиотека, которая называется configparser. Вы можете использовать её для создания и управления файлами конфигурации в wxPython. Как бы то ни было, я предпочитаю использовать ConfigObj, но это отдельный пакет, который вам нужно скачивать и устанавливать.
Приступая к работе
ConfigObj немного проще использовать чем configparser. Более того, он позволяет провести валидацию. А ещё он может доставить из файла конфигурации типы Python, в то время как configparser достаёт только строки. Если ConfigObj не установлен у вас, то используйте pip:
|
1 |
pip install configobj |
Сразу же после установки создайте простой контроллер для создания файлов конфигурации и доступа к ним с помощью ConfigObj.
Создание контроллера
Использование парадигмы модель-вид-контроллер очень популярно во время разработки пользовательского интерфейса. Контролер обычно служит оболочкой для самого кода, который и выполняет поставленную функцию. Моделью являются описание базы данных или даже самих виджетов, ведь wxPython поддерживает и XRC. Видом здесь является код, который рисует интерфейс для пользователя, так что, в данном случае, он будет составлять большую часть кода wxPython. Сейчас нам не нужно беспокоится о модели, так что мы можем сразу начать с контроллера.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 |
# controller.py import configobj import os import sys appPath = os.path.abspath(os.path.dirname(os.path.join(sys.argv[0]))) inifile = os.path.join(appPath, "example.ini") def create_config(): """ Create the configuration file """ config = configobj.ConfigObj() config.filename = inifile config['update server'] = "http://www.someCoolWebsite/hackery.php" config['username'] = "" config['password'] = "" config['update interval'] = 2 config['agency filter'] = 'include' config['filters'] = "" config.write() def get_config(): """ Открывает файл конфигурации и возвращает configobj """ if not os.path.exists(inifile): create_config() return configobj.ConfigObj(inifile) |
Этот фрагмент кода довольно прямолинеен. В функции create_config создаётся файл example.ini в той же директории, из которой запускался скрипт. Файл конфигурации получает 6 полей, но в нём отсутствуют секции. В функции get_config, код проверяет наличие файла конфигурации и, в случае отсутствия, создаёт его. Несмотря ни на что, функция возвращает объект ConfigObj к коллеру. Мы вставляем данный скрипт в controller.py.
Создание вида
Всё, что нам нужно для нашего вида – превратить класс wx.Dialog, чтобы создать диалог параметров. Этот фрагмент кода довольно длинный, так что давайте разберём его по кусочкам.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 |
import controller import os import sys import wx from wx.lib.buttons import GenBitmapTextButton appPath = os.path.abspath(os.path.dirname(os.path.join(sys.argv[0]))) class CloseBtn(GenBitmapTextButton): """ Creates a reusable close button with a bitmap """ def __init__(self, parent, label="Close"): """Constructor""" font = wx.Font(16, wx.SWISS, wx.NORMAL, wx.BOLD) img = wx.Bitmap(r"%s/images/cancel.png" % appPath) GenBitmapTextButton.__init__(self, parent, wx.ID_CLOSE, img, label=label, size=(110, 50)) self.SetFont(font) |
Данный простенький код создаёт кнопку, позволяющую закрыть приложение. Мы абстрагировали его, чтобы было проще делится этим кодом. Вы даже может вставить этот фрагмент в его собственный модуль, который можно будет импортировать другими приложениями. Теперь давайте взглянем на код главного диалога:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 |
class PreferencesDialog(wx.Dialog): """ Creates and displays a preferences dialog that allows the user to изменить некоторые настройки. """ def __init__(self): """ Инициализируйте диалог """ wx.Dialog.__init__(self, None, wx.ID_ANY, 'Preferences', size=(550,400)) appPath = controller.appPath # Создать виджеты font = wx.Font(12, wx.SWISS, wx.NORMAL, wx.BOLD) serverLbl = wx.StaticText(self, label="Update Server:") self.serverTxt = wx.TextCtrl(self) self.serverTxt.Disable() usernameLbl = wx.StaticText(self, label="Username:") self.usernameTxt = wx.TextCtrl(self) self.usernameTxt.Disable() passwordLbl = wx.StaticText(self, label="Password:") self.passwordTxt = wx.TextCtrl(self, style=wx.TE_PASSWORD) self.passwordTxt.Disable() updateLbl = wx.StaticText(self, label="Update Interval:") self.updateTxt = wx.TextCtrl(self) minutesLbl = wx.StaticText(self, label="minutes") agencyLbl = wx.StaticText(self, label="Agency Filter:") choices = ["Include all agencies except", "Exclude all agencies except"] self.agencyCbo = wx.ComboBox( self, value="Include all agencies except", choices=choices, style=wx.CB_DROPDOWN|wx.CB_READONLY) self.agencyCbo.SetFont(font) self.filterTxt = wx.TextCtrl(self, wx.ID_ANY, "") img = wx.Bitmap(r"%s/images/filesave.png" % appPath) saveBtn = GenBitmapTextButton( self, wx.ID_ANY, img, "Save", size=(110, 50)) saveBtn.Bind(wx.EVT_BUTTON, self.savePreferences) cancelBtn = CloseBtn(self, label="Cancel") cancelBtn.Bind(wx.EVT_BUTTON, self.onCancel) # Задать шрифт виджетов widgets = [serverLbl, usernameLbl, passwordLbl, updateLbl, agencyLbl, minutesLbl, self.serverTxt, self.usernameTxt, self.passwordTxt, self.updateTxt, self.agencyCbo, self.filterTxt, saveBtn, cancelBtn] for widget in widgets: widget.SetFont(font) # Расположение виджетов mainSizer = wx.BoxSizer(wx.VERTICAL) updateSizer = wx.BoxSizer(wx.HORIZONTAL) btnSizer = wx.BoxSizer(wx.HORIZONTAL) prefSizer = wx.FlexGridSizer(cols=2, hgap=5, vgap=5) prefSizer.AddGrowableCol(1) prefSizer.Add(serverLbl, 0, wx.ALIGN_LEFT | wx.ALIGN_CENTER_VERTICAL) prefSizer.Add(self.serverTxt, 0, wx.EXPAND) prefSizer.Add(usernameLbl, 0, wx.ALIGN_LEFT | wx.ALIGN_CENTER_VERTICAL) prefSizer.Add(self.usernameTxt, 0, wx.EXPAND) prefSizer.Add(passwordLbl, 0, wx.ALIGN_LEFT | wx.ALIGN_CENTER_VERTICAL) prefSizer.Add(self.passwordTxt, 0, wx.EXPAND) prefSizer.Add(updateLbl, 0, wx.ALIGN_LEFT | wx.ALIGN_CENTER_VERTICAL) updateSizer.Add(self.updateTxt, 0, wx.RIGHT, 5) updateSizer.Add(minutesLbl, 0, wx.ALIGN_LEFT | wx.ALIGN_CENTER_VERTICAL) prefSizer.Add(updateSizer) prefSizer.Add(agencyLbl, 0, wx.ALIGN_LEFT | wx.ALIGN_CENTER_VERTICAL) prefSizer.Add(self.agencyCbo, 0, wx.EXPAND) prefSizer.Add((20,20)) prefSizer.Add(self.filterTxt, 0, wx.EXPAND) mainSizer.Add(prefSizer, 0, wx.EXPAND|wx.ALL, 5) btnSizer.Add(saveBtn, 0, wx.ALL, 5) btnSizer.Add(cancelBtn, 0, wx.ALL, 5) mainSizer.Add(btnSizer, 0, wx.ALL | wx.ALIGN_RIGHT, 10) self.SetSizer(mainSizer) # Загрузка параметров self.loadPreferences() |
Этот код лишь инициализирует и размещает виджеты, которые нужны в вашем приложении. Он также настраивает хэндлеры событий и делает так, чтобы во всех виджетах использовался одинаковый шрифт. Последним фрагментом, который мы рассмотрим, будет секция хэндлеров событий:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 |
def loadPreferences(self): """ Load the preferences and fill the text controls """ config = controller.get_config() updateServer = config['update server'] username = config['username'] password = config['password'] interval = config['update interval'] agencyFilter = config['agency filter'] filters = config['filters'] self.serverTxt.SetValue(updateServer) self.usernameTxt.SetValue(username) self.passwordTxt.SetValue(password) self.updateTxt.SetValue(interval) self.agencyCbo.SetValue(agencyFilter) self.filterTxt.SetValue(filters) def onCancel(self, event): """ Closes the dialog """ self.EndModal(0) def savePreferences(self, event): """ Save the preferences """ config = controller.get_config() config['update interval'] = self.updateTxt.GetValue() config['agency filter'] = str(self.agencyCbo.GetValue()) data = self.filterTxt.GetValue() if "," in data: filters = [i.strip() for i in data.split(',')] elif " " in data: filters = [i.strip() for i in data.split(' ')] else: filters = [data] text = "" for f in filters: text += " " + f text = text.strip() config['filters'] = text config.write() dlg = wx.MessageDialog( self, "Preferences Saved!", 'Information', wx.OK|wx.ICON_INFORMATION) dlg.ShowModal() dlg.EndModal(0) if __name__ == "__main__": app = wx.App(False) dlg = PreferencesDialog() dlg.ShowModal() dlg.Destroy() |
Код, написанный выше, позволяет нам загрузить конфигурацию из файла используя ConfigObj. Вы можете увидеть, как он работает, прочитав часть кода, где используется метод loadPreferences. Другой внушительный фрагмент кода посвящён сохранению данных после того, как пользователь внёс свои корректировки. Для этого, нам нужно обратить внимание на метод savePreferences. Это довольно прямолинейный метод, который позволяет захватывать различные значения из виджетов, используя специализированные функции для получения, доступные wx.
Здесь также прописано условие, которое запускает минорную проверку поля фильтра. Причина этому проста: изначально в своей программе я использовал пробел в качестве разделителя, поэтому программа должна была превращать запятые и прочие знаки в пробелы. Данный код всё ещё находится на стадии разработки и может пропускать некоторые символы, которые может ввести пользователь. Но не стесняйтесь расширять его, чтобы он стал более универсальным.
В любом случае, как только значения попали в дикт-интерефейс ConfigObj, мы превращаем данные файла инстанции ConfigObj в файл. Далее программа отображает простое диалоговое окно, уведомляющее пользователя о том, что было сохранено.
Вы также заметите, что для корректного закрытия диалогового окна, мы вызывали EndModal в методе onCancel.
Теперь, давайте представим, что специализация нашей программы изменилась настолько, что нам нужно убрать или заменить параметр. Всё, что нам нужно сделать – это удалить или добавить файл конфигурации. ConfigObj сам соберёт все изменения, нам нужно лишь запомнить о том, что нужно добавить или удалить соответствующие виджеты в нашем графическом интерфейсе. Самое лучшее в ConfigObj то, что он не будет переписывать данные в вашем файле, а просто добавить фрагменты, которые нужны для изменений. Попробуйте и убедитесь в том, что это невероятно просто!
Итоги
Теперь вы должны уметь создавать свои собственные диалоговые окна с параметрами и использовать ConfigObj для увеличения их количества. Я считаю, что ConfigObj лучше подходит Python в вопросах чтения и написания файлов конфигурации. Я думаю, что вы со мной согласитесь. Если вы хотите посоревноваться или просто размяться, то попробуйте открыть диалоговое окно «Параметры» в любой установленной на вашем компьютере программе, например, в Microsoft Word, а затем попробуйте создать его копию их используя wxPython. Это одно из лучших обучающих упражнений, так как вы будете сразу использовать несколько виджетов, что положительно скажется на вашей креативности в вопросах файлов конфигурации.
Являюсь администратором нескольких порталов по обучению языков программирования Python, Golang и Kotlin. В составе небольшой команды единомышленников, мы занимаемся популяризацией языков программирования на русскоязычную аудиторию. Большая часть статей была адаптирована нами на русский язык и распространяется бесплатно.
E-mail: vasile.buldumac@ati.utm.md
Образование
Universitatea Tehnică a Moldovei (utm.md)
- 2014 — 2018 Технический Университет Молдовы, ИТ-Инженер. Тема дипломной работы «Автоматизация покупки и продажи криптовалюты используя технический анализ»
- 2018 — 2020 Технический Университет Молдовы, Магистр, Магистерская диссертация «Идентификация человека в киберпространстве по фотографии лица»