[stdlib] Update stdlib corresponding to 2024-05-08 nightly/mojo

docs/changelog-released.md

@@ -3,11 +3,6 @@ title: Mojo🔥 changelog
 sidebar_label: Changelog
 description: A history of significant Mojo changes.
 toc_max_heading_level: 2
-website:
-  open-graph:
-    image: /static/images/mojo-social-card.png
-  twitter-card:
-    image: /static/images/mojo-social-card.png
 ---
 
 This is a running list of significant changes for the Mojo language and tools.
@@ -68,7 +63,7 @@ modular update mojo
 
 - Improvements to variadic arguments support.
 
-  - Heterogenous variadic pack arguments now work reliably even with memory types,
+  - Heterogeneous variadic pack arguments now work reliably even with memory types,
     and have a more convenient API to use, as defined by the
     [`VariadicPack`](/mojo/stdlib/builtin/builtin_list/VariadicPack) type. For
     example, a simplified version of `print` can be implemented like this:
@@ -1612,7 +1607,7 @@ experience without dedicated sugar.
   `num_physical_cores()`, `num_logical_cores()`, and `num_performance_cores()`
   functions.
 
-- Homogenous variadic arguments consisting of memory-only types, such as
+- Homogeneous variadic arguments consisting of memory-only types, such as
   `String` are more powerful and easier to use. These arguments are projected
   into a
   [`VariadicListMem`](/mojo/stdlib/builtin/builtin_list/VariadicListMem).
@@ -1656,7 +1651,7 @@ experience without dedicated sugar.
           i[] += " world"
   ```
 
-  Heterogenous variadic arguments have not yet been moved to the new model, but
+  Heterogeneous variadic arguments have not yet been moved to the new model, but
   will in future updates.
 
   Note that for variadic arguments of register-passable types like `Int`, the
@@ -2077,7 +2072,7 @@ experience without dedicated sugar.
   ```
 
   Traits can also inherit from other traits, which simply requires that
-  implementors of the child trait also conform to all parent traits.
+  implementers of the child trait also conform to all parent traits.
 
   ```mojo
   trait Parent:
@@ -3985,7 +3980,7 @@ busy this week.
 
 - 📚 Memcpy and memcmp now consistently use count as the byte count.
 
-- 📚 Add a variadic sting join on strings.
+- 📚 Add a variadic string join on strings.
 
 - 📚 Introduce a `reduce_bit_count` method to count the number of 1 across all
   elements in a SIMD vector.

docs/changelog.md

@@ -18,6 +18,28 @@ what we publish.
 
 ### ⭐️ New
 
+- Mojo now supports adding a `@deprecated` decorator on structs, functions,
+  traits, aliases, and global variables. The decorator marks the attached decl
+  as deprecated and causes a warning to be emitted when the deprecated decl is
+  referenced in user code. The decorator requires a deprecation message to be
+  specified as a string literal.
+
+  ```mojo
+  @deprecated("Foo is deprecated, use Bar instead")
+  struct Foo:
+      pass
+
+  fn outdated_api(x: Foo): # warning: Foo is deprecated, use Bar instead
+      pass
+
+  @deprecated("use another function!")
+  fn bar():
+      pass
+
+  fn techdebt():
+      bar() # warning: use another function!
+  ```
+
 - `int()` can now take a string and a specified base to parse an integer from a
   string: `int("ff", 16)` returns `255`. Additionally, if a base of zero is
   specified, the string will be parsed as if it was an integer literal, with the
@@ -45,8 +67,9 @@ what we publish.
           return Self(round(self.re), round(self.im))
   ```
 
-- The `abs, round, min, and max` functions have moved from `math` to `builtin`,
-  so you no longer need to do `from math import abs, round, min, max`.
+- The `abs, round, min, max, and divmod` functions have moved from `math` to
+  `builtin`, so you no longer need to do
+  `from math import abs, round, min, max, divmod`.
 
 - Mojo now allows types to opt in to use the `floor()` and `ceil()` functions in
   the `math` module by implementing the `__floor__()` and `__ceil__()` methods
