1
0
mirror of https://github.com/actix/actix-website synced 2025-01-22 16:15:56 +01:00

clarity role of actix in whatis

This commit is contained in:
Rob Ede 2021-01-17 16:58:25 +00:00 committed by GitHub
parent 4aece987ac
commit 2e91d76e2e
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -4,22 +4,27 @@ menu: docs_intro
weight: 100 weight: 100
--- ---
# Actix is an ecosystem of crates # Actix is an Ecosystem of Crates
Actix is a few things. The base of it is a powerful actor system for Rust on top of which the Long ago, `actix-web` was built on top of `actix`, a powerful and fast actor system.
`actix-web` system was originally built. This is what you are most likely going to work with. What Now, `actix-web` is largely unrelated to the actor framework and is built using a different system.
`actix-web` gives you is a powerful and very fast web development framework. Though `actix` is still maintained, it's usefulness as a general tool is diminishing as the
futures and async/await ecosystem matures. At this time, the use of `actix` it is only required for
WebSocket endpoints.
We call `actix-web` a small and pragmatic framework. For all intents and purposes it's a We call `actix-web` a powerful and pragmatic framework. For all intents and purposes it's a
micro-framework with a few twists. If you are already a Rust programmer you will probably find micro-framework with a few twists. If you are already a Rust programmer you will probably find
yourself at home quickly, but even if you are coming from another programming language you should yourself at home quickly, but even if you are coming from another programming language you should
find `actix-web` easy to pick up. find `actix-web` easy to pick up.
<!-- TODO -->
<!-- actix-extras -->
An application developed with `actix-web` will expose an HTTP server contained within a native An application developed with `actix-web` will expose an HTTP server contained within a native
executable. You can either put this behind another HTTP server like nginx or serve it up as-is. Even executable. You can either put this behind another HTTP server like nginx or serve it up as-is. Even
in the complete absence of another HTTP server `actix-web` is powerful enough to provide HTTP/1 and in the complete absence of another HTTP server `actix-web` is powerful enough to provide HTTP/1 and
HTTP/2 support as well as TLS (HTTPS). This makes it useful for building small services ready for HTTP/2 support as well as TLS (HTTPS). This makes it useful for building small services ready for
distribution. production.
Most importantly: `actix-web` runs on Rust {{< rust-version "actix-web" >}} or later and it works Most importantly: `actix-web` runs on Rust {{< rust-version "actix-web" >}} or later and it works
with stable releases. with stable releases.