Rietveld Code Review Tool
Help | Bug tracker | Discussion group | Source code

Side by Side Diff: include/AdblockPlus/FileSystem.h

Issue 29449592: Issue 5183 - Provide async interface for FileSystem (Closed) Base URL: https://hg.adblockplus.org/libadblockplus/
Patch Set: Rebased on https://codereview.adblockplus.org/29481704 Created July 6, 2017, 10:40 p.m.
Left:
Right:
Use n/p to move between diff chunks; N/P to move between comments.
Jump to:
View unified diff | Download patch
OLDNEW
1 /* 1 /*
2 * This file is part of Adblock Plus <https://adblockplus.org/>, 2 * This file is part of Adblock Plus <https://adblockplus.org/>,
3 * Copyright (C) 2006-2017 eyeo GmbH 3 * Copyright (C) 2006-2017 eyeo GmbH
4 * 4 *
5 * Adblock Plus is free software: you can redistribute it and/or modify 5 * Adblock Plus is free software: you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License version 3 as 6 * it under the terms of the GNU General Public License version 3 as
7 * published by the Free Software Foundation. 7 * published by the Free Software Foundation.
8 * 8 *
9 * Adblock Plus is distributed in the hope that it will be useful, 9 * Adblock Plus is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of 10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 * GNU General Public License for more details. 12 * GNU General Public License for more details.
13 * 13 *
14 * You should have received a copy of the GNU General Public License 14 * You should have received a copy of the GNU General Public License
15 * along with Adblock Plus. If not, see <http://www.gnu.org/licenses/>. 15 * along with Adblock Plus. If not, see <http://www.gnu.org/licenses/>.
16 */ 16 */
17 17
18 #ifndef ADBLOCK_PLUS_FILE_SYSTEM_H 18 #ifndef ADBLOCK_PLUS_FILE_SYSTEM_H
19 #define ADBLOCK_PLUS_FILE_SYSTEM_H 19 #define ADBLOCK_PLUS_FILE_SYSTEM_H
20 20
21 #include <istream> 21 #include <istream>
22 #include <stdint.h> 22 #include <stdint.h>
23 #include <string> 23 #include <string>
24 #include <memory> 24 #include <memory>
25 25
26 #include "IFileSystem.h"
27
26 namespace AdblockPlus 28 namespace AdblockPlus
27 { 29 {
28 /** 30 /**
29 * File system interface. 31 * File system interface.
30 */ 32 */
31 class FileSystem 33 class FileSystem
32 { 34 {
33 public: 35 public:
34 /**
35 * Result of a stat operation, i.e.\ information about a file.
36 */
37 struct StatResult
38 {
39 StatResult()
40 {
41 exists = false;
42 isDirectory = false;
43 isFile = false;
44 lastModified = 0;
45 }
46
47 /**
48 * File exists.
49 */
50 bool exists;
51
52 /**
53 * File is a directory.
54 */
55 bool isDirectory;
56
57 /**
58 * File is a regular file.
59 */
60 bool isFile;
61
62 /**
63 * POSIX time of the last modification.
64 */
65 int64_t lastModified;
66 };
67
68 typedef std::vector<uint8_t> IOBuffer;
69
70 virtual ~FileSystem() {} 36 virtual ~FileSystem() {}
71 37
72 /** 38 /**
73 * Reads from a file. 39 * Reads from a file.
74 * @param path File path. 40 * @param path File path.
75 * @return Buffer with the file content. 41 * @return Buffer with the file content.
76 */ 42 */
77 virtual IOBuffer 43 virtual IFileSystem::IOBuffer
78 Read(const std::string& path) const = 0; 44 Read(const std::string& path) const = 0;
79 45
80 /** 46 /**
81 * Writes to a file. 47 * Writes to a file.
82 * @param path File path. 48 * @param path File path.
83 * @param data Buffer with the data to write. 49 * @param data Buffer with the data to write.
84 */ 50 */
85 virtual void Write(const std::string& path, 51 virtual void Write(const std::string& path,
86 const IOBuffer& data) = 0; 52 const IFileSystem::IOBuffer& data) = 0;
87 53
88 /** 54 /**
89 * Moves a file (i.e.\ renames it). 55 * Moves a file (i.e.\ renames it).
90 * @param fromPath Current path to the file. 56 * @param fromPath Current path to the file.
91 * @param toPath New path to the file. 57 * @param toPath New path to the file.
92 */ 58 */
93 virtual void Move(const std::string& fromPath, 59 virtual void Move(const std::string& fromPath,
94 const std::string& toPath) = 0; 60 const std::string& toPath) = 0;
95 61
96 /** 62 /**
97 * Removes a file. 63 * Removes a file.
98 * @param path File path. 64 * @param path File path.
99 */ 65 */
100 virtual void Remove(const std::string& path) = 0; 66 virtual void Remove(const std::string& path) = 0;
101 67
102 /** 68 /**
103 * Retrieves information about a file. 69 * Retrieves information about a file.
104 * @param path File path. 70 * @param path File path.
105 * @return File information. 71 * @return File information.
106 */ 72 */
107 virtual StatResult Stat(const std::string& path) const = 0; 73 virtual IFileSystem::StatResult Stat(const std::string& path) const = 0;
108 74
109 /** 75 /**
110 * Returns the absolute path to a file. 76 * Returns the absolute path to a file.
111 * @param path File path (can be relative or absolute). 77 * @param path File path (can be relative or absolute).
112 * @return Absolute file path. 78 * @return Absolute file path.
113 */ 79 */
114 virtual std::string Resolve(const std::string& path) const = 0; 80 virtual std::string Resolve(const std::string& path) const = 0;
115 }; 81 };
116 82
117 /** 83 /**
118 * Shared smart pointer to a `FileSystem` instance. 84 * Shared smart pointer to a `FileSystem` instance.
119 */ 85 */
120 typedef std::shared_ptr<FileSystem> FileSystemPtr; 86 typedef std::shared_ptr<FileSystem> FileSystemSyncPtr;
121 } 87 }
122 88
123 #endif 89 #endif
OLDNEW

Powered by Google App Engine
This is Rietveld