@@ -100,11 +123,31 @@ what we publish.
 - `object` now implements all the bitwise operators.
     ([PR #2324](https://github.com/modularml/mojo/pull/2324) by [@LJ-9801](https://github.com/LJ-9801))
 
+- A new `--validate-doc-strings` option has been added to `mojo` to emit errors
+  on invalid doc strings instead of warnings.
+
+- A new decorator, `@doc_private`, was added that can be used to hide a decl
+  from being generated in the output of `mojo doc`. It also removes the
+  requirement that the decl has documentation (e.g. when used with
+  --diagnose-missing-doc-strings).
+
+- `Dict` now implements `get(key)` and `get(key, default)` functions.
+    ([PR #2519](https://github.com/modularml/mojo/pull/2519) by [@martinvuyk](https://github.com/martinvuyk))
+
 ### 🦋 Changed
 
 - The `abs` and `round` functions have moved from `math` to `builtin`, so you no
   longer need to do `from math import abs, round`.
 
+- Many functions returning a pointer type have been unified to have a public
+  API function of `unsafe_ptr()`.
+
+- The `--warn-missing-doc-strings` flag for `mojo` has been renamed to
+  `--diagnose-missing-doc-strings`.
+
+- The `take` function in `Variant` and `Optional` has been renamed to
+`unsafe_take`.
+
 ### ❌ Removed
 
 - The method `object.print()` has been removed. Since now, `object` has the

docs/community.md

@@ -3,11 +3,6 @@ title: Mojo🔥 community
 sidebar_label: Community
 description: Resources to share feedback, report issues, and chat.
 hide_table_of_contents: true
-website:
-  open-graph:
-    image: /static/images/mojo-social-card.png
-  twitter-card:
-    image: /static/images/mojo-social-card.png
 ---
 
 

docs/faq.md

@@ -2,11 +2,6 @@
 title: Mojo🔥 FAQ
 sidebar_label: FAQ
 description: Answers to questions we expect about Mojo.
-website:
-  open-graph:
-    image: /static/images/mojo-social-card.png
-  twitter-card:
-    image: /static/images/mojo-social-card.png
 ---
 
 We tried to anticipate your questions about Mojo on this page. If this page

docs/manual/basics.ipynb

@@ -2,21 +2,16 @@
  "cells": [
   {
    "cell_type": "raw",
-   "metadata": {},
+   "metadata": {
+    "vscode": {
+     "languageId": "raw"
+    }
+   },
    "source": [
     "---\n",
     "title: Introduction to Mojo\n",
-    "order: 1\n",
     "sidebar_position: 1\n",
     "description: Introduction to Mojo's basic language features.\n",
-    "aliases:\n",
-    "  - /mojo/notebooks/HelloMojo.html\n",
-    "css: /static/styles/page-navigation.css\n",
-    "website:\n",
-    "  open-graph:\n",
-    "    image: /static/images/mojo-social-card.png\n",
-    "  twitter-card:\n",
-    "    image: /static/images/mojo-social-card.png\n",
     "---"
    ]
   },

docs/manual/decorators/always-inline.ipynb

@@ -2,17 +2,15 @@
  "cells": [
   {
    "cell_type": "raw",
-   "metadata": {},
+   "metadata": {
+    "vscode": {
+     "languageId": "raw"
+    }
+   },
    "source": [
     "---\n",
     "title: '`@always_inline`'\n",
     "description: Copies the body of a function directly into the body of the calling function.\n",
-    "css: /static/styles/page-navigation.css\n",
-    "website:\n",
-    "  open-graph:\n",
-    "    image: /static/images/mojo-social-card.png\n",
-    "  twitter-card:\n",
-    "    image: /static/images/mojo-social-card.png\n",
     "---"
    ]
   },

docs/manual/decorators/index.md

@@ -4,12 +4,6 @@ sidebar_label: Decorators
 sidebar_position: 1
 description: A reference of Mojo's built-in decorators
 hide_table_of_contents: true
-css: /static/styles/page-navigation.css
-website:
-  open-graph:
-    image: /static/images/mojo-social-card.png
-  twitter-card:
-    image: /static/images/mojo-social-card.png
 listing:
   - id: docs
     contents:
@@ -31,6 +25,13 @@ actually calling the higher-order function, you simply add the decorator (such
 as the `@value` decorator) above your code (such as a struct). The Mojo
 compiler then uses the decorator function to modify your code at compile time.
 
+:::note No custom decorators
+
+The creation of custom decorators is not yet supported. The available ones are
+built directly into the compiler.
+
+:::
+
 The following pages describe each built-in decorator with examples.
 
 :::{#docs}

docs/manual/decorators/nonmaterializable.ipynb

@@ -2,17 +2,15 @@
  "cells": [
   {
    "cell_type": "raw",
-   "metadata": {},
+   "metadata": {
+    "vscode": {
+     "languageId": "raw"
+    }
+   },
    "source": [
     "---\n",
     "title: '`@nonmaterializable`'\n",
     "description: Declares that a type should exist only in the parameter domain.\n",
-    "css: /static/styles/page-navigation.css\n",
-    "website:\n",
-    "  open-graph:\n",
-    "    image: /static/images/mojo-social-card.png\n",
-    "  twitter-card:\n",
-    "    image: /static/images/mojo-social-card.png\n",
     "---"
    ]
   },

docs/manual/decorators/parameter.ipynb

@@ -2,17 +2,15 @@
  "cells": [
   {
    "cell_type": "raw",
-   "metadata": {},
+   "metadata": {
+    "vscode": {
+     "languageId": "raw"
+    }
+   },
    "source": [
     "---\n",
     "title: '`@parameter`'\n",
     "description: Executes a function or if statement at compile time.\n",
-    "css: /static/styles/page-navigation.css\n",
-    "website:\n",
-    "  open-graph:\n",
-    "    image: /static/images/mojo-social-card.png\n",
-    "  twitter-card:\n",
-    "    image: /static/images/mojo-social-card.png\n",
     "---"
    ]
   },

docs/manual/decorators/register-passable.ipynb

@@ -2,17 +2,15 @@
     "cells": [
         {
             "cell_type": "raw",
-            "metadata": {},
+            "metadata": {
+                "vscode": {
+                    "languageId": "raw"
+                }
+            },
             "source": [
                 "---\n",
                 "title: '`@register_passable`'\n",
                 "description: Declares that a type should be passed in machine registers.\n",
-                "css: /static/styles/page-navigation.css\n",
-                "website:\n",
-                "  open-graph:\n",
-                "    image: /static/images/mojo-social-card.png\n",
-                "  twitter-card:\n",
-                "    image: /static/images/mojo-social-card.png\n",
                 "---"
             ]
         },

docs/manual/decorators/staticmethod.ipynb

@@ -2,17 +2,15 @@
  "cells": [
   {
    "cell_type": "raw",
-   "metadata": {},
+   "metadata": {
+    "vscode": {
+     "languageId": "raw"
+    }
+   },
    "source": [
     "---\n",
     "title: '`@staticmethod`'\n",
     "description: Declares a struct method as static.\n",
-    "css: /static/styles/page-navigation.css\n",
-    "website:\n",
-    "  open-graph:\n",
-    "    image: /static/images/mojo-social-card.png\n",
-    "  twitter-card:\n",
-    "    image: /static/images/mojo-social-card.png\n",
     "---"
    ]
   },

docs/manual/decorators/unroll.ipynb

@@ -2,17 +2,15 @@
  "cells": [
   {
    "cell_type": "raw",
-   "metadata": {},
+   "metadata": {
+    "vscode": {
+     "languageId": "raw"
+    }
+   },
    "source": [
     "---\n",
     "title: '`@unroll`'\n",
     "description: Unrolls a loop at compile time.\n",
-    "css: /static/styles/page-navigation.css\n",
-    "website:\n",
-    "  open-graph:\n",
-    "    image: /static/images/mojo-social-card.png\n",
-    "  twitter-card:\n",
-    "    image: /static/images/mojo-social-card.png\n",
     "---"
    ]
   },

docs/manual/decorators/value.ipynb

@@ -2,17 +2,15 @@
  "cells": [
   {
    "cell_type": "raw",
-   "metadata": {},
+   "metadata": {
+    "vscode": {
+     "languageId": "raw"
+    }
+   },
    "source": [
     "---\n",
     "title: '`@value`'\n",
     "description: Generates boilerplate lifecycle methods for a struct.\n",
-    "css: /static/styles/page-navigation.css\n",
-    "website:\n",
-    "  open-graph:\n",
-    "    image: /static/images/mojo-social-card.png\n",
-    "  twitter-card:\n",
-    "    image: /static/images/mojo-social-card.png\n",
     "---"
    ]
   },

docs/manual/functions.ipynb

@@ -2,19 +2,16 @@
  "cells": [
   {
    "cell_type": "raw",
-   "metadata": {},
+   "metadata": {
+    "vscode": {
+     "languageId": "raw"
+    }
+   },
    "source": [
     "---\n",
     "title: Functions\n",
-    "order: 2\n",
     "sidebar_position: 2\n",
     "description: Introduction to Mojo `fn` and `def` functions.\n",
-    "css: /static/styles/page-navigation.css\n",
-    "website:\n",
-    "  open-graph:\n",
-    "    image: /static/images/mojo-social-card.png\n",
-    "  twitter-card:\n",
-    "    image: /static/images/mojo-social-card.png\n",
     "---"
    ]
   },