feat&perf: add temporary directory parameter, all files generated by the plugin will be moved to the temporary directory

Author: insistence

dash_tailwindcss_plugin/cli.py

@@ -38,19 +38,24 @@ def run(self):
             action='append',
             help='Glob pattern for files to scan for Tailwind classes. Can be specified multiple times.',
         )
+        parser.add_argument(
+            '--plugin-tmp-dir',
+            default='./_tailwind',
+            help='Path to temporary directory for plugin files',
+        )
         parser.add_argument(
             '--input-css-path',
-            default='./.tailwind/tailwind_input.css',
+            default='./_tailwind/tailwind_input.css',
             help='Path to input CSS file',
         )
         parser.add_argument(
             '--output-css-path',
-            default='./.tailwind/tailwind.css',
+            default='./_tailwind/tailwind.css',
             help='Path to output CSS file',
         )
         parser.add_argument(
             '--config-js-path',
-            default='./.tailwind/tailwind.config.js',
+            default='./_tailwind/tailwind.config.js',
             help='Path to Tailwind config file',
         )
         parser.add_argument(
@@ -97,6 +102,7 @@ def run(self):
             npx_path=node_manager.npx_path,
             tailwind_version=args.tailwind_version,
             content_path=args.content_path if args.content_path else ['**/*.py'],
+            plugin_tmp_dir=args.plugin_tmp_dir,
             input_css_path=args.input_css_path,
             output_css_path=args.output_css_path,
             config_js_path=args.config_js_path,

dash_tailwindcss_plugin/plugin.py

@@ -15,9 +15,10 @@ def __init__(
         mode: Literal['offline', 'online'] = 'offline',
         tailwind_version: Literal['3', '4'] = '3',
         content_path: List[str] = ['**/*.py'],
-        input_css_path: str = '.tailwind/tailwind_input.css',
-        output_css_path: str = '.tailwind/tailwind.css',
-        config_js_path: str = '.tailwind/tailwind.config.js',
+        plugin_tmp_dir: str = '_tailwind',
+        input_css_path: str = '_tailwind/tailwind_input.css',
+        output_css_path: str = '_tailwind/tailwind.css',
+        config_js_path: str = '_tailwind/tailwind.config.js',
         cdn_url: str = 'https://cdn.tailwindcss.com',
         download_node: bool = False,
         node_version: str = '18.17.0',
@@ -33,6 +34,7 @@ def __init__(
             mode (Literal['offline', 'online']): Mode of operation ('offline' or 'online')
             tailwind_version (Literal['3', '4']): Version of Tailwind CSS
             content_path (List[str]): Glob patterns for files to scan for Tailwind classes
+            plugin_tmp_dir (str): Temporary directory for plugin files
             input_css_path (str): Path to input CSS file
             output_css_path (str): Path to output CSS file
             config_js_path (str): Path to Tailwind config file
@@ -57,6 +59,7 @@ def __init__(
                 npx_path=node_manager.npx_path,
                 tailwind_version=tailwind_version,
                 content_path=content_path,
+                plugin_tmp_dir=plugin_tmp_dir,
                 input_css_path=input_css_path,
                 output_css_path=output_css_path,
                 config_js_path=config_js_path,
@@ -66,6 +69,7 @@ def __init__(
         self.mode = mode
         self.tailwind_version = tailwind_version
         self.content_path = content_path
+        self.plugin_tmp_dir = plugin_tmp_dir
         self.input_css_path = input_css_path
         self.output_css_path = output_css_path
         self.config_js_path = config_js_path
@@ -204,9 +208,10 @@ def setup_tailwindcss_plugin(
     mode: Literal['online', 'offline'] = 'offline',
     tailwind_version: Literal['3', '4'] = '3',
     content_path: List[str] = ['**/*.py'],
-    input_css_path: str = '.tailwind/tailwind_input.css',
-    output_css_path: str = '.tailwind/tailwind.css',
-    config_js_path: str = '.tailwind/tailwind.config.js',
+    plugin_tmp_dir: str = '_tailwind',
+    input_css_path: str = '_tailwind/tailwind_input.css',
+    output_css_path: str = '_tailwind/tailwind.css',
+    config_js_path: str = '_tailwind/tailwind.config.js',
     cdn_url: str = 'https://cdn.tailwindcss.com',
     download_node: bool = False,
     node_version: str = '18.17.0',
@@ -222,6 +227,7 @@ def setup_tailwindcss_plugin(
         mode (Literal['online', 'offline']): Mode of operation ('offline' or 'online')
         tailwind_version (Literal['3', '4']): Version of Tailwind CSS
         content_path (List[str]): Glob patterns for files to scan for Tailwind classes
+        plugin_tmp_dir (str): Temporary directory for plugin files
         input_css_path (str): Path to input CSS file
         output_css_path (str): Path to output CSS file
         config_js_path (str): Path to Tailwind config file
@@ -237,6 +243,7 @@ def setup_tailwindcss_plugin(
         mode=mode,
         tailwind_version=tailwind_version,
         content_path=content_path,
+        plugin_tmp_dir=plugin_tmp_dir,
         input_css_path=input_css_path,
         output_css_path=output_css_path,
         config_js_path=config_js_path,

dash_tailwindcss_plugin/utils.py

@@ -337,6 +337,7 @@ def __init__(
         npx_path: str,
         tailwind_version: Literal['3', '4'],
         content_path: List[str],
+        plugin_tmp_dir: str,
         input_css_path: str,
         output_css_path: str,
         config_js_path: str,
@@ -370,6 +371,10 @@ def __init__(
         self.config_js_path = config_js_path
         self.is_cli = is_cli
         self.theme_config = theme_config or {}
+        # Ensure the tailwind_plugin directory exists
+        self.plugin_tmp_dir = plugin_tmp_dir
+        if not os.path.exists(self.plugin_tmp_dir):
+            os.makedirs(self.plugin_tmp_dir)
 
     def create_default_input_tailwindcss(self):
         """
@@ -463,7 +468,7 @@ def _check_npm_init(self) -> bool:
         Returns:
             bool: True if npm init has been run, False otherwise
         """
-        return os.path.exists('package.json')
+        return os.path.exists(f'{self.plugin_tmp_dir}/package.json')
 
     def _check_tailwindcss(self) -> bool:
         """
@@ -474,7 +479,7 @@ def _check_tailwindcss(self) -> bool:
         """
         check_cmd = [self.npx_path, f'{self._tailwind_cli} --help']
 
-        result = subprocess.run(check_cmd, capture_output=True, text=True, env=self.node_env)
+        result = subprocess.run(check_cmd, capture_output=True, text=True, cwd=self.plugin_tmp_dir, env=self.node_env)
         return result.returncode == 0
 
     def init(self) -> Self:
@@ -516,7 +521,9 @@ def init(self) -> Self:
 
             if not self._check_npm_init():
                 init_cmd = [self.npm_path, 'init', '-y']
-                result = subprocess.run(init_cmd, capture_output=True, text=True, env=self.node_env)
+                result = subprocess.run(
+                    init_cmd, capture_output=True, text=True, cwd=self.plugin_tmp_dir, env=self.node_env
+                )
                 if result.returncode != 0:
                     raise RuntimeError(result.stderr)
 
@@ -544,7 +551,9 @@ def install(self) -> Self:
                     '-D',
                     *self._tailwind_package,
                 ]
-                result = subprocess.run(install_cmd, capture_output=True, text=True, env=self.node_env)
+                result = subprocess.run(
+                    install_cmd, capture_output=True, text=True, cwd=self.plugin_tmp_dir, env=self.node_env
+                )
                 if result.returncode != 0:
                     raise RuntimeError(result.stderr)
 
@@ -567,7 +576,7 @@ def build(self) -> Self:
         try:
             build_cmd: list[str] = [
                 self.npx_path,
-                self._tailwind_cli,
+                f'{self.plugin_tmp_dir}/node_modules/{self._tailwind_cli}',
                 '-i',
                 self.input_css_path,
                 '-o',
@@ -601,7 +610,7 @@ def watch(self) -> Self:
         try:
             watch_cmd = [
                 self.npx_path,
-                self._tailwind_cli,
+                f'{self.plugin_tmp_dir}/node_modules/{self._tailwind_cli}',
                 '-i',
                 self.input_css_path,
                 '-o',
@@ -632,12 +641,12 @@ def clean(self) -> Self:
         try:
             files_to_remove = [
                 self.config_js_path,
-                'package.json',
-                'package-lock.json',
+                f'{self.plugin_tmp_dir}/package.json',
+                f'{self.plugin_tmp_dir}/package-lock.json',
                 self.input_css_path,
             ]
 
-            directories_to_remove = ['node_modules']
+            directories_to_remove = [f'{self.plugin_tmp_dir}/node_modules']
 
             # Remove files
             for file_path in files_to_remove: