feat: Added Assets Manager (XcodebuildAssetsManager) (#259)

README.md

@@ -13,6 +13,7 @@ It provides all essential actions for development including building, debugging,
 - [x] Support for Swift Packages (building & testing).
 - [x] Project-based configuration.
 - [x] Project Manager to deal with project files without using Xcode.
+- [x] Assets Manager to manage images, colors, and data assets.
 - [x] Test Explorer to visually present a tree with all tests and results.
 - [x] Built using official command line tools like `xcodebuild` and `xcrun simctl`.
 - [x] Actions to build, run, debug, and test apps on simulators and physical devices.

doc/xcodebuild.txt

@@ -22,6 +22,7 @@ Project Configuration ·····························
 App Data ·········································· |xcodebuild.project.appdata|
 Project Builder ··································· |xcodebuild.project.builder|
 Project Manager ··································· |xcodebuild.project.manager|
+Project Assets Manager ····························· |xcodebuild.project.assets|
 Device ············································ |xcodebuild.platform.device|
 Device Proxy ································ |xcodebuild.platform.device_proxy|
 macOS Platform Integration ························· |xcodebuild.platform.macos|
@@ -228,6 +229,7 @@ Features                                                   *xcodebuild.features*
  - Support for Swift Packages (building & testing).
  - Project-based configuration.
  - Project Manager to deal with project files without using Xcode.
+ - Assets Manager to manage images, colors, and data assets.
  - Test Explorer to visually present a tree with all tests and results.
  - Built using official command line tools like `xcodebuild` and `xcrun simctl`.
  - Actions to build, run, debug, and test apps on simulators and
@@ -449,6 +451,7 @@ Project Manager
  | Command                            | Description                                                |
  | ---------------------------------- | ---------------------------------------------------------- |
  | `XcodebuildProjectManager`           | Show picker with all Project Manager actions               |
+ | `XcodebuildAssetsManager`            | Show picker with all Assets Manager actions                |
  | `XcodebuildCreateNewFile`            | Create a new file and add it to target(s)                  |
  | `XcodebuildAddCurrentFile`           | Add the active file to target(s)                           |
  | `XcodebuildRenameCurrentFile`        | Rename the current file                                    |
@@ -863,6 +866,10 @@ M.test_explorer_rerun_tests()
   Runs last executed tests or all if nothing was executed.
 
 
+M.show_assets_manager()                 *xcodebuild.actions.show_assets_manager*
+  Show the Assets Manager.
+
+
 M.get_project_targets()                 *xcodebuild.actions.get_project_targets*
   Returns project targets.
 
@@ -2233,6 +2240,62 @@ M.show_action_picker()
   Shows the action picker with all available actions.
 
 
+==============================================================================
+Project Assets Manager                               *xcodebuild.project.assets*
+
+This module contains the functionality to manage Xcode project assets.
+
+It allows to add, delete, and browse assets in the project.
+Supported asset types are: images, colors, and data.
+
+                                        *xcodebuild.project.assets.create_image*
+M.create_image({filename}, {path}, {template})
+  Creates a new image set.
+
+  Parameters: ~
+    {filename}  (string)
+    {path}      (string)
+    {template}  (boolean) renderings as template
+
+
+M.create_data({filename}, {path})        *xcodebuild.project.assets.create_data*
+  Creates a new data set.
+
+  Parameters: ~
+    {filename}  (string)
+    {path}      (string)
+
+
+M.create_color({name}, {color}, {path}) *xcodebuild.project.assets.create_color*
+  Creates a new color set.
+
+  Parameters: ~
+    {name}   (string) color name
+    {color}  (string) color in hex format, e.g. #FF0000
+    {path}   (string)
+
+
+                             *xcodebuild.project.assets.create_new_asset_picker*
+M.create_new_asset_picker()
+  Shows a wizard to create a new asset.
+
+
+                                   *xcodebuild.project.assets.show_asset_picker*
+M.show_asset_picker()
+  Shows a picker with all the assets in the project.
+  Opens the asset in Finder or Quick Look.
+
+
+                                 *xcodebuild.project.assets.delete_asset_picker*
+M.delete_asset_picker()
+  Shows a picker to delete an asset.
+
+
+                                 *xcodebuild.project.assets.show_assets_manager*
+M.show_assets_manager()
+  Shows the Assets Manager with all available actions.
+
+
 ==============================================================================
 Device                                              *xcodebuild.platform.device*
 
@@ -4417,7 +4480,7 @@ M.shell({cmd})                                           *xcodebuild.util.shell*
 
 
 M.shellAsync({cmd}, {callback})                     *xcodebuild.util.shellAsync*
-  Runs a shell command and asynchronously.
+  Runs a shell command asynchronously.
 
   Parameters: ~
     {cmd}       (string|string[])

lua/xcodebuild/actions.lua

@@ -20,6 +20,7 @@ local testRunner = require("xcodebuild.tests.runner")
 local projectBuilder = require("xcodebuild.project.builder")
 local projectConfig = require("xcodebuild.project.config")
 local projectManager = require("xcodebuild.project.manager")
+local assetsManager = require("xcodebuild.project.assets")
 local appdata = require("xcodebuild.project.appdata")
 local lsp = require("xcodebuild.integrations.lsp")
 
@@ -310,6 +311,13 @@ function M.test_explorer_rerun_tests()
   testExplorer.repeat_last_run()
 end
 
+-- Assets Management
+
+---Show the Assets Manager.
+function M.show_assets_manager()
+  assetsManager.show_assets_manager()
+end
+
 -- Project Management
 
 ---Returns project targets.

lua/xcodebuild/docs/commands.lua

@@ -26,6 +26,7 @@
 --- | Command                            | Description                                                |
 --- | ---------------------------------- | ---------------------------------------------------------- |
 --- | `XcodebuildProjectManager`           | Show picker with all Project Manager actions               |
+--- | `XcodebuildAssetsManager`            | Show picker with all Assets Manager actions                |
 --- | `XcodebuildCreateNewFile`            | Create a new file and add it to target(s)                  |
 --- | `XcodebuildAddCurrentFile`           | Add the active file to target(s)                           |
 --- | `XcodebuildRenameCurrentFile`        | Rename the current file                                    |

lua/xcodebuild/docs/features.lua

@@ -4,6 +4,7 @@
 --- - Support for Swift Packages (building & testing).
 --- - Project-based configuration.
 --- - Project Manager to deal with project files without using Xcode.
+--- - Assets Manager to manage images, colors, and data assets.
 --- - Test Explorer to visually present a tree with all tests and results.
 --- - Built using official command line tools like `xcodebuild` and `xcrun simctl`.
 --- - Actions to build, run, debug, and test apps on simulators and

lua/xcodebuild/health.lua

@@ -33,7 +33,7 @@ local optional_dependencies = {
   {
     binary = "fd",
     url = "https://github.com/sharkdp/fd",
-    message = "Improves performance when searching for files.",
+    message = "Improves performance when searching for files. Required for Assets Manager.",
   },
 }
 

lua/xcodebuild/init.lua

@@ -329,6 +329,9 @@ function M.setup(options)
   vim.api.nvim_create_user_command("XcodebuildUpdateCurrentFileTargets", call(actions.update_current_file_targets), { nargs = 0 })
   vim.api.nvim_create_user_command("XcodebuildShowCurrentFileTargets", call(actions.show_current_file_targets), { nargs = 0 })
 
+  -- Assets Manager
+  vim.api.nvim_create_user_command("XcodebuildAssetsManager", call(actions.show_assets_manager), { nargs = 0 })
+
   -- Other
   vim.api.nvim_create_user_command("XcodebuildEditEnvVars", call(actions.edit_env_vars), { nargs = 0 })
   vim.api.nvim_create_user_command("XcodebuildEditRunArgs", call(actions.edit_run_args), { nargs = 0 })