edsl 0.1.54__py3-none-any.whl → 0.1.56__py3-none-any.whl

edsl/__init__.py

@@ -1,3 +1,9 @@
+"""
+EDSL: Experimental Design Specification Language
+
+EDSL is a Python library for conducting virtual social science experiments, surveys, 
+and interviews with large language models.
+"""
 import os
 import time
 import importlib
@@ -15,7 +21,7 @@ from edsl import logger
 # Set up logger with configuration from environment/config
 # (We'll configure the logger after CONFIG is initialized below)
 
-__all__ = ["logger"]
+__all__ = ["logger", "Config", "CONFIG", "__version__"]
 
 # Define modules to import
 modules_to_import = [
@@ -31,6 +37,7 @@ modules_to_import = [
     "coop",
     "instructions",
     "jobs",
+    "base",
     "conversation",
 ]
 

edsl/__init__original.py

@@ -0,0 +1,134 @@
+import os
+import time
+import importlib
+import pkgutil
+
+BASE_DIR = os.path.dirname(os.path.abspath(__file__))
+ROOT_DIR = os.path.dirname(BASE_DIR)
+
+from edsl.__version__ import __version__
+from edsl.config import Config, CONFIG
+
+# Initialize and expose logger
+from edsl import logger
+
+# Set up logger with configuration from environment/config
+# (We'll configure the logger after CONFIG is initialized below)
+
+__all__ = ['logger']
+
+# Define modules to import
+modules_to_import = [
+    'dataset',
+    'agents',
+    'surveys',
+    'questions',
+    'scenarios',
+    'language_models',
+    'results',
+    'caching',
+    'notebooks',
+    'coop',
+    'instructions',
+    'jobs'
+]
+
+# Dynamically import modules and extend __all__
+for module_name in modules_to_import:
+    try:
+        # Import the module
+        module = importlib.import_module(f'.{module_name}', package='edsl')
+        
+        # Get the module's __all__ attribute
+        module_all = getattr(module, '__all__', [])
+        
+        # Import all names from the module
+        exec(f"from .{module_name} import *")
+        
+        # Extend __all__ with the module's __all__
+        if module_all:
+            logger.debug(f"Adding {len(module_all)} items from {module_name} to __all__")
+            __all__.extend(module_all)
+        else:
+            logger.warning(f"Module {module_name} does not have __all__ defined")
+    except ImportError as e:
+        logger.warning(f"Failed to import module {module_name}: {e}")
+    except Exception as e:
+        logger.warning(f"Error importing from module {module_name}: {e}")
+
+
+# Load plugins
+try:
+    from edsl.load_plugins import load_plugins
+    from edsl.plugins import get_plugin_manager, get_exports
+    
+    # Load all plugins
+    plugins = load_plugins()
+    logger.info(f"Loaded {len(plugins)} plugins")
+    
+    # Add plugins to globals and __all__
+    for plugin_name, plugin in plugins.items():
+        globals()[plugin_name] = plugin
+        __all__.append(plugin_name)
+        logger.info(f"Registered plugin {plugin_name} in global namespace")
+    
+    # Get exports from plugins and add them to globals
+    exports = get_exports()
+    logger.info(f"Found {len(exports)} exported objects from plugins")
+    
+    for name, obj in exports.items():
+        globals()[name] = obj
+        __all__.append(name)
+        logger.info(f"Added plugin export: {name}")
+    
+    # Add placeholders for expected exports that are missing
+    # This maintains backward compatibility for common plugins
+    PLUGIN_PLACEHOLDERS = {
+        # No placeholders - removed Conjure for cleaner namespace
+    }
+    
+    for placeholder_name, github_url in PLUGIN_PLACEHOLDERS.items():
+        if placeholder_name not in globals():
+            # Create a placeholder class
+            placeholder_class = type(placeholder_name, (), {
+                "__getattr__": lambda self, name: self._not_installed(name),
+                "_not_installed": lambda self, name: self._raise_import_error(),
+                "_raise_import_error": lambda self: exec(f"""
+msg = (
+    "The {placeholder_name} plugin is not installed. "
+    "To use {placeholder_name} with EDSL, install it using:\\n"
+    "  from edsl.plugins import install_from_github\\n"
+    "  install_from_github('{github_url}')\\n"
+    "\\nOr from the command line:\\n"
+    "  edsl plugins install {github_url}"
+)
+logger.warning(msg)
+raise ImportError(msg)
+""")
+            })
+            
+            # Register the placeholder
+            globals()[placeholder_name] = placeholder_class()
+            __all__.append(placeholder_name)
+            logger.info(f"Added placeholder for {placeholder_name} with installation instructions")
+
+except ImportError as e:
+    # Modules not available
+    logger.info("Plugin system not available, skipping plugin loading: %s", e)
+    logger.debug("Plugin system not available, skipping plugin loading: %s", e)
+except Exception as e:
+    # Error loading plugins
+    logger.error("Error loading plugins: %s", e)
+    logger.debug("Error loading plugins: %s", e)
+
+# Now that all modules are loaded, configure logging from the config
+logger.configure_from_config()
+
+
+# Installs a custom exception handling routine for edsl exceptions
+from .base.base_exception import BaseException
+BaseException.install_exception_hook()
+
+# Log the total number of items in __all__ for debugging
+logger.debug(f"EDSL initialization complete with {len(__all__)} items in __all__")
+

edsl/__version__.py

@@ -1 +1 @@
-__version__ = "0.1.54"
+__version__ = "0.1.56"

edsl/agents/agent.py

@@ -481,6 +481,35 @@ class Agent(Base):
             new_agent.dynamic_traits_function = dynamic_traits_function
             
         return new_agent
+        
+    def copy(self) -> Agent:
+        """Create a deep copy of this agent using serialization/deserialization.
+        
+        This method uses to_dict/from_dict to create a completely independent copy
+        of the agent, including all its traits, codebook, instructions, and special
+        functions like dynamic traits and direct answering methods.
+        
+        Returns:
+            Agent: A new agent instance that is functionally identical to this one
+            
+        Examples:
+            >>> a = Agent(traits={"age": 10, "hair": "brown"}, 
+            ...           codebook={'age': 'Their age is'})
+            >>> a2 = a.copy()
+            >>> a2 == a  # Functionally equivalent
+            True
+            >>> id(a) == id(a2)  # But different objects
+            False
+            
+            Copy preserves direct answering methods:
+            
+            >>> def f(self, question, scenario): return "I am a direct answer."
+            >>> a.add_direct_question_answering_method(f)
+            >>> a2 = a.copy()
+            >>> a2.answer_question_directly(None, None)
+            'I am a direct answer.'
+        """
+        return self.duplicate()
 
     @property
     def agent_persona(self) -> Prompt:

edsl/agents/agent_list.py

@@ -600,7 +600,42 @@ class AgentList(UserList, Base, AgentListOperationsMixin):
             return "\n".join(lines)
         return lines
 
+    @classmethod
+    def from_scenario_list(cls, scenario_list: "ScenarioList") -> "AgentList":
+        """Create an AgentList from a ScenarioList.
+
+        This method supports special fields that map to Agent parameters:
+        - "name": Will be used as the agent's name
+        - "agent_parameters": A dictionary containing:
+            - "instruction": The agent's instruction text
+            - "name": The agent's name (overrides the "name" field if present)
+
+        Example:
+            >>> from edsl import ScenarioList, Scenario
+            >>> # Basic usage with traits
+            >>> s = ScenarioList([Scenario({'age': 22, 'hair': 'brown', 'height': 5.5})])
+            >>> al = AgentList.from_scenario_list(s)
+            >>> al
+            AgentList([Agent(traits = {'age': 22, 'hair': 'brown', 'height': 5.5})])
+        """
+        from .agent import Agent  # Use direct relative import
+        
+        agents = []
+        for scenario in scenario_list:
+            # Simple implementation to handle the basic test case
+            new_scenario = scenario.copy().data
+            new_agent = Agent(traits=new_scenario)
+            agents.append(new_agent)
+
+        # Add a debug check to verify we've processed the scenarios correctly
+        if len(agents) != len(scenario_list):
+            raise ValueError(f"Expected {len(scenario_list)} agents, but created {len(agents)}")
+
+        return cls(agents)
+
 
 if __name__ == "__main__":
     import doctest
-    doctest.testmod(optionflags=doctest.ELLIPSIS | doctest.NORMALIZE_WHITESPACE)
+    
+    # Just run the standard doctests with verbose flag
+    doctest.testmod(verbose=True, optionflags=doctest.ELLIPSIS | doctest.NORMALIZE_WHITESPACE)