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;