2014-02-05 10:52:54 -06:00
|
|
|
// Copyright 2012-2014 The Rust Project Developers. See the COPYRIGHT
|
|
|
|
// file at the top-level directory of this distribution and at
|
|
|
|
// http://rust-lang.org/COPYRIGHT.
|
|
|
|
//
|
|
|
|
// Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
|
|
|
|
// http://www.apache.org/licenses/LICENSE-2.0> or the MIT license
|
|
|
|
// <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your
|
|
|
|
// option. This file may not be copied, modified, or distributed
|
|
|
|
// except according to those terms.
|
|
|
|
|
|
|
|
//! Support code for encoding and decoding types.
|
|
|
|
|
|
|
|
/*
|
|
|
|
Core encoding and decoding interfaces.
|
|
|
|
*/
|
|
|
|
|
2015-03-05 10:53:51 -06:00
|
|
|
// Do not remove on snapshot creation. Needed for bootstrap. (Issue #22364)
|
|
|
|
#![cfg_attr(stage0, feature(custom_attribute))]
|
2014-07-01 09:12:04 -05:00
|
|
|
#![crate_name = "serialize"]
|
2015-01-22 20:22:03 -06:00
|
|
|
#![unstable(feature = "rustc_private",
|
2015-01-12 20:40:19 -06:00
|
|
|
reason = "deprecated in favor of rustc-serialize on crates.io")]
|
Preliminary feature staging
This partially implements the feature staging described in the
[release channel RFC][rc]. It does not yet fully conform to the RFC as
written, but does accomplish its goals sufficiently for the 1.0 alpha
release.
It has three primary user-visible effects:
* On the nightly channel, use of unstable APIs generates a warning.
* On the beta channel, use of unstable APIs generates a warning.
* On the beta channel, use of feature gates generates a warning.
Code that does not trigger these warnings is considered 'stable',
modulo pre-1.0 bugs.
Disabling the warnings for unstable APIs continues to be done in the
existing (i.e. old) style, via `#[allow(...)]`, not that specified in
the RFC. I deem this marginally acceptable since any code that must do
this is not using the stable dialect of Rust.
Use of feature gates is itself gated with the new 'unstable_features'
lint, on nightly set to 'allow', and on beta 'warn'.
The attribute scheme used here corresponds to an older version of the
RFC, with the `#[staged_api]` crate attribute toggling the staging
behavior of the stability attributes, but the user impact is only
in-tree so I'm not concerned about having to make design changes later
(and I may ultimately prefer the scheme here after all, with the
`#[staged_api]` crate attribute).
Since the Rust codebase itself makes use of unstable features the
compiler and build system to a midly elaborate dance to allow it to
bootstrap while disobeying these lints (which would otherwise be
errors because Rust builds with `-D warnings`).
This patch includes one significant hack that causes a
regression. Because the `format_args!` macro emits calls to unstable
APIs it would trigger the lint. I added a hack to the lint to make it
not trigger, but this in turn causes arguments to `println!` not to be
checked for feature gates. I don't presently understand macro
expansion well enough to fix. This is bug #20661.
Closes #16678
[rc]: https://github.com/rust-lang/rfcs/blob/master/text/0507-release-channels.md
2015-01-06 08:26:08 -06:00
|
|
|
#![staged_api]
|
2014-03-21 20:05:05 -05:00
|
|
|
#![crate_type = "rlib"]
|
|
|
|
#![crate_type = "dylib"]
|
|
|
|
#![doc(html_logo_url = "http://www.rust-lang.org/logos/rust-logo-128x128-blk-v2.png",
|
|
|
|
html_favicon_url = "http://www.rust-lang.org/favicon.ico",
|
2014-10-09 12:47:22 -05:00
|
|
|
html_root_url = "http://doc.rust-lang.org/nightly/",
|
2014-06-06 11:12:18 -05:00
|
|
|
html_playground_url = "http://play.rust-lang.org/")]
|
2015-01-30 14:26:44 -06:00
|
|
|
|
2015-01-07 08:15:34 -06:00
|
|
|
#![feature(box_syntax)]
|
2015-01-22 20:22:03 -06:00
|
|
|
#![feature(collections)]
|
|
|
|
#![feature(core)]
|
|
|
|
#![feature(rustc_private)]
|
2015-01-30 14:26:44 -06:00
|
|
|
#![feature(staged_api)]
|
2015-01-22 20:22:03 -06:00
|
|
|
#![feature(std_misc)]
|
|
|
|
#![feature(unicode)]
|
2015-03-10 18:29:02 -05:00
|
|
|
#![feature(str_char)]
|
2015-04-10 13:39:53 -05:00
|
|
|
#![cfg_attr(test, feature(test))]
|
2014-02-05 10:52:54 -06:00
|
|
|
|
|
|
|
// test harness access
|
2015-01-06 11:24:46 -06:00
|
|
|
#[cfg(test)] extern crate test;
|
|
|
|
#[macro_use] extern crate log;
|
2014-12-31 22:43:46 -06:00
|
|
|
|
2014-12-10 21:46:38 -06:00
|
|
|
extern crate unicode;
|
2014-12-17 09:16:10 -06:00
|
|
|
extern crate collections;
|
|
|
|
|
2014-02-05 10:52:54 -06:00
|
|
|
pub use self::serialize::{Decoder, Encoder, Decodable, Encodable,
|
2014-02-21 16:18:39 -06:00
|
|
|
DecoderHelpers, EncoderHelpers};
|
2014-02-05 10:52:54 -06:00
|
|
|
|
2015-01-04 00:24:50 -06:00
|
|
|
mod serialize;
|
2014-02-21 16:18:39 -06:00
|
|
|
mod collection_impls;
|
2014-02-11 18:40:52 -06:00
|
|
|
|
|
|
|
pub mod hex;
|
2014-02-21 16:18:39 -06:00
|
|
|
pub mod json;
|
2014-12-19 00:52:48 -06:00
|
|
|
|
|
|
|
mod rustc_serialize {
|
|
|
|
pub use serialize::*;
|
|
|
|
}
|