140 lines
71 KiB
Plaintext
140 lines
71 KiB
Plaintext
|
rust
|
|||
|
|
à #rustc 1.93.0 (254b59607 2026-01-19)Á“õ…·fÊvŠ ¦%g- -c48c539199cbc88bÁ ³VOÐêùÿ²?ÑL¼�§Ì± -a7a40eb546f9e2b0Á á\ƒ¦è3$|]åŒ[IÚ tæ -14b12edc9f8cd90bÁ ë&Gf·Ã ¬ëñq:¤»b -bb76018b1173caf6Áà 9m Ù„«ÐÒþá•c‘B; -030c5b0bba47cc8fÁ rustc_std_workspace_coreÁÛ¹þÓ7>H%¸ÚÉ’› -4b81d37a5530864dÁ üÃùs<Uß7VyóHr#QÏ -c66cc7807550ce25Á miniz_oxideÁõFÖˆÚ™ª‹"ÞXzLVª -62cbc7af83058505Á adler2Á—wÉD‘嵯�|6¨%Œ
|
|||
|
|
+ -2f171dd2394b4b62Á hashbrownÁ,ïcV¼¨ø¢:Ê\'È߈ -9571ba9e0f6c7a90Á rustc_std_workspace_allocÁ%¥Èxµù·¼5Ä3Bœ -aac566ad65903fa4Á
|
|||
|
|
std_detectÁMmáýZ^9õ Îà§e˜÷e -2edb296e590136d8Á rustc_demangleÁ@¼§VÉNb˜æ¨fHÌ+V3 -53b132e4a2fa6e26Á cfg_ifÁfÝv�.Å"ÒÜuPp¹ˆ¶ -f76b385d7d4d7f3eÁ addr2lineÁÕú-WiúQVÓ¬
|
|||
|
|
µT§�5 -fe25100bd73e48e4Á gimliÁ¹xLáÇí÷‘o ±Ñ8£Å -265ba9e6e4f70b3fÁ objectÁÔ³ÝzÓÿ¶ò°öM›¼òü` -9ae0d1f8ea52a318Á memchrÁRÎ÷׎™te~QÓ¿ØC\Ò -0bff3c8e8f4e489eÁ –©H�tGNÏ ·ˆ!á -d69228d077d46f36Á testsÁ,¶3 à$«3 'Å,×,à$Ì, Å,ùià$îi “ ª readÁ parseÁ from_mmpÁ to_mmpÁ at_leastÁ at_mostÁ exactlyÁ Í Í channelÁ ¨ » ‡ supports_featuresÁ is_devÁ
|
|||
|
|
is_nightlyÁ is_betaÁ is_stableÁ %Í dateÁ ' ' )¨ * * )» - - ) from_ymdÁ ) to_ymdÁ )ë 2 )þ 4 )� 6 '8Í #version_and_date_from_rustc_versionÁ ? ? ? ? +version_and_date_from_rustc_verbose_versionÁ D E get_version_and_dateÁ G G G tripleÁ is_min_dateÁ is_max_dateÁ
|
|||
|
|
is_exact_dateÁ is_min_versionÁ is_max_versionÁ is_exact_versionÁ is_feature_flaggableÁ R supports_featureÁ T T V T ALLOW_FEATURESÁ T T T T VersionÁ ]
|
|||
|
|
]ì aÕ c˜ gÈ i¤
|
|||
|
|
kÐ KindÁ m DevÁ n
|
|||
|
|
m NightlyÁ p
|
|||
|
|
m BetaÁ r
|
|||
|
|
m StableÁ t
|
|||
|
|
vÍ yÕ {˜ È ChannelÁ �
|
|||
|
|
�ì „Í
|
|||
|
|
‡Õ ‰˜
|
|||
|
|
�È ' DateÁ �
|
|||
|
|
�ì '’Í ''•Õ '—˜ '''›È ' �¤ '
|
|||
|
|
ŸÐ
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
!
|
|||
|
|
"
|
|||
|
|
#
|
|||
|
|
$
|
|||
|
|
&
|
|||
|
|
&
|
|||
|
|
&
|
|||
|
|
-
|
|||
|
|
1
|
|||
|
|
2
|
|||
|
|
2
|
|||
|
|
4
|
|||
|
|
4
|
|||
|
|
6
|
|||
|
|
6
|
|||
|
|
9
|
|||
|
|
9
|
|||
|
|
9
|
|||
|
|
?
|
|||
|
|
D
|
|||
|
|
D
|
|||
|
|
L
|
|||
|
|
M
|
|||
|
|
N
|
|||
|
|
O
|
|||
|
|
P
|
|||
|
|
Q
|
|||
|
|
T
|
|||
|
|
b
|
|||
|
|
b
|
|||
|
|
d
|
|||
|
|
h
|
|||
|
|
j
|
|||
|
|
j
|
|||
|
|
l
|
|||
|
|
l
|
|||
|
|
w
|
|||
|
|
w
|
|||
|
|
w
|
|||
|
|
z
|
|||
|
|
z
|
|||
|
|
|
|
|||
|
|
€
|
|||
|
|
…
|
|||
|
|
…
|
|||
|
|
…
|
|||
|
|
ˆ
|
|||
|
|
ˆ
|
|||
|
|
Š
|
|||
|
|
Ž
|
|||
|
|
“
|
|||
|
|
“
|
|||
|
|
“
|
|||
|
|
–
|
|||
|
|
–
|
|||
|
|
˜
|
|||
|
|
œ
|
|||
|
|
ž
|
|||
|
|
ž
|
|||
|
|
|
|||
|
|
|
|||
|
|
¬â ] ] ^ß _ì D.Úˆ»C˜¿ žÎÎ £Î þ Î áÎ ÞÎ ÉÎÎ ÃÎ å`Î à`Î à` m n oÆ p qÔ r sæ t uõ ý\Åú66AW ¬âá žáá £á þ á áá Þá à` � � ‚¾ ƒì J�çoWã[ ¬âô žôô £ô þ ô áô Þô å`ô à` � � �• ‘ì ' M_æ.c~xf ¬âõ žõõ £õ þ õ áõ Þõ Éõõ Ãõ å`õ ` ]x m† �” �a ]y m‡ �• �c ]{ m‰ �— �e ]} m‹ �™ �f ]~ mŒ �š �g ] m� �› �i ]� �k ]Ÿ � ]% �8 � ]v m„ �’ �¬âÑž£þ áÞÉà å` à`œ Ÿ # d b H[ Î â Ÿ g Ÿ n 4 î A K h d f â # - (p u h $ Î 0 â 7 @ J œ Ÿ Ÿ ' ,
|
|||
|
|
ËŸ Ÿ @ E M � j Pw ø°ú°û°Ð ü° ý°�þ°ì H�ˈXêE>üÕýÕþÕ LessÁ ÿÕ €Ö�Ö’ ‚Ö ƒÖ„Ö GreaterÁ …Ö iÒ6’<Ë ± â ¸ â ¿ Ÿ , ø 4 Û î è ò ƒ ^ œ Ÿ Ÿ ' ,
|
|||
|
|
ÄŸ = B J † l ƒ ƒ â â ø ƒ ø Š 3 î @ J í!³ 3Á( % + 3 J R È# e m È# 8 € ˆ È# S � ¢
|
|||
|
|
‹a ³ ¸ À w Õ ê³í³ î³Ò ï³ì ð³ ñ³“ò³ì äs{ ©¶‘Í Ñ¼Ñ¼Ò¼” štÀ. V á a Á`Á` œ Ã`è Á] Ä` bufÁÁ] Ê\É:• § È# ¯ · Á þÏ Ú ¶$ä H
|
|||
|
|
( z 8 = C N é% U é% \ Â& c Â& j s î € __self_discrÁ™ __arg1_discrÁ° ¸ , | * Í
|
|||
|
|
é% ' (4 9 € á + é% 2 ; E (¼ È# ó á à` Q V
|
|||
|
|
¨a g l \ y Á … � ë$ › ô ¥ ô% ¬ È# ³ ¢* ¥ é% ¯ é% ¶ Ô þá ë ž+¢*á ¼*û ó á á ' ,
|
|||
|
|
áá @ E M Ì ˆ HÃ
|
|||
|
|
ÿ* ÿ* é% † é% � 2 î ? I —,¶ Ð Š Î Í ÿ* $ . (Ø Ý Ž " ' ô 3 ÿ* : C M (€ È# Å ¢* G L ¼* X ] M j … “ � ë$ Œ õ – ô% � È# ¤ ¢* – ù. £ „0 ª È þÕ ß ‚0¢*Õ ¼*ï Å ù. ù. # � – H‡
|
|||
|
|
ã/ ã/ ù. g ù. n 2 î ? I ” ˜ ’ Í ã/ $ . ( œ ¡ œ " ' õ 3 ã/
|
|||
|
|
] ^ # Î . Ÿ 5 < J
|
|||
|
|
] _ ^ k Î v Ÿ } „ ”à
|
|||
|
|
� ‚ % ô 0 á 7 > L
|
|||
|
|
� b ‚ o ô z á � ˆ |µ
|
|||
|
|
� � % õ 0 ù. 7 > L
|
|||
|
|
� b � o õ z ù. � ˆ '?DGKLMNOPQRT“ Ò µ" Û :Ò ‰ :y<Ì" Ð. ;ß<” ] <¾<ë � =•$À � >ü ¢¢ ü K H This tiny crate checks that the running or installed `rustc` meets someÁ üLM J version requirements. The version is queried by calling the Rust compilerÁ üšJ G with `--version`. The path to the compiler is determined first via theÁ üåL I `RUSTC` environment variable. If it is not set, then `rustc` is used. IfÁ ü²B ? that fails, no determination is made, and calls return `None`.Á õË tù # ExamplesÁ ˆË üŒL I **Note:** Please see [feature detection] for a note on enabling unstableÁ üÙ/ , features based on detection via this crate.Á ‰Ë ü�0 - [feature detection]: crate#feature-detectionÁ ¾Ë üÂN K * Set a `cfg` flag in `build.rs` if the running compiler was determined toÁ ü‘# be at least version `1.13.0`:Á µË l¹
|
|||
|
|
```rustÁ üÇ* ' extern crate version_check as rustc;Á òË üö; 8 if rustc::is_min_version("1.13.0").unwrap_or(false) {Á ü²= : println!("cargo:rustc-cfg=question_mark_operator");Á <ð }Á Lø ```Á ‚Ë ü†M J See [`is_max_version`] or [`is_exact_version`] to check if the compilerÁ üÔ2 / is _at most_ or _exactly_ a certain version.Á ”‡ <br /><br />Á šË üžL I * Check that the running compiler was released on or after `2018-12-18`:Á ëË lïÊ@ üý*à@ ¨ Ë ü¬ . + match rustc::is_min_date("2018-12-18") {Á üÛ , ) Some(true) => "Yep! It's recent!",Á üˆ
|
|||
|
|
+ ( Some(false) => "No, it's older.",Á ü´
|
|||
|
|
9 6 None => "Couldn't determine the rustc version."Á Dî
|
|||
|
|
};Á L÷
|
|||
|
|
¶B � Ë ü… K H See [`is_max_date`] or [`is_exact_date`] to check if the compiler wasÁ üÑ 9 6 released _prior to_ or _exactly on_ a certain date.Á ”‹ ãC ž Ë ü¢ = : * Check that the running compiler supports feature flags:Á à Ë lä Ê@ üò *à@ �
|
|||
|
|
Ë ü¡
|
|||
|
|
+ ( match rustc::is_feature_flaggable() {Á üÍ
|
|||
|
|
> ; Some(true) => "Yes! It's a dev or nightly release!",Á üŒ4 1 Some(false) => "No, it's stable or beta.",Á üÁ9«F DûìF L„¶B ŽË ü’1 . Please see the note on [feature detection].Á ”ÄãC ×Ë üÛB ? * Check that the running compiler supports a specific feature:Á žË l¢Ê@ ü°*à@ ÛË üß> ; if let Some(true) = rustc::supports_feature("doc_cfg") {Á üž1 . println!("cargo:rustc-cfg=has_doc_cfg");Á <ЧB LضB âË üæ1—K ”˜ãC «Ë ü¯? < * Check that the running compiler is on the stable channel:Á ïË lóÊ@ ü�*à@ ¬Ë ü°$ ! match rustc::Channel::read() {Á üÕC @ Some(c) if c.is_stable() => format!("Yes! It's stable."),Á ü™E B Some(c) => format!("No, the channel {} is not stable.", c),Á üßB ? None => format!("Couldn't determine the rustc version.")Á D¢ìF L«¶B µË ü¹O L To interact with the version, release date, and release channel as structs,Á ü‰N K use [`Version`], [`Date`], and [`Channel`], respectively. The [`triple()`]Á üØ2 / function returns all three values efficiently.Á ‹Ë ¼� # Feature DetectionÁ §Ë ü«N K While this crate can be used to determine if the current compiler supportsÁ üúN K an unstable feature, no crate can determine whether that feature will workÁ üÉG D in a way that you expect ad infinitum. If the feature changes in anÁ ü‘G D incompatible way, then your crate, as well as all of its transitiveÁ üÙP M dependents, will fail to build. As a result, great care should be taken whenÁ üªJ G enabling nightly features even when they're supported by the compiler.Á õË üùM J One common mitigation used in practice is to make using unstable featuresÁ üÇO L transitively opt-in via a crate feature or `cfg` so that broken builds onlyÁ ü— M J affect those that explicitly asked for the feature. Another complementaryÁ üå N K approach is to probe `rustc` at build-time by asking it to compile a smallÁ ü´ P M but exemplary program that determines whether the feature works as expected,Á ü… M J enabling the feature only if the probe succeeds. Finally, eschewing theseÁ üÓ O L recommendations, you should track the `nightly` channel closely to minimizeÁ ü£ , ) the total impact of a nightly breakages.Á Ð Ë ”Ô # AlternativesÁ ç Ë üë N K This crate is dead simple with no dependencies. If you need something moreÁ üº O L and don't care about panicking if the version cannot be obtained, or if youÁ üŠ!' $ don't mind adding dependencies, seeÁ ü²!< 9 [rustc_version](https://crates.io/crates/rustc_version).Á '?DGKLMNOPQRT“P ÒR Û :Òd ‰ :yR Ð. ;ßQ ] <¾P � =•O � >\‡" <‹" ]^Í ï+ D d£ Î
|
|||
|
|
üÍ ü¶I F Reads the version of the running compiler. If it cannot be determinedÁ ü„? < (see the [top-level documentation](crate)), returns `None`.Á È Ë lÐ
|
|||
|
|
# ExampleÁ â Ë \ê ```rustÁ üú use version_check::Version;Á ž Ë Ü¦ match Version::read() {Á üÆ0 - Some(d) => format!("Version is: {}", d),Á üû6 3 None => format!("Failed to read the version.")Á 4¶ };Á <Á ```Á$Ô ø°ú°û°Ð ü° ý°�þ°ì H�ˈXêE>Î
|
|||
|
|
t§ <closure_kind>Á <closure_signature>Á <upvars>Á ø°ú°û°Ð ü° ý°�þ°ì H�ˈXêE>ÉHÉH ’ ÊHœÜ3 ËÚ¢×€JÜ ×g×g Í LÕ øe �f f Íg ›hƒf Í üÛ. ü…- * Parse a Rust release version (of the formÁ ü·H E `major[.minor[.patch[-channel]]]`), ignoring the release channel, ifÁ ü„H E any. Returns `None` if `version` is not a valid Rust version string.Á Ñ Ë lÙ Õb ë Ë \ó õb üƒ ‰c § Ë ü¯4 1 let version = Version::parse("1.18.0").unwrap();Á üè' $ assert!(version.exactly("1.18.0"));Á ” Ë üœ < 9 let version = Version::parse("1.20.0-nightly").unwrap();Á üÝ ' $ assert!(version.exactly("1.20.0"));Á ü‰
|
|||
|
|
, ) assert!(version.exactly("1.20.0-beta"));Á º
|
|||
|
|
Ë üÂ
|
|||
|
|
1 . let version = Version::parse("1.3").unwrap();Á üø
|
|||
|
|
& # assert!(version.exactly("1.3.0"));Á £ Ë ü« / , let version = Version::parse("1").unwrap();Á üß & # assert!(version.exactly("1.0.0"));Á Š Ë ü’ 7 4 assert!(Version::parse("one.two.three").is_none());Á üÎ 3 0 assert!(Version::parse("1.65536.2").is_none());Á ü†
|
|||
|
|
. + assert!(Version::parse("1. 2").is_none());Á ü¹
|
|||
|
|
* ' assert!(Version::parse("").is_none());Á üè
|
|||
|
|
, ) assert!(Version::parse("1.").is_none());Á ü™1 . assert!(Version::parse("1.2.3.4").is_none());Á <Ï äd,â ¡ ¡ ƒf ñ
|
|||
|
|
ª<è Œ øe
|
|||
|
|
�f
|
|||
|
|
f
|
|||
|
|
|
|||
|
|
|
|||
|
|
È#ê³í³ î³Ò ï³ì ð³ ñ³“ò³ì äs{ ©¶‘Œ�Œ�
|
|||
|
|
ParseIntErrorÁ ��¯ ¼ ˼D|9A Í Á ƒ#ü¹> ü‚H E Creates a `Version` from `(major, minor, patch)` version components.Á Ï Ë l× Õb é Ë \ñ õb ü� ‰c ¥ Ë ü; 8 assert!(Version::from_mmp(1, 35, 0).exactly("1.35.0"));Á üí; 8 assert!(Version::from_mmp(1, 33, 0).exactly("1.33.0"));Á ü; 8 assert!(Version::from_mmp(1, 35, 1).exactly("1.35.1"));Á üí; 8 assert!(Version::from_mmp(1, 13, 2).exactly("1.13.2"));Á < ädDÀ ¨t¨t¨tÎ
|
|||
|
|
majorÁ,É minorÁ,Õ patchÁ,á ü¹' üÕE B Returns the `(major, minor, patch)` version components of `self`.Á Ÿ Ë l§ Õb ¹ Ë \Á õb üÑ ‰c õ Ë üýG D assert_eq!(Version::parse("1.35.0").unwrap().to_mmp(), (1, 35, 0));Á üÉG D assert_eq!(Version::parse("1.33.0").unwrap().to_mmp(), (1, 33, 0));Á ü•G D assert_eq!(Version::parse("1.35.1").unwrap().to_mmp(), (1, 35, 1));Á üáG D assert_eq!(Version::parse("1.13.2").unwrap().to_mmp(), (1, 13, 2));Á < äd4À ¢ ¢Î ¨t¨t¨t Ç
|
|||
|
|
|
|||
|
|
$È ü…#- ü� C @ Returns `true` if `self` is greater than or equal to `version`.Á É Ë üÑ L I If `version` is greater than `self`, or if `version` is not a valid RustÁ ü¢ $ ! version string, returns `false`.Á Ë Ë lÓ Õb å Ë \í õb üý ‰c ¡ Ë ü© 4 1 let version = Version::parse("1.35.0").unwrap();Á â Ë üê ( % assert!(version.at_least("1.33.0"));Á ü— ( % assert!(version.at_least("1.35.0"));Á üÄ ( % assert!(version.at_least("1.13.2"));Á ñ Ë üù ) & assert!(!version.at_least("1.35.1"));Á ü§!) & assert!(!version.at_least("1.55.0"));Á Õ! Ë üÝ!4 1 let version = Version::parse("1.12.5").unwrap();Á –" Ë üž"( % assert!(version.at_least("1.12.0"));Á üË") & assert!(!version.at_least("1.35.0"));Á <ù" ädDŒ# £ ¤ £Î ¤ •#
|