Update getting-started.md (#175)

Add __name__ == "__main__" clauses and a make_app function so that the app can be run with the CLI too.
pull/176/head
leunga1000 2024-05-03 16:32:02 +01:00 zatwierdzone przez GitHub
rodzic 2aba41ff7b
commit 293b2a97c2
Nie znaleziono w bazie danych klucza dla tego podpisu
ID klucza GPG: B5690EEEBB952194
1 zmienionych plików z 35 dodań i 23 usunięć

Wyświetl plik

@ -8,10 +8,14 @@ Hello world app
```python ```python
from socketify import App from socketify import App
app = App() def make_app(app: App):
app.get("/", lambda res, req: res.end("Hello World socketify from Python!")) app.get("/", lambda res, req: res.end("Hello World socketify from Python!"))
app.listen(3000, lambda config: print("Listening on port http://localhost:%d now\n" % config.port))
app.run() if __name__ == "__main__":
app = App()
make_app(app)
app.listen(3000, lambda config: print("Listening on port http://localhost:%d now\n" % config.port))
app.run()
``` ```
> This example just show how intuitive is to start an simple hello world app. > This example just show how intuitive is to start an simple hello world app.
@ -19,10 +23,13 @@ SSL version sample
``` python ``` python
from socketify import App, AppOptions from socketify import App, AppOptions
app = App(AppOptions(key_file_name="./misc/key.pem", cert_file_name="./misc/cert.pem", passphrase="1234")) def make_app(app):
app.get("/", lambda res, req: res.end("Hello World socketify from Python!")) app.get("/", lambda res, req: res.end("Hello World socketify from Python!"))
app.listen(3000, lambda config: print("Listening on port http://localhost:%d now\n" % config.port))
app.run() if __name__ == "__main__":
app = App(AppOptions(key_file_name="./misc/key.pem", cert_file_name="./misc/cert.pem", passphrase="1234"))
app.listen(3000, lambda config: print("Listening on port http://localhost:%d now\n" % config.port))
app.run()
``` ```
> We have a lot of SSL options, but this is the most common you can see all the options in the [API Reference](api.md) > We have a lot of SSL options, but this is the most common you can see all the options in the [API Reference](api.md)
@ -39,19 +46,24 @@ def ws_message(ws, message, opcode):
#Ok is false if backpressure was built up, wait for drain #Ok is false if backpressure was built up, wait for drain
ok = ws.send(message, opcode) ok = ws.send(message, opcode)
app = App() def make_app(app):
app.ws("/*", { app.ws("/*", {
'compression': CompressOptions.SHARED_COMPRESSOR, 'compression': CompressOptions.SHARED_COMPRESSOR,
'max_payload_length': 16 * 1024 * 1024, 'max_payload_length': 16 * 1024 * 1024,
'idle_timeout': 12, 'idle_timeout': 12,
'open': ws_open, 'open': ws_open,
'message': ws_message, 'message': ws_message,
'drain': lambda ws: print('WebSocket backpressure: %i' % ws.get_buffered_amount()), 'drain': lambda ws: print('WebSocket backpressure: %i' % ws.get_buffered_amount()),
'close': lambda ws, code, message: print('WebSocket closed') 'close': lambda ws, code, message: print('WebSocket closed')
}) })
app.any("/", lambda res,req: res.end("Nothing to see here!'")) app.any("/", lambda res,req: res.end("Nothing to see here!'"))
app.listen(3000, lambda config: print("Listening on port http://localhost:%d now\n" % (config.port)))
app.run()
if __name__ == "__main__":
app = App()
make_app(app)
app.listen(3000, lambda config: print("Listening on port http://localhost:%d now\n" % (config.port)))
app.run()
``` ```
> We can have multiple routes for WebSockets, but in this example we just get one for anything we need, adding an option of compression using SHARED_COMPRESSOR, max_payload_length of 1mb and an idle timeout of 12s just to show some most commonly used features you can see all these options in the [API Reference](api.md) > We can have multiple routes for WebSockets, but in this example we just get one for anything we need, adding an option of compression using SHARED_COMPRESSOR, max_payload_length of 1mb and an idle timeout of 12s just to show some most commonly used features you can see all these options in the [API Reference](api.md)