echocorn 1.0.1b0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (12) hide show
  1. echocorn-1.0.1b0/PKG-INFO +154 -0
  2. echocorn-1.0.1b0/README.md +106 -0
  3. echocorn-1.0.1b0/echocorn/__init__.py +1 -0
  4. echocorn-1.0.1b0/echocorn/__main__.py +1230 -0
  5. echocorn-1.0.1b0/echocorn.egg-info/PKG-INFO +154 -0
  6. echocorn-1.0.1b0/echocorn.egg-info/SOURCES.txt +11 -0
  7. echocorn-1.0.1b0/echocorn.egg-info/dependency_links.txt +1 -0
  8. echocorn-1.0.1b0/echocorn.egg-info/entry_points.txt +2 -0
  9. echocorn-1.0.1b0/echocorn.egg-info/requires.txt +2 -0
  10. echocorn-1.0.1b0/echocorn.egg-info/top_level.txt +1 -0
  11. echocorn-1.0.1b0/setup.cfg +7 -0
  12. echocorn-1.0.1b0/setup.py +68 -0
echocorn-1.0.1b0/PKG-INFO ADDED
@@ -0,0 +1,154 @@
1
+ Metadata-Version: 2.4
2
+ Name: echocorn
3
+ Version: 1.0.1b0
4
+ Summary: Very fast asynchronous asgi server with HTTP/1.1 and HTTP/2.0
5
+ Home-page: https://github.com/mishakorzik/echocorn
6
+ Author: MishaKorzhik_He1Zen
7
+ Author-email: developer.mishakorzhik@gmail.com
8
+ License: Apache 2.0
9
+ Project-URL: Bug Tracker, https://github.com/mishakorzik/echocorn/issues
10
+ Project-URL: Donate, https://www.buymeacoffee.com/misakorzik
11
+ Keywords: asgi,async,uvloop,fast,http,https,hsts,tls,server,secure,secured,dualstack
12
+ Classifier: Development Status :: 4 - Beta
13
+ Classifier: License :: OSI Approved :: Apache Software License
14
+ Classifier: Operating System :: OS Independent
15
+ Classifier: Programming Language :: Python
16
+ Classifier: Programming Language :: Python :: 3
17
+ Classifier: Programming Language :: Python :: 3.7
18
+ Classifier: Programming Language :: Python :: 3.8
19
+ Classifier: Programming Language :: Python :: 3.9
20
+ Classifier: Programming Language :: Python :: 3.10
21
+ Classifier: Programming Language :: Python :: 3.11
22
+ Classifier: Programming Language :: Python :: 3.12
23
+ Classifier: Programming Language :: Python :: 3.13
24
+ Classifier: Programming Language :: Python :: 3.14
25
+ Classifier: Programming Language :: Python :: Implementation :: CPython
26
+ Classifier: Programming Language :: Python :: Implementation :: PyPy
27
+ Classifier: Framework :: AsyncIO
28
+ Classifier: Topic :: Internet :: WWW/HTTP
29
+ Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
30
+ Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
31
+ Classifier: Environment :: Web Environment
32
+ Requires-Python: >=3.7
33
+ Description-Content-Type: text/markdown
34
+ Requires-Dist: h2>=4.0.0
35
+ Requires-Dist: toml>=0.10.0
36
+ Dynamic: author
37
+ Dynamic: author-email
38
+ Dynamic: classifier
39
+ Dynamic: description
40
+ Dynamic: description-content-type
41
+ Dynamic: home-page
42
+ Dynamic: keywords
43
+ Dynamic: license
44
+ Dynamic: project-url
45
+ Dynamic: requires-dist
46
+ Dynamic: requires-python
47
+ Dynamic: summary
48
+
49
+ # Echocorn
50
+
51
+ **Echocorn** is an exceptionally fast, lightweight ASGI server with a custom HTTP/1.1 implementation and first-class HTTP/2 support (powered by the `h2` library). Designed for modern web applications, Echocorn combines high throughput with small resource overhead and includes built-in response compression and hardened HTTP header security.
52
+
53
+ ---
54
+
55
+ ## Key features
56
+
57
+ * High-performance ASGI server optimized for low-latency workloads
58
+ * Native HTTP/1.1 implementation plus built-in HTTP/2 support via `h2`
59
+ * Transparent response compression (gzip/deflate) to reduce bandwidth usage
60
+ * Enhanced HTTP header security (CSP, HSTS, X-Frame-Options, etc.) out of the box
61
+ * Minimal dependencies and small memory footprint
62
+ * Simple command-line interface for quick deployment
63
+
64
+ ---
65
+
66
+ ## Quick install
67
+
68
+ Install from PyPI:
69
+
70
+ ```bash
71
+ pip install echocorn
72
+ ```
73
+
74
+ ---
75
+
76
+ ## Quick start
77
+
78
+ Run your ASGI application (example using a callable named `app` inside `app.py`):
79
+
80
+ ```bash
81
+ echocorn --app app:app --port 443
82
+ ```
83
+
84
+ Show all available command-line options:
85
+
86
+ ```bash
87
+ echocorn --help
88
+ ```
89
+
90
+ ---
91
+
92
+ ## Example usage
93
+
94
+ Use Echocorn to serve a FastAPI, Starlette, or any ASGI app.
95
+
96
+ ```bash
97
+ # Serve app.app (where `app` is an ASGI application instance)
98
+ echocorn --app app:app --host 0.0.0.0 --port 443 --workers 2 --safe-headers --keyfile key.pem --certfile cert.pem
99
+ ```
100
+
101
+ ---
102
+
103
+ ## Configuration & options
104
+
105
+ Echocorn exposes CLI flags for common server settings such as:
106
+
107
+ * `--app` — module:callable path to your ASGI application
108
+ * `--host` / `--port` — where the server listens
109
+ * `--workers` — number of worker processes
110
+ * `--certfile`, `--keyfile` — TLS/SSL files for secure connections
111
+ * `--compression` — toggle or tune response compression
112
+ * `--safe-headers` — enable security headers
113
+ * `--domain` — allows requests only if host in headers matches
114
+ * `--about` — show about the server
115
+
116
+ Run `echocorn --help` to see the full set of parameters and defaults.
117
+
118
+ ---
119
+
120
+ ## Security & performance
121
+
122
+ Echocorn focuses on secure and efficient defaults:
123
+
124
+ * HTTP header hardening (CSP, HSTS, X-Content-Type-Options, X-Frame-Options) to reduce common web risks
125
+ * Built-in compression to reduce latency & bandwidth costs for clients
126
+ * Optimised request/response handling path for minimal overhead and maximum throughput
127
+
128
+ For production use, pair Echocorn with standard hardening measures (firewall rules, TLS best practices, OS-level tuning) and monitor resource usage.
129
+
130
+ ---
131
+
132
+ ## Screenshots
133
+
134
+ Examples of running Echocorn and request logs:
135
+
136
+ <img width="48.9%" src="https://raw.githubusercontent.com/mishakorzik/echocorn/refs/heads/main/screenshot_1.jpg"/>
137
+ <img width="48.9%" src="https://raw.githubusercontent.com/mishakorzik/echocorn/refs/heads/main/screenshot_2.jpg"/>
138
+
139
+ ---
140
+
141
+ ## Donate
142
+
143
+ If you find Echocorn useful and want to support development, you can donate here:
144
+
145
+ [<img title="Donate" src="https://img.shields.io/badge/Donate-Echocorn-blue?style=for-the-badge&logo=github"/>](https://www.buymeacoffee.com/misakorzik)
146
+
147
+ ---
148
+
149
+ ## Community & support
150
+
151
+ * Telegram: [https://t.me/ubp2q](https://t.me/ubp2q)
152
+ * Discord: [https://discord.gg/xwpMuMYW57](https://discord.gg/xwpMuMYW57)
153
+
154
+ If you find a bug or have questions, open an issue or reach out on Discord.
echocorn-1.0.1b0/README.md ADDED
@@ -0,0 +1,106 @@
1
+ # Echocorn
2
+
3
+ **Echocorn** is an exceptionally fast, lightweight ASGI server with a custom HTTP/1.1 implementation and first-class HTTP/2 support (powered by the `h2` library). Designed for modern web applications, Echocorn combines high throughput with small resource overhead and includes built-in response compression and hardened HTTP header security.
4
+
5
+ ---
6
+
7
+ ## Key features
8
+
9
+ * High-performance ASGI server optimized for low-latency workloads
10
+ * Native HTTP/1.1 implementation plus built-in HTTP/2 support via `h2`
11
+ * Transparent response compression (gzip/deflate) to reduce bandwidth usage
12
+ * Enhanced HTTP header security (CSP, HSTS, X-Frame-Options, etc.) out of the box
13
+ * Minimal dependencies and small memory footprint
14
+ * Simple command-line interface for quick deployment
15
+
16
+ ---
17
+
18
+ ## Quick install
19
+
20
+ Install from PyPI:
21
+
22
+ ```bash
23
+ pip install echocorn
24
+ ```
25
+
26
+ ---
27
+
28
+ ## Quick start
29
+
30
+ Run your ASGI application (example using a callable named `app` inside `app.py`):
31
+
32
+ ```bash
33
+ echocorn --app app:app --port 443
34
+ ```
35
+
36
+ Show all available command-line options:
37
+
38
+ ```bash
39
+ echocorn --help
40
+ ```
41
+
42
+ ---
43
+
44
+ ## Example usage
45
+
46
+ Use Echocorn to serve a FastAPI, Starlette, or any ASGI app.
47
+
48
+ ```bash
49
+ # Serve app.app (where `app` is an ASGI application instance)
50
+ echocorn --app app:app --host 0.0.0.0 --port 443 --workers 2 --safe-headers --keyfile key.pem --certfile cert.pem
51
+ ```
52
+
53
+ ---
54
+
55
+ ## Configuration & options
56
+
57
+ Echocorn exposes CLI flags for common server settings such as:
58
+
59
+ * `--app` — module:callable path to your ASGI application
60
+ * `--host` / `--port` — where the server listens
61
+ * `--workers` — number of worker processes
62
+ * `--certfile`, `--keyfile` — TLS/SSL files for secure connections
63
+ * `--compression` — toggle or tune response compression
64
+ * `--safe-headers` — enable security headers
65
+ * `--domain` — allows requests only if host in headers matches
66
+ * `--about` — show about the server
67
+
68
+ Run `echocorn --help` to see the full set of parameters and defaults.
69
+
70
+ ---
71
+
72
+ ## Security & performance
73
+
74
+ Echocorn focuses on secure and efficient defaults:
75
+
76
+ * HTTP header hardening (CSP, HSTS, X-Content-Type-Options, X-Frame-Options) to reduce common web risks
77
+ * Built-in compression to reduce latency & bandwidth costs for clients
78
+ * Optimised request/response handling path for minimal overhead and maximum throughput
79
+
80
+ For production use, pair Echocorn with standard hardening measures (firewall rules, TLS best practices, OS-level tuning) and monitor resource usage.
81
+
82
+ ---
83
+
84
+ ## Screenshots
85
+
86
+ Examples of running Echocorn and request logs:
87
+
88
+ <img width="48.9%" src="https://raw.githubusercontent.com/mishakorzik/echocorn/refs/heads/main/screenshot_1.jpg"/>
89
+ <img width="48.9%" src="https://raw.githubusercontent.com/mishakorzik/echocorn/refs/heads/main/screenshot_2.jpg"/>
90
+
91
+ ---
92
+
93
+ ## Donate
94
+
95
+ If you find Echocorn useful and want to support development, you can donate here:
96
+
97
+ [<img title="Donate" src="https://img.shields.io/badge/Donate-Echocorn-blue?style=for-the-badge&logo=github"/>](https://www.buymeacoffee.com/misakorzik)
98
+
99
+ ---
100
+
101
+ ## Community & support
102
+
103
+ * Telegram: [https://t.me/ubp2q](https://t.me/ubp2q)
104
+ * Discord: [https://discord.gg/xwpMuMYW57](https://discord.gg/xwpMuMYW57)
105
+
106
+ If you find a bug or have questions, open an issue or reach out on Discord.
echocorn-1.0.1b0/echocorn/__init__.py ADDED
@@ -0,0 +1 @@
1
+ # Nothing