"Upcoming docs.rs changes"

posts/2019-09-18-upcoming-docsrs-changes.md

@@ -0,0 +1,98 @@
+---
+layout: post
+title: "Upcoming docs.rs changes"
+author: The Rust Infrastructure Team
+---
+
+On September 30th breaking changes will be deployed to the [docs.rs] build
+environment. [docs.rs] is a free service building and hosting documentation for
+all the crates published on [crates.io]. It's [open source][docsrs-source],
+maintained by the [Rustdoc team][rustdoc-team] and operated by the
+[Infrastructure team][infra-team].
+
+## What will change
+
+Builds will be executed inside the [rustops/crates-build-env] Docker image.
+That image contains a lot of system dependencies installed to ensure we can
+build as many crates as possible. It's already used by [Crater], and we added
+all the dependencies previously installed in the legacy build environment.
+
+To ensure we can continue operating the service in the future and to increase
+its reliability we also improved the sandbox the builds are executed in, adding
+new limits:
+
+* Each platform will now have **15 minutes** to build its dependencies and
+  documentation.
+* **3 GB of RAM** will be available for the build.
+* Network access will be **disabled** (crates.io dependencies will still be
+  fetched).
+* Only the `target/` directory will be writable, and it will be purged after
+  each build.
+
+Finally, docs.rs will now use the latest nightly available when building
+crates, instead of using a manually updated pinned version of nightly.
+
+## How to prepare for the changes
+
+To test if your crate builds inside the new environment you can download the
+Docker image locally and execute a shell inside it:
+
+```
+docker pull rustops/crates-build-env
+docker run --rm --memory 3221225472 -it rustops/crates-build-env bash
+```
+
+Once you're in a shell you can install [rustup] (it's not installed by default
+in the image), install Rust nightly, clone your crate's repository and then
+build the documentation:
+
+```
+time cargo doc --no-deps
+```
+
+To aid your testing these commands will limit the available RAM to 3 GB and
+show the total execution time of `cargo doc`, but network access will not be
+blocked as you'll need to fetch dependencies.
+
+If your project needs a system dependency missing in the build environment,
+please [open an issue][crates-build-env-issue] on the Docker image's
+[repository][rustops/crates-build-env] and we'll consider adding it.
+
+If your crate fails to build because it took more than 15 minutes to generate
+its docs or it uses more than 3 GB of RAM please [open an issue][docsrs-issue]
+and we will consider reasonable limit increases for your crate. We will **not**
+enable network access for your crate though: you'll need to change your crate
+not to require any external resource at build time.
+
+We recommend using [Cargo features] to remove the parts of the code causing
+build failures, enabling those features with [docs.rs metadata].
+
+## Acknowledgements
+
+The new build environment is based on [Rustwide], the library powering
+[Crater]. It was extracted from the Crater codebase, and created both by the
+[Crater contributors] and the [Rustwide contributors].
+
+The implementation work on the docs.rs side was done by [Pietro Albini][pietro]
+and [Onur Aslan][onur], with [QuietMisdreavus][misdreavus] and [Mark
+Rousskov][mark] reviewing the changes.
+
+[docs.rs]: https://docs.rs
+[crates.io]: https://crates.io
+[docsrs-source]: https://github.com/rust-lang/docs.rs
+[rustdoc-team]: https://www.rust-lang.org/governance/teams/dev-tools#rustdoc
+[infra-team]: https://www.rust-lang.org/governance/teams/operations#infra
+[rustops/crates-build-env]: https://hub.docker.com/r/rustops/crates-build-env
+[Crater]: https://github.com/rust-lang/crater
+[rustup]: https://rustup.rs
+[crates-build-env-issue]: https://github.com/rust-lang/crates-build-env/issues
+[docsrs-issue]: https://github.com/rust-lang/crates-build-env/issues
+[Cargo features]: https://doc.rust-lang.org/cargo/reference/manifest.html#the-features-section
+[docs.rs metadata]: https://docs.rs/about
+[rustwide]: https://github.com/rust-lang/rustwide
+[Crater contributors]: https://github.com/rust-lang/crater/graphs/contributors
+[Rustwide contributors]: https://github.com/rust-lang/rustwide/graphs/contributors
+[pietro]: https://github.com/pietroalbini
+[onur]: https://github.com/onur
+[mark]: https://github.com/Mark-Simulacrum
+[misdreavus]: https://github.com/QuietMisdreavus

src/main.rs

@@ -121,6 +121,11 @@ impl Blog {
             // yeah this might blow up, but it won't
             let filename = path.file_name().unwrap().to_str().unwrap();
 
+            // ignore vim temporary files
+            if filename.starts_with(".") && filename.ends_with(".swp") {
+                continue;
+            }
+
             // we need to get the metadata out of the url
             let mut split = filename.splitn(4, "-");