1 /++
2 Scriptlike_Changelog:
3 
4 The latest version of this changelog is always available at:$(BR)
5 $(LINK http://semitwist.com/scriptlike/changelog.html)
6 
7 (Dates below are YYYY/MM/DD)
8 
9 $(H2 v0.10.2 - 2017/03/03)
10 
11 $(UL
12 	$(ENHANCE
13 		Added $(API_CORE trace) functions as debugging aid. Outputs
14 		file/line info and optionally a variable name/value.
15 	)
16 	$(ENHANCE
17 		Added $(API_FILE_EXTR isUserExec), $(API_FILE_EXTR isGroupExec)
18 		and $(API_FILE_EXTR isWorldExec) to check a file's executable bits on Posix.
19 	)
20 	$(FIXED
21 		$(ISSUE 34): Unable to build docs of own project with DUB.
22 	)
23 	$(FIXED
24 		Make sure the example tests, when run in travis-ci, always use
25 		the current scriptlike commit, instead of using a scriptlike release
26 		from the published dub repos.
27 	)
28 	$(FIXED
29 		Docs weren't being correctly built for $(API_FILE_WRAP symlink),
30 		$(API_FILE_WRAP readLink), $(API_FILE_WRAP getTimesWin) and $(API_FILE_EXTR trySymlink).
31 	)
32 	$(CHANGE
33 		Removed outdated, messy and problematic "plain script" example.
34 	)
35 )
36 
37 $(H2 v0.10.1 - 2017/02/25)
38 
39 $(UL
40 	$(FIXED
41 		Fix some minor doc and travis-ci issues with v0.10.0's release.
42 	)
43 )
44 
45 $(H2 v0.10.0 - 2017/02/25)
46 
47 $(UL
48 	$(CHANGE
49 		$(ISSUE 33): Rename `Path.toRawString` to `Path.raw`.
50 	)
51 	$(CHANGE
52 		Deprecated `Ext.toRawString`. It didn't do anything
53 		different from `Ext.toString` and thus wasn't needed.
54 	)
55 	$(FIXED
56 		$(ISSUE 19): Compile error with DMDFE 2.065. Note, Scriptlike
57 		still $(I officially) requires at least DMDFE 2.066, mainly because
58 		of a bugfix for Windows, but DMDFE 2.065 appears to still be
59 		important for Debian's GDC.
60 	)
61 	$(FIXED
62 		Excess blank lines and malformed `</p><p>` in this changelog.
63 	)
64 )
65 
66 $(H2 v0.9.7 - 2017/01/23)
67 
68 $(UL
69 	$(ENHANCE
70 		Docs/Examples: Now recommend DUB v1.0.0+'s single-file package support,
71 		and test the provided example.
72 	)
73 	$(FIXED
74 		$(ISSUE 31): Deprecation warnings on DMD 2.072 and up.
75 	)
76 )
77 
78 $(H2 v0.9.6 - 2016/05/28)
79 
80 (Note: This was going to be v0.9.5, but the release got borked, so it's released as v0.9.6 instead.)
81 
82 $(UL
83 	$(FIXED
84 		$(ISSUE 26): Deprecation warnings on DMD 2.070 and 2.071.
85 	)
86 	$(FIXED
87 		$(ISSUE 27): Flush stdout when requesting input.
88 		[$(LINK2 https://github.com/JesseKPhillips, Jesse Phillips)]
89 	)
90 	$(FIXED
91 		$(LINK2 https://github.com/Abscissa/scriptlike/blob/master/USAGE.md#in-a-plain-script, Plain script)
92 		example fails on DUB 0.9.25 (due to a change in dub's package cache directory structure).
93 	)
94 	$(FIXED
95 		Testing any pull request on
96 		$(LINK2 https://travis-ci.org/Abscissa/scriptlike/, Travis-CI)
97 		fails.
98 	)
99 	$(FIXED
100 		Unittests fail to build on DMD 2.071.
101 	)
102 )
103 
104 $(H2 v0.9.4 - 2015/09/22)
105 
106 $(UL
107 	$(FIXED
108 		Previous release broke the `unittest` script when `dub test` support was added.
109 	)
110 	$(FIXED
111 		In echo mode, several functions would echo the wrong "try*" or
112 		non-"try*" version. Ex: $(API_PROCESS run) echoed $(API_PROCESS tryRun),
113 		and $(API_FILE_EXTR tryRename) echoed $(API_FILE_WRAP rename).
114 	)
115 	$(FIXED
116 		$(API_PATH_EXTR Path) and $(API_PATH_EXTR buildNormalizedPathFixed) now
117 		convert back/forward slashes to native on BOTH Windows and Posix, not
118 		just on Windows.
119 	)
120 	$(FIXED
121 		Some links within changelog and API reference were pointing to the
122 		reference docs for Scriptlike's latest version, instead of staying
123 		within the same documentation version. This made 
124 		$(LINK2 http://semitwist.com/scriptlike-docs/, archived docs for previous versions)
125 		difficult to navigate.
126 	)
127 	$(ENHANCE
128 		$(ISSUE 17),$(ISSUE 20): Added usage examples to readme.
129 	)
130 	$(ENHANCE
131 		Add $(API_CORE interp) for interpolated strings:$(BR)
132 		`string s = mixin( interp!"Value is ${variableOrExpression}" )`
133 	)
134 	$(ENHANCE
135 		Add $(API_FILE_EXTR removePath)/$(API_FILE_EXTR tryRemovePath) for
136 		deleting a path regardless of whether it's a file or directory. (Calls
137 		$(API_FILE_WRAP remove) for files and $(API_FILE_WRAP rmdirRecurse) for
138 		directories.)
139 	)
140 	$(ENHANCE
141 		Add a Path-accepting overload of $(API_PATH_EXTR escapeShellArg) for
142 		the sake of generic code.
143 	)
144 	$(ENHANCE
145 		When $(API_PROCESS runCollect) throws, the $(API_PROCESS ErrorLevelException)
146 		now includes and displays the command's output (otherwise there'd be no
147 		way to inspect the command's output for diagnostic purposes).
148 	)
149 	$(ENHANCE
150 		Greatly extended and improved set of tests.
151 	)
152 )
153 
154 $(H2 v0.9.3 - 2015/08/19)
155 
156 $(UL
157 	$(FIXED
158 		$(ISSUE 16): Access to standard Phobos function hampered.
159 	)
160 	$(ENHANCE
161 		Support running unittests through DUB: `dub test`
162 	)
163 	$(ENHANCE
164 		Uses $(LINK2 https://travis-ci.org, travis-ci.org) for continuous integration testing.
165 	)
166 )
167 
168 $(H2 v0.9.2 - 2015/07/10)
169 
170 $(UL
171 	$(FIXED
172 		Properly flush all command echoing output
173 		(ie, in $(API_CORE yap) and $(API_CORE yapFunc)).
174 	)
175 	$(ENHANCE
176 		Add a "no-build" configuration for projects that need to import/depend
177 		on Scriptlike through DUB, but use their own buildsystem.
178 	)
179 )
180 
181 $(H2 v0.9.1 - 2015/06/28)
182 
183 $(UL
184 	$(FIXED Fails to compile unless the `makedocs` script has been run.)
185 )
186 
187 $(H2 v0.9.0 - 2015/06/27)
188 
189 $(UL
190 	$(CHANGE Split $(MODULE_FILE) and $(MODULE_PATH) into the following:$(BR)
191 		$(UL
192 			$(LI $(MODULE_CORE) )
193 			$(LI $(MODULE_FILE_EXTR) )
194 			$(LI $(MODULE_FILE_WRAP) )
195 			$(LI $(MODULE_PATH_EXTR) )
196 			$(LI $(MODULE_PATH_WRAP) )
197 		)
198 		Utilizes `package.d` to retain ability to import $(MODULE_FILE) and $(MODULE_PATH).
199 	)
200 	$(CHANGE Convert changelog from markdown to $(DDOX) so links are more readable. )
201 	$(ENHANCE Add (opt-in) command echoing to most functions in $(MODULE_FILE). )
202 	$(ENHANCE
203 		Add $(API_CORE yap) and $(API_CORE yapFunc) as improved versions
204 		of to-be-deprecated $(API_CORE echoCommand).
205 	)
206 	$(FIXED Make $(API_PATH_EXTR escapeShellArg) const-correct. )
207 	$(FIXED
208 		Make $(API_PATH_EXTR Path.toRawString) and $(API_PATH_EXTR Ext.toRawString)
209 		both be `pure @safe nothrow`.
210 	)
211 )
212 
213 $(H2 v0.8.1 - 2015/06/22)
214 
215 $(UL
216 	$(ENHANCE
217 		New overload for $(API_INTERACT userInput) to allow type inference:$(BR)
218 		`void userInput(T=string)(string question, ref T result);`
219 		(suggestion from
220 		$(LINK2 http://forum.dlang.org/post/povoxkcogcmbvhwlxqbc@forum.dlang.org, Per Nordlöw)).
221 	)
222 )
223 
224 $(H2 v0.8.0 - 2015/06/13)
225 
226 $(UL
227 	$(CHANGE
228 		Minimum officially supported $(DMD) increased from v2.064.2 to v2.066.0.
229 		Versions below v2.066.0 may still work, but there will now be certain
230 		problems when dealing with paths that contain spaces, particularly
231 		on Windows.
232 	)
233 	$(CHANGE
234 		Removed unnecessary non-$(API_PATH_EXTR Path) wrappers around $(MODULE_STD_FILE)/$(MODULE_STD_PATH).
235 		Things not wrapped (like $(STD_PATH dirSeparator) and $(STD_FILE SpanMode))
236 		are now selective public imports instead of aliases. These changes should
237 		reduce issues with symbol conflicts.
238 	)
239 	$(CHANGE
240 		$(LINK2 http://semitwist.com/scriptlike/, API reference) now built
241 		using $(DDOX) and uses much improved styling (actually uses a stylesheet now).
242 	)
243 	$(CHANGE
244 		Eliminate remnants of the "planned but never enabled" wstring/dstring
245 		versions of $(API_PATH_EXTR Path)/$(API_PATH_EXTR Ext)/$(API_PROCESS Args). There
246 		turned out not to be much need for them, and even $(MODULE_STD_FILE)
247 		doesn't support wstring/dstring either.
248 	)
249 	$(CHANGE Put output binaries in "bin" subdirectory, instead of Scriptlike's root. )
250 	$(ENHANCE
251 		Add module scriptlike.only to import all of scriptlike, but omit the
252 		helper Phobos imports in scriptlike.std.
253 	)
254 	$(ENHANCE
255 		$(API_FAIL fail) now accepts an arbitrary list of args of any type,
256 		just like $(STD_STDIO writeln),
257 	)
258 	$(ENHANCE
259 		Added $(API_FAIL failEnforce), like Phobos's $(STD_EXCEPTION enforce),
260 		but for $(API_FAIL fail).
261 	)
262 	$(ENHANCE
263 		Added $(API_PROCESS runCollect) and $(API_PROCESS tryRunCollect), to
264 		capture a command's output instead of displaying it.
265 	)
266 	$(ENHANCE Added $(API_INTERACT pause) to pause and prompt the user to press Enter. )
267 	$(ENHANCE $(API_CORE echoCommand) is no longer private. )
268 	$(ENHANCE
269 		Added $(API_PATH_EXTR Path)-based wrappers for $(MODULE_STD_FILE)'s 
270 		$(STD_FILE getcwd), $(STD_FILE thisExePath) and $(STD_FILE tempDir).
271 	)
272 	$(FIXED No longer uses Phobos's deprecated $(STD_PROCESS system) function.)
273 )
274 
275 $(H2 v0.7.0 - 2015/04/02)
276 
277 $(UL
278 	$(ENHANCE
279 		$(ISSUE 14): Added scriptlike.interact module for easy user-input prompts.
280 		[$(LINK2 https://github.com/JesseKPhillips, Jesse Phillips)]
281 	)
282 	$(FIXED Unittest compile failure on $(DMD) v2.067.0. )
283 )
284 
285 $(H2 v0.6.0 - 2014/02/16)
286 
287 $(UL
288 	$(CHANGE
289 		$(API_PATH_EXTR Path) and $(API_PATH_EXTR Ext) are now aliases for the UTF-8
290 		instantiations, and the template structs are now named `PathT` and `ExtT`.
291 	)
292 	$(CHANGE
293 		Removed `path()` and `ext()` helper functions to free up useful names
294 		from the namespace, since they are no longer needed. Use `Path()` and
295 		`Ext()` instead.
296 	)
297 	$(CHANGE
298 		Internally split into separate modules, but uses `package.d` to
299 		preserve `import scriptlike;`.
300 	)
301 	$(CHANGE Rename `escapeShellPath` -> $(API_PATH_EXTR escapeShellArg). )
302 	$(CHANGE
303 		Rename $(API_PROCESS runShell) -> $(API_PROCESS tryRun). Temporarily keep
304 		$(API_PROCESS runShell) as an alias.
305 	)
306 	$(CHANGE
307 		Rename $(API_CORE scriptlikeTraceCommands) -> $(API_CORE scriptlikeEcho).
308 		Temporarily keep $(API_CORE scriptlikeTraceCommands) as an alias.
309 	)
310 	$(ENHANCE Added scripts to run unittests and build API docs. )
311 	$(ENHANCE
312 		Added $(API_PATH_EXTR Path.opCast) and $(API_PATH_EXTR Ext.opCast) for
313 		converting to bool.
314 	)
315 	$(ENHANCE
316 		$(API_FAIL fail) no longer requires any boilerplate in `main()`.
317 		($(LINK2 http://forum.dlang.org/thread/ldc6qt$(DOLLAR)22tv$(DOLLAR)1@digitalmars.com, Newsgroup link))
318 	)
319 	$(ENHANCE
320 		Added $(API_PROCESS run) to run a shell command like $(API_PROCESS tryRun),
321 		but automatically throw if the process returns a non-zero error level.
322 	)
323 	$(ENHANCE $(ISSUE 2): Optional callback sink for command echoing: $(API_CORE scriptlikeCustomEcho). )
324 	$(ENHANCE $(ISSUE 8): Dry run support via bool $(API_CORE scriptlikeDryRun). )
325 	$(ENHANCE
326 		$(ISSUE 13): Added `ArgsT` (and $(API_PROCESS Args) helper alias)
327 		to safely build command strings from parts.
328 	)
329 	$(ENHANCE Added this changelog. )
330 	$(FIXED
331 		$(API_PATH_EXTR Path)(null) and $(API_PATH_EXTR Ext)(null) were automatically
332 		changed to empty string.
333 	)
334 	$(FIXED $(ISSUE 10): Docs should include all OS-specific functions. )
335 )
336 
337 $(H2 v0.5.0 - 2014/02/11)
338 
339 $(UL
340 	$(LI Initial release. )
341 )
342 
343 Copyright:
344 Copyright (C) 2014-2017 Nick Sabalausky.
345 Portions Copyright (C) 2010 Jesse Phillips.
346 
347 License: zlib/libpng
348 Authors: Nick Sabalausky, Jesse Phillips
349 +/
350 module changelog;