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
counter.py · 6.1 KB · 237 lines
1"""
2Counter Endpoint - A living object primitive
3
4This endpoint demonstrates the complete Object Primitive System:
5- Self-logging (logs all requests to itself)
6- Self-versioning (tracks changes to its own code)
7- Self-contained state (maintains own counter)
8- Network accessible (can be called via HTTP)
9
10The counter:
11- Increments on GET requests
12- Can be reset via POST
13- Logs every operation to its own log file
14- Versions changes to its code
15- Tracks execution time for performance monitoring
16"""
17import time
18
19# This will be injected by the runtime
20_logger = None
21_state_manager = None
22
23
24def GET(request):
25 """
26 Increment counter and return current value.
27
28 Args:
29 request: HTTP request dict
30
31 Returns:
32 Dict with counter value
33 """
34 start_time = time.time()
35
36 # Get current count
37 if _state_manager:
38 count = _state_manager.get('count', 0)
39 count += 1
40 _state_manager.set('count', count)
41 else:
42 # Fallback if no state manager
43 count = 1
44
45 # Calculate execution time
46 exec_time_ms = (time.time() - start_time) * 1000
47
48 # Log the operation with execution time
49 if _logger:
50 _logger.info(
51 f'Counter incremented - completed in {exec_time_ms:.2f}ms',
52 method='GET',
53 count=count,
54 exec_time_ms=exec_time_ms,
55 user_id=request.get('user_id'),
56 request_id=request.get('request_id'),
57 )
58
59 return {
60 'status': 'ok',
61 'count': count,
62 'message': f'Counter is now at {count}',
63 }
64
65
66def POST(request):
67 """
68 Reset counter to 0 (or specified value).
69
70 Args:
71 request: HTTP request dict with optional 'value' field
72
73 Returns:
74 Dict with new counter value
75 """
76 start_time = time.time()
77
78 # Get reset value (default to 0)
79 new_value = request.get('value', 0)
80
81 # Reset count
82 if _state_manager:
83 old_value = _state_manager.get('count', 0)
84 _state_manager.set('count', new_value)
85 else:
86 old_value = 0
87
88 # Calculate execution time
89 exec_time_ms = (time.time() - start_time) * 1000
90
91 # Log the reset with execution time
92 if _logger:
93 _logger.warning(
94 f'Counter reset - completed in {exec_time_ms:.2f}ms',
95 method='POST',
96 old_value=old_value,
97 new_value=new_value,
98 exec_time_ms=exec_time_ms,
99 user_id=request.get('user_id'),
100 request_id=request.get('request_id'),
101 )
102
103 return {
104 'status': 'ok',
105 'count': new_value,
106 'message': f'Counter reset from {old_value} to {new_value}',
107 }
108
109
110def DELETE(request):
111 """
112 Delete counter state (reset to uninitialized).
113
114 Args:
115 request: HTTP request dict
116
117 Returns:
118 Dict with status
119 """
120 if _state_manager:
121 old_value = _state_manager.get('count', 0)
122 _state_manager.delete('count')
123 else:
124 old_value = 0
125
126 # Log the deletion
127 if _logger:
128 _logger.critical(
129 'Counter state deleted',
130 method='DELETE',
131 old_value=old_value,
132 user_id=request.get('user_id'),
133 request_id=request.get('request_id'),
134 )
135
136 return {
137 'status': 'ok',
138 'message': f'Counter state deleted (was {old_value})',
139 }
140
141
142def test_increment():
143 """
144 Test that counter increments correctly.
145
146 Objects can test themselves! This is dogfooding at its finest.
147 """
148 if not _state_manager:
149 return {'status': 'skip', 'reason': 'No state manager available'}
150
151 # Reset to known state
152 _state_manager.set('count', 10)
153
154 # Increment
155 result = GET({'test': True})
156
157 # Verify
158 assert result['count'] == 11, f"Expected count=11, got {result['count']}"
159 assert result['status'] == 'ok', f"Expected status=ok, got {result['status']}"
160
161 if _logger:
162 _logger.info('test_increment passed', test='test_increment', result='pass')
163
164 return {'status': 'pass', 'test': 'test_increment'}
165
166
167def test_reset():
168 """Test that counter resets to specified value."""
169 if not _state_manager:
170 return {'status': 'skip', 'reason': 'No state manager available'}
171
172 # Set to some value
173 _state_manager.set('count', 99)
174
175 # Reset to 0
176 result = POST({'value': 0})
177
178 # Verify
179 assert result['count'] == 0, f"Expected count=0, got {result['count']}"
180 assert _state_manager.get('count') == 0, "State not actually reset"
181
182 if _logger:
183 _logger.info('test_reset passed', test='test_reset', result='pass')
184
185 return {'status': 'pass', 'test': 'test_reset'}
186
187
188def test_state_persistence():
189 """Test that state persists across calls."""
190 if not _state_manager:
191 return {'status': 'skip', 'reason': 'No state manager available'}
192
193 # Set known value
194 _state_manager.set('count', 42)
195
196 # Get it back
197 value = _state_manager.get('count')
198
199 # Verify
200 assert value == 42, f"Expected count=42, got {value}"
201
202 if _logger:
203 _logger.info('test_state_persistence passed', test='test_state_persistence', result='pass')
204
205 return {'status': 'pass', 'test': 'test_state_persistence'}
206
207
208__endpoint__ = {
209 'name': 'counter',
210 'description': 'A self-logging, self-versioning counter endpoint',
211 'version': '1.0.0',
212 'author': 'Object Primitive System',
213 'methods': ['GET', 'POST', 'DELETE'],
214 'self_logging': True,
215 'self_versioning': True,
216 'self_testing': True, # Objects can test themselves!
217 'state': {
218 'count': 'Integer counter value',
219 },
220 'examples': {
221 'GET': {
222 'description': 'Increment counter',
223 'request': {},
224 'response': {'status': 'ok', 'count': 1, 'message': 'Counter is now at 1'},
225 },
226 'POST': {
227 'description': 'Reset counter',
228 'request': {'value': 0},
229 'response': {'status': 'ok', 'count': 0, 'message': 'Counter reset from 5 to 0'},
230 },
231 'DELETE': {
232 'description': 'Delete counter state',
233 'request': {},
234 'response': {'status': 'ok', 'message': 'Counter state deleted (was 5)'},
235 },
236 },
237}