├── .gitattributes
├── src
    ├── main.cpp
    ├── filesystem.cpp
    ├── binaryio.h
    └── filesystem.h
├── .gitignore
├── vc12
    ├── detfc.sln
    ├── detfc.vcxproj.filters
    └── detfc.vcxproj
├── license.txt
└── readme.org


/.gitattributes:
--------------------------------------------------------------------------------
1 | readme.org encoding=utf-8
2 | 


--------------------------------------------------------------------------------
/src/main.cpp:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/misohena/detfc/master/src/main.cpp


--------------------------------------------------------------------------------
/src/filesystem.cpp:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/misohena/detfc/master/src/filesystem.cpp


--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
 1 | *~
 2 | *.ncb
 3 | *.suo
 4 | *.vcproj.*.user
 5 | *.sdf
 6 | *.opensdf
 7 | *.vcxproj.user
 8 | vc12/Debug/
 9 | vc12/Release/
10 | 


--------------------------------------------------------------------------------
/vc12/detfc.sln:
--------------------------------------------------------------------------------
 1 | 
 2 | Microsoft Visual Studio Solution File, Format Version 12.00
 3 | # Visual Studio 2012
 4 | Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "detfc", "detfc.vcxproj", "{E4D68FED-9009-461A-9232-0C3ECA6734C2}"
 5 | EndProject
 6 | Global
 7 | 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 8 | 		Debug|Win32 = Debug|Win32
 9 | 		Release|Win32 = Release|Win32
10 | 	EndGlobalSection
11 | 	GlobalSection(ProjectConfigurationPlatforms) = postSolution
12 | 		{E4D68FED-9009-461A-9232-0C3ECA6734C2}.Debug|Win32.ActiveCfg = Debug|Win32
13 | 		{E4D68FED-9009-461A-9232-0C3ECA6734C2}.Debug|Win32.Build.0 = Debug|Win32
14 | 		{E4D68FED-9009-461A-9232-0C3ECA6734C2}.Release|Win32.ActiveCfg = Release|Win32
15 | 		{E4D68FED-9009-461A-9232-0C3ECA6734C2}.Release|Win32.Build.0 = Release|Win32
16 | 	EndGlobalSection
17 | 	GlobalSection(SolutionProperties) = preSolution
18 | 		HideSolutionNode = FALSE
19 | 	EndGlobalSection
20 | EndGlobal
21 | 


--------------------------------------------------------------------------------
/license.txt:
--------------------------------------------------------------------------------
 1 | The MIT License (MIT)
 2 | Copyright (c) 2014 AKIYAMA Kouhei
 3 | Permission is hereby granted, free of charge, to any person obtaining a copy
 4 | of this software and associated documentation files (the "Software"), to deal
 5 | in the Software without restriction, including without limitation the rights
 6 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 7 | copies of the Software, and to permit persons to whom the Software is
 8 | furnished to do so, subject to the following conditions:
 9 | The above copyright notice and this permission notice shall be included in all
10 | copies or substantial portions of the Software.
11 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
12 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
13 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
14 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
15 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
16 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
17 | SOFTWARE.
18 | 


--------------------------------------------------------------------------------
/src/binaryio.h:
--------------------------------------------------------------------------------
 1 | #ifndef DETFC_BINARYIO_H_INCLUDED
 2 | #define DETFC_BINARYIO_H_INCLUDED
 3 | 
 4 | #include <istream>
 5 | #include <ostream>
 6 | 
 7 | namespace detfc{
 8 | 
 9 | // Binary I/O
10 | 
11 | template<typename T>
12 | void writeBinary(std::ostream &os, const T &v)
13 | {
14 | 	os.write(reinterpret_cast<const char *>(&v), sizeof(v));
15 | }
16 | 
17 | template<typename T>
18 | T readBinary(std::istream &is)
19 | {
20 | 	T v = T();
21 | 	is.read(reinterpret_cast<char *>(&v), sizeof(v));
22 | 	return v;
23 | }
24 | 
25 | void writeStringBinary(std::ostream &os, std::string &v)
26 | {
27 | 	writeBinary(os, v.size());
28 | 	os.write(v.data(), v.size());
29 | }
30 | 
31 | std::string readStringBinary(std::istream &is)
32 | {
33 | 	typedef char CHAR;
34 | 	const std::size_t size = readBinary<std::size_t>(is);
35 | 	if (!is){
36 | 		return std::string();
37 | 	}
38 | 	if (size == 0){
39 | 		return std::string();
40 | 	}
41 | 	const std::size_t MAX_CHARS = 1024;
42 | 	if (size <= MAX_CHARS){
43 | 		CHAR buf[MAX_CHARS];
44 | 		is.read(buf, size);
45 | 		return std::string(buf, buf + size);
46 | 	}
47 | 	else{
48 | 		std::unique_ptr<CHAR[]> buf(new CHAR[size]);
49 | 		is.read(buf.get(), size);
50 | 		return std::string(buf.get(), buf.get() + size);
51 | 	}
52 | }
53 | 
54 | }//namespace detfc
55 | #endif
56 | 


