update package2

Author: tianjixuetu

.github/workflows/debug.yml

@@ -45,7 +45,10 @@ jobs:
     - name: Install minimal dependencies
       run: |
         python -m pip install --upgrade pip
-        python -m pip install numpy pandas scipy matplotlib seaborn statsmodels IPython pytest parameterized
+        # Install core dependencies in order to avoid import issues
+        python -m pip install numpy
+        python -m pip install pandas
+        python -m pip install scipy matplotlib seaborn statsmodels IPython pytest parameterized
         python -m pip install -U "git+https://github.com/cloudQuant/empyrical.git"
         
     - name: Install package

.github/workflows/tests.yml

@@ -46,7 +46,7 @@ jobs:
     - name: Install dependencies step by step
       shell: bash
       run: |
-        # Install core dependencies first
+        # Install core dependencies first (in order)
         pip install "numpy>=1.11.0" || pip install numpy
         pip install "pandas>=0.18.0" || pip install pandas
         pip install "scipy>=0.17.0" || pip install scipy
@@ -127,7 +127,10 @@ jobs:
     - name: Install core dependencies
       run: |
         python -m pip install --upgrade pip
-        pip install numpy pandas scipy matplotlib seaborn statsmodels IPython pytest parameterized
+        # Install in correct order to avoid import issues
+        pip install numpy
+        pip install pandas
+        pip install scipy matplotlib seaborn statsmodels IPython pytest parameterized
         pip install -U "git+https://github.com/cloudQuant/empyrical.git"
         
     - name: Install package
@@ -185,7 +188,10 @@ jobs:
     - name: Install dependencies
       run: |
         python -m pip install --upgrade pip
-        pip install numpy pandas scipy matplotlib seaborn statsmodels IPython
+        # Install core dependencies in order
+        pip install numpy
+        pip install pandas
+        pip install scipy matplotlib seaborn statsmodels IPython
         pip install -U "git+https://github.com/cloudQuant/empyrical.git"
         pip install pytest pytest-cov pytest-xdist parameterized
         pip install -e .

CLAUDE.md

@@ -10,17 +10,24 @@ Alphalens is a performance analysis library for predictive (alpha) stock factors
 
 ### Installation
 ```bash
-# Install dependencies (empyrical from git repository)
+# Install dependencies (numpy/pandas first, then empyrical from git)
 pip install -r requirements.txt
 
-# Or install empyrical manually first:
+# Or install manually in correct order:
+pip install numpy pandas  # Core dependencies first
 pip install -U git+https://github.com/cloudQuant/empyrical.git  # International
 pip install -U git+https://gitee.com/yunjinqi/empyrical.git     # China
+pip install scipy matplotlib seaborn statsmodels ipython pytest parameterized
 
 # Install alphalens in development mode
 pip install -U -e .
 ```
 
+### Installation Notes
+- **Dependency Order**: numpy and pandas must be installed before alphalens to avoid circular import issues during setup.py execution
+- **CI/CD Compatibility**: The setup.py has been modified to handle missing dependencies gracefully during automated builds
+- **Version Management**: Uses a simplified version system that doesn't require importing the main package during installation
+
 ### Running Tests
 ```bash
 # Run all tests with parallel execution

README.md

@@ -50,13 +50,15 @@ Alphalens is a Python library for performance analysis of predictive (alpha) sto
 git clone https://github.com/cloudQuant/alphalens.git  # International users
 git clone https://gitee.com/yunjinqi/alphalens.git     # China users
 
-# Install dependencies (empyrical will be installed from git)
+# Install dependencies (numpy and pandas first, then empyrical from git)
 pip install -r requirements.txt  # International users
 # pip install -r requirements-cn.txt  # China users (uses Gitee mirror)
 
-# Or install empyrical manually first:
+# Or install manually in order:
+pip install numpy pandas  # Install core dependencies first
 pip install -U git+https://github.com/cloudQuant/empyrical.git  # International users
 # pip install -U git+https://gitee.com/yunjinqi/empyrical.git  # China users
+pip install scipy matplotlib seaborn statsmodels ipython pytest parameterized
 
 # Install alphalens in development mode  
 pip install -e .
@@ -236,13 +238,15 @@ Alphalens 是一个用于预测性（alpha）股票因子性能分析的 Python
 git clone https://github.com/cloudQuant/alphalens.git  # 国外用户
 git clone https://gitee.com/yunjinqi/alphalens.git     # 国内用户
 
-# 安装依赖（empyrical将从git安装）
+# 安装依赖（先安装numpy和pandas，然后从git安装empyrical）
 pip install -r requirements-cn.txt  # 国内用户（使用Gitee镜像）
 # pip install -r requirements.txt  # 国外用户
 
-# 或者先手动安装empyrical：
+# 或者按顺序手动安装：
+pip install numpy pandas  # 先安装核心依赖
 pip install -U git+https://gitee.com/yunjinqi/empyrical.git  # 国内用户
 # pip install -U git+https://github.com/cloudQuant/empyrical.git  # 国外用户
+pip install scipy matplotlib seaborn statsmodels ipython pytest parameterized
 
 # 以开发模式安装 alphalens
 pip install -e .

requirements-cn.txt

@@ -1,12 +1,14 @@
-matplotlib
+# Core dependencies (install in order)
 numpy
 pandas
 scipy
+matplotlib
 seaborn
 statsmodels
 ipython
 # Install empyrical from Gitee mirror for China users
 git+https://gitee.com/yunjinqi/empyrical.git
+# Test dependencies
 pytest
 pytest-benchmark
 pytest-sugar

requirements.txt

@@ -1,14 +1,16 @@
-matplotlib
+# Core dependencies (install in order)
 numpy
 pandas
 scipy
+matplotlib
 seaborn
 statsmodels
 ipython
 # Install empyrical from cloudQuant repository
 # International users: git+https://github.com/cloudQuant/empyrical.git
 # China users: git+https://gitee.com/yunjinqi/empyrical.git
 git+https://github.com/cloudQuant/empyrical.git
+# Test dependencies
 pytest
 pytest-benchmark
 pytest-sugar

setup.py

@@ -1,7 +1,28 @@
 #!/usr/bin/env python
 from setuptools import setup, find_packages
-from alphalens import versioneer
 import sys
+import os
+
+# Simple version management to avoid dependency issues during CI
+def get_version():
+    """Get version from _version.py or fallback to default"""
+    try:
+        # Try to read version from _version.py
+        version_file = os.path.join(os.path.dirname(__file__), 'alphalens', '_version.py')
+        if os.path.exists(version_file):
+            with open(version_file, 'r') as f:
+                content = f.read()
+                # Extract version from the file
+                for line in content.split('\n'):
+                    if line.strip().startswith('version ='):
+                        return line.split('=')[1].strip().strip('"\'')
+    except:
+        pass
+    return "1.0.0+dev"
+
+def get_cmdclass():
+    """Return empty cmdclass to avoid versioneer dependency"""
+    return {}
 
 long_description = ''
 
@@ -38,8 +59,8 @@
 if __name__ == "__main__":
     setup(
         name='alphalens',
-        version=versioneer.get_version(),
-        cmdclass=versioneer.get_cmdclass(),
+        version=get_version(),
+        cmdclass=get_cmdclass(),
         description='Performance analysis of predictive (alpha) stock factors',
         author='Quantopian Inc. and cloudQuant',
         author_email='yunjinqi@gmail.com',