allow integer values for multi

README.rst

@@ -74,7 +74,11 @@ The following is the full list of parameters.  Please pass them as
    For both modes, the function returns ``None`` if nothing is matched or
    a user cancelled.
 
-   ``False`` by default.
+   It is also possible to provide an integer value ``>0`` instead of ``True``/``False``.
+   This limits the amount of possible selections. If an integer is provided,
+   the return value is a list if one or more elements were selected and ``None`` else.
+
+   ``None`` by default.
 
    Corresponds to ``-m``/``--multi`` option.
 
@@ -183,12 +187,17 @@ is 3.4.5.
 
 .. _Semantic Versioning: http://semver.org/
 
-
 Version 0.6.0.20.0
 ~~~~~~~~~~~~~~~~~~
 
 To be released.  Bundles ``fzf`` 0.20.0.
 
+- Changed ``multi`` option to allow numeric values as well.
+  e.g. ``iterfzf(list, multi=15)`` allows the selection of at most 15 items.
+  [`#11`__ by Abraham Hinteregger]
+
+__ https://github.com/dahlia/iterfzf/pull/11
+
 
 Version 0.5.0.20.0
 ~~~~~~~~~~~~~~~~~~

iterfzf/__init__.py

@@ -29,7 +29,7 @@ def iterfzf(
     # Search mode:
     extended=True, exact=False, case_sensitive=None,
     # Interface:
-    multi=False, mouse=True, print_query=False,
+    multi=None, mouse=True, print_query=False,
     # Layout:
     prompt='> ',
     preview=None,
@@ -43,8 +43,14 @@ def iterfzf(
         cmd.append('+i' if case_sensitive else '-i')
     if exact:
         cmd.append('--exact')
-    if multi:
-        cmd.append('--multi')
+    if multi is not None:
+        if isinstance(multi, bool):
+            if multi:
+                cmd.append('--multi')
+        elif isinstance(multi, int) and multi > 0:
+            cmd.append('--multi=' + str(multi))
+        else:
+            raise ValueError('multi must be either bool or an int>0')
     if not mouse:
         cmd.append('--no-mouse')
     if print_query:

iterfzf/__init__.pyi

@@ -1,4 +1,4 @@
-from typing import AnyStr, Iterable, Optional
+from typing import AnyStr, Iterable, Optional, Union
 
 BUNDLED_EXECUTABLE: Optional[str]
 
@@ -9,7 +9,7 @@ def iterfzf(
     exact: bool = ...,
     case_sensitive: Optional[bool] = ...,
     # Interface:
-    multi: bool = ...,
+    multi: Optional[Union[bool,int]] = ...,
     mouse: bool = ...,
     print_query: bool = ...,
     # Layout: