blob: d84d96a0e91733cb90d5d5614772dedb4c0d5332 [file] [log] [blame] [view]
Urgau120c6b12024-03-26 12:30:461<div align="center">
2 <picture>
Zander Milroyce4cc9d2024-04-03 00:05:013 <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/rust-lang/www.rust-lang.org/master/static/images/rust-social-wide-dark.svg">
4 <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/rust-lang/www.rust-lang.org/master/static/images/rust-social-wide-light.svg">
Urgau120c6b12024-03-26 12:30:465 <img alt="The Rust Programming Language: A language empowering everyone to build reliable and efficient software"
Zander Milroyce4cc9d2024-04-03 00:05:016 src="https://raw.githubusercontent.com/rust-lang/www.rust-lang.org/master/static/images/rust-social-wide-light.svg"
Urgau120c6b12024-03-26 12:30:467 width="50%">
8 </picture>
Corey Farwelld2cc79e2020-12-23 19:17:349
Urgau120c6b12024-03-26 12:30:4610[Website][Rust] | [Getting started] | [Learn] | [Documentation] | [Contributing]
11</div>
0xf33356d7b9c2023-02-27 03:20:0912
Peter Atashianbe43c652016-06-27 17:51:2713This is the main source code repository for [Rust]. It contains the compiler,
Andreas Jonson30659cd2020-07-19 14:53:3714standard library, and documentation.
Nick Hamann74f18182015-05-15 05:43:4015
Alex Touchet8915ba72022-12-29 05:47:0916[Rust]: https://www.rust-lang.org/
Urgau120c6b12024-03-26 12:30:4617[Getting Started]: https://www.rust-lang.org/learn/get-started
18[Learn]: https://www.rust-lang.org/learn
19[Documentation]: https://www.rust-lang.org/learn#learn-use
20[Contributing]: CONTRIBUTING.md
Claes Gilld7256a62023-10-19 20:32:1121
Urgauf6b51c12024-04-03 05:59:1522## Why Rust?
23
Aarik Pokras2d71dd52024-12-07 21:42:5924- **Performance:** Fast and memory-efficient, suitable for critical services, embedded devices, and easily integrated with other languages.
Urgauf6b51c12024-04-03 05:59:1525
26- **Reliability:** Our rich type system and ownership model ensure memory and thread safety, reducing bugs at compile-time.
27
28- **Productivity:** Comprehensive documentation, a compiler committed to providing great diagnostics, and advanced tooling including package manager and build tool ([Cargo]), auto-formatter ([rustfmt]), linter ([Clippy]) and editor support ([rust-analyzer]).
29
30[Cargo]: https://github.com/rust-lang/cargo
31[rustfmt]: https://github.com/rust-lang/rustfmt
32[Clippy]: https://github.com/rust-lang/rust-clippy
33[rust-analyzer]: https://github.com/rust-lang/rust-analyzer
34
Jack Moffitt8d64fa32013-07-18 23:27:4335## Quick Start
Brian Andersonc92d2ed2012-07-10 05:13:4836
Fuqiao Xue09ac4782017-06-09 05:37:2237Read ["Installation"] from [The Book].
Austin Seipp62c4d2c2012-01-23 21:53:1238
misagh3d23e552018-12-10 22:28:5539["Installation"]: https://doc.rust-lang.org/book/ch01-01-installation.html
Eli Friedmanbbbfed22015-08-09 21:15:0540[The Book]: https://doc.rust-lang.org/book/index.html
Jack Moffitt8d64fa32013-07-18 23:27:4341
Alex Touchet7e64f292024-01-15 21:57:2942## Installing from Source
Jack Moffitt8d64fa32013-07-18 23:27:4343
Alex Touchet7e64f292024-01-15 21:57:2944If you really want to install from source (though this is not recommended), see
45[INSTALL.md](INSTALL.md).
Austin Seipp62c4d2c2012-01-23 21:53:1246
Kevin Yap24fa6be2015-02-21 22:46:0647## Getting Help
Brian Andersoncd1fabe2014-08-22 18:04:3548
Joshua Nelsona06e5de2022-12-24 01:03:5049See https://www.rust-lang.org/community for a list of chat platforms and forums.
Steve Klabnikf645cad2015-02-13 17:26:4450
51## Contributing
52
Joshua Nelsona06e5de2022-12-24 01:03:5053See [CONTRIBUTING.md](CONTRIBUTING.md).
Camelid8783c622020-09-02 00:48:1554
Brian Andersonc92d2ed2012-07-10 05:13:4855## License
Austin Seipp62c4d2c2012-01-23 21:53:1256
Alex Touchet8915ba72022-12-29 05:47:0957Rust is primarily distributed under the terms of both the MIT license and the
58Apache License (Version 2.0), with portions covered by various BSD-like
59licenses.
Austin Seipp62c4d2c2012-01-23 21:53:1260
Peter Atashianbe43c652016-06-27 17:51:2761See [LICENSE-APACHE](LICENSE-APACHE), [LICENSE-MIT](LICENSE-MIT), and
62[COPYRIGHT](COPYRIGHT) for details.
Andrew Xu8ffb6fd2019-04-06 10:04:0663
64## Trademark
Andrew Xu8ffb6fd2019-04-06 10:04:0665
Liigo Zhuang9c65f9f2021-05-26 02:51:1366[The Rust Foundation][rust-foundation] owns and protects the Rust and Cargo
Alex Touchet8915ba72022-12-29 05:47:0967trademarks and logos (the "Rust Trademarks").
Andrew Xu8ffb6fd2019-04-06 10:04:0668
Alex Touchet8915ba72022-12-29 05:47:0969If you want to use these names or brands, please read the
70[media guide][media-guide].
Andrew Xu8ffb6fd2019-04-06 10:04:0671
Andrew Xu98beb122019-04-12 14:14:2172Third-party logos may be subject to third-party copyrights and trademarks. See
73[Licenses][policies-licenses] for details.
74
Liigo Zhuang2caaa072021-05-20 10:11:0175[rust-foundation]: https://foundation.rust-lang.org/
Alex Touchet8915ba72022-12-29 05:47:0976[media-guide]: https://foundation.rust-lang.org/policies/logo-policy-and-media-guide/
Andrew Xu98beb122019-04-12 14:14:2177[policies-licenses]: https://www.rust-lang.org/policies/licenses