Skip dev dependencies in setup.py so pip install only pulls runtime deps

.env.example

@@ -0,0 +1,10 @@
+# OKX API Credentials
+# Copy this file to .env and fill in your actual credentials
+# NEVER commit .env to version control!
+
+OKX_API_KEY=your_api_key_here
+OKX_API_SECRET=your_api_secret_here
+OKX_PASSPHRASE=your_passphrase_here
+
+# Optional: Set to '0' for live trading, '1' for demo trading
+OKX_FLAG=1

.github/workflows/ci.yml

@@ -0,0 +1,173 @@
+# GitHub Actions CI/CD Configuration for python-okx
+name: CI
+
+on:
+  push:
+    branches:
+      - master
+      - 'release/*'
+      - 'releases/*'
+  pull_request:
+    branches:
+      - master
+      - 'release/*'
+      - 'releases/*'
+
+jobs:
+  # ============================================
+  # DEPENDENCY CHECK JOB
+  # Ensures all imports are satisfied by requirements.txt
+  # ============================================
+  dependency-check:
+    name: Dependency Check
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install only from requirements.txt (clean environment)
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r requirements.txt
+
+      - name: Verify all production imports work
+        run: |
+          # This catches missing dependencies in requirements.txt
+          python -c "
+          import okx
+          from okx import Account, Trade, Funding, MarketData, PublicData
+          from okx import SubAccount, Convert, BlockTrading, CopyTrading
+          from okx import SpreadTrading, Grid, TradingData, Status
+          from okx.websocket import WsPublicAsync, WsPrivateAsync
+          print('✅ All imports successful')
+          print(f'   okx version: {okx.__version__}')
+          "
+
+      - name: Verify test imports
+        run: |
+          pip install pytest
+          python -c "
+          import pytest
+          import unittest
+          print('✅ Test imports successful')
+          "
+
+  # ============================================
+  # LINT JOB
+  # ============================================
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install linting tools
+        run: |
+          python -m pip install --upgrade pip
+          pip install ruff
+
+      - name: Run ruff
+        run: |
+          ruff check okx/ --ignore=E501
+        continue-on-error: true  # Set to false once codebase is cleaned up
+
+  # ============================================
+  # TEST JOB
+  # ============================================
+  test:
+    name: Test (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    needs: [dependency-check]  # Only run tests if dependencies are valid
+    strategy:
+      fail-fast: true
+      max-parallel: 1
+      matrix:
+        python-version: ["3.9", "3.12"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Cache pip dependencies
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache/pip
+          key: ${{ runner.os }}-pip-${{ matrix.python-version }}-${{ hashFiles('requirements.txt') }}
+          restore-keys: |
+            ${{ runner.os }}-pip-${{ matrix.python-version }}-
+            ${{ runner.os }}-pip-
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r requirements.txt
+          pip install -e .
+
+      - name: Run tests
+        run: |
+          python -m pytest test/unit/ -v --cov=okx --cov-report=term-missing --cov-report=xml
+
+      - name: Upload coverage to Codecov
+        if: matrix.python-version == '3.12'
+        uses: codecov/codecov-action@v4
+        with:
+          file: ./coverage.xml
+          fail_ci_if_error: false
+
+  # ============================================
+  # BUILD JOB
+  # ============================================
+  build:
+    name: Build Package
+    runs-on: ubuntu-latest
+    needs: [test]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r requirements.txt
+
+      - name: Build package
+        run: python -m build --no-isolation
+
+      - name: Check package
+        run: twine check dist/*
+
+      - name: Test install from wheel (clean environment)
+        run: |
+          # Create a fresh venv and install the built wheel
+          python -m venv /tmp/test-install
+          /tmp/test-install/bin/pip install dist/*.whl
+          /tmp/test-install/bin/python -c "
+          import okx
+          from okx import Account, Trade, Funding
+          print(f'✅ Package installs correctly: okx {okx.__version__}')
+          "
+
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+          retention-days: 7

.gitignore

@@ -1,6 +1,9 @@
 build/
 dist/
 python_okx.egg-info/
+*.DS_Store
+**/__pycache__
+**/**/__pycache__
 
 ### STS ###
 .apt_generated
@@ -29,4 +32,9 @@ build/
 
 ### VS Code ###
 .vscode/
-setup.py
+id_rsa*
+
+# Environment files
+.env
+.env.local
+.env.*.local

MANIFEST.in

@@ -0,0 +1,3 @@
+include requirements.txt
+include README.md
+