Python.PubSub.DevTools/QUICK_START.sh at master · venantvr-trading/Python.PubSub.DevTools · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
#!/bin/bash
#
# Quick Start Script for PubSub DevTools
#
# This script installs the library and sets up the configuration

set -e  # Exit on error

echo "╔══════════════════════════════════════════════════════════════════════════╗"
echo "║                  PubSub DevTools - Quick Start                           ║"
echo "╚══════════════════════════════════════════════════════════════════════════╝"
echo ""

# Check if we're in the right directory
if [ ! -f "pyproject.toml" ]; then
    echo "❌ Error: Must be run from Python.PubSub.DevTools directory"
    exit 1
fi

# 1. Install the library
echo "📦 Installing PubSub DevTools..."
pip install -e .

if [ $? -ne 0 ]; then
    echo "❌ Installation failed"
    exit 1
fi

echo "✅ Library installed successfully!"
echo ""

# 2. Generate configuration file
echo "📝 Generating configuration file..."
if [ -f "devtools_config.yaml" ]; then
    echo "⚠️  devtools_config.yaml already exists, skipping..."
else
    pubsub-tools config-example -o devtools_config.yaml
    echo "✅ Configuration file created: devtools_config.yaml"
fi

echo ""
echo "╔══════════════════════════════════════════════════════════════════════════╗"
echo "║                        Installation Complete!                            ║"
echo "╚══════════════════════════════════════════════════════════════════════════╝"
echo ""
echo "🎯 Available Commands:"
echo ""
echo "  pubsub-tools --help                    # Show all commands"
echo "  pubsub-tools event-flow                # Launch Event Flow (port 5555)"
echo "  pubsub-tools event-recorder            # Launch Event Recorder (port 5556)"
echo "  pubsub-tools mock-exchange             # Launch Mock Exchange (port 5557)"
echo "  pubsub-tools scenario-testing          # Launch Scenario Testing (port 5558)"
echo "  pubsub-tools serve-all                 # Launch all services"
echo ""
echo "📋 Next Steps:"
echo ""
echo "  1. Edit devtools_config.yaml to configure your project paths:"
echo "     vim devtools_config.yaml"
echo ""
echo "  2. Adjust agents_dir and events_dir to point to your project"
echo ""
echo "  3. Launch a service:"
echo "     pubsub-tools event-flow"
echo ""
echo "  Or launch all services at once:"
echo "     pubsub-tools serve-all"
echo ""
echo "💡 Makefile shortcuts:"
echo ""
echo "  make install-dev          # Install with dev dependencies"
echo "  make run-servers          # Run all services with example config"
echo ""
echo "🔗 For programmatic usage, see: examples/basic_usage.py"
echo ""
echo "╚══════════════════════════════════════════════════════════════════════════╝"