--------------------------------------------------------------------------------
/vc12/detfc.vcxproj.filters:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="utf-8"?>
 2 | <Project ToolsVersion="4.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
 3 |   <ItemGroup>
 4 |     <Filter Include="ソース ファイル">
 5 |       <UniqueIdentifier>{4FC737F1-C7A5-4376-A066-2A32D752A2FF}</UniqueIdentifier>
 6 |       <Extensions>cpp;c;cc;cxx;def;odl;idl;hpj;bat;asm;asmx</Extensions>
 7 |     </Filter>
 8 |     <Filter Include="ヘッダー ファイル">
 9 |       <UniqueIdentifier>{93995380-89BD-4b04-88EB-625FBE52EBFB}</UniqueIdentifier>
10 |       <Extensions>h;hpp;hxx;hm;inl;inc;xsd</Extensions>
11 |     </Filter>
12 |     <Filter Include="リソース ファイル">
13 |       <UniqueIdentifier>{67DA6AB6-F800-4c08-8B7A-83BB121AAD01}</UniqueIdentifier>
14 |       <Extensions>rc;ico;cur;bmp;dlg;rc2;rct;bin;rgs;gif;jpg;jpeg;jpe;resx;tiff;tif;png;wav;mfcribbon-ms</Extensions>
15 |     </Filter>
16 |   </ItemGroup>
17 |   <ItemGroup>
18 |     <ClCompile Include="..\src\main.cpp">
19 |       <Filter>ソース ファイル</Filter>
20 |     </ClCompile>
21 |     <ClCompile Include="..\src\filesystem.cpp">
22 |       <Filter>ソース ファイル</Filter>
23 |     </ClCompile>
24 |   </ItemGroup>
25 |   <ItemGroup>
26 |     <ClInclude Include="..\src\filesystem.h">
27 |       <Filter>ヘッダー ファイル</Filter>
28 |     </ClInclude>
29 |     <ClInclude Include="..\src\binaryio.h">
30 |       <Filter>ヘッダー ファイル</Filter>
31 |     </ClInclude>
32 |   </ItemGroup>
33 | </Project>


