dcli 1.6.3

An API and dev environment for writing console (cli) apps/scripts using dart. e.g. allows you to build bash style scripts with dart.

1.6.3

• improved the messaging when dcli isn't on the path. improved colour coding of installer.
• Added toParagraph method to the progress. Returns the output as a single string joined by the platform specific line delimitier.

1.6.2

1.6.1

organised imports. Added method to find the primary version of a package installed into pubcache. Added skip when not running on windows for the windows process helper tests. Change the code which loads a list of processes to use windows api calls rather than spawning tasklist. There is a slight regression in that we can't get the memory used but I think thats not a feature that people will be using as yet. method to allocate/free memory for ffi calls. Released 1.6.0. Fixed the isCompiled method so it also works on windows. reimplemented isPrivilegedUser with ffi calls.

1.5.12

Fixed a bug in the call to chmod during the dart sdk install from archives.

1.5.11

• Fixed a a path that we use to look for dart during installation.
• Removed use of ansi chars to show dart sdk progress as having problems in a docker container. Now just print a '.' each time data arrives.

1.5.10

Added code to catch error if we attempt to read the cursorPosition if stdin is closed.

1.5.9

• Changed the installer so it no longer uses apt to install dart as the apt package is always stale. Now always install from the dart archives.
• Also fixed a bug where the installer failed to install dart as it incorrected thought that dart was installed.

1.5.8

Added back in the global activation of dcli as we have removed the sudo requirement which means that https://github.com/dart-lang/sdk/issues/46255 no longer applies. Added documenation on using chmod. Added Windodws support by making the call a noop. Changed DartProject.isReadyToRun to use DartSdk.isPubGetRequired as this does a more complete check.

1.5.7

FIXES:

• Fixed a bug in the namedLock class. If a lot of threads where trying to get a hard lock then then thread with the lock couldn't get a hard lock to release it. Threads without a lock now check for a valid file lock before trying to get a hard lock. Fixed lock tests so they now work every time.
• unit tests for project_create_test.dart now work correctly.
• Fixed the ask test. The message now is wrapped in ansi red encoding which is why it started failed.
• NamedLock - Fixed a bug with the wait loop for taking a hard lock that was waiting 30secs * 30secs rather than just 30 secs. suppressed lint.

IMPROVEMENTS:

• Added verbose statement when exception is thrown in named lock.
• Changed logging to directly use verbose to improve performance.
• removed an verbose logger in the progress as it was generating execessive logs.
• added detached and terminal options to DartSDK.run method.
• Added details on Pub Cache to doctor and some general formatting cleanup.
• removed refernces to the dcli cache as its no longer used.
• Improved the code the checks that a package name conforms to a dart indentifier.
• critical_tests setup hook now exists with a non-zero exit code if not running as a privilged user under windows.
• removed the isPriviliged requirement unless we are running on windows.
• Added method runPubGet to the DartScript class. Fixed the run_test.dart unit test which failed to run pub get after creating the script.
• added calls to pub get for each of the test packages to ensure they are ready to run
• Added method to check if pub get needs to be run DartScript.isPubGetRequired
• Added logic to critical_test startup prehook to run pub get on all test packages.
• NamedLock - Moved from a raw socket to a tcp socket and change the port no. to a value below 10000 (9003) as this is what is requierd to work on Windows.
• Added logic to remove empty strings from the PATH which can occur if the path contains two adjacent delimiters;

1.5.6

updated documentation link.

1.5.5

Updated the homepage.

1.5.4

removed the dcli symlink for sudo as it just wasn't going to work.

1.5.3

performance improvements for unit tests. restricted the privileged requirements on install to windows. Merge branch 'master' of https://github.com/bsutton/dcli GitBook: [master] 67 pages modified Fixed the named lock trash test so it shuts down cleanly.

1.6.0-beta.1

• improved performance of unit tests by removing unnecessary testfilesystem.
• Fixed a bug in the new extensionSearch which was returning the full path to the found exe rather than just the basename as passed in.
• removed debugging code.
• Merge branch 'master' of https://github.com/bsutton/dcli
• Fixed a major bug in find. When a directory contained more than 100 child directories all child directories were returned but the contents of every second directory (after the first 100) where not returned.
• Added extensionSearch to start function.
• Fixed bug in createScript as it was ignore the project path.
• Changed ask and confirm to return immediately if no terminal is attached.
• added checks that we are running as a privliged users.
• Added windows registry methods regIsOnUserPath and regPrependtoPath
• Added extensionSearch argument to which function. The argument only affects windows and causes the which command to search the set of possible extensions defined in PATHEXT.
• deprecated addToPATHIfAbsent in favour of appendToPath which now does a check before adding the path.

1.5.2

Added

• Added working directory option to DartScript.compile.
• Added method to instantiate a DartProject from .pub-cache.

Fixed

• a bug were we throw if the template folder doesn't exist. We now print a message asking the user to install dcli.

Removed the call to globally activate dcli. We are not currently supporting the standalone dcli_install exe and there appears to be a bug in dart that stops us form do a global activate whilst running under sudo. https://github.com/dart-lang/sdk/issues/46255

Change the arguments to DartScript.run so that 'args' is an optional name paramter. I don't think this is in regular usage as yet so shouldn't cause too many issues and it will result in a compile error which is easy to fix.

1.5.1

Deprecated DartProject.current in favour of DartProject.self and DartScript.current in favour of DartScript.self. Current was ambigous; for a project was it the current running project or the one in the current directory. Change DartScript to self for consistency.

Fixed a bug caused by the dart_console. If you try to get the screen dimensions when no terminal is attached it causes the app to hang.

Changed the rootPath so it returns 'C:' on windows.

1.5.0

This release largely focuses on fixes for Windows.

Changes:

• update dart version to 2.13 so we can use the latest win32.
• dcli install now updates the PATH registry settings and notifies all top level windows.

Added:

