Fix more instances of present tense in docstrings

Author: ctrueden

src/appose/__init__.py

@@ -389,7 +389,7 @@ def custom() -> SimpleBuilder:
 def _is_url(source: str) -> bool:
     """
     Check if string appears to be a URL.
-    Detects common URL schemes (http, https, ftp, file, jar) by using
+    Detect common URL schemes (http, https, ftp, file, jar) by using
     a pattern of 3+ letter scheme followed by "://" to avoid matching
     Windows drive letters like "C:".
 

src/appose/builder/__init__.py

@@ -217,7 +217,7 @@ def base(self, env_dir: str | Path) -> Builder:
     @abstractmethod
     def channels(self, *channels: str) -> Builder:
         """
-        Adds channels/repositories to search for packages.
+        Add channels/repositories to search for packages.
 
         The interpretation of channels is builder-specific:
         - Pixi/Mamba: conda channels (e.g., "conda-forge", "bioconda")
@@ -233,7 +233,8 @@ def channels(self, *channels: str) -> Builder:
 
     def file(self, path: str | Path) -> Builder:
         """
-        Specifies a configuration file to build from.
+        Specify a configuration file to build from.
+
         Reads the file content immediately and delegates to content().
 
         Args:
@@ -255,7 +256,8 @@ def file(self, path: str | Path) -> Builder:
 
     def url(self, url: str) -> Builder:
         """
-        Specifies a URL to fetch configuration content from.
+        Specify a URL to fetch configuration content from.
+
         Reads the URL content immediately and delegates to content().
 
         Args:
@@ -277,7 +279,8 @@ def url(self, url: str) -> Builder:
     @abstractmethod
     def content(self, content: str) -> Builder:
         """
-        Specifies configuration file content to build from.
+        Specify configuration file content to build from.
+
         The scheme will be auto-detected from content syntax.
 
         Args:
@@ -291,7 +294,8 @@ def content(self, content: str) -> Builder:
     @abstractmethod
     def scheme(self, scheme: str) -> Builder:
         """
-        Explicitly specifies the scheme for the configuration.
+        Explicitly specify the scheme for the configuration.
+
         This overrides auto-detection.
 
         Args:
@@ -305,7 +309,7 @@ def scheme(self, scheme: str) -> Builder:
     @abstractmethod
     def subscribe_progress(self, subscriber: ProgressConsumer) -> Builder:
         """
-        Registers a callback to be invoked when progress happens during environment building.
+        Register a callback to be invoked when progress happens during environment building.
 
         Args:
             subscriber: Function to call with (title, current, maximum) when progress happens
@@ -318,7 +322,7 @@ def subscribe_progress(self, subscriber: ProgressConsumer) -> Builder:
     @abstractmethod
     def subscribe_output(self, subscriber: Callable[[str], None]) -> Builder:
         """
-        Registers a callback to be invoked when output is generated during environment building.
+        Register a callback to be invoked when output is generated during environment building.
 
         Args:
             subscriber: Function to call with output strings
@@ -331,7 +335,7 @@ def subscribe_output(self, subscriber: Callable[[str], None]) -> Builder:
     @abstractmethod
     def subscribe_error(self, subscriber: Callable[[str], None]) -> Builder:
         """
-        Registers a callback to be invoked when errors occur during environment building.
+        Register a callback to be invoked when errors occur during environment building.
 
         Args:
             subscriber: Function to call with error strings
@@ -344,7 +348,7 @@ def subscribe_error(self, subscriber: Callable[[str], None]) -> Builder:
     @abstractmethod
     def flags(self, *flags: str) -> Builder:
         """
-        Adds command-line flags to be passed to the underlying tool during build operations.
+        Add command-line flags to be passed to the underlying tool during build operations.
 
         These flags are passed directly to the tool's command-line invocation.
         The interpretation of flags is tool-specific:
@@ -418,7 +422,8 @@ def supports_scheme(self, scheme: str) -> bool:
     @abstractmethod
     def priority(self) -> float:
         """
-        Returns the priority of this builder for scheme resolution.
+        Return the priority of this builder for scheme resolution.
+
         Higher priority builders are preferred when multiple builders support the same scheme.
 
         Returns:
@@ -429,7 +434,7 @@ def priority(self) -> float:
     @abstractmethod
     def can_wrap(self, env_dir: str | Path) -> bool:
         """
-        Checks if this builder can wrap the given existing environment directory.
+        Check if this builder can wrap the given existing environment directory.
 
         Args:
             env_dir: The directory to check
