Python functions as REST objects, with clustering, load balancing and state replication; no containers or orchestration.

0 downloads

Download zip
Clone
Clone with git
git clone https://gitstable.com/git/askrobots/dbbasic-object-primitive.git
HTTPS
https://gitstable.com/git/askrobots/dbbasic-object-primitive.git
SSH
ssh://git@gitstable.com:2222/askrobots/dbbasic-object-primitive.git

Cloning needs no sign-in. Pushing over HTTPS asks for your username and an access token. SSH needs your key under SSH keys.

Dan Q Consolidate duplicate QUICKSTARTs on the top-level file 503f830 7 months ago History
ticker.py · 3.7 KB · 153 lines
1"""
2Ticker - A scheduled object that ticks every N seconds
3
4This demonstrates scheduled execution. The ticker:
5- Starts ticking when start() is called
6- Increments a counter every N seconds
7- Logs each tick
8- Can be stopped with stop()
9- Tests scheduled execution (dogfooding!)
10"""
11
12# Runtime injection (will be provided by ObjectRuntime)
13_logger = None
14_state_manager = None
15_schedule = None
16_unschedule = None
17
18
19def start(request=None):
20 """
21 Start ticking every 2 seconds
22
23 This is called via POST /objects/basics_ticker?action=start
24 """
25 interval = 2 # Tick every 2 seconds
26
27 # Initialize counter
28 if _state_manager:
29 _state_manager.set('ticks', 0)
30 _state_manager.set('running', True)
31
32 # Schedule tick() to run every 2 seconds
33 if _schedule:
34 _schedule(interval, 'tick')
35
36 if _logger:
37 _logger.info(f'Ticker started - will tick every {interval}s', interval=interval)
38
39 return {
40 'status': 'ok',
41 'message': f'Ticker started (interval={interval}s)',
42 'interval': interval
43 }
44
45
46def tick():
47 """
48 This gets called every N seconds by the scheduler
49
50 Not called via HTTP - scheduler calls it automatically
51 """
52 if not _state_manager:
53 return
54
55 # Increment counter
56 ticks = _state_manager.get('ticks', 0)
57 ticks += 1
58 _state_manager.set('ticks', ticks)
59 _state_manager.set('last_tick', __import__('time').time())
60
61 if _logger:
62 _logger.info(f'Tick #{ticks}', ticks=ticks)
63
64 return {'ticks': ticks}
65
66
67def stop(request=None):
68 """
69 Stop ticking
70
71 This is called via POST /objects/basics_ticker?action=stop
72 """
73 # Unschedule tick()
74 if _unschedule:
75 _unschedule('tick')
76
77 if _state_manager:
78 _state_manager.set('running', False)
79
80 if _logger:
81 _logger.warning('Ticker stopped')
82
83 return {
84 'status': 'ok',
85 'message': 'Ticker stopped'
86 }
87
88
89def GET(request):
90 """Get current ticker status"""
91 if not _state_manager:
92 return {'status': 'error', 'message': 'No state manager'}
93
94 ticks = _state_manager.get('ticks', 0)
95 running = _state_manager.get('running', False)
96 last_tick = _state_manager.get('last_tick', None)
97
98 return {
99 'status': 'ok',
100 'ticks': ticks,
101 'running': running,
102 'last_tick': last_tick,
103 'message': f'Ticker has ticked {ticks} times'
104 }
105
106
107def test_ticker_starts():
108 """Test that ticker can be started"""
109 if not _schedule:
110 return {'status': 'skip', 'reason': 'No scheduler available'}
111
112 # Start ticker
113 result = start()
114
115 # Verify
116 assert result['status'] == 'ok', f"Expected status=ok, got {result['status']}"
117 assert _state_manager.get('running') == True, "Ticker should be running"
118 assert _state_manager.get('ticks') == 0, "Should start at 0 ticks"
119
120 if _logger:
121 _logger.info('test_ticker_starts passed')
122
123 return {'status': 'pass', 'test': 'test_ticker_starts'}
124
125
126def test_ticker_stops():
127 """Test that ticker can be stopped"""
128 if not _unschedule:
129 return {'status': 'skip', 'reason': 'No scheduler available'}
130
131 # Start then stop
132 start()
133 result = stop()
134
135 # Verify
136 assert result['status'] == 'ok', f"Expected status=ok, got {result['status']}"
137 assert _state_manager.get('running') == False, "Ticker should be stopped"
138
139 if _logger:
140 _logger.info('test_ticker_stops passed')
141
142 return {'status': 'pass', 'test': 'test_ticker_stops'}
143
144
145__endpoint__ = {
146 'name': 'ticker',
147 'description': 'A scheduled object that ticks every N seconds',
148 'version': '1.0.0',
149 'methods': ['GET'],
150 'self_logging': True,
151 'self_testing': True,
152 'scheduled': True, # This object uses scheduled execution
153}