TODO.rst

   1 ===============
   2 Immediate goals
   3 ===============
   4
   5 See end of this document for "eventual goals".
   6
   7
   8 Remove old libraries
   9 ====================
  10
  11 Should file a RM request to ftpmasters for these old crates:
  12
  13 (no old crates, yay!)
  14
  15
  16 Ready for upload (Request For Sponsor)
  17 ======================================
  18
  19 If you do not have upload rights, simply ``touch src/$crate/debian/RFS`` in
  20 your crate's directory, commit and push it, and a DD or DM will get around to
  21 it at some point.
  22
  23 To list all packages under RFS, run ``dev/list-rfs.sh``.
  24
  25 If your update breaks semver compatibility, please first check the reverse
  26 dependencies by running::
  27
  28     $ aptitude search '~Dlibrust-$cratename'
  29
  30 and try to verify that they won't be broken by your update, by building them.
  31 If they are broken, then:
  32
  33 1. Document the problem in ``debian/BLOCK``.
  34 2. File an issue upstream to report that they should update to the new library
  35 3. Write a patch if you can get that working, and document it.
  36
  37
  38 Unblocking testing migrations
  39 =============================
  40
  41 Run ``dev/rust-excuses.mk refresh all`` to see these in a nice graph.
  42
  43 Run ``dev/rust-regressions.sh`` to analyse autopkgtest regressions.
  44
  45 From the excuses graph, find the lowest crates i.e. those with no arrows going
  46 outwards to other crates. Then run ``dev/list-rdeps.sh @ $lowest_crotes`` to
  47 see which of its rdeps are broken, and need to be fixed.
  48
  49
  50 New packages
  51 ============
  52
  53 Use ``dev/list-remaining-deps.sh`` to help you figure out what's missing.
  54
  55 rustfmt-nightly
  56 ---------------
  57
  58 * rustc-ap-syntax
  59   * rustc-ap-rustc_data_structures (prepared)
  60     * rustc-ap-graphviz (needs nightly)
  61     * rustc-ap-rustc-cratesio-shim (needs nightly)
  62   * rustc-ap-rustc-errors (depends on the rest of the list here)
  63   * rustc-ap-rustc-target
  64   * rustc-ap-serialize (to be uploaded, dep issue?!)
  65   * rustc-ap-syntax-pos
  66   * rustc-ap-serialize (fails because of usage of nightly feature)
  67
  68 bingrep
  69 -------
  70
  71 * hexplay
  72 * metagoblin
  73
  74 tokei
  75 -----
  76
  77 needs handlebars
  78 which needs pest
  79 which needs ucd-trie
  80
  81 librsvg
  82 -------
  83
  84 see https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=907629
  85
  86 [ ] alga
  87 [ ] c_vec
  88 [ ] criterion
  89 [ ] criterion-plot
  90 [ ] criterion-stats
  91 [ ] downcast-rs
  92 [ ] handlebars
  93 [ ] itertools-num
  94 [ ] matrixmultiply
  95 [ ] nalgebra
  96 [ ] num-traits-0.1.43
  97 [ ] pest_derive
  98 [ ] quote-0.3.15
  99 [ ] rand-0.4.2
 100 [ ] rawpointer
 101 [ ] syn-0.11.11
 102 [ ] synom
 103 [ ] unicode-xid-0.0.4
 104
 105
 106 bench
 107 -----
 108 * criterion
 109   * criteron-plot
 110
 111 rustup
 112 ------
 113
 114 * rustup (not available as a crate)
 115  * git-testament
 116    * git-testament-derive
 117  * markdown
 118    * pipeline
 119  * retry
 120  * xz2
 121
 122 tokio/futures/hyper with async/await
 123 ------------------------------------
 124
 125 *dependency tree*
 126
 127 * futures 0.3.4
 128    * futures-executor 0.3.4
 129    * futures-util 0.3.4
 130       * futures-task 0.3.4
 131       * futures-channel 0.3.4
 132          * futures-core 0.3.4
 133          * future-sink 0.3.4
 134       * futures-io 0.3.4
 135       * futures-macro 0.3.4
 136       * pin-utils 0.1.0-alpha.4
 137       * proc-macro-nested 0.1.3
 138
 139 * tokio-macros 0.2.3
 140
 141 * tokio 0.2.10
 142    * bytes 0.5.3 (outdated)
 143    * futures-core 0.3.4 (see above)
 144    * pin-project-lite 0.1.1
 145    * tokio-macros 0.2.3
 146
 147 * tokio-tls 0.3.0
 148    * tokio 0.2.10 (+ subset of dependencies)
 149
 150 * tokio-util 0.2.0
 151    * tokio 0.2.10 (+ subset of dependencies)
 152    * futures-sink 0.3.4 (see above)
 153
 154 * hyper 0.13.1
 155    * futures-* 0.3.4 (see above)
 156    * h2 0.2.1
 157       * futures-* 0.3.4 (see above)
 158       * http 0.2.0
 159          * bytes 0.5.3 (needed for tokio anyway)
 160       * tokio 0.2.10 (see above)
 161       * tokio-util 0.2.0 (see above)
 162    * http-body 0.3.4
 163       * http 0.2.0 (+ deps)
 164    * pin-project 0.4.7
 165       * pin-project-internal 0.4.7
 166    * tokio 0.2.10 (see above)
 167    * tower-service 0.3.0
 168    * want 0.3.0
 169    * mio 0.6.21
 170    * iovec 0.1.4
 171
 172 *rdeps outside of tokio/futures/hyper*
 173
 174 * bcder (recently packaged, not yet compatible with bytes 0.5)
 175 * bufstream (dead upstream, no rdeps)
 176 * bzip2 (no upstream support yet, no rdeps for future/tokio features)
 177 * flate2 (no upstream support (yet), no rdeps for future/tokio features)
 178 * gstreamer-* (new upstream version is compatible, updated, no non-gstreamer rdeps, needs glib update, which triggers:
 179    * atk
 180    * cairo-rs
 181    * gdk
 182    * gdk-pixbuf
 183    * gio
 184    * gtk
 185    * pangocairo
 186    * pango
 187    * and their respective sys crates
 188 * mio-extras (no rdeps, compatible)
 189 * mio-named-pipes (no rdeps except tokio-process, compatible)
 190 * mio-uds (rdeps: signal-hook, tokio-uds, tokio-signal)
 191 * pcap (no rdeps, can be dropped)
 192 * reqwest (updated, needs updated hyper-tls, new wasm-bindgen-futures, updated web-sys/js-sys/webasm)
 193 * signal-hook (updated version not yet released, single rdep "tokio-signal" got merged into tokio and only uses signal-hook-registry now -> patched to remove dependency)
 194 * string (relaxed dep on bytes)
 195 * want (updated)
 196
 197 *old crates to be removed*
 198
 199 * futures-cpupool (no rdeps outside of futures/tokio/hyper, merged into futures-executor)
 200 * tokio-async-await (merged into tokio-macros)
 201 * tokio-buf (dropped upstream, rdeps no longer need it after updating)
 202 * tokio-codec (merged into tokio-util)
 203 * tokio-core (only 1 rdep: pcap, can be dropped after pcap was dropped, merged into tokio)
 204 * tokio-current-thread (merged into tokio)
 205 * tokio-executor (merged into tokio)
 206 * tokio-fs (merged into tokio)
 207 * tokio-io (merged into tokio, see above for rdeps bufstream, bzip2, flate2)
 208 * tokio-process (merged into tokio)
 209 * tokio-reactor (renamed to tokio-net, merged into tokio, see above for rdep signal-hook)
 210 * tokio-signal (merged into tokio)
 211 * tokio-sync (merged into tokio)
 212 * tokio-tcp (merged into tokio)
 213 * tokio-threadpool (merged into tokio)
 214 * tokio-timer (merged into tokio)
 215 * tokio-uds (merged into tokio)
 216 * tokio-udp (merged into tokio)
 217
 218 *incompatible rdeps with no futher rdeps, dead upstream, to be removed*
 219
 220 * pcap (replaced by pcap-sys)
 221 * bufstream: https://github.com/alexcrichton/bufstream/issues/13
 222
 223 *NEW, installable as-is*
 224
 225 * pin-utils (NEW)
 226 * proc-macro-nested (NEW)
 227 * futures-sink
 228 * futures-task
 229 * futures-io
 230 * futures-macro
 231 * tokio-macros
 232 * pin-project-lite
 233 * tower-service (NEW)
 234 * pin-project-internal + pin-project
 235 * paste-impl (NEW) + paste
 236 * webasm-bindgen-futures
 237
 238 *NEW, with dependency within transition*
 239
 240 * futures-channel (after futures-core/futures-sink)
 241 * futures-util (after futures-channel, proc-macro-nested, pin-utils)
 242 * futures-executor (after futures-core, futures-task, futures-util)
 243 * tokio-tls (after tokio)
 244 * tokio-util (after tokio, bytes, futures-core, futures-sink, pin-project-lite)
 245
 246
 247 ==============
 248 Eventual goals
 249 ==============
 250
 251 Binary crates worth packaging (please add if you know more):
 252
 253 - bench - simple benchmarking
 254 - bingrep - Grep through binaries from various OSs and architectures.
 255 - brewstillery - Brewer's, vinter's and distiller's calculator (GTK).
 256 - cargo-download - Download sources of a crate
 257 - cargo-edit - Cargo editing subcommands (add, rm, upgrade)
 258 - hg - Rust implement of hg
 259 - jql - JSON Query Language CLI tool.
 260 - recode_rs -  CLI tool converting between the character encodings.
 261 - rural - User-friendly command-line HTTP tool
 262 - rustfmt-nightly - rust coding style
 263 - rustup - installing and managing multiple rust toolchains
 264 - tmux-hints - Find matches (e.g. urls) and navigate them by keyboard
 265 - xsv - Command line program for manipulating CSV files
 266
 267 To see lists of interesting binary crates, you can run something like::
 268
 269   $ apt-get install koji-client
 270   $ koji -p fedora search package 'rust-*' | cut -b6- | dev/filter-binary-crates.sh
 271
 272 Current output (on 2020-01-17), minus stuff already in Debian, is:
 273
 274   afterburn
 275   alloc-no-stdlib
 276   alloc-stdlib
 277   askalono-cli
 278   brotli
 279   brotli-decompressor
 280   cargo-c
 281   comrak
 282   coreos-installer
 283   ffsend
 284   heatseeker
 285   jql
 286   lsd
 287   multipart
 288   open
 289   permutate
 290   pretty-git-prompt
 291   qrcode
 292   skim
 293   starship
 294   varlink-cli
 295   varlink_generator
 296
 297 Sccache is also helpful for reducing the build-time of things like firefox and thunderbird
 298
 299 - sccache https://github.com/mozilla/sccache
 300
 301 There are also more binaries here:
 302
 303 https://github.com/rust-unofficial/awesome-rust