# Rust libz blitz!
**URL:** https://internals.rust-lang.org/t/rust-libz-blitz/5184
**Category:** libs
**Created:** [May 5, 2017, 5:58pm UTC](https://internals.rust-lang.org/t/rust-libz-blitz/5184 "2017-05-05T17:58:18Z")
**Posts on this page:** 20
**Page:** 2
### Author:  [@brson](https://internals.rust-lang.org/u/brson)
#### Post date: [May 11, 2017, 7:27pm UTC](https://internals.rust-lang.org/t/rust-libz-blitz/5184/21 "2017-05-11T19:27:28Z")
[thread-id](https://docs.rs/thread-id/3.0.0/thread_id/) is another fundamental crate.
---
### Author:  [@cuviper](https://internals.rust-lang.org/u/cuviper)
#### Post date: [May 11, 2017, 7:38pm UTC](https://internals.rust-lang.org/t/rust-libz-blitz/5184/22 "2017-05-11T19:38:08Z")
Won’t `thread-id` be subsumed by `std::thread::ThreadId`? [#21507](https://github.com/rust-lang/rust/issues/21507)
---
### Author:  [@brson](https://internals.rust-lang.org/u/brson)
#### Post date: [May 12, 2017, 6:38pm UTC](https://internals.rust-lang.org/t/rust-libz-blitz/5184/23 "2017-05-12T18:38:26Z")
I took the liberty of adding bytes, syslog, lzw, ring, openssl, petgraph, daggy, typenum, image, cfg-if, and itertools to the [crate list](https://public.etherpad-mozilla.org/p/rust-crate-list). Others suggested may be good candidates, but I have less certainty.
nom I think is obviously an important and high-quality crate, but I’m not sure I consider parser generators in scope here. That’s not something I usually associate with batteries included standard libraries.
---
### Author:  [@brson](https://internals.rust-lang.org/u/brson)
#### Post date: [May 12, 2017, 6:55pm UTC](https://internals.rust-lang.org/t/rust-libz-blitz/5184/24 "2017-05-12T18:55:19Z")
There are a number of additional library ecosystem tasks that don’t fit into the blitz structure that I would like to move forward sometime this summer. Just to telegraph that a bit, here is a braindump.
- Standard library survey - Last year the libs team started a [survey](https://docs.google.com/spreadsheets/d/1cWzulriPQOimUBK_EowRO8rM-g977DLOq773wZAgFkw/edit?usp=sharing) of batteries included standard libraries, but never finished. The intent was to get a handle on the set of features typically expected out of a language’s runtime stack, and then identify areas where we are lacking and need to focus effort.
- rand design review - The rand crate has long been unsatisfactory to the libs team, and needs some focused design work. People that love random numbers are needed. I know @bstrie indicated he was keen about this.
- chrono design review - This crate provides comprehensive date/time solutions, but it my experience using it (and I gather others’), it can be difficult to discover how to do some fairly basic tasks. I recall my biggest pain point was understanding how to deal with all the timezone concerns that are represented in the type system. It may be that just writing cookbook examples for a number of tasks would help. It also still depends on the time crate, which is destined to be deprecated. cc @lifthrasiir I hope you will be amenable.
- A 1.0 crate scoreboard - Just a simple motivator. Create a thread on urlo that lists, in reverse chronological order, the crates that hit 1.0, their dates, and their authors. This clearly would be gameable, but that’s fine. At least it conveys consistently that 1.0 crates are important, and crate authors should endeavor to get there. It would be pretty easy to maintain with a script. Once a week post an update to the op, and a comment indicating all the updates and thanking the crate authors.
- A cookbook roadmap and urlo thread - I’d like to define what a 1.0 cookbook looks like so there’s a clear destination, make regular point releases and status updates.
---
### Author:  [@brson](https://internals.rust-lang.org/u/brson)
#### Post date: [May 12, 2017, 9:31pm UTC](https://internals.rust-lang.org/t/rust-libz-blitz/5184/25 "2017-05-12T21:31:40Z")
I’ve just discovered that [docs.rs](http://docs.rs) displays a crate’s GitHub README. Can you tell the difference between these two pages:
- [https://docs.rs/log/0.3.7/log/index.html](https://docs.rs/log/0.3.7/log/index.html)
- [https://docs.rs/crate/log/0.3.7](https://docs.rs/crate/log/0.3.7)
I was quite confused, and I think all this redundant information makes a poor experience.
In any case, we have no guidelines for crate READMEs, and since this is a crucial part of the documentation UI, it seems like we must establish some, then go back and review the crates we’ve done. cc @dtolnay
---
### Author:  [@dtolnay](https://internals.rust-lang.org/u/dtolnay)
#### Post date: [May 12, 2017, 9:51pm UTC](https://internals.rust-lang.org/t/rust-libz-blitz/5184/26 "2017-05-12T21:51:10Z")
> [@brson](#):
>
> In any case, we have no guidelines for crate READMEs, and since this is a crucial part of the documentation UI, it seems like we must establish some, then go back and review the crates we've done.
Yep, I'll have to bring this up in the front page styleguide RFC [https://github.com/rust-lang/rfcs/pull/1687](https://github.com/rust-lang/rfcs/pull/1687).
---
### Author:  [@Nemo157](https://internals.rust-lang.org/u/Nemo157)
#### Post date: [May 12, 2017, 9:57pm UTC](https://internals.rust-lang.org/t/rust-libz-blitz/5184/27 "2017-05-12T21:57:13Z")
> I've just discovered that docs.rs displays a crate's GitHub README
I would just like to note that this has nothing directly to do with GitHub (it just happens to be the same in approximately 100% of the cases), if you were to have a package with the source hosted elsewhere it should work just the same. Judging by [this code](https://github.com/onur/docs.rs/blob/e03fd5c2a12fcfefc5ecc500aace8821ec314da7/src/db/add_package.rs#L220) from docs.rs it is based on the `package.readme` key in the packages `Cargo.toml` + a default if not specified, [as described in The Manifest Format](http://doc.crates.io/manifest.html):
```ini
# This points to a file in the repository (relative to this `Cargo.toml`). The
# contents of this file are stored and indexed in the registry.
readme = "..."
```
---
### Author:  [@jan\_hudec](https://internals.rust-lang.org/u/jan_hudec)
#### Post date: [May 12, 2017, 10:23pm UTC](https://internals.rust-lang.org/t/rust-libz-blitz/5184/28 "2017-05-12T22:23:29Z")
> [@brson](#):
>
> nom I think is obviously an important and high-quality crate, but I'm not sure I consider parser generators in scope here.
I needed a parser, looked at many of them and wasn't satisfied with either, but I agree it is a relatively niche tool.
* * *
However I would like to nominate some more XML-related crates. I see `xml` (should be `xml-rs`?) is already [in](https://public.etherpad-mozilla.org/p/rust-crate-list), but some DOM should also be included. I see a couple of candidates for that: `sxd-document` (+`sxd-xpath`), `minidom`, `elementtree`, `rquery`, `treexml`, `xmltree`. They are mostly equivalent, so some should be chosen.
---
### Author:  [@brson](https://internals.rust-lang.org/u/brson)
#### Post date: [May 13, 2017, 2:30am UTC](https://internals.rust-lang.org/t/rust-libz-blitz/5184/29 "2017-05-13T02:30:58Z")
# Rust libz blitz status update 2017-05-12
Ok, here’s what we accomplished this week.
- log
- [We filled out _most_ of the log evaluation](https://internals.rust-lang.org/t/crate-evaluation-for-2017-05-16-log/5185/1)
- There are a few remaining sections of the guidelines checklist
- Thanks to everyone who contributed to the discussion
- url
- [@tomecki implemented Display for HostAndPort](https://github.com/servo/rust-url/issues/328)
- [@brson closed a bogus url issue](https://github.com/servo/rust-url/issues/307)
- [@hngnaig added examples to Url methods](https://github.com/servo/rust-url/issues/326)
- [@DarkEld3r added the html\_root\_url attribute](https://github.com/servo/rust-url/pull/325)
- [@Svenito added ci badges](https://github.com/servo/rust-url/issues/324)
- [@DarkEld3r added categories](https://github.com/servo/rust-url/pull/322)
- memmap
- [@bugaevc began overhauling the API](https://github.com/danburkert/memmap-rs/pull/42)
- [@cldershem added badges](https://github.com/danburkert/memmap-rs/issues/39)
- [@opilar added html\_root\_url](https://github.com/danburkert/memmap-rs/issues/41)
- bitflags
- [All issues completed except the 1.0 bump](https://github.com/rust-lang-nursery/bitflags/issues/80)
- tempdir
- [The only thing left is to finalize ‘close’ conventions](https://github.com/rust-lang-nursery/tempdir/issues/26)
- flate2
- [@AndyGauge added compression examples](https://github.com/alexcrichton/flate2-rs/pull/111)
- [@chrisvittal began adding distinct flush types](https://github.com/alexcrichton/flate2-rs/pull/109)
- cookbook
- [@brson posted recipe ideas](https://github.com/brson/rust-cookbook/issues/61)
- [@budziq and @rap2hpoutre made lots of cookbook improvements](https://github.com/brson/rust-cookbook/pulls?q=is%3Apr+is%3Aclosed)!
- [@rap2hpoutre added a “Log messages with a custom logger” cookbook recipe](https://github.com/brson/rust-cookbook/pull/74)
- [@budziq added a “Log to the Unix syslog” cookbook recipe](https://github.com/brson/rust-cookbook/pull/70)
- [@budziq added a “Remove fragment identifiers and query pairs from a URL” cookbook recipe](https://github.com/brson/rust-cookbook/pull/55)
- [@budziq added a “Make a HTTP GET request” cookbook recipe](https://github.com/brson/rust-cookbook/pull/53)
- [@mikeastock added a “Create new URLs from a base URL” cookbook recipe](https://github.com/brson/rust-cookbook/pull/46)
- [@Piripant added several url cookbook recipes](https://github.com/brson/rust-cookbook/pull/48)
- [@mikeastock added a “Create a base URL by removing path segments” cookbook recipe](https://github.com/brson/rust-cookbook/pull/47)
- [@bostelk add a “Parse a URL from a string to a `Url` type” cookbook recipe](https://github.com/brson/rust-cookbook/pull/45)
- guidelines
- [@samoylovfp and @nliberg made small fixes](https://github.com/brson/rust-api-guidelines/pulls?q=is%3Apr+is%3Aclosed)
- other
- We added a number of new crates to the crate list. Thanks for all the suggestions.
Also @dtolnay @danburkert @SimonSapin @sfackler and @alexcrichton reviewed tons of stuff.
Wow. So that’s pretty amazing. Thanks everyone!
---
### Author:  [@brson](https://internals.rust-lang.org/u/brson)
#### Post date: [May 13, 2017, 2:44am UTC](https://internals.rust-lang.org/t/rust-libz-blitz/5184/30 "2017-05-13T02:44:04Z")
OK, one more thing for today.
The `walkdir` crate is scheduled for 6/13, has no assigned lead, and I do want to start getting these evaluations going more weeks in advance. I know we’ve only had one round to crib off of so far ([log](https://internals.rust-lang.org/t/crate-evaluation-for-2017-05-16-log/5185), but if anybody has an inclination to _lead_ the walkdir evaluation, I can help walk them through the evolving process. I’ll be on vacation next week, but the one following we can get started. Alternately, if somebody is up to getting walkdir started next week @dtolnay can assist.
@dtolnay will be starting the reqwest evaluation soon.
---
### Author:  [@dtolnay](https://internals.rust-lang.org/u/dtolnay)
#### Post date: [May 16, 2017, 7:32pm UTC](https://internals.rust-lang.org/t/rust-libz-blitz/5184/31 "2017-05-16T19:32:12Z")
I added a link to the `reqwest` evaluation.
> [@Crate evaluation for 2017-05-30: reqwest](https://internals.rust-lang.org/t/crate-evaluation-for-2017-05-30-reqwest/5248):
>
> For additional contribution opportunities, see the [main libz blitz thread](https://internals.rust-lang.org/t/rust-libs-blitz/5184). This post is a wiki. Feel free to edit it. Links [https://crates.io/crates/reqwest](https://crates.io/crates/reqwest)[https://github.com/seanmonstar/reqwest](https://github.com/seanmonstar/reqwest)[https://docs.rs/reqwest](https://docs.rs/reqwest) Needs your help! Anything that is not checked off still needs your help! There is no need to sign up or ask for permission - follow any of these links and leave your thoughts: [Guidelines checklist](https://public.etherpad-mozilla.org/p/rust-api-guidelines-reqwest) This document is collaboratively editable. Pick a few of the guidelines, com…
---
### Author:  [@dtolnay](https://internals.rust-lang.org/u/dtolnay)
#### Post date: [May 18, 2017, 4:15am UTC](https://internals.rust-lang.org/t/rust-libz-blitz/5184/32 "2017-05-18T04:15:39Z")
I added a link to the libs team meeting about `log`.
[https://air.mozilla.org/rust-libs-team-meeting-2017-05-16/](https://air.mozilla.org/rust-libs-team-meeting-2017-05-16/)
---
### Author:  [@alexcrichton](https://internals.rust-lang.org/u/alexcrichton)
#### Post date: [May 19, 2017, 8:27pm UTC](https://internals.rust-lang.org/t/rust-libz-blitz/5184/33 "2017-05-19T20:27:51Z")
I’ve filled in the tracking issue and cookbook issue for the `log` crate:
- [tracking](https://github.com/rust-lang-nursery/log/issues/150)
- [cookbook](https://github.com/brson/rust-cookbook/issues/61)
---
### Author:  [@dtolnay](https://internals.rust-lang.org/u/dtolnay)
#### Post date: [May 20, 2017, 2:33am UTC](https://internals.rust-lang.org/t/rust-libz-blitz/5184/34 "2017-05-20T02:33:28Z")
# Status update 2017-05-19
There has been a ton of great libz blitz progress this week. We are going to need even more help to keep up the momentum! **Contribution opportunities are in bold.**
### log
- [**Tracking issue for all the improvements we need to make; there are so many issues! Please help**](https://github.com/rust-lang-nursery/log/issues/150)
- [**We still need to write some good cookbook examples!**](https://github.com/brson/rust-cookbook/issues/61)
- [@dpc, @LilianMoraru, @sfackler, @vl0 provided valuable feedback on their experience using log](https://internals.rust-lang.org/t/crate-evaluation-for-2017-05-16-log/5185?u=dtolnay)
- [The libs team held our video meeting to discuss log (recording)](https://air.mozilla.org/rust-libs-team-meeting-2017-05-16/)
- [@alexcrichton wrote down minutes of the meeting](https://internals.rust-lang.org/t/crate-evaluation-for-2017-05-16-log/5185/51?u=dtolnay)
### reqwest
- [**The evaluation is underway!**](https://internals.rust-lang.org/t/crate-evaluation-for-2017-05-30-reqwest/5248?u=dtolnay)
- [@KodrAus made amazing progress on the guidelines checklist](https://public.etherpad-mozilla.org/p/rust-api-guidelines-reqwest)
- [**There are many more guidelines to evaluate!**](https://public.etherpad-mozilla.org/p/rust-api-guidelines-reqwest)
- [@budziq came up with some nice cookbook examples](https://github.com/brson/rust-cookbook/issues/84)
- The libs team discussion will happen a week from Tuesday
### url
- [**We need help triaging and reviewing PRs!**](https://users.rust-lang.org/t/help-wanted-maintaining-rust-url/10707?u=dtolnay)
- [@hngnaig added some new examples](https://github.com/servo/rust-url/pull/340)
- [@tmccombs improved documentation](https://github.com/servo/rust-url/pull/344)
### flate2
- [**Still needs help!**](https://github.com/alexcrichton/flate2-rs/issues/89)
### memmap
- [**Still needs help!**](https://github.com/danburkert/memmap-rs/issues/38)
### Cookbook
- [**We filed tons of easy ways for new contributors to chip in!**](https://github.com/brson/rust-cookbook/issues?q=is%3Aissue+is%3Aopen+label%3Aexample) Check out [**CONTRIBUTING.md**](https://github.com/brson/rust-cookbook/blob/master/CONTRIBUTING.md)
- [We successfully begged for help on reddit; thanks for the amazing response](https://www.reddit.com/r/rust/comments/6bs9jh/rust_cookbook_needs_a_lot_of_help/)
- [@budziq installed aspell to catch all of our typos](https://github.com/brson/rust-cookbook/pull/76)
- [@budziq added two rand examples](https://github.com/brson/rust-cookbook/pull/77)
- [@budziq added a log level example](https://github.com/brson/rust-cookbook/pull/78)
- [@budziq added an example of downloading a file to a temp directory](https://github.com/brson/rust-cookbook/pull/79)
- [@budziq added two GitHub API examples](https://github.com/brson/rust-cookbook/pull/80)
- [@budziq added a quick way to edit examples straight from the cookbook website](https://github.com/brson/rust-cookbook/pull/88)
- [@budziq set up a way to hide boilerplate error handling code](https://github.com/brson/rust-cookbook/pull/107)
- [@budziq made sure our example code never goes out of date](https://github.com/brson/rust-cookbook/pull/118)
- [@gsquire added an example of making an http HEAD request](https://github.com/brson/rust-cookbook/pull/120)
- [@Michael-F-Bryan added an example of parsing subprocess output](https://github.com/brson/rust-cookbook/pull/122)
- [@xpayn added an example of extracting a tarball to a temp directory](https://github.com/brson/rust-cookbook/pull/124)
- [@jaemk added an example of using lazy\_static](https://github.com/brson/rust-cookbook/pull/130)
- [@bjnyfv added an example of hex encoding](https://github.com/brson/rust-cookbook/pull/132)
- [@cetra3 added an example of logging to a custom filepath](https://github.com/brson/rust-cookbook/pull/133)
- [@jaemk added an example of using global mutable state](https://github.com/brson/rust-cookbook/pull/134)
- [@raph2hpoutre added an example of base64 encoding](https://github.com/brson/rust-cookbook/pull/135)
- [@xpayn added an example of recursively traversing a directory](https://github.com/brson/rust-cookbook/pull/136)
- [@AndyGauge added an example of listening on a random port](https://github.com/brson/rust-cookbook/pull/137)
- [@budziq added an example of url-encoding](https://github.com/brson/rust-cookbook/pull/138)
- [@jeanm provided some visual improvements](https://github.com/brson/rust-cookbook/pull/127)
- [@jmcomets is working on two env\_logger examples](https://github.com/brson/rust-cookbook/pull/128)
- [@AndyGauge is working on a POST example](https://github.com/brson/rust-cookbook/issues/90)
- [@budziq is working on a header and url param example](https://github.com/brson/rust-cookbook/issues/91)
- [@budziq is working on timestamped log messages](https://github.com/brson/rust-cookbook/issues/98)
- [@karan1276 is working on a threadpool example](https://github.com/brson/rust-cookbook/issues/102)
- [@DeltaManiac is working on a memmap example](https://github.com/brson/rust-cookbook/issues/105)
- [@luisbg and @henninglive started thinking about an html5ever example](https://github.com/brson/rust-cookbook/issues/110)
- [@luisbg is working on a walkdir predicate example](https://github.com/brson/rust-cookbook/issues/125)
- [@budziq is working on making hyperlinks look nicer](https://github.com/brson/rust-cookbook/issues/142)
- [@derekdreery suggested a new example](https://github.com/brson/rust-cookbook/issues/24)
- [@budziq suggested some walkdir examples](https://github.com/brson/rust-cookbook/issues/112)
### API guidelines
- [**What lessons can we learn from the reqwest crate?**](https://github.com/brson/rust-api-guidelines/issues/62)
- [**Guidelines need to be updated based on the log evaluation!**](https://github.com/brson/rust-api-guidelines/issues)
- [@daboross caught and fixed a small mistake](https://github.com/brson/rust-api-guidelines/pull/67)
- [tempdir raised the question of a convention for checked teardown](https://github.com/brson/rust-api-guidelines/issues/61)
* * *
Thanks everyone!
---
### Author:  [@brson](https://internals.rust-lang.org/u/brson)
#### Post date: [May 23, 2017, 12:19am UTC](https://internals.rust-lang.org/t/rust-libz-blitz/5184/35 "2017-05-23T00:19:35Z")
It’s been suggested to me that [base64](https://docs.rs/base64), [data\_encoding](https://docs.rs/data_encoding), [tar](https://docs.rs/tar), and [backtrace](https://docs.rs/backtrace) are all appropriate here. Sounds right to me. Any other opinions?
---
### Author:  [@brson](https://internals.rust-lang.org/u/brson)
#### Post date: [May 23, 2017, 12:34am UTC](https://internals.rust-lang.org/t/rust-libz-blitz/5184/36 "2017-05-23T00:34:48Z")
[hex](https://docs.rs/hex/0.2.0/hex/) is along similar lines, and apparently it’s the best place to get hex conversion.
---
### Author:  [@dtolnay](https://internals.rust-lang.org/u/dtolnay)
#### Post date: [May 24, 2017, 2:12am UTC](https://internals.rust-lang.org/t/rust-libz-blitz/5184/37 "2017-05-24T02:12:35Z")
This graph shows the great effect the libz blitz has been having for the `log` crate. We still need lots more help! Please check the tracking issue for opportunities to contribute.
* * *
* * *
>
---
### Author:  [@brson](https://internals.rust-lang.org/u/brson)
#### Post date: [May 24, 2017, 7:31pm UTC](https://internals.rust-lang.org/t/rust-libz-blitz/5184/38 "2017-05-24T19:31:04Z")
I updated links in the op. There are already cookbook tracking issues for [mio](https://github.com/brson/rust-cookbook/issues/113) and [walkdir](https://github.com/brson/rust-cookbook/issues/112).
---
### Author:  [@brson](https://internals.rust-lang.org/u/brson)
#### Post date: [May 24, 2017, 7:43pm UTC](https://internals.rust-lang.org/t/rust-libz-blitz/5184/39 "2017-05-24T19:43:50Z")
I updated the [crate list](https://public.etherpad-mozilla.org/p/rust-crate-list) per the last few suggestions, and attempted to generalize the categorizations there a bit.
---
### Author:  [@brson](https://internals.rust-lang.org/u/brson)
#### Post date: [May 24, 2017, 7:47pm UTC](https://internals.rust-lang.org/t/rust-libz-blitz/5184/40 "2017-05-24T19:47:23Z")
The walkdir review is scheduled for 6/13, and the intent is to start evaluations one month ahead of time, so it’s behind schedule. It still doesn’t have a lead assigned. **Is anybody interested in leading the walkdir evaluation** , starting this week? It doesn’t require a great deal of experience, since the entire process is outlined in the checklist, and there are previous examples to crib off of.
If not, I will begin the walkdir evaluation on Friday.
The error-chain review is scheduled for 6/27, which means @aturon needs to get that evaluation rolling soon as well.
[Previous page](https://internals.rust-lang.org/t/rust-libz-blitz/5184.md?page=1)
[Next page](https://internals.rust-lang.org/t/rust-libz-blitz/5184.md?page=3)