1
0
mirror of https://github.com/google/comprehensive-rust.git synced 2024-12-16 23:08:36 +02:00
Commit Graph

1592 Commits

Author SHA1 Message Date
Henri F
72cdaaa29f
zh-CN: New CR2 translations with line numbers removed (#1764)
Publishes the new translations for CR2 (originally from zh-CN-cr2) #1463
which were previously reviewed.
It also removes line numbers (#1753)
#324

You can skim this PR with the [GitHub CLI](https://cli.github.com/):

```
gh pr diff 1764 | bat -l patch
```
2024-01-26 18:45:20 -08:00
Henri F
0e2d1109b4
es: refresh translation for January 2024 (#1759)
From @mgeisler PRs (e.g. #1752, #1753)

This is a clean refresh, requires only a syntactic review.

You can skim this PR with the [GitHub CLI](https://cli.github.com/):

```
gh pr diff 1759 | bat -l patch
```
2024-01-25 12:48:46 -08:00
Dustin J. Mitchell
20f45521e5
Move Trait Objects to the Smart Pointers segment (#1756)
Fixes #1516.
2024-01-25 09:47:50 -05:00
Dustin J. Mitchell
2313c0c3d0
Add a 'course-content' binary (#1757)
This allows dumping the course content in order, which I've needed
several times to verify whether a concept is used before it is covered
-- for example in #1516 I want to make sure we don't use trait objects
before the Smart Pointers section.
2024-01-25 09:47:23 -05:00
Martin Geisler
fda5f8f17e
Sort workspace members (#1760)
This should make it easier to insert new members going forward.
2024-01-25 11:08:53 +01:00
Martin Geisler
88f089f759
el: refresh translation for January 2024 (#1745)
This is a clean refresh, requires only a syntactical review.

You can skim this PR with the [GitHub CLI](https://cli.github.com/):

```
gh pr diff 1745 | bat -l patch
```
2024-01-25 09:52:58 +01:00
Martin Geisler
b45d4d1a20
id: refresh translation for January 2024 (#1737)
This is a clean refresh, requires only a syntactical review.

You can skim this PR with the [GitHub CLI](https://cli.github.com/):

```
gh pr diff 1737 | bat -l patch
```
2024-01-25 09:52:53 +01:00
Martin Geisler
6f8ad75f96
fr: refresh translation for January 2024 (#1741)
This is a clean refresh, requires only a syntactical review.

You can skim this PR with the [GitHub CLI](https://cli.github.com/):

```
gh pr diff 1741 | bat -l patch
```
2024-01-25 09:52:35 +01:00
Martin Geisler
a63ab24b95
ro: refresh translation for January 2024 (#1750)
This is a clean refresh, requires only a syntaxtical review.

You can skim this PR with the [GitHub CLI](https://cli.github.com/):

```
gh pr diff 1750 | bat -l patch
```
2024-01-25 09:51:36 +01:00
Martin Geisler
c62127698e
Tell translators to remove line numbers from PO files (#1753)
A `granularity` setting of `0` will remove the line numbers from the PO
files. This reduces the churn as we update the English source texts.
2024-01-25 09:46:24 +01:00
Martin Geisler
00a6f76647
ja: refresh translation for January 2024 (#1752)
This is a clean refresh, requires only a syntactical review.

You can skim this PR with the [GitHub CLI](https://cli.github.com/):

```
gh pr diff 1752 | bat -l patch
```
2024-01-25 08:52:51 +09:00
Martin Geisler
fd1313d0fe
tr: refresh translation for January 2024 (#1740)
This is a clean refresh, requires only a syntactical review.

You can skim this PR with the [GitHub CLI](https://cli.github.com/):

```
gh pr diff 1740 | bat -l patch
```
2024-01-24 08:17:09 -08:00
Ivan De Marino
dc76b73bc4
Adding the Italian translation to the list of incomplete ones (#1747)
Long overdue.

It felt a bit "odd" self-assigning merit, especially because I think I
haven't nearly contributed enough translations. So I looked at the
[history of `it.po` file](https://github.com/google/comprehensive-rust/commits/main/po/it.po)
and identified also @henrythebuilder as the other "owner" of the Italian
translation (definitely, based on number of lines contributed).

@henrythebuilder please confirm you are comfortable with this.
2024-01-24 16:10:53 +00:00
Martin Geisler
1735ae285e
it: Fix monospace for block comments (#1754)
This should fix the formatting on
https://google.github.io/comprehensive-rust/it/control-flow-basics/conditionals.html.
2024-01-24 14:36:05 +01:00
Martin Geisler
7d2952acb8
ru: refresh translation for January 2024 (#1739)
This is a clean refresh, requires only a syntactical review.

You can skim this PR with the [GitHub CLI](https://cli.github.com/):

```
gh pr diff 1739 | bat -l patch
```
2024-01-24 13:28:41 +00:00
Martin Geisler
6deafe050f
pl: refresh translation for January 2024 (#1748)
This is a clean refresh, requires only a syntaxtical review.

You can skim this PR with the [GitHub CLI](https://cli.github.com/):

```
gh pr diff 1748 | bat -l patch
```
2024-01-24 13:28:06 +00:00
Martin Geisler
767f1400e8
uk: refresh translation for January 2024 (#1749)
This is a clean refresh, requires only a syntaxtical review.

You can skim this PR with the [GitHub CLI](https://cli.github.com/):

```
gh pr diff 1749 | bat -l patch
```
2024-01-24 13:27:15 +00:00
Martin Geisler
dd48150ce2
it: refresh translation for January 2024 (#1738)
This is a clean refresh, requires only a syntactical review.
2024-01-24 13:10:45 +01:00
Martin Geisler
08af38a63e
es: refresh translation for January 2024 (#1746)
This is a clean refresh, requires only a syntaxtical review.
2024-01-24 13:01:05 +01:00
Andriy Redko
ca93a26758
uk: Day 1: afternoon (#1735)
uk: Day 1: afternoon
2024-01-23 10:46:45 +00:00
dependabot[bot]
cdfb8de46b
cargo: bump shlex from 1.2.0 to 1.3.0 (#1733)
Bumps shlex from 1.2.0 to 1.3.0.

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2024-01-23 09:47:41 +01:00
Yihao Wang
e990b395cd
Add myself (Ethan) to zh-CN reviewers (#1734) 2024-01-22 20:13:47 -08:00
Martin Geisler
1f6c0ea8a6
Remove double "finally" in java.md (#1732) 2024-01-22 11:15:06 -08:00
dependabot[bot]
00ece67120
cargo: bump embedded-hal from 0.2.7 to 1.0.0 in /src/bare-metal/microcontrollers/examples (#1721)
Bumps [embedded-hal](https://github.com/rust-embedded/embedded-hal) from
0.2.7 to 1.0.0.

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2024-01-22 11:02:43 -08:00
dependabot[bot]
bc12c3820c
cargo: bump embedded-hal from 0.2.7 to 1.0.0 in /src/exercises/bare-metal/compass (#1720)
Bumps [embedded-hal](https://github.com/rust-embedded/embedded-hal) from
0.2.7 to 1.0.0.

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2024-01-22 11:01:45 -08:00
dependabot[bot]
29bd1213e3
cargo: bump the patch group with 1 update (#1730)
Bumps the patch group with 1 update:
[regex](https://github.com/rust-lang/regex).

Updates `regex` from 1.10.2 to 1.10.3
2024-01-22 09:23:45 -05:00
dependabot[bot]
d76ca698ba
Bump crate-ci/typos from 1.17.1 to 1.17.2 (#1731)
Bumps [crate-ci/typos](https://github.com/crate-ci/typos) from 1.17.1 to
1.17.2.

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2024-01-22 09:20:40 -05:00
dependabot[bot]
475955a7dc
cargo: bump h2 from 0.3.22 to 0.3.24 (#1726)
Bumps [h2](https://github.com/hyperium/h2) from 0.3.22 to 0.3.24.

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2024-01-19 22:17:12 +00:00
Yuri Astrakhan
1dfc9f2e33
Clarify usage for thiserror-and-anyhow (#1724)
IMO it is better to explain to users the common usage / applicability
domain for anyhow and thiserror crates

---------

Co-authored-by: Dustin J. Mitchell <djmitche@google.com>
2024-01-18 15:28:00 -05:00
Dustin J. Mitchell
9d9b4170e4
Replace GUI exercise with Logger (#1682)
This should be a bit simpler, and notably
* does not require trait objects, which per #1516 should be moved later
in the course
 * does not require a lot of futzing with string formatting

But all that hard work developing the GUI exercise is not for naught: it
remains in the "Modules" segment, where students will get a chance to
read some Rust code and reorganize it a little bit.

Fixes #1617.

R=mgeisler as the original author of the GUI exercise.
2024-01-18 19:15:19 +00:00
dependabot[bot]
b4164e44a3
cargo: bump the minor group in /src/exercises/bare-metal/compass with 1 update (#1718)
Bumps the minor group in /src/exercises/bare-metal/compass with 1
update: [lsm303agr](https://github.com/eldruin/lsm303agr-rs).

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2024-01-18 12:08:15 +00:00
Kanta Yamaoka (山岡幹太)
9b8e4b3586
ja: Translate Chapter 60 (Shared State) (#1690)
Hi, ja translation team (#652 ). Here's an MR for the chapter "Shared
States." Could you review the translations? any feedback would be
appreciated. Thank you 😄

cc: @keiichiw , @chikoski , @HidenoriKobayashi , @ternbusty 
(Retrieved translaftion draft #1636 Chapter 60 draft, after recent
`ja.po` file refresh #1676 )
2024-01-18 20:32:44 +09:00
dependabot[bot]
19c3d7f904
cargo: bump the patch group with 1 update (#1722)
Bumps the patch group with 1 update:
[clap](https://github.com/clap-rs/clap).

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2024-01-18 11:10:08 +00:00
dependabot[bot]
d7d3c9c6c1
cargo: bump the patch group in /src/exercises/bare-metal/rtc with 1 update (#1717)
Bumps the patch group in /src/exercises/bare-metal/rtc with 1 update:
[bitflags](https://github.com/bitflags/bitflags).

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2024-01-18 11:09:51 +00:00
dependabot[bot]
d0e7e23da7
cargo: bump the patch group in /src/bare-metal/aps/examples with 1 update (#1716)
Bumps the patch group in /src/bare-metal/aps/examples with 1 update:
[bitflags](https://github.com/bitflags/bitflags).

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2024-01-18 11:09:34 +00:00
dependabot[bot]
5ae1b33c75
cargo: bump the minor group in /src/bare-metal/microcontrollers/examples with 2 updates (#1719)
Bumps the minor group in /src/bare-metal/microcontrollers/examples with
2 updates: [nrf52833-hal](https://github.com/nrf-rs/nrf-hal) and
[nrf52833-pac](https://github.com/nrf-rs/nrf-pacs).

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2024-01-18 11:09:11 +00:00
Andrew Walbran
01f5ecf1e6
Run dependabot on bare-metal examples and exercises too. (#1712)
These can't be in the main workspace due to needing custom cargo config
for linker scripts and targets.
2024-01-18 10:21:46 +00:00
Chan Wang
4797401c83
Add myself to zh-CN reviewers (#1714) 2024-01-17 21:47:15 +00:00
dependabot[bot]
3b17afd042
cargo: bump the patch group with 1 update (#1703)
Bumps the patch group with 1 update:
[tokio-websockets](https://github.com/Gelbpunkt/tokio-websockets).

Updates `tokio-websockets` from 0.5.0 to 0.5.1

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Dustin J. Mitchell <djmitche@google.com>
2024-01-17 09:04:52 -05:00
Dustin J. Mitchell
e785962ca4
split typos and formatting checks into separate workflows (#1710)
Without this it's easy for failures of one of these checks to hide
failures of the other.
2024-01-17 13:57:42 +00:00
Dustin J. Mitchell
73068d2af2
Improve interior mutability slide (#1683)
Mutex is probably more broadly understood by people coming from other
languages.

Fixes #1512.
2024-01-17 08:53:05 -05:00
Martin Geisler
d731da4a5e
Move pandoc/ folder out of the way (#1704)
The config fragments there are only used in the GitHub actions, so we
can stash them way in the `.github/` folder.
2024-01-16 19:25:45 -05:00
Martin Geisler
312e1515ec
Always use a nightly rustfmt in dprint fmt (#1694)
Without this, several of the formatting directives in our `rustfmt.toml`
file won’t have any effect. This will in turn lead to mismatches between
the formatting done locally and in CI.

This creates a dependency on `rustup`, but I think this is overall
better than silently ignoring the formatting directives.

From the discussion in #1682.
2024-01-16 19:10:02 +01:00
Andrew Shao
94b517461e
More clarification of blocks (#1706)
I believe it would be helpful to further clarify what delimits a block

---------

Co-authored-by: Martin Geisler <martin@geisler.net>
2024-01-16 14:06:24 +00:00
Pavel Roskin
0a1c30ef87
Better explanation why futures need to be pinned (#1687)
Attempt to address #1677.

Expert review is needed. The new text is my best guess based on the
original text and other explanations I could find online.

A few things to note:

* I'm trying to distinguish the future we return and the future we
await. My assumption is that the stack contents goes to the future the
code returns, not the future the code is awaiting.
* Readers could be worried if they need to pin the code they write. I'm
reassuring them that the borrow checks would normally catch bad
references.
* I'm intentionally avoiding the words that something is unsafe (or
would be unsafe). The async Rust is safe.
* I'm trying to be clear that `Pin` is a protective wrapper around a
pointer, not a mechanism that changes the pointer or the pointed object.
* Likewise, I don't want to give an impression that an unpinned pointer
to a future is inherently unsafe or invalid. It just cannot be used to
poll the future.
* I dropped the vague mention of the "issues", as it probably refers to
the issue with replacing a future (as opposed to resetting it in place).
It's already mentioned in the notes further on this page. It affects
pinning on stack only, `Box::pin()` can be replaced.

Co-authored-by: Martin Geisler <martin@geisler.net>
2024-01-16 15:05:33 +01:00
Mike Sandman
f23aa10d32
n1 should be 5, not 15 (#1693) 2024-01-16 11:05:30 +01:00
Max Heller
9ed01cca77
Render book as PDF in publish.yml workflow (#1572)
Renders the book as a PDF and includes it in the published HTML bundle
as `comprehensive-rust.pdf`.

Closes #1543
2024-01-15 23:02:05 +01:00
dependabot[bot]
3f1957c56d
cargo: bump the minor group with 1 update (#1702)
Bumps the minor group with 1 update:
[googletest](https://github.com/google/googletest-rust).

Updates `googletest` from 0.10.0 to 0.11.0

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2024-01-15 22:40:41 +01:00
Martin Geisler
3dc774d8e7
Group Dependabot PRs by minor/patch level (#1701)
This should help us limit the number of PRs opened by Dependabot. The
intention is for the bot to mostly open two PRs per week:

- one for patch updates (the ‘z’ in ‘x.y.z’)
- one for minor updates (the ‘y’ in ‘x.y.z’)

The rare major version updates (the ‘x’ in ‘x.y.z’) are sent
individually.

The configuration options here are taken from


https://docs.github.com/en/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file#groups

This might help with #1681, but I don’t know yet how the new PR
description looks.
2024-01-15 13:53:14 +00:00
Martin Geisler
60c5a332ec
Partially revert #1576 (#1700)
The GitHub action added in #1576 fails because it cannot run with the
necessary permissions: it requires write access to be able to post a
comment, but when triggered from a fork, the token is limited to read
access.

The error is from the thollander/actions-comment-pull-request action:

No comment has been found with asked pattern. Creating a new comment.
    Error: Resource not accessible by integration

The downgrading of the token is explained on:

https://docs.github.com/en/actions/security-guides/automatic-token-authentication

where “Maximum access for pull requests from public forked repositories”
says that the pull-requests permission is capped at read in the typical
case for us.

I kept the underlying functionality since we might want to use it for
something else (perhaps track the duration in the README).

Fixes the errors seen on the recent PRs: #1693, #1687, and likely
others.
2024-01-15 13:56:05 +01:00