Use keyword-only style for optional arguments of public APIs (#107)

aiodocker/containers.py

@@ -40,7 +40,7 @@ async def create_or_replace(self, name, config):
 
         return container
 
-    async def create(self, config, name=None):
+    async def create(self, config, *, name=None):
         url = "containers/create"
 
         config = json.dumps(config, sort_keys=True).encode('utf-8')
@@ -56,7 +56,7 @@ async def create(self, config, name=None):
         )
         return DockerContainer(self.docker, id=data['Id'])
 
-    async def run(self, config, name=None):
+    async def run(self, config, *, name=None):
 
         try:
             container = await self.create(config, name)
@@ -102,7 +102,7 @@ def __init__(self, docker, **kwargs):
             "ID", self._container.get("Id")))
         self.logs = DockerLog(docker, self)
 
-    async def log(self, stdout=False, stderr=False, follow=False, **kwargs):
+    async def log(self, *, stdout=False, stderr=False, follow=False, **kwargs):
         if stdout is False and stderr is False:
             raise TypeError("Need one of stdout or stderr")
 
@@ -185,7 +185,7 @@ async def kill(self, **kwargs):
         await response.release()
         return
 
-    async def wait(self, timeout=None, **kwargs):
+    async def wait(self, *, timeout=None, **kwargs):
         data = await self.docker._query_json(
             "containers/{self._id}/wait".format(self=self),
             method='POST',
@@ -230,7 +230,7 @@ async def port(self, private_port):
 
         return h_ports
 
-    async def stats(self, stream=True):
+    async def stats(self, *, stream=True):
         if stream:
             response = await self.docker._query(
                 "containers/{self._id}/stats".format(self=self),

aiodocker/docker.py

@@ -113,7 +113,7 @@ async def version(self):
         data = await self._query_json("version")
         return data
 
-    async def pull(self, image, stream=False):
+    async def pull(self, image, *, stream=False):
         response = await self._query(
             "images/create", "POST",
             params={"fromImage": image},

aiodocker/events.py

@@ -20,7 +20,7 @@ def listen(self):
                       DeprecationWarning, stacklevel=2)
         return self.channel.subscribe()
 
-    def subscribe(self, create_task=True):
+    def subscribe(self, *, create_task=True):
         if create_task:
             self.task = asyncio.ensure_future(self.run())
         return self.channel.subscribe()

aiodocker/swarm.py

@@ -60,7 +60,7 @@ async def inspect(self) -> Dict:
 
         return response
 
-    async def leave(self, force: bool=False) -> bool:
+    async def leave(self, *, force: bool=False) -> bool:
         """
         Leave a swarm