Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Macro-swift/Macro
An unopinionated SwiftNIO based asynchronous I/O framework, Node.js like.
https://github.com/Macro-swift/Macro
asyncio swift swiftnio
Last synced: 3 months ago
JSON representation
An unopinionated SwiftNIO based asynchronous I/O framework, Node.js like.
- Host: GitHub
- URL: https://github.com/Macro-swift/Macro
- Owner: Macro-swift
- License: apache-2.0
- Created: 2020-01-07T14:40:42.000Z (about 5 years ago)
- Default Branch: develop
- Last Pushed: 2024-10-08T16:27:20.000Z (5 months ago)
- Last Synced: 2024-11-14T11:02:35.904Z (3 months ago)
- Topics: asyncio, swift, swiftnio
- Language: Swift
- Homepage:
- Size: 398 KB
- Stars: 36
- Watchers: 2
- Forks: 1
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
Macro
A small, unopinionated "don't get into my way" / "I don't wanna `wait`"
asynchronous web framework for Swift.
With a strong focus on replicating the Node APIs in Swift.
But in a typesafe, and fast way.
Macro is a more capable variant of
[µExpress](https://github.com/NozeIO/MicroExpress).
The goal is still to keep a small core, but add some
[Noze.io](http://noze.io)
modules and concepts.
Eventually it might evolve into Noze.io v2 (once backpressure enabled streams
are fully working).
The companion [MacroExpress](https://github.com/Macro-swift/MacroExpress)
package adds Express.js-like middleware processing and functions, as well
as templates.
[MacroLambda](https://github.com/Macro-swift/MacroLambda) has the bits to
directly deploy Macro applications on AWS Lambda.
## Streams
Checkout [Noze.io for people who don't know Node](http://noze.io/noze4nonnode/),
most things apply to Macro as well.
## What does it look like?
The Macro [Examples](https://github.com/Macro-swift/Examples) package
contains a few examples which all can run straight from the source as
swift-sh scripts.
The most basic HTTP server:
```swift
#!/usr/bin/swift sh
import Macro // @Macro-swift ~> 0.8.0
http
.createServer { req, res in
res.writeHead(200, [ "Content-Type": "text/html" ])
res.write("
Hello Client: \(req.url)
")
res.end()
}
.listen(1337)
```
Macro also provides additional Node-like modules, such as:
- `fs`
- `path`
- `jsonfile`
- `JSON`
- `basicAuth`
- `querystring`
## Environment Variables
- `macro.core.numthreads`
- `macro.core.iothreads`
- `macro.core.retain.debug`
- `macro.concat.maxsize`
- `macro.streams.debug.rc`
## Async/Await
This intentionally doesn't support `async`/`await` yet as proper streaming
would require custom executors. Which are not yet available.
### Links
- [µExpress](http://www.alwaysrightinstitute.com/microexpress-nio2/)
- [Noze.io](http://noze.io)
- [SwiftNIO](https://github.com/apple/swift-nio)
- JavaScript Originals
- [Connect](https://github.com/senchalabs/connect)
- [Express.js](http://expressjs.com/en/starter/hello-world.html)
- Swift Apache
- [mod_swift](http://mod-swift.org)
- [ApacheExpress](http://apacheexpress.io)
### Who
**Macro** is brought to you by
[Helge Heß](https://github.com/helje5/) / [ZeeZide](https://zeezide.de).
We like feedback, GitHub stars, cool contract work,
presumably any form of praise you can think of.
There is a `#microexpress` channel on the
[Noze.io Slack](http://slack.noze.io/). Feel free to join!