• A set of registry functions to set/get registry keys.
• Added method loggedInUsersHome for WindowsMixin
• Added new methods to Terminal()
• writeline with text alignment.
• cursorUp/Down/Left/Right
• get/set current column/row cursor position.
• support for running .dart scripts from the command and power shell prompts. You can now rung hello.dart rather than dart hello.dart
• Created new function withOpenFile that opens a file for the duration of a callback.
• Created new function fileLength that returns the length of a file.

Deprecated:

• Deprecated methods in Terminal
  • previousUp in favor of cursorUp
  • lines in favour of rows.

Fixes:

• numerous issues with ansi/terminal under windows. Now use the dart_console package to handle the windows setup.
• Stopped the terminal trying to get the cursor position when we don't have a terminal as this just caused the app to hang.
• a bug in Ansi.isSupported which was testing stdin for ansi support when we should have tested stdout. Ansi colors now work on windows.
• the uri construction for accessing assets so it works under windows.
• a bug in sleep function. Was using microseconds when milliseconds was passed.
• detection of pub_cache location. Should now work on all versions of windows.
• the root prefix when privatising paths on windows.
• bug where dcli doctor wasn't finding the dcli path as we were searching for the wrong name.
• the cmd shell was incorrectly reporting that it had privileges.
• Attempt to fix the problem with DartScript.scriptName when running globally activated. We have been getting a dart version no. in the scriptName which I'm now stripping out. Hopefully this is the correct action.
• fixed path building so that createTempDir now works correctly on windows.

1.3.0

Added new methods

• withFileProtection. Allows you to back a collection of files/directories run an action and then restore any changes to those files/directories. Handy when implementing dry run type features.
• restorePrivileges. Implemented to complement restorePrivileges
• calculateHash. Generates an sha256 checksum on a file.

Changes

• all internall calls to Settings().verbose have been changed to verbose to reduce logging overheads.
• Upgraded to dart 2.13 - google tells me that this still allows older packages to work with dcli.
• Added keep arguments to withTempFile and withTempDir to preseve the temp directories. Handy for examining problems with unit tests.
• Changed truepath to call normalize rather than canonicalize as canonicalize changes the case of paths on Windows. I believe this should be non-breaking.
• Added support for windows \ path separator in the find function.

Fixes:

• Fixed a bug where find failed if an absolute path was prepended to the pattern. Now works for no path, a relative path and an absolute path prefixed to the pattern.
• Improvements to the DartProject and DartScript path detection when running unit tests under windows.

Known Problems:

Note we have found a problem using forEach with the start function.

start('ls *.txt').forEach( print);

Currently this works and look like it is going to have to be part of the process re-org we are working through. In the mean time you can use:

for (final line in start('ls *.txt', progress: Progress.capture().lines) {print(line);}

1.2.3

Added new methods:

• withTempDir - Allows you to run a callback with access to a temporary directory which is automatically cleaned up when the callback completes.
• withTempFile - Allows you to run a callback with access to a temporary file which is automatically cleaned up when the callback completes.
• createTempFilename

Changes:

• Deprecated FileSync.tempFile in favour of createTempFilename
• updated unit tests to reduce reliance of TestFileSystem to speed up the unit tests.
• depcrecated FileSync.tempFile in favour of creaeTempFilename updated to use teh new createTempFilename
• Added ignoreMissing arg to backupFile. Now throws a BackupFileException if the backup file is missing and ignoreMissing is not set.

Fixes:

• Fixed the Ansi.strip command as the unit tests were falely reporting that they worked.

Experimental:

• Added method to ProcessHelper to obtain a complete list of running processes. Not currently supported on osx.

1.2.2

Reverted method names on DartScript from pathToDartScript to pathToScript and similar to reduce api breakage.

1.2.1

• Fixed accidentail breakage. renamed some methods to use 'library' rather than 'script'.
• Changed Ansi.strip to a static method to match convention used for other Ansi methods.
• Added overwriteLine to Terminal class. Added Ansi().strip method to stripout ansi escape sequences from a string.
• Changed run to print stdout and stderr to the console rather than devNull so it was consistent with other functions.
• Added run method to make it easy to run the dart exe. Change runPub to print stderr and stdout to the console rather than supress it.
• Changed startFromArgs to print stderr and stdout by default so it is consistent with outer functions.
• formatting.

1.2.0

Breaking Change:

• Renamed Script to DartScript to make way for integration with cli_script.

• As Script was labelled as an internal class this hopefully shouldn't be too disruptive.

• DartScript is now part of the public api.

• Code changes should simply required changing Script to DartScript as the api is identical.

• Progress ctor now setting _includedStd(out, err) based on whether devNull is passed as the relevant LineAction. Previously _includeStderr wasn't being enabled if a LineAction was passed.

• Improvements to processing of 'detached' processes.

• Added sudo tag to tests so these can be run separately.

• Fixed a bug where nothrow was not being passed down pubRun.

• Improved doco on detached argument to start.

• Changed the installer (yet again) to require privileges to be run. We now releasePrivileges to and withPrivileges to provide more precise control over what we execute with privileges.

1.1.1

Fixed a bug in the menu function when the passed 'limit' argument is greater than the no. of options.

1.1.0

Breaking Change: Change the 'search' argument on DartProject.fromPath to default to true rather than false.
On looking at the documentation and the common usages the search logic is assumed to be on. This should only affect a small no. of people as you would only want search off if you are creating a dart project from scratch.

New:

• simple backup and restore methods backupFile and restoreFile.
• getters in DartProject for the common paths in a dart project folder.
• Added columns and lines methods to Terminal
• Unit tests for copy function.

Changes:

• Improved the exception messages for the copy function when things go bad as the OS errors are ambiguous.
• Documentation improvements.

1.0.9

Fixed a bug in the createTempDir method and added unit test for same.

1.0.8

Exposed method createTempDir.

1.0.7

BUG: runPubGet was not passing down the Progress so you couldn't dump the output if so desired.

1.0.6

Updated readme.

1.0.5

Deprecated ProgressWithCapture and moved the capture logic into the base Progress class. Use Progress.capture() instead.

• Modified startFromArgs to NOT print any output by default.
• This is to bring it in line with start.
• If you currently use startFromArgs and want to continue with the original behaviour you will need to change how you call startFromArgs

startFromArgs('ls', ['-la']);

becomes

startFromArgs('ls', ['-la'], progress: Progress.print);

This change is in response to issue #134

• Switched to using critical_test package for running unit tests.
• Added method runPub to DartSdk.
• Improved the code doco for find
• Added unit tests for progress methods toList and forEach

1.0.4

Update README.md

1.0.3

Enhancements:

• Added method isPrivilegedPasswordRequired to test if the sudo password is currently cached.
• For the installer added logic to suppress the sudo requirement if the link path is already writable or we are already privileged. If we are going to prompt - for the password we now warn the user.

1.0.2

Fixed a bug in the shell detection logic.

1.0.1

Replace now takes a Pattern so you can do a Regx replacement as well as a simple string replacement.

1.0.0

No major changes. The api is now stable enough for us to consider this a 1.0 release :) upgraded to release versions os csv, equatable and ini package.

