tree-view-nodnd

tldr; : Quick Install

# disable core package: "tree-view"
apm disable "tree-view"

# print the version of "tree-view"
apm list -pb | grep 'tree-view@' | sed 's/tree-view@//g'

# choose the directory corresponding to a version number <= version of "tree-view"
# this assures the most appropriate set of scripts
cd '0.215.1'

# for the security minded: wipe all package data and start over
rm *.zip *.7z

# install community package: "tree-view-nodnd"
cd '.scripts'
./1_apply_patch.sh
./2_install.sh

Background

The Atom text editor includes the core package: tree-view.

This tree view includes a drag-and-drop feature to enable moving files and directories.

Personally, I would never intentionally use this feature. However, there are many times that I feel as though I may have accidentally moved files. There's no log to check to confirm that such an operation has happened. And there's no easy way to undo such an operation. It's a dangerous feature to have enabled. However, Atom doesn't include any configurable option to disable this feature. There have been several issues (ex: 566, 588, 996, ...) and feature requests from users asking for this configuration option. However, the core team rejects pull requests and is adamant that it's a good feature and everyone should shutup and like it.

Some of my favorite contributions include:

• pull request 623 by user: Tyriar
  • adds the boolean option: "Enable Drag and Drop"
• commit by user: marceloadsj
  • adds a confirmation dialog to drop events, which prompts the user to confirm the move operation before it is allowed to occur

However, there isn't any fork that includes both options. Even if there was, I don't want to be stuck using a particular version of the package from several years ago. And I'm against downloading pre-built packages from users who I don't know, and don't trust.

Instead, I combined both of these ideas and wrote shell scripts that will apply the necessary changes as a patch against any fairly current release.

• script 1 (1_apply_patch.sh):
  • downloads a specific (ie: target) version of "tree-view" from github
  • unzips it
  • applies a few in-place text edits
  • zips up a modified 7-zip archive
• script 2 (2_install.sh):
  • copies the modified 7-zip archive to Atom's packages directory
  • unzips it
  • installs it

The code is easy to audit, so it can be used safely. The only "coding" a user needs to perform is to update a configuration file to specify the target version of "tree-view".

Installation Instructions

• start Atom:
  • Edit > Preferences > Packages
  • under "Core Packages",
    scroll nearly to the bottom and find the package named: "tree-view"
  • click: "Disable"
  • tip:
    • make a note of which version this is
• exit Atom
• (optional) edit the file: ./.scripts/0_config.sh
  • configure the name for the new package
    • default: "tree-view-nodnd"
  • configure the version of "tree-view" to download and patch
    • default: same as core package that is bundled with Atom (and is now disabled)
    • tip:
      • if you hard-code a version number:
        • confirm that your value obeys the rules of semantic versioning
        • confirm there exists a corresponding release
          • note: tags prepend "v" to the semantic version number
          • example: version '0.215.1' is tagged 'v0.215.1'
• run:

cd ./.scripts
./1_apply_patch.sh
./2_install.sh

• start Atom:
  • Edit > Preferences > Packages
  • under "Community Packages",
    you'll see the newly installed package
    (displayed using the name as it was configured)
  • it should already be enabled
  • in its "Settings",
    • "Enable Drag and Drop" is disabled by default
    • "Confirm Drag and Drop" is enabled by default

Uninstall Instructions (GUI)

• start Atom:
  • Edit > Preferences > Packages
    • "Community Packages" > "tree-view-nodnd"
      • click: "Uninstall"
    • "Core Packages" > "tree-view"
      • click: "Enable"

Uninstall Instructions (command-line)

apm remove "tree-view-nodnd"
apm enable "tree-view"

Final Comments

• though the scripts should work on all recent versions of "tree-view" without requiring any changes
  • this repo includes them under specific version(s)
  • if a new version of "tree-view" was to make a change that requires a slight modification to 1_apply_patch.sh
    • a new directory named for that version will be added to this repo
    • updated scripts will be included within that directory
  • to avoid any version mis-match between the "tree-view-nodnd" package and Atom,
    it's advisable that the target version to patch is the same as the version of "tree-view" bundled with Atom
    • to determine this version number, run:
      apm list -pb | grep 'tree-view@' | sed 's/tree-view@//g'
      
    • to find the correct scripts:
      • look for directory in this repo corresponding to a version number that is less-than or equal-to the target
      • copy, (optionally) configure, and run the scripts contained there-in
  • note:
    • the initial directory corresponds to version number: '0.215.1'
    • this version number has no real significance,
      other than the fact that this is the version of "tree-view"
      that is bundled as a core package in Atom: 1.16.0 x64 Ubuntu,
      which happens to be the release used for testing
    • the scripts in this directory are likely to work with older versions of "tree-view",
      but I'm not aware of where this compatibility breaks
• each directory in this repo corresponding to a version number contains data files that can safely be deleted:
  • the unmodified .zip archive (downloaded from github by 1_apply_patch.sh)
  • the modified .7z archive (produced as output by 1_apply_patch.sh)

Addons

• there are other branches in this repo
  • each branch is an orphan
  • each branch contains an "addon" that is unrelated to "drag and drop"
• each "addon" consists of additional bash scripts that apply patches to the "community package" variation of "tree-view" that is installed by the bash scripts in the "master" branch
• each "addon" adds a new feature or enhancement
• the list of available "addons" includes:
  • option to disable colors based on state in VCS
  • context menu item to recursively expand/collapse directory
  • context menu item to open directory in terminal
    note:
    • Has been tested in Linux (Lubuntu w/ lxterminal).
    • Has not been tested in Windows or Mac; would appreciate feedback.