@@ -612,7 +617,8 @@ def __init__(self):
 
     def bin_paths(self, *paths: str) -> SimpleBuilder:
         """
-        Appends additional binary paths to search for executables.
+        Append additional binary paths to search for executables.
+
         Paths are searched in the order they are added.
 
         Args:
@@ -626,7 +632,7 @@ def bin_paths(self, *paths: str) -> SimpleBuilder:
 
     def append_system_path(self) -> SimpleBuilder:
         """
-        Appends the current process's system PATH directories to the environment's binary paths.
+        Append the current process's system PATH directories to the environment's binary paths.
 
         Returns:
             This builder instance
@@ -637,7 +643,8 @@ def append_system_path(self) -> SimpleBuilder:
 
     def inherit_running_java(self) -> SimpleBuilder:
         """
-        Configures the environment to use the same Java installation as the parent process.
+        Configure the environment to use the same Java installation as the parent process.
+
         This prepends ${JAVA_HOME}/bin to the binary paths and sets the JAVA_HOME
         environment variable.
 
@@ -852,7 +859,7 @@ def find_factory_for_wrapping(env_dir: str | Path) -> BuilderFactory | None:
 
 def can_wrap(env_dir: str | Path) -> bool:
     """
-    Checks if the given directory can be wrapped as a known environment type.
+    Check if the given directory can be wrapped as a known environment type.
 
     Args:
         env_dir: The directory to check
@@ -865,7 +872,7 @@ def can_wrap(env_dir: str | Path) -> bool:
 
 def env_type(env_dir: str | Path) -> str | None:
     """
-    Returns the environment type name for the given directory.
+    Return the environment type name for the given directory.
 
     Args:
         env_dir: The directory to check

src/appose/builder/mamba.py

@@ -53,7 +53,7 @@ def env_type(self) -> str:
 
     def build(self) -> Environment:
         """
-        Builds the Mamba environment.
+        Build the Mamba environment.
 
         Returns:
             The newly constructed Environment
@@ -147,7 +147,7 @@ def build(self) -> Environment:
 
     def wrap(self, env_dir: str | Path) -> Environment:
         """
-        Wraps an existing Mamba/conda environment directory.
+        Wrap an existing Mamba/conda environment directory.
 
         Args:
             env_dir: The existing environment directory to wrap
@@ -175,7 +175,7 @@ def wrap(self, env_dir: str | Path) -> Environment:
 
     def _create_environment(self, mamba: Mamba, env_dir: Path) -> Environment:
         """
-        Creates an Environment for the given Mamba/conda directory.
+        Create an Environment for the given Mamba/conda directory.
 
         Args:
             env_dir: The Mamba/conda environment directory
@@ -201,7 +201,7 @@ class MambaBuilderFactory(BuilderFactory):
 
     def create_builder(self) -> Builder:
         """
-        Creates a new MambaBuilder instance.
+        Create a new MambaBuilder instance.
 
         Returns:
             A new MambaBuilder instance
@@ -213,7 +213,7 @@ def env_type(self) -> str:
 
     def supports_scheme(self, scheme: str) -> bool:
         """
-        Checks if this builder supports the given scheme.
+        Check if this builder supports the given scheme.
 
         Args:
             scheme: The scheme to check
@@ -225,7 +225,7 @@ def supports_scheme(self, scheme: str) -> bool:
 
     def priority(self) -> float:
         """
-        Returns the priority for this builder.
+        Return the priority for this builder.
 
         Returns:
             Priority value (higher = more preferred)
@@ -234,7 +234,7 @@ def priority(self) -> float:
 
     def can_wrap(self, env_dir: str | Path) -> bool:
         """
-        Checks if this builder can wrap the given environment directory.
+        Check if this builder can wrap the given environment directory.
 
         Args:
             env_dir: The directory to check

src/appose/builder/pixi.py

@@ -57,7 +57,7 @@ def env_type(self) -> str:
 
     def conda(self, *packages: str) -> PixiBuilder:
         """
-        Adds conda packages to the environment.
+        Add conda packages to the environment.
 
         Args:
             packages: Conda package specifications (e.g., "numpy", "python>=3.8")
@@ -70,7 +70,7 @@ def conda(self, *packages: str) -> PixiBuilder:
 
     def pypi(self, *packages: str) -> PixiBuilder:
         """
-        Adds PyPI packages to the environment.
+        Add PyPI packages to the environment.
 
         Args:
             packages: PyPI package specifications (e.g., "matplotlib", "requests==2.28.0")
@@ -83,7 +83,7 @@ def pypi(self, *packages: str) -> PixiBuilder:
 
     def build(self) -> Environment:
         """
-        Builds the Pixi environment.
+        Build the Pixi environment.
 
         Returns:
             The newly constructed Environment
@@ -230,7 +230,7 @@ def build(self) -> Environment:
 
     def wrap(self, env_dir: str | Path) -> Environment:
         """
