hs.settings

Строка, представляющая идентификатор пакета, в котором хранятся настройки Hammerspoon. Вы можете использовать его с командной утилитой defaults или другими инструментами, которые позволяют получить доступ к User Defaults приложений, чтобы получить доступ к ним вне Hammerspoon.

Строка, представляющая ожидаемый формат даты и времени при представлении даты и времени в виде строки для hs.setDate(). Например, os.date(hs.settings.dateFormat)

Удаляет параметр.

• key — строка, содержащая имя параметра

• Булево значение, true, если параметр был удален, иначе false

Загружает параметр.

• key — строка, содержащая имя параметра

• Значение параметра

• Эта функция может загружать все типы данных, поддерживаемые hs.settings.set(), hs.settings.setData() и hs.settings.setDate().

Получает все ранее сохраненные имена параметров.

• Нет

• Таблица, содержащая все ключи параметров в настройках Hammerspoon

• Используйте ipairs(hs.settings.getKeys()) для перебора всех доступных параметров.
• Используйте hs.settings.getKeys()["someKey"] для проверки существования определенного ключа.

Сохраняет параметр с распространенными типами данных.

• key — строка, содержащая имя параметра
• val — необязательное значение параметра. Допустимые типы данных:
  • строка
  • число
  • булево
  • nil
  • таблица (которая может содержать любые из тех же допустимых типов данных)

• Нет

• Если параметр val не указан, предполагается, что он равен nil
• Эта функция не может задавать даты или типы данных с сырыми данными, см. hs.settings.setDate() и hs.settings.setData()
• Установка значения nil эквивалентна очистке значения с помощью hs.settings.clear

Сохраняет параметр с сырыми данными.

• key — строка, содержащая имя параметра
• val — некоторые сырые данные

• Нет

Сохраняет параметр с датой.

• key — строка, содержащая имя параметра
• val — число, представляющее секунды с момента 1970-01-01 00:00:00 +0000 (например, os.time()), или строка, содержащая дату в формате RFC3339 (YYYY-MM-DD[T]HH:MM:SS[Z])

• Нет

• См. hs.settings.dateFormat для удобного представления формата RFC3339, чтобы использовать его с другими функциями, связанными с датой/временем

Получить или установить наблюдателя для вызова обратного вызова при изменении указанного ключа настроек.

• identifier — необходимая строка, используемая в качестве идентификатора для этого обратного вызова
• key — ключ настроек, за изменением которого нужно наблюдать
• fn — функция обратного вызова, которая должна вызываться при изменении указанного ключа. Если это явный nil, удаляет существующий обратный вызов.

• если обратный вызов устанавливается или удаляется, возвращает идентификатор; в противном случае возвращает текущую функцию обратного вызова или nil, если функция обратного вызова в данный момент не определена.

• идентификатор необходим для регистрации нескольких обратных вызовов для одного и того же ключа разными модулями; его значение не влияет на то, за чем ведется наблюдение, но должно быть уникальным для нескольких наблюдателей одного и того же ключа.
• Не работает с ключами, которые содержат точку (.) в имени ключа, потому что KVO использует нотацию точек для указания последовательности свойств. Если вам известно, как экранировать точки, чтобы они были доступны в качестве имен ключей NSUserDefaults, пожалуйста, создайте вопрос и поделитесь информацией!