Introduction

This is the all-in-one "book" of the Debian Rust Team. It's a living document, updated as packaging practices evolve.

If you are new to Rust packaging in Debian, or Rust the language, read Getting started for some background information. Then, read Packaging processes.

If you are also new to Debian packaging in general, consider reading a tutorial to Debian packaging first, like the Packaging Tutorial by Lucas Nussbaum. You need to have a basic understanding of Debian packaging before packaging Rust things for Debian, or anything really.

The team

What the Debian Rust Team does:

• Package the Rust compiler (rustc) and the cargo package manager
• Package various programs and libraries distributed on crates.io, the official Rust package registry
• Coordinate with and help other teams with packages that involve Rust¹
• Maintain the Rust packaging policy

Team packages are hosted on salsa:

• rustc and cargo are at rust-team/rust (cargo used to be its own packaging at rust-team/cargo, but has been merged into the rustc package since 1.70.0+dfsg1-1)
• Ordinary packages are in a monorepo at rust-team/debcargo-conf, see Single crate packaging process

There is a page on the Debian wiki about salsa.

Get involved

• Mailing list: debian-rust@lists.debian.org, subscribe (also list archive)
• IRC: #debian-rust:irc.oftc.net
• Matrix: #debian-rust:matrix.debian.social (bridged to the IRC channel)

Whether you have packaging problems, are interested in packaging something Rust, or just want to say hi, feel free to speak up!

Join the team

Welcome, and thank you for helping out! Please subscribe to the mailing list and say hello in the IM channels, since we discuss and organize packaging and other team matters there.

Because the packaging processes are a bit different than in other places, it's helpful to start with a merge request, so we can help you getting used to them. When you are confident, Request Access on the salsa team page ("︙" button to the right of the team name).

This book

It's written in Markdown and built with mdBook, using salsa CI, and published to https://rust-team.pages.debian.net/book/. Its source is at salsa:rust-team/book, and CI definition in the .gitlab-ci.yml file in the repo.

1. For example, the Debian Gnome Team has its own packaging policy for Gnome apps written in Rust; the Debian Python Team has seen packages starting to use extensions written in Rust, rather than C/C++. ↩