0.51.10

Fixed a bug ith the install when 'pub' command is not on the path. Now correctly uses dart pub.

0.51.9

• Added createTempDir.
• Added a regex validator.

0.51.9

• Merge branch 'nullsaftey' into master as nnbd migration is now complete.
• Added createTempDir.
• Added a regex validator.

0.51.8

• Added class ProgessWithCapture thanks to @passsy for the contribution and suggestions.
• You can now use the start function and capture the output with a simple progress.
• Allowed the priviliged flag to work on osx as well as linux for the start function.
• Improvements to documenation.
• Fixed the import path for dcli on the templates which I broke when fixing lints.

0.51.7

Added work around for "Invalid Argument' when using the find command over a steam directory tree. We just log the path and keep on trucking.

0.51.6

Added code to return the exit code even when running a process in a terminal. This is to resolve #100. However I'm not certain if the exit code will be meaningful as it might just be the terminals exit code.

• Added new createTempDir thanks to @Reductions

• Moved to only support 2.12 and not the beta.

• tweaked the template expander to remove any lint warnings. Updated the expander so that it updates the dcli and package versions.

• Remove the lock logic around creating as testfile system as its no longer needed and greatly slows down testing.

• Change default shell detection expected as mostly we run it from the cli.

• Added logic so that the template builder updates the dcli and dependency versions to match the current versions used by dcli.

• Migrated to full set of lint rules in lint package. First pass revert to 80chars.

• moved back to using pubspec now that nnbd version has been released.

• moved to official validators library.

0.51.5

Hack to get around getIsolateID nndb bug.

0.51.4

• Updated to latest readme content from gitbooks
• Improved the Env documentation.

0.51.3

Updated template pubspec.yaml to have the correct args package. Updated the installer so that it replaces the templates when a new version of dcli is installed.

0.51.2

removed hard coded verbose:true statement

0.51.1

Fixed the toList String extensions so that it never returns nulls.

0.51.0

Extended version ranges for ini.

0.51.0

Moved to temporary validators2 which I published so dcli can be full nndb. Hopefully the validators authors will update their package shortly.

0.50.2

re-added ini support. Upgraded to latest packages.

0.50.1

re-added args as a transitive dependency. I'm still uncertain if this is a good idea.

0.50.0

First full nnbd release.

• Removed support for 32bit installs until system_info releases a nnbd version.
• Changed to pubspec2 until pubspec is released with nnpd.
• changed createScript to expect a script name not a full path.
• Fixed the exception handling for dcli exceptions that I screwed up.
• Moved to using posix to get parent pid. Impoved exception handling.
• Used late final to do delayed initialisation. Added exceptions when pub get or dart not installed.
• updated doco
• removed ini support as the upstream package doesn't appear to be maintained.
• Finalised nnbd migration by bringing the validators class into the project.
• Fixed bug in version if dart not installed.

0.50.0-nullsaftey.0

• First pass at nullsaftey.
• removed suffix as no longer supported.

0.41.16

Reverted posix and intl upgrades as they required 2.12.

0.41.15

upgraded intl.

0.41.14

• Upgraded dcli to latest version of equatable.
• removed unnecessary log statement in symlink.

0.41.13

• Added logging for symlink related funcitons.
• Improvements to documentation.

0.41.12

Added verbose output when setting environment vars.

0.41.11

Exposed isXXX members that were being hidden for no good reason.

0.41.10

• Improved the move error message when the target directory doesn't exist.
• grammar improvements in script.dart's doco.

0.41.9

Removed code in env which tried to update the platform.environment settings which of course is impossible.

0.41.8

0.41.7

• Added documentation for compile method.
• Added version to help message.

0.41.6

Release due to bug in pub_release that was not updating the 'latest' tag

0.41.5

Fixed bug in getlogin (Shell.loggedInUser) when running in docker. Now corretly returns 'root' as before it was seg faulting in the posix code.

0.41.4

With pub_release fixed so it can upload assets this release is to take advantage of that

0.41.3

Testing of pub_release uploading exes.

0.41.1

• Improved documentation around waitForEx stack traces and added a test for same.
• Added test for wait_for_ex exceptions.
• Added cause to dcliexception.

0.41.0

• BREAKING CHANGE: renamed the find argument 'root' to ' workingDirectory'. As I'm using the api I've found that I naturally go to use workingDirectory as its used everywhere else. So this feels more consistent.
• Implemented chown using the posix api via ffi.
• Added protection for a number of anomalies that can occur when scanning a full file system.

0.40.6

