Changelog

Unreleased

Дополнения

• all: добавлен FSNOTIFY_DEBUG для вывода событий в stderr ([#619]).

Изменения и исправления

• windows: исправлено поведение WatchList() ([#610]).

• kqueue: игнорируются события с Ident=0 ([#590]).

• kqueue: установлен параметр O_CLOEXEC для предотвращения передачи файловых дескрипторов дочерним процессам ([#617]).

• kqueue: события при наблюдении за символической ссылкой выводятся как «/path/dir/file» вместо «path/link/file» ([#625]).

• inotify: не отправляется событие IN_DELETE_SELF, если также отслеживается родительский каталог ([#620]).

• fen: разрешено отслеживание подкаталогов отслеживаемых каталогов ([#621]).

1.7.0 — 2023-10-22

Для этой версии fsnotify требуется Go 1.17.

Дополнения

• illumos: добавлен бэкенд FEN для поддержки illumos и Solaris (#371).

• all: добавлена функция NewBufferedWatcher(), которая позволяет использовать буферизованный канал, что может быть полезно в случаях, когда невозможно контролировать буфер ядра и получать большое количество событий пакетами (#550, #572).

• all: добавлена функция AddWith(), идентичная функции Add(), но позволяющая передавать параметры (#521).

• windows: добавлена возможность установки размера буфера ReadDirectoryChangesW() с помощью fsnotify.WithBufferSize(); по умолчанию используется значение 64 КБ, которое является максимальным значением, работающим на всех платформах, и достаточным для большинства целей, но в некоторых случаях требуется больший буфер (#521).

Изменения и исправления

• inotify: удаляется наблюдатель, если отслеживаемый путь переименован (#518). После переименования сообщаемое имя не обновлялось или даже было пустой строкой. Inotify не предоставляет хороших средств для его обновления, поэтому просто удалите наблюдателя. Так уже работало на kqueue и FEN. На Windows это работает и остаётся рабочим.

• windows: не отслеживаются изменения атрибутов файлов (#520). Изменения атрибута файла отправляются как FILE_ACTION_MODIFIED через Windows API без возможности определить, являются ли они записью файла или изменением атрибута, поэтому будут отображаться как событие fsnotify.Write. Это никогда не бывает полезным и может привести к появлению множества ложных событий записи.

• windows: возвращается ошибка ErrEventOverflow, если буфер заполнен (#525). Раньше возвращалась только ошибка «короткое чтение», что затрудняло обнаружение этой ошибки.

• kqueue: обеспечивается правильная доставка событий для всех файлов при удалении отслеживаемого каталога (#526). Ранее они отправлялись с пустой строкой (""), или точкой (".") в качестве имени пути.

• kqueue: не создаются ложные события создания для символических ссылок (#524). Ссылка будет разрешена, но kqueue «забудет», что он уже видел саму ссылку, что приведёт к событию Create для каждого события Write для каталога.

• all: возвращается ошибка ErrClosed при вызове Add(), когда наблюдатель закрыт (#516).

• other: добавлены Watcher.Errors и Watcher.Events к недействующему Watcher в backend_other.go, что упрощает использование на неподдерживаемых платформах, таких как WASM, AIX и т. д. (#528).

• other: используется файл backend_other.go без операций, если установлен тег сборки appengine; Google AppEngine запрещает использование небезопасного пакета, поэтому бэкэнд inotify там не компилируется.

1.6.0 — 2022-10-13

Эта версия fsnotify... Вот перевод текста на русский язык:

[1.5.1] - 2021-08-24

• Revert Add AddRaw, чтобы не следовать символическим ссылкам #394

[1.5.0] - 2021-08-20

• Go: увеличить минимальную требуемую версию до Go 1.12 #381
• Функция: добавить метод AddRaw, который не следует символическим ссылкам при добавлении часов наблюдения #289
• Windows: по умолчанию следовать символическим ссылкам, как и на всех других системах #289
• CI: использовать GitHub Actions для CI и охвата версий go 1.12–1.17 #378, #381, #385
• Go 1.14+: исправить небезопасное преобразование указателей #325

[1.4.9] - 2020-03-11

• Переместить пример использования в файл readme #329. Это может решить проблему #328.

[1.4.8] - 2020-03-10

• CI: протестировать больше версий Go (@nathany 1d13583d846ea9d66dcabbfefbfb9d8e6fb05216)
• Тесты: события inotify, поставленные в очередь, могли быть прочитаны тестом до того, как был достигнут max_queued_events (@matthias-stone #265)
• Тесты: t.Fatalf -> t.Errorf в горутинах (@gdey #266)
• CI: меньше многословности (@nathany #267)
• Тесты: Darwin: Exchangedata устарела на 10.13 (@nathany #267)
• Тесты: проверьте, закрыты ли каналы в примере (@alexeykazakov #244)
• CI: запускать golint только на последней версии Go и исправлять проблемы (@cpuguy83 #284)
• CI: добавить Windows в матрицу Travis (@cpuguy83 #284)
• Документы: удалить значок AppVeyor (@nathany 11844c0959f6fff69ba325d097fce35bd85a8e93)
• Linux: создать epoll и pipe fds с close-on-exec (@JohannesEbke #219)
• Linux: открывать файлы с close-on-exec (@linxiulei #273)
• Документы: план поддержки fanotify (@nathany ab058b44498e8b7566a799372a39d150d9ea0119 )
• Проект: добавить go.mod (@nathany #309)
• Проект: пересмотреть конфигурацию редактора (@nathany #309)
• Проект: обновить авторские права на 2019 год (@nathany #309)
• CI: исключить go1.8 из матрицы CI (@nathany #309)
• Документы: обновление раздела часто задаваемых вопросов о поддержке NFS & FUSE файловых систем (@Pratik32 4bf2d1fec78374803a39307bfb8d340688f4f28e )

[1.4.7] - 2018-01-09

• BSD/macOS: исправить возможную взаимоблокировку при закрытии наблюдателя на kqueue (спасибо @nhooyr и @glycerine)
• Тесты: исправить отсутствующий глагол в строке формата (спасибо @rchiossi)
• Linux: исправить взаимоблокировку в Remove (спасибо @aarondl)
• Linux: улучшения в Watch.Add (избежать гонки, исправить согласованность, уменьшить количество мусора) (спасибо @twpayne)
• Документы: перенесён раздел часто задаваемых вопросов в README (спасибо @vahe)
• Linux: правильно обрабатывать событие IN_Q_OVERFLOW в inotify (спасибо @zeldovich)
• Документы: заменить ссылки на OS X на macOS

[1.4.2] - 2016-10-10

• Linux: используйте InotifyInit1 с IN_CLOEXEC, чтобы остановить утечку файлового дескриптора дочернему процессу при использовании fork/exec #178 (спасибо @pattyshack)

[1.4.1] - 2016-10-04

• Исправить ненадёжный стресс-тест inotify на Linux #177 (спасибо @pattyshack)

[1.4.0] - 2016-10-01

• Добавить метод String() к Event.Op #165 (спасибо @oozie)

[1.3.1] - 2016-06-28

• Windows: исправление для двойной обратной косой черты при просмотре корня диска #151 (спасибо @brunoqc)

[1.3.0] - 2016-04-19

• Поддержка linux/arm64 путём исправления x/sys/unix и перехода на него с syscall (спасибо @suihkulokki) #135

[1.2.10] - 2016-03-02

• Fix golint errors in windows.go #121 (thanks @tiffanyfj)

[1.2.9] - 2016-01-13

kqueue: исправить логику для CREATE после REMOVE #111 (спасибо @bep)

[1.2.8] - 2015-12-17

• kqueue: исправить состояние гонки в Close #105 (спасибо @djui за сообщение об ошибке и @ppknap за написание неудачного теста)

• inotify: исправить ошибку в тесте

• включить режим гонки ### Дев / 2014-05-23

• [API] Удалить текущую реализацию WatchFlags.

  • Текущая реализация не использует преимущества ОС для повышения эффективности.
  • Обеспечивает небольшую выгоду по сравнению с фильтрацией событий по мере их поступления, но имеет дополнительную бухгалтерию и мьютексы.
  • Нет тестов для текущей реализации.
  • Не полностью реализован на Windows (#93).

[0.9.3] — 2014-12-31

• kqueue: очистка внутреннего наблюдения перед отправкой события удаления (#51).

[0.9.2] — 2014-08-17

• [Backport] Исправление пропущенных событий создания на macOS (#14) (спасибо @zhsso).

[0.9.1] — 2014-06-12

• Исправление гонки данных в буфере kevent (спасибо @tilaks) (#98).

[0.9.0] — 2014-01-17

• IsAttrib() для событий, которые касаются только метаданных файла (#79) (спасибо @abustany).
• [Исправление] kqueue: исправление взаимоблокировки (#77) (спасибо @cespare).
• [УВЕДОМЛЕНИЕ] Разработка перенесена на code.google.com/p/go.exp/fsnotify в рамках подготовки к включению в стандартную библиотеку Go.

[0.8.12] — 2013-11-13

• [API] Удаление FD_SET и друзей из адаптера Linux.

[0.8.11] — 2013-11-02

• [Док] Добавление Changelog (#72) (спасибо @nathany).
• [Док] Spotlight и двойные события изменения на macOS (#62) (сообщил @paulhammond).

[0.8.10] — 2013-10-19

• [Исправление] kqueue: удаление наблюдений за файлами при удалении родительского каталога (#71) (сообщил @mdwhatcott).
• [Исправление] kqueue: гонка между Close и readEvents (#70) (сообщил @bernerdschaefer).
• [Док] указание ограничений для конкретных ОС в README (спасибо @debrando).

[0.8.9] — 2013-09-08

• [Док] Вклад (спасибо @nathany).
• [Док] обновление пути пакета в примере кода (#63) (спасибо @paulhammond).
• [Док] Значок GoCI в README (только для Linux) (#60).
• [Док] Кроссплатформенное тестирование с Vagrant (#59) (спасибо @nathany).

[0.8.8] — 2013-06-17

• [Исправление] Windows: обработка ERROR_MORE_DATA в Windows (#49) (спасибо @jbowtie).

[0.8.7] — 2013-06-03

• [API] Сделать флаги системного вызова внутренними.
• [Исправление] inotify: игнорировать изменения событий.
• [Исправление] гонка в тесте на символическую ссылку (#45) (сообщил @srid).
• [Исправление] тесты на Windows.
• сообщения об ошибках в нижнем регистре.

[0.8.6] — 2013-05-23

• kqueue: использование флага EVT_ONLY на Darwin.
• [Док] Обновление README с полным примером.

[0.8.5] — 2013-05-09

• [Исправление] inotify: разрешить мониторинг «сломанных» символических ссылок (спасибо @tsg).

[0.8.4] — 2013-04-07

• [Исправление] kqueue: наблюдение за всеми событиями файлов (#40) (спасибо @ChrisBuchholz).

[0.8.3] — 2013-03-13

• [Исправление] утечка памяти inoitfy/kqueue (#36) (сообщил @nbkolchin).
• [Исправление] kqueue: использовать fsnFlags для наблюдения за каталогом (#33) (сообщил @nbkolchin).

[0.8.2] — 2013-02-07

• [Док] добавить авторов.
• [Исправление] исправить гонки данных для доступа к карте (#29) (спасибо @fsouza).

[0.8.1] — 2013-01-09

• [Исправление] разделители путей Windows.
• [Док] лицензия BSD.

[0.8.0] — 2012-11-09

• kqueue: улучшения наблюдения за каталогами (спасибо @vmirage).
• inotify: добавить IN_MOVED_TO (#25) (запрошено @cpisto).
• [Исправление] kqueue: удаление наблюдаемого каталога (#24) (сообщил @jakerr).

[0.7.4] — 2012-10-09

• [Исправление] inotify: исправления с https://codereview.appspot.com/5418045/ (ugorji).
• [Исправление] kqueue: сохранение флагов наблюдения при наблюдении за удалением (#21) (сообщено @robfig).
• [Исправление] kqueue: наблюдать за каталогом, даже если это не новое наблюдение (спасибо @robfig).
• [Исправление] kqueue: изменение после воссоздания файла.

[0.7.3] — 2012-09-27

• [Исправление] kqueue: наблюдение с существующей папкой внутри наблюдаемой папки (спасибо @vmirage).
• [Исправление] kqueue: больше не получать повторяющиеся события CREATE.

[0.7.2] — 2012-09-01

• kqueue: события для созданных каталогов.

[0.7.1] — 2012-07-14

• [Исправление] для переименования файлов.

[0.7.0] — 2012-07-02

• [Функция] Флаги FSNotify.
• [Исправление] inotify: добавлен путь к файлу обратно в путь события.

[0.6.0] — 2012-06-06

• kqueue: просмотр файлов после создания каталога (спасибо @tmc).

[0.5.1] — 2012-05-22

• [Исправление] inotify: удалить все наблюдения перед Close().

[0.5.0] — 2012-05-03

• [API] kqueue: возврат. Ошибки при watch вместо отправки по каналу:
• kqueue: поведение соответствия символической ссылке в Linux;
• inotify: добавить DELETE_SELF (запрошено @taralx);
• [Исправление] kqueue: обработать EINTR (сообщено @robfig);
• [Док.] Пример Godoc [#1].

[0.4.0] — 2012-03-30

• Выпущен Go 1: сборка с помощью инструмента go.
• [Функция] Поддержка Windows с использованием winfsnotify.
• В Windows нет уведомлений об изменении атрибутов, их нужно включить в IsModify.

[0.3.0] — 2012-02-19

• kqueue: добавлять файлы при наблюдении за каталогом.

[0.2.0] — 2011-12-30

• Обновление до последнего еженедельного кода Go.

[0.1.0] — 2011-10-19

• kqueue: наблюдение за созданием файла для соответствия inotify;
• kqueue: создание события файла;
• inotify: игнорировать события IN_IGNORED;
• event String();
• linux: общие функции FileEvent;
• первоначальный коммит.