Update documentation and contributors

docs/api.rst

@@ -186,7 +186,7 @@ SevenZipFile Object
  py7zr looks for files and directories as same as specified in element
  of 'targets'.
 
- When the method get a ``str`` object or another object other than collection
+ When the method gets a ``str`` object or another object other than collection
  such as LIST or SET, it will raise :exc:`TypeError`.
 
  Once extract() called, the ``SevenZipFile`` object become exhausted,
@@ -199,6 +199,20 @@ SevenZipFile Object
  'somedir/somefile' then pass a list: ['somedirectory', 'somedir/somefile']
  as a target argument.
 
+
+.. py:method:: SevenZipFile.extract(path=None, targets=None, recursive=True)
+
+ 'recursive' is a BOOLEAN which if set True, helps with simplifying subcontents
+ extraction.
+
+ Instead of specifying all files / directories under a parent
+ directory by passing a list of 'targets', specifying only the parent directory
+ and setting 'recursive' to True forces an automatic extraction of all
+ subdirectories and subcontents recursively.
+
+ If 'recursive' is not set, it defaults to False, so the extraction proceeds as
+ if the parameter did not exist.
+
  Please see 'tests/test_basic.py: test_py7zr_extract_and_getnames()' for
  example code.
 
@@ -210,6 +224,8 @@ SevenZipFile Object
  targets = [f if filter_pattern.match(f) for f in allfiles]
  with SevenZipFile('archive.7z', 'r') as zip:
  zip.extract(targets=targets)
+ with SevenZipFile('archive.7z', 'r') as zip:
+ zip.extract(targets=targets, recursive=True)
 
 
 .. py:method:: SevenZipFile.readall()

docs/authors.rst

@@ -23,6 +23,7 @@ Contributors, listed alphabetically, are:
 * Kyle Altendorf -- Fix multithreading problem (#82)
 * Martin Larralde -- Fix writef method (#397)
 * Megan Leet -- Fix infinite loop when extraction (#354)
+* Nikolaos Episkopos -- Add recursive subdirectories extraction (#585)
 * @padremayi -- Fix crash on wrong crationtime in archive (#275)
 * @royopa -- Fix typo (#108)
 * Sergei -- Update report_update() (#558)