• Implemented chown using the posix api via ffi.
• changed find's root to workingDirectory
• exposed chmod.
• Added protection for a number of anomoulies that can occur when scanning a full file system.
• BREAKING CHANGE: renamed the find argument 'root' to ' workingDirectory'. As I'm using the api I've found that I naturally go to use workingDirectory as its used everywhere else. So this feels more consistent.
• released 0.40.5

0.40.5

• Added release hook to activate published version of dcli.
• sorted dependencies.
• Fixed the isReadyToRun method as it was looking for .dart_code rather than .dart_tool

0.40.4

• exposed the PosixShell.
• Added tests for loggedInUsersHome.

0.40.3

• reverted to returning null for a non-existing key as the changes were too destructive and end up with rather ugly code.
• Added logging of the pub-cache path.

0.40.2

Minor changes to progress messages.

0.40.1

Introduced isPrivilegedProcess so we can always tell if we started with privilegese. Changed isPrivilegedUser back to its original semantics in that it reflects the current effective user id. Fixed withPrivileges so it uses isPriviliegedProcess to correctly determine if privileges exist. Fix the 'start' function so that it interats correctly with wiithPrivileges and releasePrivileges.

0.40.0

• BREAKING CHANGE: Accessing an environment key which doesn't exists now throws EnvironmentKeyNotFound rather than returning a null. This is in prepare for nnbd.
• Updated doco for Env.
• Changed from using whoami to to using getuid for posix systems.

0.39.10

Implemented Shell.current.releasePrivileges and Shell.current.withPriviliges

0.39.9

• Made the Script.isCompiled method more reliable.
• Fixed the Script.pathToScript path when in a compiled exe. It was just returning the pwd.
• replaced calls to absolute with truepath
• Moved the verbose statement in the copy function up so we will see it even if an exception is thrown.
• removed the --suffix switch as no longer supported from git_release hook.

0.39.8

• Fixed unit testing bugs.
• Changed logic that obtains the scripts path to handle more scenarios.
• Updated the asset builder to change the dcli version in the pubspec.yaml template as it creates the expander.
• Moved docker files under tools as per the dart conventions.

0.39.7

Added additional checks for version nos.

0.39.6

Added method to check if the script is running from pub-cache.

0.39.5

• Fixes #126 - Does not like dashes in directory name. We now replace any invalid chars in the project name with _.
• Relaxed the requirement that the default value had to pass the validator. It made it hard to initialise the default from an uninitialised settings file.

0.39.4

• Fixed a bug where the fetch caused an app to not shutdown as we failed to close the client.
• Adding fish shell support
• the method is a getter.
• Code no longer exludes proc et el directories if running 2.10 or later as bug is fixed.

0.39.3

Fixed a bug on osx where the install was looking for dart in the wrong place.

0.39.2

• tried removing the futures now we fixed the core problem with the stackoverflow.
• work on stackoverflow - tried leaving the subscription until after the progress event returns.
• attempt to fix the stackoverflow caused by fetch progress events that use the echo function. The progress events are now async which I hope will resolve the issue.

0.39.1

Fixed bug for windows cmd shell when running isPriviligedUser

0.39.0

• Removed the development mode requirement for dcli as we no longer symlink under windows.
• Added notes on the symlink methods for running under windows.
• Improved the version message when dcli install hasn't been run.

0.38.0

change calls to 'pub' to 'dart pub'.

0.37.2

finally fixed the clearLine method. Looks like it was the flush in the echo method that was causing the problem. Now using stdout.write directly.

0.37.1

• Updated the path to use a test script rather than the eample directory.
• Fixed a bug with resolving symbolic links when the link was to a directory.

0.37.0

• We now take pub from the PATH rather than calculating it from the dart directory as on some systems its not in the dart-sdk dir.
• moved from pedantic to lint and removed all of the lint warnings.

0.35.0

We now test if dart compile is supported (2.10 onwards) and use that rather than dart2native.

0.34.6

• Added support in the find method for patterns that contain a partial path.
• added lint to warn about incorrect usage of await.
• Fixed the doco on the append method as it incorrectly states that newline is a bool.

0.34.5

renamed example/readme.md to example/example.md as looks like the doco I found was wrong on what name was required.

0.34.4

Created an examples/readme.md to highlight additional examples.

0.34.3

Fixed code that was using find and forgetting to turn recursion off.

0.34.2

Added exception handler to find to deal with files being deleted during the find operation.

0.34.1

• Fixed two bugs in the NamedLock which effectively made it totally non-functional. The lock name had changed to have a leading '.' which meant the find command didn't find the locks and the parser no longer parsed the pid from the lock file name.
• Added new unit test that can now detected if a lock isn't taken correctly.

0.34.0

Added methods to encode environment vars to json and then restore them from json.

0.33.8

• Added 'entries' and 'addAll' methods to Env.
• removed save as you can't update the Platform.environment.

0.33.7

Added method to save the environment back to the platform.

0.33.6

command line completion for dcli cli: added test for an invalid path. Added logic to quote paths that contains spaces. Added bash option so it won't add a space after directory names.

0.33.5

tweak tab completion so that dir/ matches the ls behaviour.

0.33.4

Simplified the logic and doing a better job of directory expansion. Still has a problem with two matching directories.

0.33.3

tab completion now works with a complete directory name as the search word.

0.33.2

work on improving the tab completion when a partial path is entered.

0.33.1

Fixed a bug in confirm as it needs to explictly set required .

0.33.0

• upgraded package versions for dart 2.10 compatability.
• moved humanReadable into Format class and made it part of the public api. Changed Format.percentage to static.
• Modifyed the prompt argument to accept an empty string rather than null to make way for null safety
• Added 'required' parameter to ask.
• Update windows_installer.yml

0.32.6

• Update windows_installer.yml

• Fixes for unit tests

• the root dir was not deterministic for testing so changed to a path we own.

• removed the bash launcher and changed expect to sh.

• added missing default.

• add arg to suppress dcli install.

• removed the @pubspec as we no longer support it.

• Added option to test file system to no install dcli so we can test installing dcli.

• Moved to using the Shell install method.

0.32.5

• dcli create - improved doco and made the creating script prompt green.
  • Fixed a bug in the creation of the analysis_options path.
• Added a dot before the name of the lock so it is hidden.
• dart_project: centralise the lock filename,
• pubspec.yaml.template: upgraded the min dcli and sdk versions.
• exists - added verbose logging.

0.32.4

• Updated DartProject.current so that it works somewhat intelligently for compiled scripts.
• As a compiled script doesn't have a pubspec.yaml we will return the current working directory.

0.32.3

Added DartProject.current which will return the current script's dart project.

0.32.2

Fixed git_release script so that it stores the settings in a config file.

0.32.1

Fixed a bug with the logic to check for dart. Had the found logic inverted.

0.32.0

exported the Dependency class.

0.31.0

• Changed which again. It now returns a specific class (Which) that contains information specfic to the which command which makes it much more intuitive to use.
• Which: improved the doco.
• Added the progress to the Which class.

0.30.0

Breaking Change: Changed the which function to return an list of paths rather than a progress as users expect to diretcly access the list. Added an hours interval to sleep.

0.29.2

Exposed the 'Interval' enum used by the sleep method.

0.29.1

somehow I reverted the code to remove the workingdirectory.

0.29.0

0.29.0

• breaking change: PubSpec now returns a map for dependencies and dependency overrides rather than a list.
• renamed the default.dart template to basic.dart as default is a dart keyword and was causing conflicts in the asset generation.
• optimised the unit test by using a shared file system.
• Fixed a bug in the unit test runner as we need to run with a bash shell rather than sh as a number of unit tests expect to find bash.
• fixed a unit test as dependencies have changed fro ma list to a map.
• change from env to loggedInUser as this will be more cross platform.
• reverted logic that had the script being run from the script directory as it doesn't allow people to select the directory they want to run the script in.
• removed references to syslog as it doesn't exists in the docker test environment.
• updated name in pubspect to match directory.
• added version no. to the install started message.
• changed to using the newist patToProjectRoot
• copyTree: Changed the default for the [recursive] argument. It is now true by default (it recurses). The command is copyTree which implies its recursive.
• renamed directory test_scripts to test_script in line with dart conventions.
• Fix: create was ignorning the passed templatename.
• fixed bug as clean now works on projects not scripts.
• added test for warmup.
• removed the --package switch as we no longer need it as we have removed virtual projects.
• re-implemented touch using native dart libs.
• install: fixed bug where we were trying to use chmod to change ownership :<

0.28.0

• This release includes significant changes to the dcli command line.
• The command 'clean' has been renamed to warmup.
• There is now a new 'clean' command which now does what the label says. It removes all build artifiacts.
• Find: Added static properties for file, directory and link which can be used a short hand for FileSystemEntityType.
• exposed the pub cache environment variable.
• Added a method clean to DartProjects.
• Added method warmup to DartProjects.
• Added method to PubCache to set the .pub-cache path to an alternate location.
• Improved the Move exception error.
• Fixed the compile install option which was using the wrong source path.
• Fixes to the docker unit tests.
• Added test for integer validator.
• Added compile entry point to Script and updated unit tests to use it.
• Added a 'run' method to Script so users can easily run a script from the dcli api.
• Fixed a bug in the compiler. Even if you agreed to overwrite the exe during the install it would still report an error.

0.27.1

• Exposed DartProject class as part of the public api
• Added color tests.

0.27.0

• Small breaking change:
• For each of the color function we have changed the argument bgcolor to background.
• Abbreviations go against the coding guidelines and this one wasn't even very mature.

0.26.1

• ENH: Added bold option to ansi colors and made it the default for the set of built in colors e.g. red(), green()
• ENH: Added a compile method to DartProject and Script so that users can do compiles without spawning a new process.
• removed dart_project until we decide how much to expose.
• FIX: Fixed a number of bugs in dcli create,clean and compile after we stripped out virtual projects.
• Fixed a bug where the pubspec name ended up as '.' when the script was created in the current directory.
• Fixed a bug when trying to create a script in the local directory which was also the projectRoot.
• FIX: Modified runDart2Native to take a full path to the executable file that is to be created and modified the dart2native call so it now runs in the scripts directory.

0.26.0

• In a docker shell SUDO_USER isn't defined so we need to default back to 'root'

• Improved the sudo detection.

• Fixed the install so it will work for a root usage such as in a docker container.

• Added ask and confirm examples to the script

• PubSpecFile has been replaced with PubSpec.

• Reduced pubspec to a single class now we have removed virtual projects.

0.25.0

This is a major update which has removed support for virtual pubspecs and pubspec annotations. The reality was that in production we used neither of these as ide's don't work with out an actual pubspec and in as the code built up we would normally cluster files into a single directory so having a pubspec wasn't an issue.

Change dcli create to generate a pubspec.yaml and an analysis_options.yaml. Also now generates a more complex sample using a template.

• Ask: Added logic to hide default hidden values when logging.
• Ask: Fixed bugs in the Ask.any method. Exposed valueRange and removed all of the validator classes from the public api.
• AnsiColor: made AnsiColor class and static properties public so that you can actually use the background colours.
• Clean: Added logic to stop pub get occuring when running under sudo.
• PubspecFile: Added support for executables back in now the pubspec 0.1.5 has been released.
• Improved the process of detecting the dartsdk by resolving sym links.
• Fixed the paths so that dcli will run under sudo. The logic to find the dcli exe assumed it was on the path and that won't be the case during install.
• updated the links to the dcli manual

0.24.1

Updated readme to refer to the new gitbook manual. touch : now returns the path that was passed in. Documentation improvements. Added Ask.any and Ask.all. Exposed all of the built in validators as methods.

0.24.0

added method to get overriden dependencies.

0.23.0

Breaking changes:

• Added requirements for privileges when installing so we can set up paths for sudo usage of dcli. Also added option to disable the requirement primarily for unit testing.
• Changed the names of all validators to start with AskValidator. The aim is to make auto completion in ide's work better.

Non breaking changes

• Rewrote the find command so that it works even if a directory contains a file for which we don't have permissions.
• Performance improvements for the find command by reducing the amount of heap allocation going on. We now re-use arrays as much as possible. We can process 1.3M files in 3 seconds. The performance problems start when we push the files into the Progress stream.
• Updated doco to remove any references to setEnv
• Changed from Platform.isWindows to Settings().isWindows so that we can mock the platform when unit testing.
• createDir now returns the path that it created.
• Marked some tests as skip until we work out what tests are required now we have changed how we handle pubspec.yaml

0.22.0

removed env() and setEnv() and replaced them with operators env[] and env[]=

0.21.2

Fixed a bug in the Progress.stream mehthod. It was only outputing stdout and it needs to also output stderr. It now does.

0.21.1

• renamed _pubCacheBinDir to _pubCacheBinPath for consistency.
• Changed the default stream method so that it now includes stderr by default as this is generally what people expect (e.g. stream what I would normally see).
• Fixed the verbose messages that mis-reported why stream output was being ignored.

0.21.0

Breaking changes:

• Refactored methods names related to paths. They now all start with a pathTo prefix.
• The aim is to make it easier to find the methods and for ide auto-completion to be more useful.

All methods that refer to the PATH environment variable now use the capitalised word PATH in the method name.

0.20.2

Pubspec - Added support for fetching a list of executables.

0.20.0

Renamed dshell to dcli to better reflect its functionality and improve its discoverability on the pub.dev store.

Also took the opportunity to change the version no. to 0.x to reflect the fact that the api is still in flux.

1.11.1

• Changed how we determine the packages path as a work around for #95
• reduce logging for start method.
• Forced fqdn to lowercase.

1.11.0

Breaking changes: Changed the 'prompt' argument on ask and confirm to be a positional argument. This feels like a more natual use and is an easy fix where it breaks code.

1.10.21

Fixed a bug in Shell.loggedInUser. If you use sudo and the system has multiple users logged in then the wrong username would be returned. updated doco for setEnv.

1.10.20

Exposed the PubCache class as part of the public api as part of the tooling we are providing to explore the scripts dart environment.

1.10.19

• dcli doctor wasn't printing the dart version as the cli output from dart --version had changed. Improved the parsing method so it should be more robust in the face of future changes.
• Added coverage switch to run_unit_tests.dart
• corrected the name of the coverage directory.
• create_project_test: Fixed a bug in the set of expeced filenames after upgrading to dart 2.9.
• Added pid to Shell.
• Unit test incorrectly had paths presenting as absolute after glob expansion when we only get relative paths.

1.10.18

• Set the working directory to pwd if not passed.
• Glob: fixed bug where globs like middle/.* where not being expanded correctly. Also modified the exception handling so that if the glob describes a directory that doesn't exist we now throw an exception rather than suppressing it. This is not the same as bash. If the glob doesn't match a valid directory it will just pass back the original glob. The new approach however is more consistent with dclis philosophy that any invalid paths should generate an exception. Added unit tests around the above concepts.

1.10.17

• Fixed the compile for scripts with a 'local' pubspec.yaml
• removed stray print statment.

1.10.16

Fixed dcli compile so it works with 2.9.

1.10.15

• moved to support the new .dart_tools directory so we work with dart 2.9.
• Added an addition check for runnable that the package config exists.

1.10.14

Fixed a bug in parsing the results of who which resulting the logged in user name being reported incorrectly.

1.10.13

• Fixed #81 NamedLocks where allowing multiple isolates/processes through.
• Added logic to ensure that streams are fully process to the Progress even when a non-zero exit code is returned. .run will now fully output both stdout and stderr even if a non-zero exit code is returned.
• doco on exceptions when the default value is invalid. Improved the message output when the defaultValue fails validation.
• Added code to clean up the temp directory after unit tests complete.

1.10.12

• Fixed a bug where the username had a trialing space char.
• improved doco.

1.10.11

• Added method to Shell to return the current shell. This replaces having to call ShellDetection().detectShell();
• Removed ShellDetection from the public api.

1.10.10

Fixed isComple.

1.10.9

Added a method to detect if the script is compiled. Also fixed #83 by not trying to read the annotation from the scrsipt when the script is compiled.

1.10.8

• Added a new method to Script so you can get the currently running script.
• Work on testing .run and handling of stderr and stdout.
• added unit test timeouts as the github actions run rather slowly.
• work on generating test coverage.

1.10.7

Fixed a bug where glob was ignoring hidden files even when the pattern was .* I'm not certain if this is the right solution. Need more usage patterns.

1.10.6

argh. managed to delete the working directory arg.

1.10.5

Fixed a bug in the start command. Needed a default for priviledged.

1.10.4

Added a 'privildeged' option to the run/start commands which attempts to escalate privildges if not currently running as a privildeged user. Currently only supported under Linux

1.10.3

Now throws a RunException if the passed working directory doesn't exists. We found that if the working directory is invalid then for some reason searching the PATH fails. You end up with a command not found error rather than the real error which is that the working directory doesn't exists.

1.10.2

• Added test for quote expansion with a complex mysql command.
• A number of functions where not passing down the working directory and the nothrow setting.

1.10.1

Fixed a bug when the move command has to fall back to a copy/delete it wasn't passing down the overwrite flag.

1.10.0

Fixed a bug with glob expansion that was returning absolute paths when apps expect relative paths. Was causing problems when trying to zip a directory and the files being expanded with absolute paths into the zip file.

Its unlikely that any apps dependend on the prior behaviour and going forward this must be changed in order to get the expected behaviour.

1.9.18

