Python: Remove the 'max_port' argument from port4me(). This is (a) to…

… harmonize with the R API, and (b) to be conservative for now and only provide a minimal API. We can revisit this later and grow it as needed. [#60]

python/NEWS.md

@@ -1,16 +1,20 @@
 # Version (development version)
 
+## Significant Changes
+
+ * Remove the `max_port` argument from `port4me()`.
+
 ## Miscellaneous
 
-* Add unit test asserting that a bound port is detected as such.
+ * Add unit test asserting that a bound port is detected as such.
 
 ## Bug Fixes
 
-* `port4me(test = port)` would throw an `OSError` exception instead of
-  returning `False` if the port was busy.
+ * `port4me(test = port)` would throw an `OSError` exception instead
+   of returning `False` if the port was busy.
 
-* `port4me(list = 0)` would behave like `list = 1`.  Now it gives it
-  produces an error.
+ * `port4me(list = 0)` would behave like `list = 1`.  Now it gives it
+   produces an error.
 
 
 # Version 0.6.0 [2023-07-13]

python/port4me/__init__.py

@@ -7,7 +7,7 @@
 from os import getenv
 
 
-__version__ = "0.6.0-9009"
+__version__ = "0.6.0-9010"
 __all__ = ["port4me", "port4me_gen"]
 
 
@@ -136,7 +136,7 @@ def port4me_gen(tool=None, user=None, prepend=None, include=None, exclude=None,
 
 
 def port4me(tool=None, user=None, prepend=None, include=None, exclude=None, skip=None,
-            list=None, test=None, max_tries=65535, must_work=True, min_port=1024, max_port=65535):
+            list=None, test=None, max_tries=65535, must_work=True, min_port=1024):
     """
     Find a free TCP port using a deterministic sequence of ports based on the current username.
 
@@ -167,15 +167,13 @@ def port4me(tool=None, user=None, prepend=None, include=None, exclude=None, skip
         If True, then an error is produced if no port could be found. If False, then `-1` is returned.
     min_port : int, optional
         Skips any ports that are smaller than this
-    max_port : int, optional
-        Skips any ports that are larger than this
     """
     if test:
         return is_port_free(test)
 
     tries = 1
 
-    gen = port4me_gen(tool, user, prepend, include, exclude, min_port, max_port)
+    gen = port4me_gen(tool, user, prepend, include, exclude, min_port)
 
     if skip is None:
         skip = getenv("PORT4ME_SKIP", "0")