42c4e481cd
This commit stabilizes essentially all of the new `std::path` API. The
API itself is changed in a couple of ways (which brings it in closer
alignment with the RFC):
* `.` components are now normalized away, unless they appear at the
start of a path. This in turn effects the semantics of e.g. asking for
the file name of `foo/` or `foo/.`, both of which yield `Some("foo")`
now. This semantics is what the original RFC specified, and is also
desirable given early experience rolling out the new API.
* The `parent` function now succeeds if, and only if, the path has at
least one non-root/prefix component. This change affects `pop` as
well.
* The `Prefix` component now involves a separate `PrefixComponent`
struct, to better allow for keeping both parsed and unparsed prefix data.
In addition, the `old_path` module is now deprecated.
Closes #23264
[breaking-change]
97 lines
3.0 KiB
Rust
97 lines
3.0 KiB
Rust
// Copyright 2012-2013 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.
|
|
|
|
#![allow(deprecated)] // old path, used for compatibility with dynamic lib
|
|
|
|
use clean;
|
|
|
|
use std::dynamic_lib as dl;
|
|
use serialize::json;
|
|
use std::mem;
|
|
use std::string::String;
|
|
|
|
pub type PluginJson = Option<(String, json::Json)>;
|
|
pub type PluginResult = (clean::Crate, PluginJson);
|
|
pub type PluginCallback = fn (clean::Crate) -> PluginResult;
|
|
|
|
/// Manages loading and running of plugins
|
|
pub struct PluginManager {
|
|
dylibs: Vec<dl::DynamicLibrary> ,
|
|
callbacks: Vec<PluginCallback> ,
|
|
/// The directory plugins will be loaded from
|
|
pub prefix: Path,
|
|
}
|
|
|
|
impl PluginManager {
|
|
/// Create a new plugin manager
|
|
pub fn new(prefix: Path) -> PluginManager {
|
|
PluginManager {
|
|
dylibs: Vec::new(),
|
|
callbacks: Vec::new(),
|
|
prefix: prefix,
|
|
}
|
|
}
|
|
|
|
/// Load a plugin with the given name.
|
|
///
|
|
/// Turns `name` into the proper dynamic library filename for the given
|
|
/// platform. On windows, it turns into name.dll, on OS X, name.dylib, and
|
|
/// elsewhere, libname.so.
|
|
pub fn load_plugin(&mut self, name: String) {
|
|
let x = self.prefix.join(libname(name));
|
|
let lib_result = dl::DynamicLibrary::open(Some(&x));
|
|
let lib = lib_result.unwrap();
|
|
unsafe {
|
|
let plugin = lib.symbol("rustdoc_plugin_entrypoint").unwrap();
|
|
self.callbacks.push(mem::transmute::<*mut u8,PluginCallback>(plugin));
|
|
}
|
|
self.dylibs.push(lib);
|
|
}
|
|
|
|
/// Load a normal Rust function as a plugin.
|
|
///
|
|
/// This is to run passes over the cleaned crate. Plugins run this way
|
|
/// correspond to the A-aux tag on Github.
|
|
pub fn add_plugin(&mut self, plugin: PluginCallback) {
|
|
self.callbacks.push(plugin);
|
|
}
|
|
/// Run all the loaded plugins over the crate, returning their results
|
|
pub fn run_plugins(&self, krate: clean::Crate) -> (clean::Crate, Vec<PluginJson> ) {
|
|
let mut out_json = Vec::new();
|
|
let mut krate = krate;
|
|
for &callback in &self.callbacks {
|
|
let (c, res) = callback(krate);
|
|
krate = c;
|
|
out_json.push(res);
|
|
}
|
|
(krate, out_json)
|
|
}
|
|
}
|
|
|
|
#[cfg(target_os = "windows")]
|
|
fn libname(mut n: String) -> String {
|
|
n.push_str(".dll");
|
|
n
|
|
}
|
|
|
|
#[cfg(target_os="macos")]
|
|
fn libname(mut n: String) -> String {
|
|
n.push_str(".dylib");
|
|
n
|
|
}
|
|
|
|
#[cfg(all(not(target_os="windows"), not(target_os="macos")))]
|
|
fn libname(n: String) -> String {
|
|
let mut i = String::from_str("lib");
|
|
i.push_str(&n);
|
|
i.push_str(".so");
|
|
i
|
|
}
|