Added methods to check file permission access. Only implemented on linux at this point.

1.9.17

Fixed a bug where Progress.stream was missing a default value for a bool

1.9.16

• Exposed TableAlign and privatePath.
• Setting up more detailed testing of .run and toList with intent to display stderr for .run.

1.9.15

Changed defaultValue to defaultOption to better indicate that it should be from the list of options. Fixed a bug when the defaultOption is null. Documented defaultOption.

1.9.14

• unit test for ask and menu.
• Added a Range validator to ask.
• Added default value to menu.

1.9.13

• Added defaultValue option to ask function.
• Added code to test for child shutdown.

1.9.12

Improved the progress.stream method so that it streams data even when the called process is long running. It also waits for stderr/stdout streams to be fully processed before shutting down.

1.9.11

Fixed defaults for runInShell and nothrow for string_as_process stream.

1.9.11

Fixed defaults for runInShell and nothrow.

1.9.10

• Added stream option to string_as_process.
• Added the ability to return a stream from a progress.

1.9.9

• Fixed the fetch unit tests as the download path had moved after re-org of test directory.
• Unit tests for VirtualProject.doctor to address #71
• Fixed a bug in split where it always tried to create a project even when it already exists.
• Added method createOrLoad. Fixed a bug in the loading of local projects where the pubspec path was not being set correctly.
• Fixed doco. Changed getProjectRoot to a getter.
• wording.

1.9.8

• Exposed the Script class as part of the public api as it has some useful methods.
• experiments with generating coverage.
• Minor documentation fix.

1.9.7

• FIX: split command now works!
• tweaked doco on pubspec locations.
• Fixes for activatelocal.dart We now compile the local dcli and set the path correctly. We also change the version no. so you can see that we are running the local version.
• added unit tests for annotated pubspecs.
• Added tests for the more liberal parsing of annotations.
• removed color coding on verbose output as it was distracting.
• updated doco to reflect that [local] pubspec also have a projectRootPath that is actual.
• Fixed a bug which stripped required indentation on pubspec annotations.
• Added unit test for pubspec annotations and enhanced the parser to handle more commenting styles.
• Added support for install quiet option to the tab completion installer.
• Added printStdErr progression which only prints to stderr.
• Added a quiet option to the installer to suppress progress messages.
• restructured test folders to match src folders

1.9.6

Added a method to remove a symbolic link.

1.9.5

enhanced the logic for tradititional builds to work even if the file is deeply nested under a prescribed directory.

1.9.4

Fixed lints.

1.9.3

Fixed the compile path to .packages for the traditional projects.

1.9.2

dcli was failing to return non-zero exit codes.

1.9.1

Fixed a bug in the call to setVerbose when disabling verbose.

1.9.0

Added support for running scripts from a standard dart project structure. We now detect the correct pubspec.yaml and run from there. This is a fairly significant change as it fixes a long standing hole in dclis execurtion model.

• Fixed a bug where the releaseLock would be called even when the lock had failed.
• Improved the timeout exception so that you actually know the locked timed out. Change the retry interval to 100ms (down from 1s). Now guarentee that at least one lock attempt will be made even if the timeout is less then 100ms.
• reverted start returning a progress as that doesn't work as the stream has already been processed by the time start returns. Added a unit test for same.

1.8.23

'command'.start() now returns a progress.

1.8.22

• made tests OS specific.
• Fixed duplication of windows paths during install issue.
• test script for path manipulation.
• move pub_cache back to util.
• restored the correct pathSeparator method and renamed it pathDelimiter to make it clearer what its purpose is.

1.8.21

• Work on improving the windows installer.

• Exposed the Env class as it has a number of useful PATH related methods.

• Windows Installer now checks that developer mode is enabled so we can use symlinks.

• Added resets between pub-cache tests. Looks like join recognizes both slashes so no need to use platform specific slash.

• marked reset method in a number of classes as only visible for unit testing. renamed pubcache unitTestrest to reset for consitency.

• Looks like c:\ is prefixed also need to reset pubcache between tests.

• removed pathSeparator as it duplicated dart Platform functionality.

• Fixes for bugs with locating pub cache on windows and added unit tests.

• Added addition paths to the windows PATH.

• Added pathPutIfAbsent. Also renamed all the path functions to begin with 'path'.

• Added pubcache and .dcli/bin to path.

• Fixed a bug in the format of setx.

• Added dcli path and now launches bash shell to do dev in. Not certain its what we need.

• incomplete docker script to do local dev.

• Added logic to delete the install dir if it already exists.

• Added a check for install preconditions. If they are not met the installer will exit. For powershell we now check that developer mode is enabled as we require this for symlinks. We nolonger allow an install from the old command shell.

• Added methods to manipulate the path.

• Removed a sperious print statement.

1.8.20

Fixed a bug in the default script which had an extra /

1.8.19

• Work on getting dcli to install under alpine docker image.
• reduced progress messages when ansi not supported.
• Added logic to move the dart-sdk to the write directory after expanding it. Added execute permissions to files in dart/bin directory. reduced the no. of progress messages.
• Now printing out the dir dart is installed into.
• Terminal: added method to check if ansi escapses are supported.
• suppressed asking the user to confirm the install path.
• Fixed a bug where moveTree wasn't actually recursive.
• Added a fallback mechanism on linux system to install from the archive if apt isn't found.

1.8.18

• Fixed a number of bugs around shell detection when one can't be determined.
• exists() - added test for null or empty path.
• dcli install - added a --nodart option to suppress installation of dart.
• Fixed bugs in windows stackframe parsing.
• Added install link for windows dcli_install.

1.8.17

another script path error.

1.8.16

Fixed for doctor when some paths missing.

1.8.15

• Created github actions to generated linux and windows installer for dcli and dart.
• Change copyDir to copyTree.
• Changed moveDir to moveTree.
• Created new simplified moveDir that just moves the top level dir.
• Created a 'fetch' method for downloading files.
• add logic to check if shell has a start script. Only trys to add a path when it does.
• Fixed a npe when who doesn't return a user.
• trying to improve the error message with .run is called and fails.
• fixed an npe if the SHELL env var doesn't exist.
• change paths to use truepath for consistency.
• fixed broken brackets in readme.md
• Developed code to download dartsdk from google archive and wrote test for same.
• refactored the ansi classes and introduced additional methods for controlling a terminal.
• added method to format a double as a percentage.
• added cursor management.
• dart_install for linux
• workflow to create installer each time we do a release.

1.8.14

• moved mockit to dev dependencies.
• For the moment I've wound back the privileged requirements for install as it makes unit tests fail.
• fixed unit tests to deal with unordered file lists.
• Added logic to handling moving files between partitions. We fallback to doing a copy then delete.
• Added .dcli/bin to path during install.
• work on improving shell detection
• Now using our own version of recase.
• now using official pub_release.
• changed writeToFile to saveToFile as felt it was more evocative.
• removed dependancy on recase as was causing conflicts and we only use one line from it.
• now exporting pubspec_file as its a useful class.
• Added nothrow option to string start method.
• restructured shell related classes as part of work to improve shell detection.
• incorrect case in help.
• seplling.
• Fixed a bug where running 'dcli help ' wouldn't print the command help but did print the entire usage.
• made the path columns wider.
• colour coded the shell name.
• fixed warning.
• v 0.1.0 of docker cli for dcli.
• Work on installing dcli using sudo and as a root user. Added priviledged required message.
• The default script was using a relative path when it should be using a package.

1.8.14-dev.3

Added null check around sourcePath.

1.8.14-dev.2

Removed ReCase as a dependency as its used in lots of other project causing dependency conflicts.

1.8.14-dev.1

• Work on improving shell detection.
• Added nothrow to string_as_process start method.
• Exposed PubSpec_File class as part of the public api.

1.8.13

• fixed indentation problem. released 1.8.13
• exposed SortDirection required for FileSort.
• applied effective dart.
• Had max/min back to front for Menu options.

1.8.13-dev.1

• [ENH] Work on a docker based cli for dcli.
• [FIX] unknown shell no returns false for priviliged user to avoid npe.
• [Fix] for macos which by default only supports 127.0.0.1.
• [ENH] added logic to fix permission when dcli rans as root.
• [FIX] bug when determing pub-cache path if environment variable set.
• [ENH] added new methods loggedInUser and isPrivilegedUser.
• [ENH] released dcli_install as a binary so people could easily install dcli.

1.8.12

• [ENH] created a command to upgrade dcli.
• [DOC] cleaned up the public interface by making a number a items private.
• [IMP] changed color for command messages for consistency.
• [IMP] removed clean all as when you first install as there should be no projects. dcli upgrade on the other hand does need to do a clean all.
• [IMP] cleaned up invalid argument processing.
• [FIX] Fixed a bug which allowed install to be run from sudo.

1.8.11

• [enh] adding validation to ask.
• [imp] moved the cleanall after the install has completed so that compile errors don't stop the install completeing.
• [bug] Fix for Service.getIsolateID returning null in compiled script. The hashcode should be a stable substitute. The question is why is getIsolateID only failing in some compiled scripts.

1.8.10

Fixed bug in glob expansion where a relative path with ../ was mistaken for a hidden path.

1.8.9

second go at fixing the compile install bug.

1.8.8

[BUG] dcli compile was failing to install due to move bug.

• reformatted error so you can copy paste cmdline for testing.
• bug in move as overwrite did not have a default value.

1.8.7

[ENH] added copyDir and moveDir functions.

1.8.6

[BUG] bug in the quote handling of startsWithArgs

1.8.5

• [ENH] Exposed NamedLock as part of the official dcli api.
  • Tidied up the NamedLock documentation and removed internal implementation from the api.
• [ENH] changed how we handle quoted arguments when the startWithArgs method is called. We no longer strip quotes from passed arguments because if you pass quotes you probably really need them to be there. This differs from passing cmdLine where we need to strip the quotes as bash does.
• [ENH] added logic to suppress color codes if terminal doesn't support them.
• [ENH] added support for backspace when entering hidden text for ask.
• [CLEANUP] dog fooding the internals of VirtualProject.

1.8.4

• This release is primarily about getting dcli to work correctly under windows.

• There is still a no. of significant issues that need to be resolve for windows.

• This release however has sufficient improvements for general dcli users that I thought it was time for a release.

• The core windows issues is that dart2native doesn't support symlinks so compilation doesn't work.

• This is affecting unit tests so its a little hard to evaluate just how stable the windows release.

• Having said that it does look like dcli is broadly working under windows.

• I will be attempting to resolve these issues over the next week or so.

• This release also fixes an issue that Mac uses had that stopped them compiling dcli.

• It appears that the logger package has a problem (Invalid cid) that stopped compilation on Mac, windows and Rasp Pi. I've removed this package and now compilation seems to work fine.

1.8.3

• [fix] Compile fixes when project has local pubspec.yaml.
• [enh] Added experimental parser to string_process which allows reading and parsing a number of common file formats.
• [enh] Added glob expansion when running command lines.
• [enh] New NamedLock class provides an inter isoloate and inter process locking mechanism.
• [enh] Improvements to documentation.
• [enh] New method on FileSync to create a temp file.
• [enh] Version of start which takes a command and an arg array to provide a simplified path
• when complex escaping is involved.
• [fix] For unit test so that all test can now complete in a single run.
• [fix] Start was not passing the Progress down.
• [fix] Bug in tab completion when expanding scripts.
• [fix] Two compiler bugs. It was trying to compile scripts in subdirectories when we are only meant to compile scripts in the current directory. Fixed bug where local pubspec.yaml was being ignored.

1.8.3

Added start method which takes an arg array to avoid escaping lots of quotes.