rhapsody-cli 0.1.0__tar.gz → 0.2.0__tar.gz

{rhapsody_cli-0.1.0/src/rhapsody_cli.egg-info → rhapsody_cli-0.2.0}/PKG-INFO

@@ -1,12 +1,13 @@
 Metadata-Version: 2.4
 Name: rhapsody-cli
-Version: 0.1.0
+Version: 0.2.0
 Summary: Pythonic wrapper around the IBM Rhapsody COM API, mirroring the Rhapsody Java API
 License: MIT
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: pywin32>=306; sys_platform == "win32"
+Requires-Dist: PyYAML>=6.0
 Provides-Extra: dev
 Requires-Dist: pytest>=7.4; extra == "dev"
 Requires-Dist: pytest-cov>=4.1; extra == "dev"
@@ -20,7 +21,7 @@ Dynamic: license-file
 
 # rhapsody-cli
 
-[![Version](https://img.shields.io/badge/version-0.1.0-blue.svg)](https://github.com/user/rhapsody-cli)
+[![Version](https://img.shields.io/badge/version-0.2.0-blue.svg)](https://github.com/user/rhapsody-cli)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 [![Python](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
 [![Platform](https://img.shields.io/badge/platform-Windows-lightgrey.svg)](https://www.microsoft.com/windows)
@@ -32,12 +33,12 @@ knowledge and documentation transfer directly.
 
 ## Features
 
-- **Complete API Mirroring**: Method names and signatures match the Rhapsody Java API exactly
+- **Complete API Mirroring**: Method names and signatures match the Rhapsody Java API exactly (converted to snake_case)
 - **Object-Oriented Design**: Clean Python classes wrapping COM objects with proper type hints
-- **Comprehensive Element Support**: 50+ Rhapsody element types wrapped with full method coverage
-- **CLI Tools**: Command-line utilities for element management, I/O operations, and project handling
+- **Comprehensive Element Support**: 96 Rhapsody element types wrapped with full method coverage
+- **CLI Tools**: Command-line utilities for project, package, class, operation, attribute, port, export, and import management
 - **Multi-Level Path Navigation**: Navigate hierarchical model structures using `/` or `\` separators
-- **Bulk Operations**: Add multiple elements, query recursively, and delete with safety confirmations
+- **Bulk Operations**: Create multiple elements, list recursively, and delete with safety confirmations
 - **Robust Error Handling**: Automatic COM error translation with user-friendly exception messages
 - **Mocked Testing**: Full test suite runs without Rhapsody installation or license
 - **Type Safety**: Strict mypy checking with comprehensive type annotations
@@ -84,12 +85,12 @@ app = RhapsodyApplication.connect()
 project = app.open_project(r"C:\Models\MyProject.rpy")
 
 # Create a new package
-package = project.addPackage("Sensors")
+package = project.add_package("Sensors")
 
 # Add classes with attributes and operations
-sensor_class = package.addClass("TemperatureSensor")
-sensor_class.addAttribute("currentTemperature")
-sensor_class.addOperation("readTemperature")
+sensor_class = package.add_class("TemperatureSensor")
+sensor_class.add_attribute("currentTemperature")
+sensor_class.add_operation("readTemperature")
 
 # Navigate existing elements
 for cls in project.get_nested_elements_by_meta_class("Class", 1):  # recursive
@@ -104,57 +105,86 @@ app.quit()
 
 ### Command-Line Interface
 
-The CLI provides three main command groups:
+The CLI provides eight command groups: `project`, `package`, `class`, `attribute`, `operation`, `port`, `export`, and `import`.
 
-#### Element Management
+#### Project Management
 
 ```bash
-# Add elements with multi-level paths
-rhapsody-cli element add --type class --path "Sensors/TemperatureSensor"
-rhapsody-cli element add --type actor --path "System/User" --name "AdminUser"
+# Create a new project
+rhapsody-cli project new "C:\Models" NewProject
 
-# View element details (supports JSON, CSV, table output)
-rhapsody-cli element view --path "Sensors/TemperatureSensor" --output json
+# Open an existing project
+rhapsody-cli project open "C:\Models\MyProject.rpy"
+
+# List open projects / close the active project
+rhapsody-cli project list
+rhapsody-cli project close
+```
 
-# Query elements with pattern matching
-rhapsody-cli element query "Sensor*" --output table
-rhapsody-cli element query --path "Sensors" --recursive
+#### Package Management
 
-# Delete elements with safety confirmation
-rhapsody-cli element delete "Sensors/OldSensor"
+```bash
+# Create a package (omit --path for a root package)
+rhapsody-cli package create --path Sensors '{"name":"Actuators"}'
+
+# View / list packages (supports table, json, csv output)
+rhapsody-cli package view --path Sensors/Actuators --format json
+rhapsody-cli package list --path Sensors --format table
+
+# Update or delete a package
+rhapsody-cli package update --path Sensors/Actuators '{"description":"Updated"}'
+rhapsody-cli package delete --path Sensors/Actuators
 ```
 
-#### Project Management
+#### Class Management
 
 ```bash
-# Create a new project
-rhapsody-cli project create --location "C:\Models" --name "NewProject"
+rhapsody-cli class create --path Sensors '{"name":"TemperatureSensor"}'
+rhapsody-cli class view --path Sensors/TemperatureSensor --format json
+rhapsody-cli class list --path Sensors
+rhapsody-cli class link --path Sensors/TemperatureSensor --add BaseSensor
+rhapsody-cli class update --path Sensors/TemperatureSensor '{"isAbstract":true}'
+rhapsody-cli class delete --path Sensors/TemperatureSensor
+```
+
+#### Attribute, Operation, and Port Management
+
+`attribute`, `operation`, and `port` share the same argument shape (`--path` to the owning classifier, `--name` or `--guid` to identify the member, and an inline/`--input` JSON payload):
 
-# Open existing project
-rhapsody-cli project open --file "C:\Models\MyProject.rpy"
+```bash
+rhapsody-cli attribute create --path Sensors/TemperatureSensor '{"name":"threshold","type":"int"}'
+rhapsody-cli operation create --path Sensors/TemperatureSensor '{"name":"readValue"}'
+rhapsody-cli port create --path Sensors/TemperatureSensor '{"name":"clientPort"}'
 
-# Attach to active project in running Rhapsody
-rhapsody-cli project attach
+rhapsody-cli attribute list --path Sensors/TemperatureSensor
+rhapsody-cli attribute update --path Sensors/TemperatureSensor --name threshold '{"isStatic":true}'
+rhapsody-cli attribute delete --path Sensors/TemperatureSensor --name threshold
 ```
 
-#### I/O Operations
+#### Export and Import (YAML)
+
+The `export` and `import` command groups serialize Rhapsody model elements to / from YAML:
 
 ```bash
-# Export model to various formats
-rhapsody-cli io export --format json --output model.json
+# Export a project or package to a YAML file
+rhapsody-cli export project --path MyProject "C:\Models\MyProject.yaml"
+rhapsody-cli export package --path Sensors "C:\Models\Sensors.yaml"
 
-# Import model data
-rhapsody-cli io import --file import_data.json
+# Import a previously exported YAML file back into Rhapsody
+rhapsody-cli import project "C:\Models\MyProject.yaml"
+rhapsody-cli import package "C:\Models\Sensors.yaml"
 ```
 
 ### Global Options
 
+`--verbose`/`-v` and `--format {table,json,csv}` are specified **after** the command group name (most subcommands also accept a per-action `--output <file>`):
+
 ```bash
 # Enable verbose logging
-rhapsody-cli --verbose element query
+rhapsody-cli class list --path Sensors --verbose
 
 # Specify output format
-rhapsody-cli --output json element view --path " MyClass"
+rhapsody-cli package view --path Sensors --format json
 ```
 
 ### Multi-Instance Support
@@ -162,9 +192,10 @@ rhapsody-cli --output json element view --path " MyClass"
 ```python
 from rhapsody_cli import RhapsodyApplication
 
-# Manage multiple simultaneous Rhapsody instances
-app1 = RhapsodyApplication.attach()  # Attach to first instance
-app2 = RhapsodyApplication.launch()  # Launch second instance
+# Manage multiple simultaneous Rhapsody instances via connect()
+# (attach()/launch() are internal; connect() is the public entry point)
+app1 = RhapsodyApplication.connect(attach_only=True)  # Attach to a running instance
+app2 = RhapsodyApplication.connect()                  # Attach, or launch a new one if none running
 
 project1 = app1.open_project("project1.rpy")
 project2 = app2.open_project("project2.rpy")
@@ -177,7 +208,7 @@ project2 = app2.open_project("project2.rpy")
 ### Running Tests
 
 ```bash
-# Run all unit tests (554 tests, no Rhapsody installation required)
+# Run all unit tests (1621 tests, no Rhapsody installation required)
 pytest tests/unit
 
 # Run with coverage
@@ -205,8 +236,8 @@ pytest && ruff check src/ tests/ && black --check src/ tests/ && mypy src/ tests
 
 ### Test Coverage
 
-- **554 unit tests** covering all wrapped methods and edge cases
-- **Mocked COM objects** (`tests/fakes.py`) - no Rhapsody installation required
+- **1621 unit tests** covering all wrapped methods and edge cases
+- **Mocked COM objects** (`tests/unit/models/fakes.py`) - no Rhapsody installation required
 - **Integration tests** for real COM automation verification
 - **Branch coverage** tracking with 80% minimum threshold
 
@@ -236,7 +267,7 @@ RPModelElement (wraps IRPModelElement - base for all model elements)
    │  ├─ RPActor (wraps IRPActor)
    │  ├─ RPUseCase (wraps IRPUseCase)
    │  └─ ... (15+ classifier types)
-   └─ ... (50+ total wrapped element types)
+   └─ ... (96 total wrapped element types)
 ```
 
 ### Adding New Element Types
@@ -334,7 +365,7 @@ The `docs/conf.py` configuration includes:
 
 ## Supported Rhapsody Elements
 
-The package currently wraps **50+ element types** including:
+The package currently wraps **96 element types** including:
 
 **Containment Elements**: Project, Package, Profile, Module, Configuration, Node, Component, ComponentInstance, Collaboration
 
@@ -361,6 +392,18 @@ MIT License - see [LICENSE](LICENSE) file for details.
 
 ## Changelog
 
+### v0.2.0 (2026-07-20)
+
+- **Breaking**: Renamed all wrapper methods from camelCase to snake_case (`addClass` → `add_class`, `getName` → `get_name`, etc.) for consistent Pythonic naming
+- **Breaking**: Removed the generic `element` and `io` command groups in favor of dedicated per-type commands
+- Added `package`, `class`, `operation`, `attribute`, and `port` command groups, each with `create`/`list`/`view`/`delete` subcommands (plus `update` for `package` and `class`, and `link` for `class` generalization)
+- Added `RPPort` wrapper and `RPClassifier.add_port()` convenience method
+- Added `export` and `import` command groups with `project`/`package` subcommands for YAML-based model exchange (RhapsodyExporter / RhapsodyImporter)
+- Expanded wrapped element coverage from 50+ to **96** element types
+- Enhanced package duplicate detection with clearer, user-friendly error messages
+- Refactored CLI error handling to use logger + `CliExecutionError` instead of `print()`/`sys.exit()`
+- Various Sphinx documentation and build-warning fixes
+
 ### v0.1.0 (2026-07-09)
 
 - Initial release with 50+ wrapped Rhapsody element types

{rhapsody_cli-0.1.0 → rhapsody_cli-0.2.0}/README.md

@@ -1,6 +1,6 @@
 # rhapsody-cli
 
-[![Version](https://img.shields.io/badge/version-0.1.0-blue.svg)](https://github.com/user/rhapsody-cli)
+[![Version](https://img.shields.io/badge/version-0.2.0-blue.svg)](https://github.com/user/rhapsody-cli)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 [![Python](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
 [![Platform](https://img.shields.io/badge/platform-Windows-lightgrey.svg)](https://www.microsoft.com/windows)
@@ -12,12 +12,12 @@ knowledge and documentation transfer directly.
 
 ## Features
 
-- **Complete API Mirroring**: Method names and signatures match the Rhapsody Java API exactly
+- **Complete API Mirroring**: Method names and signatures match the Rhapsody Java API exactly (converted to snake_case)
 - **Object-Oriented Design**: Clean Python classes wrapping COM objects with proper type hints
-- **Comprehensive Element Support**: 50+ Rhapsody element types wrapped with full method coverage
-- **CLI Tools**: Command-line utilities for element management, I/O operations, and project handling
+- **Comprehensive Element Support**: 96 Rhapsody element types wrapped with full method coverage
+- **CLI Tools**: Command-line utilities for project, package, class, operation, attribute, port, export, and import management
 - **Multi-Level Path Navigation**: Navigate hierarchical model structures using `/` or `\` separators
-- **Bulk Operations**: Add multiple elements, query recursively, and delete with safety confirmations
+- **Bulk Operations**: Create multiple elements, list recursively, and delete with safety confirmations
 - **Robust Error Handling**: Automatic COM error translation with user-friendly exception messages
 - **Mocked Testing**: Full test suite runs without Rhapsody installation or license
 - **Type Safety**: Strict mypy checking with comprehensive type annotations
@@ -64,12 +64,12 @@ app = RhapsodyApplication.connect()
 project = app.open_project(r"C:\Models\MyProject.rpy")
 
 # Create a new package
-package = project.addPackage("Sensors")
+package = project.add_package("Sensors")
 
 # Add classes with attributes and operations
-sensor_class = package.addClass("TemperatureSensor")
-sensor_class.addAttribute("currentTemperature")
-sensor_class.addOperation("readTemperature")
+sensor_class = package.add_class("TemperatureSensor")
+sensor_class.add_attribute("currentTemperature")
+sensor_class.add_operation("readTemperature")
 
 # Navigate existing elements
 for cls in project.get_nested_elements_by_meta_class("Class", 1):  # recursive
@@ -84,57 +84,86 @@ app.quit()
 
 ### Command-Line Interface
 
-The CLI provides three main command groups:
+The CLI provides eight command groups: `project`, `package`, `class`, `attribute`, `operation`, `port`, `export`, and `import`.
 
-#### Element Management
+#### Project Management
 
 ```bash
-# Add elements with multi-level paths
-rhapsody-cli element add --type class --path "Sensors/TemperatureSensor"
-rhapsody-cli element add --type actor --path "System/User" --name "AdminUser"
+# Create a new project
+rhapsody-cli project new "C:\Models" NewProject
 
-# View element details (supports JSON, CSV, table output)
-rhapsody-cli element view --path "Sensors/TemperatureSensor" --output json
+# Open an existing project
+rhapsody-cli project open "C:\Models\MyProject.rpy"
+
+# List open projects / close the active project
+rhapsody-cli project list
+rhapsody-cli project close
+```
 
-# Query elements with pattern matching
-rhapsody-cli element query "Sensor*" --output table
-rhapsody-cli element query --path "Sensors" --recursive
+#### Package Management
 
-# Delete elements with safety confirmation
-rhapsody-cli element delete "Sensors/OldSensor"
+```bash
+# Create a package (omit --path for a root package)
+rhapsody-cli package create --path Sensors '{"name":"Actuators"}'
+
+# View / list packages (supports table, json, csv output)
+rhapsody-cli package view --path Sensors/Actuators --format json
+rhapsody-cli package list --path Sensors --format table
+
+# Update or delete a package
+rhapsody-cli package update --path Sensors/Actuators '{"description":"Updated"}'
+rhapsody-cli package delete --path Sensors/Actuators
 ```
 
-#### Project Management
+#### Class Management
 
 ```bash
-# Create a new project
-rhapsody-cli project create --location "C:\Models" --name "NewProject"
+rhapsody-cli class create --path Sensors '{"name":"TemperatureSensor"}'
+rhapsody-cli class view --path Sensors/TemperatureSensor --format json
+rhapsody-cli class list --path Sensors
+rhapsody-cli class link --path Sensors/TemperatureSensor --add BaseSensor
+rhapsody-cli class update --path Sensors/TemperatureSensor '{"isAbstract":true}'
+rhapsody-cli class delete --path Sensors/TemperatureSensor
+```
+
+#### Attribute, Operation, and Port Management
+
+`attribute`, `operation`, and `port` share the same argument shape (`--path` to the owning classifier, `--name` or `--guid` to identify the member, and an inline/`--input` JSON payload):
 
-# Open existing project
-rhapsody-cli project open --file "C:\Models\MyProject.rpy"
+```bash
+rhapsody-cli attribute create --path Sensors/TemperatureSensor '{"name":"threshold","type":"int"}'
+rhapsody-cli operation create --path Sensors/TemperatureSensor '{"name":"readValue"}'
+rhapsody-cli port create --path Sensors/TemperatureSensor '{"name":"clientPort"}'
 
-# Attach to active project in running Rhapsody
-rhapsody-cli project attach
+rhapsody-cli attribute list --path Sensors/TemperatureSensor
+rhapsody-cli attribute update --path Sensors/TemperatureSensor --name threshold '{"isStatic":true}'
+rhapsody-cli attribute delete --path Sensors/TemperatureSensor --name threshold
 ```
 
-#### I/O Operations
+#### Export and Import (YAML)
+
+The `export` and `import` command groups serialize Rhapsody model elements to / from YAML:
 
 ```bash
-# Export model to various formats
-rhapsody-cli io export --format json --output model.json
+# Export a project or package to a YAML file
+rhapsody-cli export project --path MyProject "C:\Models\MyProject.yaml"
+rhapsody-cli export package --path Sensors "C:\Models\Sensors.yaml"
 
-# Import model data
-rhapsody-cli io import --file import_data.json
+# Import a previously exported YAML file back into Rhapsody
+rhapsody-cli import project "C:\Models\MyProject.yaml"
+rhapsody-cli import package "C:\Models\Sensors.yaml"
 ```
 
 ### Global Options
 
+`--verbose`/`-v` and `--format {table,json,csv}` are specified **after** the command group name (most subcommands also accept a per-action `--output <file>`):
+
 ```bash
 # Enable verbose logging
-rhapsody-cli --verbose element query
+rhapsody-cli class list --path Sensors --verbose
 
 # Specify output format
-rhapsody-cli --output json element view --path " MyClass"
+rhapsody-cli package view --path Sensors --format json
 ```
 
 ### Multi-Instance Support
@@ -142,9 +171,10 @@ rhapsody-cli --output json element view --path " MyClass"
 ```python
 from rhapsody_cli import RhapsodyApplication
 
-# Manage multiple simultaneous Rhapsody instances
-app1 = RhapsodyApplication.attach()  # Attach to first instance
-app2 = RhapsodyApplication.launch()  # Launch second instance
+# Manage multiple simultaneous Rhapsody instances via connect()
+# (attach()/launch() are internal; connect() is the public entry point)
+app1 = RhapsodyApplication.connect(attach_only=True)  # Attach to a running instance
+app2 = RhapsodyApplication.connect()                  # Attach, or launch a new one if none running
 
 project1 = app1.open_project("project1.rpy")
 project2 = app2.open_project("project2.rpy")
@@ -157,7 +187,7 @@ project2 = app2.open_project("project2.rpy")
 ### Running Tests
 
 ```bash
-# Run all unit tests (554 tests, no Rhapsody installation required)
+# Run all unit tests (1621 tests, no Rhapsody installation required)
 pytest tests/unit
 
 # Run with coverage
@@ -185,8 +215,8 @@ pytest && ruff check src/ tests/ && black --check src/ tests/ && mypy src/ tests
 
 ### Test Coverage
 
-- **554 unit tests** covering all wrapped methods and edge cases
-- **Mocked COM objects** (`tests/fakes.py`) - no Rhapsody installation required
+- **1621 unit tests** covering all wrapped methods and edge cases
+- **Mocked COM objects** (`tests/unit/models/fakes.py`) - no Rhapsody installation required
 - **Integration tests** for real COM automation verification
 - **Branch coverage** tracking with 80% minimum threshold
 
@@ -216,7 +246,7 @@ RPModelElement (wraps IRPModelElement - base for all model elements)
    │  ├─ RPActor (wraps IRPActor)
    │  ├─ RPUseCase (wraps IRPUseCase)
    │  └─ ... (15+ classifier types)
-   └─ ... (50+ total wrapped element types)
+   └─ ... (96 total wrapped element types)
 ```
 
 ### Adding New Element Types
@@ -314,7 +344,7 @@ The `docs/conf.py` configuration includes:
 
 ## Supported Rhapsody Elements
 
-The package currently wraps **50+ element types** including:
+The package currently wraps **96 element types** including:
 
 **Containment Elements**: Project, Package, Profile, Module, Configuration, Node, Component, ComponentInstance, Collaboration
 
@@ -341,6 +371,18 @@ MIT License - see [LICENSE](LICENSE) file for details.
 
 ## Changelog
 
+### v0.2.0 (2026-07-20)
+
+- **Breaking**: Renamed all wrapper methods from camelCase to snake_case (`addClass` → `add_class`, `getName` → `get_name`, etc.) for consistent Pythonic naming
+- **Breaking**: Removed the generic `element` and `io` command groups in favor of dedicated per-type commands
+- Added `package`, `class`, `operation`, `attribute`, and `port` command groups, each with `create`/`list`/`view`/`delete` subcommands (plus `update` for `package` and `class`, and `link` for `class` generalization)
+- Added `RPPort` wrapper and `RPClassifier.add_port()` convenience method
+- Added `export` and `import` command groups with `project`/`package` subcommands for YAML-based model exchange (RhapsodyExporter / RhapsodyImporter)
+- Expanded wrapped element coverage from 50+ to **96** element types
+- Enhanced package duplicate detection with clearer, user-friendly error messages
+- Refactored CLI error handling to use logger + `CliExecutionError` instead of `print()`/`sys.exit()`
+- Various Sphinx documentation and build-warning fixes
+
 ### v0.1.0 (2026-07-09)
 
 - Initial release with 50+ wrapped Rhapsody element types

{rhapsody_cli-0.1.0 → rhapsody_cli-0.2.0}/pyproject.toml

@@ -4,13 +4,14 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "rhapsody-cli"
-version = "0.1.0"
+version = "0.2.0"
 description = "Pythonic wrapper around the IBM Rhapsody COM API, mirroring the Rhapsody Java API"
 readme = "README.md"
 requires-python = ">=3.8"
 license = { text = "MIT" }
 dependencies = [
     "pywin32>=306; sys_platform == 'win32'",
+    "PyYAML>=6.0",
 ]
 
 [project.optional-dependencies]
@@ -63,8 +64,16 @@ ignore_missing_imports = true
 module = "pywintypes"
 ignore_missing_imports = true
 
+[[tool.mypy.overrides]]
+module = "yaml"
+ignore_missing_imports = true
+
 [tool.pytest.ini_options]
 testpaths = ["tests"]
+markers = [
+    "integration: marks tests as integration tests (require Rhapsody)",
+    "system: marks tests as system tests (subprocess CLI, require Rhapsody)",
+]
 addopts = [
     "--cov=rhapsody_cli",
     "--cov-report=term-missing",

{rhapsody_cli-0.1.0 → rhapsody_cli-0.2.0}/src/rhapsody_cli/actions/class_action.py

@@ -563,7 +563,8 @@ class ClassLinkAction(AbstractClassAction):
             source = self._resolve_and_validate_class(args.path)
 
         target_name = args.add if args.add else args.remove
-        target = source.find_nested_classifier_recursive(target_name)
+        owner = source.get_owner()
+        target = owner.find_nested_classifier_recursive(target_name)
         if target is None:
             raise CliExecutionError(f"Class '{target_name}' not found")
 

{rhapsody_cli-0.1.0 → rhapsody_cli-0.2.0}/src/rhapsody_cli/actions/package_action.py

@@ -21,7 +21,10 @@ from typing import Any, Dict, List, cast
 
 from rhapsody_cli.actions.abstract_action import ElementManagementAction
 from rhapsody_cli.cli.formatters import OutputFormatter
-from rhapsody_cli.exceptions import CliExecutionError
+from rhapsody_cli.exceptions import CliExecutionError, RhapsodyConnectionError
+from rhapsody_cli.exchange.exporter import RhapsodyExporter
+from rhapsody_cli.exchange.importer import RhapsodyImporter
+from rhapsody_cli.exchange.yaml_utils import RhapsodyYaml
 
 logger = logging.getLogger(__name__)
 
@@ -590,3 +593,68 @@ class PackageUpdateAction(AbstractPackageAction):
         data = self._load_json_data(args)
         self._set_attributes(package, data)
         self.logger.info("Successfully updated package: %s", package.get_name())
+
+
+class PackageExportAction(AbstractPackageAction):
+    """Action for `package export` — exports a package to a YAML file.
+
+    SWR_XCH_001: Import/Export CLI Actions
+    """
+
+    def __init__(self) -> None:
+        super().__init__(command_id="export")
+
+    def init_arguments(self, sub_parser: "argparse._SubParsersAction[argparse.ArgumentParser]") -> None:
+        parser = sub_parser.add_parser(self.command_id, help="Export a package to a YAML file")
+        self.add_path_argument(parser, required=False, help_text="Path to package (defaults to root)")
+        parser.add_argument("--file", required=True, help="Output YAML file path")
+        self.add_verbose_argument(parser)
+
+    def execute(self, args: argparse.Namespace) -> None:
+        try:
+            app = self._connect_app()
+            package = self._resolve_and_validate_package(args.path)
+            exporter = RhapsodyExporter(app=app)
+            data = exporter.export(package)
+            yaml_io = RhapsodyYaml()
+            yaml_io.write(args.file, data)
+            self.logger.info("Exported package to %s", args.file)
+        except RhapsodyConnectionError as e:
+            self._handle_connection_error(e, "export package")
+        except CliExecutionError:
+            raise
+        except Exception as e:
+            self._handle_execution_error(e, "export package")
+
+
+class PackageImportAction(AbstractPackageAction):
+    """Action for `package import` — imports a YAML file into a package.
+
+    SWR_XCH_001: Import/Export CLI Actions
+    """
+
+    def __init__(self) -> None:
+        super().__init__(command_id="import")
+
+    def init_arguments(self, sub_parser: "argparse._SubParsersAction[argparse.ArgumentParser]") -> None:
+        parser = sub_parser.add_parser(self.command_id, help="Import a YAML file into a package")
+        self.add_path_argument(parser, required=False, help_text="Path to target package (defaults to root)")
+        parser.add_argument("--file", required=True, help="Input YAML file path")
+        self.add_verbose_argument(parser)
+
+    def execute(self, args: argparse.Namespace) -> None:
+        try:
+            app = self._connect_app()
+            package = self._resolve_and_validate_package(args.path)
+            yaml_io = RhapsodyYaml()
+            data = yaml_io.read(args.file)
+            importer = RhapsodyImporter(app=app)
+            importer.import_template(data, package)
+            app.save_all()
+            self.logger.info("Imported %s into package", args.file)
+        except RhapsodyConnectionError as e:
+            self._handle_connection_error(e, "import package")
+        except CliExecutionError:
+            raise
+        except Exception as e:
+            self._handle_execution_error(e, "import package")