1 ///////////////////////////////////////////////////////////////////////////////
2 // Name: tests/fswatcher/fswatchertest.cpp
3 // Purpose: wxFileSystemWatcher unit test
4 // Author: Bartosz Bekier
7 // Copyright: (c) 2009 Bartosz Bekier
8 ///////////////////////////////////////////////////////////////////////////////
10 // ----------------------------------------------------------------------------
12 // ----------------------------------------------------------------------------
20 #include "wx/evtloop.h"
21 #include "wx/filename.h"
22 #include "wx/filefn.h"
23 #include "wx/stdpaths.h"
24 #include "wx/fswatcher.h"
28 // ----------------------------------------------------------------------------
30 // ----------------------------------------------------------------------------
32 // class generating file system events
36 static EventGenerator
& Get()
39 ms_instance
= new EventGenerator(GetWatchDir());
44 EventGenerator(const wxFileName
& path
) : m_base(path
)
47 m_file
= RandomName();
54 wxFile
file(m_file
.GetFullPath(), wxFile
::write
);
55 return file
.IsOpened() && m_file
.FileExists();
60 CPPUNIT_ASSERT(m_file
.FileExists());
62 wxLogDebug("Renaming %s=>%s", m_file
.GetFullPath(), m_new
.GetFullPath());
64 bool ret
= wxRenameFile(m_file
.GetFullPath(), m_new
.GetFullPath());
77 CPPUNIT_ASSERT(m_file
.FileExists());
79 bool ret
= wxRemoveFile(m_file
.GetFullPath());
92 return m_file
.Touch();
97 wxFile
f(m_file
.GetFullPath());
98 CPPUNIT_ASSERT(f
.IsOpened());
101 ssize_t count
= f
.Read(buf
, sizeof(buf
));
102 CPPUNIT_ASSERT(count
> 0);
109 CPPUNIT_ASSERT(m_file
.FileExists());
111 wxFile
file(m_file
.GetFullPath(), wxFile
::write_append
);
112 CPPUNIT_ASSERT(file
.IsOpened());
114 CPPUNIT_ASSERT(file
.Write("Words of Wisdom, Lloyd. Words of wisdom\n"));
119 wxFileName
RandomName(int length
= 10)
121 return RandomName(m_base
, length
);
125 static const wxFileName
& GetWatchDir()
127 static wxFileName dir
;
132 wxString tmp
= wxStandardPaths
::Get().GetTempDir();
135 // XXX look for more unique name? there is no function to generate
136 // unique filename, the file always get created...
137 dir
.AppendDir("fswatcher_test");
138 CPPUNIT_ASSERT(!dir
.DirExists());
139 CPPUNIT_ASSERT(dir
.Mkdir());
144 static void RemoveWatchDir()
146 wxFileName dir
= GetWatchDir();
147 CPPUNIT_ASSERT(dir
.DirExists());
149 // just to be really sure we know what we remove
150 CPPUNIT_ASSERT_EQUAL( "fswatcher_test", dir
.GetDirs().Last() );
152 // FIXME-VC6: using non-static Rmdir() results in ICE
153 CPPUNIT_ASSERT( wxFileName
::Rmdir(dir
.GetFullPath(), wxPATH_RMDIR_RECURSIVE
) );
156 static wxFileName
RandomName(const wxFileName
& base
, int length
= 10)
158 static int ALFA_CNT
= 'z' - 'a';
161 for (int i
= 0 ; i
< length
; ++i
)
163 char c
= 'a' + (rand() % ALFA_CNT
);
167 return wxFileName(base
.GetFullPath(), s
);
171 wxFileName m_base
; // base dir for doing operations
172 wxFileName m_file
; // current file name
173 wxFileName m_old
; // previous file name
174 wxFileName m_new
; // name after renaming
177 static EventGenerator
* ms_instance
;
180 EventGenerator
* EventGenerator
::ms_instance
= 0;
183 // custom event handler
184 class EventHandler
: public wxEvtHandler
187 enum { WAIT_DURATION
= 3 };
190 eg(EventGenerator
::Get()), m_loop(0), m_count(0), m_watcher(0)
192 m_loop
= new wxEventLoop();
193 Connect(wxEVT_IDLE
, wxIdleEventHandler(EventHandler
::OnIdle
));
194 Connect(wxEVT_FSWATCHER
, wxFileSystemWatcherEventHandler(
195 EventHandler
::OnFileSystemEvent
));
198 virtual ~EventHandler()
203 if (m_loop
->IsRunning())
214 // sends idle event, so we get called in a moment
217 wxIdleEvent
* e
= new wxIdleEvent();
227 void OnIdle(wxIdleEvent
& /*evt*/)
229 bool more
= Action();
238 // returns whether we should produce more idle events
239 virtual bool Action()
244 CPPUNIT_ASSERT(Init());
251 CPPUNIT_ASSERT(CheckResult());
255 // TODO a mechanism that will break the loop in case we
256 // don't receive a file system event
257 // this below doesn't quite work, so all tests must pass :-)
262 CPPUNIT_ASSERT(KeepWaiting());
268 CPPUNIT_ASSERT(AfterWait());
271 } // switch (m_count)
278 // test we're good to go
279 CPPUNIT_ASSERT(wxEventLoopBase
::GetActive());
281 // XXX only now can we construct Watcher, because we need
283 m_watcher
= new wxFileSystemWatcher();
284 m_watcher
->SetOwner(this);
286 // add dir to be watched
287 wxFileName dir
= EventGenerator
::GetWatchDir();
288 CPPUNIT_ASSERT(m_watcher
->Add(dir
, wxFSW_EVENT_ALL
));
293 virtual bool KeepWaiting()
295 // did we receive event already?
298 // well, lets wait a bit more
299 wxSleep(WAIT_DURATION
);
305 virtual bool AfterWait()
307 // fail if still no events
311 s
.Printf("No events from watcher during %d seconds!",
313 CPPUNIT_FAIL((const char*)s
);
319 virtual void OnFileSystemEvent(wxFileSystemWatcherEvent
& evt
)
321 wxLogDebug("--- %s ---", evt
.ToString());
322 m_lastEvent
= wxDynamicCast(evt
.Clone(), wxFileSystemWatcherEvent
);
323 m_events
.Add(m_lastEvent
);
330 virtual bool CheckResult()
332 CPPUNIT_ASSERT_EQUAL( 1, m_events
.size() );
333 const wxFileSystemWatcherEvent
* const e
= m_events
.front();
335 // this is our "reference event"
336 const wxFileSystemWatcherEvent expected
= ExpectedEvent();
338 CPPUNIT_ASSERT_EQUAL( expected
.GetChangeType(), e
->GetChangeType() );
340 CPPUNIT_ASSERT_EQUAL((int)wxEVT_FSWATCHER
, e
->GetEventType());
342 // XXX this needs change
343 CPPUNIT_ASSERT_EQUAL(wxEVT_CATEGORY_UNKNOWN
, e
->GetEventCategory());
345 CPPUNIT_ASSERT_EQUAL(expected
.GetPath(), e
->GetPath());
346 CPPUNIT_ASSERT_EQUAL(expected
.GetNewPath(), e
->GetNewPath());
347 CPPUNIT_ASSERT_EQUAL(expected
.GetChangeType(), e
->GetChangeType());
352 virtual void GenerateEvent() = 0;
354 virtual wxFileSystemWatcherEvent
ExpectedEvent() = 0;
359 wxEventLoopBase
* m_loop
; // loop reference
360 int m_count
; // idle events count
362 wxFileSystemWatcher
* m_watcher
;
363 bool tested
; // indicates, whether we have already passed the test
365 #include "wx/arrimpl.cpp"
366 WX_DEFINE_ARRAY_PTR(wxFileSystemWatcherEvent
*, wxArrayEvent
);
367 wxArrayEvent m_events
;
368 wxFileSystemWatcherEvent
* m_lastEvent
;
372 // ----------------------------------------------------------------------------
374 // ----------------------------------------------------------------------------
376 class FileSystemWatcherTestCase
: public CppUnit
::TestCase
379 FileSystemWatcherTestCase() { }
381 virtual void setUp();
382 virtual void tearDown();
385 wxEventLoopBase
* m_loop
;
388 CPPUNIT_TEST_SUITE( FileSystemWatcherTestCase
);
389 CPPUNIT_TEST( TestEventCreate
);
390 CPPUNIT_TEST( TestEventDelete
);
392 // kqueue-based implementation doesn't collapse create/delete pairs in
393 // renames and doesn't detect neither modifications nor access to the
394 // files reliably currently so disable these tests
396 // FIXME: fix the code and reenable them
398 CPPUNIT_TEST( TestEventRename
);
399 CPPUNIT_TEST( TestEventModify
);
401 // MSW implementation doesn't detect file access events currently
403 CPPUNIT_TEST( TestEventAccess
);
405 #endif // !wxHAS_KQUEUE
406 CPPUNIT_TEST_SUITE_END();
408 void TestEventCreate();
409 void TestEventDelete();
410 void TestEventRename();
411 void TestEventModify();
412 void TestEventAccess();
414 DECLARE_NO_COPY_CLASS(FileSystemWatcherTestCase
)
417 // register in the unnamed registry so that these tests are run by default
418 CPPUNIT_TEST_SUITE_REGISTRATION( FileSystemWatcherTestCase
);
420 // also include in it's own registry so that these tests can be run alone
421 CPPUNIT_TEST_SUITE_NAMED_REGISTRATION( FileSystemWatcherTestCase
,
422 "FileSystemWatcherTestCase" );
424 void FileSystemWatcherTestCase
::setUp()
426 wxLog
::AddTraceMask(wxTRACE_FSWATCHER
);
427 EventGenerator
::Get().GetWatchDir();
430 void FileSystemWatcherTestCase
::tearDown()
432 EventGenerator
::Get().RemoveWatchDir();
435 // ----------------------------------------------------------------------------
437 // ----------------------------------------------------------------------------
438 void FileSystemWatcherTestCase
::TestEventCreate()
440 wxLogDebug("TestEventCreate()");
442 class EventTester
: public EventHandler
445 virtual void GenerateEvent()
447 CPPUNIT_ASSERT(eg
.CreateFile());
450 virtual wxFileSystemWatcherEvent
ExpectedEvent()
452 wxFileSystemWatcherEvent
event(wxFSW_EVENT_CREATE
);
453 event
.SetPath(eg
.m_file
);
454 event
.SetNewPath(eg
.m_file
);
461 wxLogTrace(wxTRACE_FSWATCHER
, "TestEventCreate tester created()");
466 // ----------------------------------------------------------------------------
468 // ----------------------------------------------------------------------------
469 void FileSystemWatcherTestCase
::TestEventDelete()
471 wxLogDebug("TestEventDelete()");
473 class EventTester
: public EventHandler
476 virtual void GenerateEvent()
478 CPPUNIT_ASSERT(eg
.DeleteFile());
481 virtual wxFileSystemWatcherEvent
ExpectedEvent()
483 wxFileSystemWatcherEvent
event(wxFSW_EVENT_DELETE
);
484 event
.SetPath(eg
.m_old
);
486 // CHECK maybe new path here could be NULL or sth?
487 event
.SetNewPath(eg
.m_old
);
492 // we need to create a file now, so we can delete it
493 EventGenerator
::Get().CreateFile();
499 // ----------------------------------------------------------------------------
501 // ----------------------------------------------------------------------------
502 void FileSystemWatcherTestCase
::TestEventRename()
504 wxLogDebug("TestEventRename()");
506 class EventTester
: public EventHandler
509 virtual void GenerateEvent()
511 CPPUNIT_ASSERT(eg
.RenameFile());
514 virtual wxFileSystemWatcherEvent
ExpectedEvent()
516 wxFileSystemWatcherEvent
event(wxFSW_EVENT_RENAME
);
517 event
.SetPath(eg
.m_old
);
518 event
.SetNewPath(eg
.m_file
);
523 // need a file to rename later
524 EventGenerator
::Get().CreateFile();
530 // ----------------------------------------------------------------------------
532 // ----------------------------------------------------------------------------
533 void FileSystemWatcherTestCase
::TestEventModify()
535 wxLogDebug("TestEventModify()");
537 class EventTester
: public EventHandler
540 virtual void GenerateEvent()
542 CPPUNIT_ASSERT(eg
.ModifyFile());
545 virtual wxFileSystemWatcherEvent
ExpectedEvent()
547 wxFileSystemWatcherEvent
event(wxFSW_EVENT_MODIFY
);
548 event
.SetPath(eg
.m_file
);
549 event
.SetNewPath(eg
.m_file
);
554 // we need to create a file to modify
555 EventGenerator
::Get().CreateFile();
561 // ----------------------------------------------------------------------------
563 // ----------------------------------------------------------------------------
564 void FileSystemWatcherTestCase
::TestEventAccess()
566 wxLogDebug("TestEventAccess()");
568 class EventTester
: public EventHandler
571 virtual void GenerateEvent()
573 CPPUNIT_ASSERT(eg
.ReadFile());
576 virtual wxFileSystemWatcherEvent
ExpectedEvent()
578 wxFileSystemWatcherEvent
event(wxFSW_EVENT_ACCESS
);
579 event
.SetPath(eg
.m_file
);
580 event
.SetNewPath(eg
.m_file
);
585 // we need to create a file to read from it and write sth to it
586 EventGenerator
::Get().CreateFile();
587 EventGenerator
::Get().ModifyFile();