Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/moonpyk/dtrx

Intelligent archive extraction
https://github.com/moonpyk/dtrx

Last synced: about 1 month ago
JSON representation

Intelligent archive extraction

Awesome Lists containing this project

README 

        
====

dtrx

====



----------------------------------

cleanly extract many archive types

----------------------------------



:Author: Brett Smith 

:Date:   2011-11-19

:Copyright:



  dtrx 7.1 is copyright © 2006-2011 Brett Smith and others.  Feel free to

  send comments, bug reports, patches, and so on.  You can find the latest

  version of dtrx on its home page at

  .

  

  dtrx is free software; you can redistribute it and/or modify it under the

  terms of the GNU General Public License as published by the Free Software

  Foundation; either version 3 of the License, or (at your option) any

  later version.

  

  This program is distributed in the hope that it will be useful, but

  WITHOUT ANY WARRANTY; without even the implied warranty of

  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General

  Public License for more details.

  

  You should have received a copy of the GNU General Public License along

  with this program; if not, see .



:Version: 7.1

:Manual section: 1



SYNOPSIS

========



dtrx [OPTIONS] ARCHIVE [ARCHIVE ...]



DESCRIPTION

===========



dtrx extracts archives in a number of different formats; it currently

supports tar, zip (including self-extracting .exe files), cpio, rpm, deb,

gem, 7z, cab, rar, lzh, and InstallShield files.  It can also decompress

files compressed with gzip, bzip2, lzma, xz, or compress.



In addition to providing one command to handle many different archive

types, dtrx also aids the user by extracting contents consistently.  By

default, everything will be written to a dedicated directory that's named

after the archive.  dtrx will also change the permissions to ensure that the

owner can read and write all those files.



To run dtrx, simply call it with the archive(s) you wish to extract as

arguments.  For example::



   $ dtrx coreutils-5.*.tar.gz



You may specify URLs as arguments as well.  If you do, dtrx will use `wget

-c` to download the URL to the current directory and then extract what it

downloads.  This may fail if you already have a file in the current

directory with the same name as the file you're trying to download.



OPTIONS

=======



dtrx supports a number of options to mandate specific behavior:



-r, --recursive

   With this option, dtrx will search inside the archives you specify to see

   if any of the contents are themselves archives, and extract those as

   well.



--one, --one-entry

   Normally, if an archive only contains one file or directory with a name

   that doesn't match the archive's, dtrx will ask you how to handle it.

   With this option, you can specify ahead of time what should happen.

   Possible values are:



   inside

      Extract the file/directory inside another directory named after the

      archive.  This is the default.



   rename

      Extract the file/directory in the current directory, and then rename

      it to match the name of the archive.



   here

      Extract the file/directory in the current directory.



-o, --overwrite

   Normally, dtrx will avoid extracting into a directory that already exists,

   and instead try to find an alternative name to use.  If this option is

   listed, dtrx will use the default directory name no matter what.



-f, --flat

   Extract all archive contents into the current directory, instead of

   their own dedicated directory.  This is handy if you have multiple

   archive files which all need to be extracted into the same directory

   structure.  Note that existing files may be overwritten with this

   option.



-n, --noninteractive

   dtrx will normally ask the user how to handle certain corner cases, such

   as how to handle an archive that only contains one file.  This option

   suppresses those questions; dtrx will instead use sane, conservative

   defaults.



-l, -t, --list, --table

   Don't extract the archives; just list their contents on standard output.



-m, --metadata

   Extract the metadata from .deb and .gem archives, instead of their normal

   contents.



-q, --quiet

   Suppress warning messages.  List this option twice to make dtrx silent.



-v, --verbose

   Show the files that are being extracted.  List this option twice to

   print debugging information.



--help

   Display basic help.



--version

   Display dtrx's version, copyright, and license information.