Introduce Rust guide #732
Open
Introduce Rust guide #732
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
TallJimbo
reviewed
Oct 9, 2025
Member
TallJimbo
left a comment
TallJimbo
left a comment
There was a problem hiding this comment.
Two big-picture comments (some echoed in various line-comments):
- I think you need to mention
rubinoxideup front concretely and organize the discussion around that; only talking about organizing code in a purely abstract sense makes the actual guidelines a lot harder to follow. - There are a lot of start-of-section sentences here that just sound like software platitudes. I understand wanting to have some sort of introductory text for each section, but I think the audience (who is likely reading it as fast as they can so they can get back to writing code) will appreciate it if you just dive right in.
natelust
force-pushed
the
tickets/DM-52152
branch
3 times, most recently
from
4955daf to
13c40dc
Compare
natelust
force-pushed
the
tickets/DM-52152
branch
from
13c40dc to
2037adc
Compare
nealmcb
reviewed
Dec 10, 2025
| 4. Code Organization | ||
| -------------------- | ||
|
|
||
| Unlike the package-centric organization often seen in Python, packages containing rust code should me monolithic and not depend on other lsst packages. |
| The de-facto location, and reference implementation, of rust within the lsst science pipelines is in a package called ``rubinoxide``. | ||
| This does not mean developers are not allowed to use rust in another dedicated package, but unless there is a compelling reason to do so rust code should be placed in ``rubinoxide``. | ||
| This guide assumes the package layout of ``rubinoxide``. | ||
| Any other Rust based packages that are written should adhear to this as best as possible. |
|
|
||
| * Rust packages should be built using maturin, which manages the complexities of compiling and bundling cargo products. | ||
| * Cargo additionally is to be used manage dependencies and run rust level tests. | ||
| * pip is used as the mechanism to locally depoly the wheels created by maturin |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
This is a first draft of the proposed rust developer guide. All comments and improvement welcome.