--------------------------------------------------------------------------------
/src/filesystem.h:
--------------------------------------------------------------------------------
 1 | #ifndef DETFC_FILESYSTEM_H_INCLUDED
 2 | #define DETFC_FILESYSTEM_H_INCLUDED
 3 | 
 4 | #include <string>
 5 | #include <memory>
 6 | #include <cstdint>
 7 | 
 8 | namespace detfc{
 9 | 
10 | typedef char PathChar;
11 | typedef std::string PathString;
12 | #define PATH_CHAR_L(x) x
13 | 
14 | // File Name
15 | 
16 | PathString getPathFileNamePart(const PathString &s);
17 | PathString getPathNotFileNamePart(const PathString &s);
18 | bool isPathTerminatedByRedundantSeparator(const PathString &s);
19 | PathString getPathWithoutLastRedundantSeparator(const PathString &s);
20 | PathString getPathDirectoryPart(const PathString &s);
21 | PathString concatPath(const PathString &a, const PathString &b);
22 | 
23 | // Directory Entry
24 | 
25 | enum FileType
26 | {
27 | 	FILETYPE_ERROR,
28 | 	FILETYPE_REGULAR,
29 | 	FILETYPE_DIRECTORY
30 | };
31 | typedef std::uint64_t FileTime;
32 | typedef std::uint64_t FileSize;
33 | 
34 | class DirectoryEntry
35 | {
36 | 	PathString dir_;
37 | 	PathString filename_;
38 | 	FileType type_;
39 | 	FileSize size_;
40 | 	FileTime lastWriteTime_;
41 | public:
42 | 	DirectoryEntry(
43 | 		const PathString &dir = PathString(),
44 | 		const PathString &filename = PathString(),
45 | 		FileType type = FILETYPE_ERROR,
46 | 		FileSize size = 0,
47 | 		FileTime lastWriteTime = 0)
48 | 		: dir_(dir), filename_(filename), type_(type), size_(size), lastWriteTime_(lastWriteTime){}
49 | 	PathString getPath() const { return concatPath(dir_, filename_);}
50 | 	PathString getFilename() const { return filename_;}
51 | 	FileTime getLastWriteTime() const { return lastWriteTime_;}
52 | 	FileSize getFileSize() const { return size_;}
53 | 	FileType getFileType() const { return type_;}
54 | 	bool isDirectory() const { return type_ == FILETYPE_DIRECTORY;}
55 | 	bool isRegularFile() const { return type_ == FILETYPE_REGULAR;}
56 | 
57 | 	void assign(const PathString &filename, FileType type, FileSize size, FileTime lastWriteTime)
58 | 	{
59 | 		filename_ = filename;
60 | 		type_ = type;
61 | 		size_ = size;
62 | 		lastWriteTime_ = lastWriteTime;
63 | 	}
64 | };
65 | 
66 | class DirectoryEntryEnumerator
67 | {
68 | 	class Impl;
69 | 	std::shared_ptr<Impl> impl_;
70 | public:
71 | 	DirectoryEntryEnumerator(const PathString &dir);
72 | 	~DirectoryEntryEnumerator();
73 | 	const DirectoryEntry &getEntry() const;
74 | 	void increment();
75 | 	bool isEnd() const;
76 | };
77 | 
78 | 
79 | // File Operation
80 | 
81 | FileType getPathFileType(const PathString &p);
82 | bool isPathExists(const PathString &p);
83 | bool isPathDirectory(const PathString &p);
84 | bool isPathRegularFile(const PathString &p);
85 | DirectoryEntry getPathDirectoryEntry(const PathString &p);
86 | FileTime getPathLastWriteTime(const PathString &p);
87 | FileTime getPathFileSize(const PathString &p);
88 | 
89 | 
90 | }//namespace detfc
91 | #endif
92 | 


--------------------------------------------------------------------------------
/readme.org:
--------------------------------------------------------------------------------
 1 | Detect File Change
 2 | 
 3 | * 概要
 4 | detfcはファイルやディレクトリの変化を検出するコマンドラインツールです。
 5 | 変化を検出したら、記録ファイルを更新したり、任意のコマンドを実行したりします。
 6 | 
 7 | * コマンドライン
 8 | 
 9 | #+BEGIN_QUOTE
