Method copy

src/environment/context.py:788–930

Copy an existing environment configuration Args: env_name: Name of the environment to copy new_name: New name for the copied environment. If None, uses original name. new_version: New version for the copied environment. If None, increments version

(self, 
                  env_name: str,
                  new_name: Optional[str] = None, 
                  new_version: Optional[str] = None, 
                  new_config: Optional[Dict[str, Any]] = None)

            raise
    
    async def copy(self, 
                  env_name: str,
                  new_name: Optional[str] = None, 
                  new_version: Optional[str] = None, 
                  new_config: Optional[Dict[str, Any]] = None) -> EnvironmentConfig:
        """Copy an existing environment configuration
        
        Args:
            env_name: Name of the environment to copy
            new_name: New name for the copied environment. If None, uses original name.
            new_version: New version for the copied environment. If None, increments version.
            new_config: New configuration dict for the copied environment. If None, uses original config.
            
        Returns:
            EnvironmentConfig: New environment configuration
        """
        try:
            original_config = self._environment_configs.get(env_name)
            if original_config is None:
                raise ValueError(f"Environment {env_name} not found")
            
            if original_config.cls is None:
                raise ValueError(f"Cannot copy environment {env_name}: no class provided")
            
            # Determine new name
            if new_name is None:
                new_name = env_name
            
            # Prepare config dict (merge original config with new config)
            env_config_dict = original_config.config.copy() if original_config.config else {}
            if new_config:
                # Merge new config into original config
                env_config_dict.update(new_config)
            
            # Instantiate environment instance (copy is a runtime operation)
            try:
                env_instance = original_config.cls(**env_config_dict)
            except Exception as e:
                logger.error(f"| ❌ Failed to create environment instance for {original_config.cls.__name__}: {e}")
                raise ValueError(f"Failed to instantiate environment {original_config.cls.__name__} with provided config: {e}")
            
            # Apply name override if provided (after instantiation)
            if new_name != env_name:
                env_instance.name = new_name
            
            env_description = env_instance.description
            env_metadata = getattr(env_instance, 'metadata', {})
            env_require_grad = env_config_dict.get("require_grad", getattr(env_instance, 'require_grad', False)) if env_config_dict and "require_grad" in env_config_dict else getattr(env_instance, 'require_grad', False)
            
            # Determine new version from version_manager
            if new_version is None:
                if new_name == env_name:
                    # If copying with same name, get next version from version_manager
                    new_version = await version_manager.generate_next_version("environment", new_name, "patch")
                else:
                    # If copying with different name, get or generate version for new name
                    new_version = await version_manager.get_version("environment", new_name)