https://github.com/2called-chaos/dle

Directory List Edit – Edit file structures in your favorite editor!
https://github.com/2called-chaos/dle

cli command-line dle filemanager filesystem ruby utility

Last synced: 24 days ago
JSON representation

Directory List Edit – Edit file structures in your favorite editor!

• Host: GitHub
• URL: https://github.com/2called-chaos/dle
• Owner: 2called-chaos
• License: mit
• Created: 2014-04-24T04:06:46.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2015-04-09T22:30:28.000Z (over 9 years ago)
• Last Synced: 2024-09-17T03:35:51.080Z (about 2 months ago)
• Topics: cli, command-line, dle, filemanager, filesystem, ruby, utility
• Language: Ruby
• Size: 215 KB
• Stars: 8
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
# DLE

**Directory List Edit – Edit file structures in your favorite editor!**

You can copy, move, rename, chmod, chown or remove individual files or directories with your favorite text editor.

**BETA product, use at your own risk, use `--simulate` to be sure, always have a backup!**

[![YouTube](http://img.youtube.com/vi/-xfnx3VQvNQ/mqdefault.jpg)](https://www.youtube.com/watch?v=-xfnx3VQvNQ)

**[▶ See it in action](https://www.youtube.com/watch?v=-xfnx3VQvNQ)**

## Requirements

You will need a UNIX system with a working Ruby (>= 1.9.3) installation, sorry Windozer!

## Installation

Simple as:

    $ gem install dle

You may also want to define your favorite editor by setting this enviromental variable (in your profile or bashrc):

    export DLE_EDITOR="subl -w"

Note that you need a blocking call to the editor (for GUI editors). Sublime and Textmate both accept `-w` or `--wait`.

## Usage

To get a list of available options invoke DLE with the `--help` or `-h` option:

    Usage: dle [options] base_directory

    # Application options

        -d, --dotfiles                   Include dotfiles (unix invisible)

        -r, --skip-review                Skip review changes before applying

        -s, --simulate                   Don't apply changes, show commands instead

        -f, --file DLFILE                Use input file (be careful)

        -o, --only pattern               files, dirs or regexp (without delimiters)

                                           e.g.: dle ~/Movies -o "(mov|mkv|avi)$"

        -a, --apply NAMED,FILTERS        Filter collection with saved filters

        -q, --query                      Filter collection with ruby code

        -e, --edit FILTER                Edit/create filter scripts

    # General options

        -m, --monochrome                 Don't colorize output

        -h, --help                       Shows this help

        -v, --version                    Shows version and other info

        -z                               Do not check for updates on GitHub (with -v/--version)

            --console                    Start console to play around with the collection (requires pry)

Change into a directory you want to work with and invoke DLE:

    dle .

    dle ~/some_path

Your editor will open with a list of your directory structure which you can edit accordingly to these rules:

  * If you remove a line we just don't care!

  * If you add a line we just don't care!

  * If you change a path we will "mkdir -p" the destination and move the file/dir

  * If you change the owner we will "chown" the file/dir

  * If you change the mode we will "chmod" the file/dir

  * If you change the mode to "cp" and modify the path we will copy instead of moving/renaming

  * If you change the mode to "del" we will "rm" the file

  * If you change the mode to "delr" we will "rm" the file or directory

  * If you change the mode to "delf" or "delrf" we will "rm -f" the file or directory

  * We will apply changes in this order (inside-out):

    * Ownership

    * Permissions

    * Rename/Move

    * Copy

    * Delete

### Filters

You can easily filter your movies with Ruby. It's not hard, just look at these examples.

```ruby

# Filter by name, for regex see http://rubular.com

@fs.index.reject! {|inode, node| node.basename =~ /whatever/i }

# Only big files

@fs.index.select! {|inode, node| node.file? && node.size > 1024 * 1024 * 10 }

# Sort by size

@fs.index.replace Hash[@fs.index.sort_by{|inode, node| node.size }.reverse]

```

## Caveats

DLE relies on inode values, do not use with hardlinks! This may lead to unexpected file operations or data loss!

## Contributing

1. Fork it ( http://github.com/2called-chaos/dle/fork )

2. Create your feature branch (`git checkout -b my-new-feature`)

3. Commit your changes (`git commit -am 'Add some feature'`)

4. Push to the branch (`git push origin my-new-feature`)

5. Create new Pull Request