-        Wraps an existing Pixi environment directory.
+        Wrap an existing Pixi environment directory.
 
         Args:
             env_dir: The existing environment directory to wrap
@@ -267,7 +267,7 @@ def wrap(self, env_dir: str | Path) -> Environment:
 
     def _create_environment(self, pixi: Pixi, env_dir: Path) -> Environment:
         """
-        Creates an Environment for the given Pixi directory.
+        Create an Environment for the given Pixi directory.
 
         Args:
             env_dir: The Pixi environment directory
@@ -304,7 +304,7 @@ class PixiBuilderFactory(BuilderFactory):
 
     def create_builder(self) -> Builder:
         """
-        Creates a new PixiBuilder instance.
+        Create a new PixiBuilder instance.
 
         Returns:
             A new PixiBuilder instance
@@ -316,7 +316,7 @@ def env_type(self) -> str:
 
     def supports_scheme(self, scheme: str) -> bool:
         """
-        Checks if this builder supports the given scheme.
+        Check if this builder supports the given scheme.
 
         Args:
             scheme: The scheme to check
@@ -328,7 +328,7 @@ def supports_scheme(self, scheme: str) -> bool:
 
     def priority(self) -> float:
         """
-        Returns the priority for this builder.
+        Return the priority for this builder.
 
         Returns:
             Priority value (higher = more preferred)
@@ -337,7 +337,7 @@ def priority(self) -> float:
 
     def can_wrap(self, env_dir: str | Path) -> bool:
         """
-        Checks if this builder can wrap the given environment directory.
+        Check if this builder can wrap the given environment directory.
 
         Args:
             env_dir: The directory to check

src/appose/builder/uv.py

@@ -56,7 +56,7 @@ def __init__(self):
 
     def python(self, version: str) -> UvBuilder:
         """
-        Specifies the Python version to use for the virtual environment.
+        Specify the Python version to use for the virtual environment.
 
         Args:
             version: Python version (e.g., "3.11", "3.10")
@@ -69,7 +69,7 @@ def python(self, version: str) -> UvBuilder:
 
     def include(self, *packages: str) -> UvBuilder:
         """
-        Adds PyPI packages to install in the virtual environment.
+        Add PyPI packages to install in the virtual environment.
 
         Args:
             packages: PyPI package specifications (e.g., "numpy", "requests==2.28.0")
@@ -85,7 +85,7 @@ def env_type(self) -> str:
 
     def build(self) -> Environment:
         """
-        Builds the uv environment.
+        Build the uv environment.
 
         Returns:
             The newly constructed Environment
@@ -200,7 +200,7 @@ def build(self) -> Environment:
 
     def wrap(self, env_dir: str | Path) -> Environment:
         """
-        Wraps an existing uv/venv environment directory.
+        Wrap an existing uv/venv environment directory.
 
         Args:
             env_dir: The existing environment directory to wrap
@@ -237,7 +237,7 @@ def wrap(self, env_dir: str | Path) -> Environment:
 
     def _create_environment(self, env_dir: Path) -> Environment:
         """
-        Creates an Environment for the given uv/venv directory.
+        Create an Environment for the given uv/venv directory.
 
         Args:
             env_dir: The uv/venv environment directory
@@ -272,7 +272,7 @@ class UvBuilderFactory(BuilderFactory):
 
     def create_builder(self) -> Builder:
         """
-        Creates a new UvBuilder instance.
+        Create a new UvBuilder instance.
 
         Returns:
             A new UvBuilder instance
@@ -284,7 +284,7 @@ def env_type(self) -> str:
 
     def supports_scheme(self, scheme: str) -> bool:
         """
-        Checks if this builder supports the given scheme.
+        Check if this builder supports the given scheme.
 
         Args:
             scheme: The scheme to check
@@ -296,7 +296,7 @@ def supports_scheme(self, scheme: str) -> bool:
 
     def priority(self) -> float:
         """
-        Returns the priority for this builder.
+        Return the priority for this builder.
 
         Returns:
             Priority value (higher = more preferred)
@@ -305,7 +305,7 @@ def priority(self) -> float:
 
     def can_wrap(self, env_dir: str | Path) -> bool:
         """
-        Checks if this builder can wrap the given environment directory.
+        Check if this builder can wrap the given environment directory.
 
         Args:
             env_dir: The directory to check

src/appose/python_worker.py

@@ -205,7 +205,7 @@ def __init__(self):
 
     def run(self) -> None:
         """
-        Processes tasks from the task queue.
+        Process tasks from the task queue.
         """
         self.running = True
         Thread(target=self._process_input, name="Appose-Receiver").start()