10 | detfc [<option> | <target>]...
11 | #+END_QUOTE
12 | 
13 | - /target/ :: チェック対象とするファイルまたはディレクトリです。
14 | - /option/ ::
15 |   - -db /DB filename/ :: 変化を調べるのに必要なデータを格納するファイルへのパスです。存在しない場合は新しく作成します。変化を検出したときのみ書き換えます。このオプションは必須です。
16 |   - -r :: /target/ にディレクトリが指定されている場合、その子孫エントリを再帰的に調べてチェック対象に加えます。
17 |   - -d :: ディレクトリ自身をチェック対象に加えます。ディレクトリの更新日時を考慮します。
18 |   - -ext /suffix/ :: チェック対象とするファイルの接尾辞です。複数指定できます。指定しなかった場合は全てのファイルがチェック対象となります。
19 |   - -e /command/ :: 変化を検出したときに実行するコマンドです。コマンドが0以外の終了ステータスで終了したとき、detfcは失敗の終了ステータスで即時終了します。そのとき、-bが指定されていない場合DBは更新されません。
20 |   - -m /checking-method-name/ :: 変化検出アルゴリズムの名前です。デフォルトは2です。
21 |   - -v :: 冗長なメッセージを出力します。変化を検出したときに何が変化したかを表示します。
22 |   - -b :: 変化を検出したとき、-eで指定したコマンドを実行する前にDBファイルを書き出します(デフォルトは実行した後)。
23 |   - -i :: -eで指定したコマンドが失敗しても処理を続行します。デフォルトはコマンドが失敗した段階でdetfcは失敗の終了ステータスで終了します(-bが指定されていない場合DBは更新されません)。
24 |   - -nw :: DBファイルの書き出しを抑制します。-vと合わせることで変化しているかをメッセージで確認できます。
25 | 
26 | * 変化検出アルゴリズム
27 | - 0 または fast :: DBファイルの更新日時より新しい更新日時を持つチェック対象が一つでもあるかどうかを調べます。
28 |                    変化を検出した場合、DBファイルの更新日時を発見した日時へ更新します。
29 |                    一つでも見つかったら処理を打ち切るため、最も高速です。
30 | - 1 または dirsummary :: ディレクトリ毎にその直下にあるチェック対象の数、ファイルサイズの合計、最も新しいチェック対象の更新日時を求め、それが変化しているかを調べます。
31 |      ただし、コマンドラインで直接指定したチェック対象(トップレベルターゲット)は、一つのディレクトリの下に存在するものとして扱います。
32 |      変化を検出した場合、DBファイルには求めたディレクトリ毎の情報を書き出します。
33 | - 2 または filestat :: チェック対象毎の更新日時、ファイルサイズ、ファイルタイプが変化しているか、また、以前存在していたチェック対象が無くなっているかどうか、また、以前存在しなかったチェック対象が存在するかどうかを調べます。
34 |      変化を検出した場合、DBファイルには全チェック対象のファイル情報を出力します。
35 | 
36 | - (未対応) :: filestatに加え、ファイル内容のMD5を調べます。
37 | 
38 | | method | 速度 | DBファイル容量                       | 削除検出 | 追加検出       | 更新日時検出                                   | ファイルサイズ変化検出         | 名前の変化検出                         |
39 | |--------+------+--------------------------------------+----------+----------------+------------------------------------------------+--------------------------------+----------------------------------------+
40 | |      0 | 速   | なし(0)                              | できない | 更新日時による | DBファイルより新しい場合のみ検出               | しない                         | できない                               |
41 | |      1 | 中   | 再帰的に検出したディレクトリ数に比例 | 不正確   | 不正確         | ディレクトリ毎の過去の最新と異なる場合のみ検出 | ディレクトリ毎の総サイズの一致 | 再帰的に検出したディレクトリのみできる |
42 | |      2 | 遅   | チェック対象数に比例                 | 正確     | 正確           | チェック対象毎の不一致を検出                   | チェック対象ごとの一致         | できる                                 |
43 | 
44 | * 変化検出後のコマンド実行とDBファイル書き換えタイミングについて
45 | 
46 | detfcは変化を検出したとき次の処理を行います。
47 | 
48 | - -eコマンド実行 :: -eで指定されているコマンドを実行します。
49 |                     コマンドが失敗の終了ステータスを返した場合、detfcも失敗の終了ステータスを返して即時終了します。
50 |                     このとき、-bが指定されていない場合はDBファイルは書き換えられません(状況に変化が無ければ、次回も再度同じ変化を検出します)。
51 | - DBファイル書き換え ::
52 |   - -nwが指定されている場合は書き換えません。
53 |   - -bが指定されている場合は-eコマンド実行の前に書き換えます。-eで指定されているコマンドが失敗しても確実に書き換えます。
54 | 


--------------------------------------------------------------------------------
/vc12/detfc.vcxproj:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="utf-8"?>
 2 | <Project DefaultTargets="Build" ToolsVersion="12.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
 3 |   <ItemGroup Label="ProjectConfigurations">
 4 |     <ProjectConfiguration Include="Debug|Win32">
 5 |       <Configuration>Debug</Configuration>
 6 |       <Platform>Win32</Platform>
 7 |     </ProjectConfiguration>
 8 |     <ProjectConfiguration Include="Release|Win32">
 9 |       <Configuration>Release</Configuration>
10 |       <Platform>Win32</Platform>
11 |     </ProjectConfiguration>
12 |   </ItemGroup>
13 |   <PropertyGroup Label="Globals">
14 |     <ProjectGuid>{E4D68FED-9009-461A-9232-0C3ECA6734C2}</ProjectGuid>
15 |     <Keyword>Win32Proj</Keyword>
16 |     <RootNamespace>detfc</RootNamespace>
17 |   </PropertyGroup>
18 |   <Import Project="$(VCTargetsPath)\Microsoft.Cpp.Default.props" />
19 |   <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'" Label="Configuration">
20 |     <ConfigurationType>Application</ConfigurationType>
21 |     <UseDebugLibraries>true</UseDebugLibraries>
22 |     <PlatformToolset>v120_xp</PlatformToolset>
23 |     <CharacterSet>MultiByte</CharacterSet>
24 |   </PropertyGroup>
25 |   <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|Win32'" Label="Configuration">
26 |     <ConfigurationType>Application</ConfigurationType>
27 |     <UseDebugLibraries>false</UseDebugLibraries>
28 |     <PlatformToolset>v120_xp</PlatformToolset>
29 |     <WholeProgramOptimization>true</WholeProgramOptimization>
30 |     <CharacterSet>MultiByte</CharacterSet>
31 |   </PropertyGroup>
32 |   <Import Project="$(VCTargetsPath)\Microsoft.Cpp.props" />
33 |   <ImportGroup Label="ExtensionSettings">
34 |   </ImportGroup>
35 |   <ImportGroup Label="PropertySheets" Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">
36 |     <Import Project="$(UserRootDir)\Microsoft.Cpp.$(Platform).user.props" Condition="exists('$(UserRootDir)\Microsoft.Cpp.$(Platform).user.props')" Label="LocalAppDataPlatform" />
37 |   </ImportGroup>
38 |   <ImportGroup Label="PropertySheets" Condition="'$(Configuration)|$(Platform)'=='Release|Win32'">
39 |     <Import Project="$(UserRootDir)\Microsoft.Cpp.$(Platform).user.props" Condition="exists('$(UserRootDir)\Microsoft.Cpp.$(Platform).user.props')" Label="LocalAppDataPlatform" />
40 |   </ImportGroup>
41 |   <PropertyGroup Label="UserMacros" />
42 |   <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">
43 |     <LinkIncremental>true</LinkIncremental>
44 |   </PropertyGroup>
45 |   <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|Win32'">
46 |     <LinkIncremental>false</LinkIncremental>
47 |   </PropertyGroup>
48 |   <ItemDefinitionGroup Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">
49 |     <ClCompile>
50 |       <PrecompiledHeader>
51 |       </PrecompiledHeader>
52 |       <WarningLevel>Level3</WarningLevel>
53 |       <Optimization>Disabled</Optimization>
54 |       <PreprocessorDefinitions>WIN32;_DEBUG;_CONSOLE;%(PreprocessorDefinitions)</PreprocessorDefinitions>
55 |       <RuntimeLibrary>MultiThreadedDebug</RuntimeLibrary>
56 |     </ClCompile>
57 |     <Link>
58 |       <SubSystem>Console</SubSystem>
59 |       <GenerateDebugInformation>true</GenerateDebugInformation>
60 |     </Link>
61 |   </ItemDefinitionGroup>
62 |   <ItemDefinitionGroup Condition="'$(Configuration)|$(Platform)'=='Release|Win32'">
63 |     <ClCompile>
64 |       <WarningLevel>Level3</WarningLevel>
65 |       <PrecompiledHeader>
66 |       </PrecompiledHeader>
67 |       <Optimization>MaxSpeed</Optimization>
68 |       <FunctionLevelLinking>true</FunctionLevelLinking>
69 |       <IntrinsicFunctions>true</IntrinsicFunctions>
70 |       <PreprocessorDefinitions>WIN32;NDEBUG;_CONSOLE;%(PreprocessorDefinitions)</PreprocessorDefinitions>
71 |       <RuntimeLibrary>MultiThreaded</RuntimeLibrary>
72 |     </ClCompile>
73 |     <Link>
74 |       <SubSystem>Console</SubSystem>
75 |       <GenerateDebugInformation>true</GenerateDebugInformation>
76 |       <EnableCOMDATFolding>true</EnableCOMDATFolding>
77 |       <OptimizeReferences>true</OptimizeReferences>
78 |     </Link>
79 |   </ItemDefinitionGroup>
80 |   <ItemGroup>
81 |     <ClCompile Include="..\src\filesystem.cpp" />
82 |     <ClCompile Include="..\src\main.cpp" />
83 |   </ItemGroup>
84 |   <ItemGroup>
85 |     <ClInclude Include="..\src\binaryio.h" />
86 |     <ClInclude Include="..\src\filesystem.h" />
87 |   </ItemGroup>
88 |   <Import Project="$(VCTargetsPath)\Microsoft.Cpp.targets" />
89 |   <ImportGroup Label="ExtensionTargets">
90 |   </ImportGroup>
91 | </Project>


--------------------------------------------------------------------------------