aboutsummaryrefslogtreecommitdiff
path: root/src/content/chapter5_advanced_features/lesson04_externals
diff options
context:
space:
mode:
authorLouis Pilfold <louis@lpil.uk>2024-02-20 12:20:16 +0000
committerLouis Pilfold <louis@lpil.uk>2024-02-20 12:20:16 +0000
commit938f49fc7835501192ccc7db7c1ab3174f050b34 (patch)
tree3e515fa15b6812df9947df80b8c16afd20faa436 /src/content/chapter5_advanced_features/lesson04_externals
parente7d45ec089262e8b6731ddf87e65a06f4de07841 (diff)
downloadtour-938f49fc7835501192ccc7db7c1ab3174f050b34.tar.gz
tour-938f49fc7835501192ccc7db7c1ab3174f050b34.zip
Let assert
Diffstat (limited to 'src/content/chapter5_advanced_features/lesson04_externals')
-rw-r--r--src/content/chapter5_advanced_features/lesson04_externals/code.gleam17
-rw-r--r--src/content/chapter5_advanced_features/lesson04_externals/en.html25
2 files changed, 0 insertions, 42 deletions
diff --git a/src/content/chapter5_advanced_features/lesson04_externals/code.gleam b/src/content/chapter5_advanced_features/lesson04_externals/code.gleam
deleted file mode 100644
index 1101b82..0000000
--- a/src/content/chapter5_advanced_features/lesson04_externals/code.gleam
+++ /dev/null
@@ -1,17 +0,0 @@
-import gleam/io
-
-// A type with no Gleam constructors
-pub type DateTime
-
-// An external function that creates an instance of the type
-@external(javascript, "./my_package_ffi.mjs", "now")
-pub fn now() -> DateTime
-
-// The `now` function in `./my_package_ffi.mjs` looks like this:
-// export function now() {
-// return new Date();
-// }
-
-pub fn main() {
- io.debug(now())
-}
diff --git a/src/content/chapter5_advanced_features/lesson04_externals/en.html b/src/content/chapter5_advanced_features/lesson04_externals/en.html
deleted file mode 100644
index 8815fa7..0000000
--- a/src/content/chapter5_advanced_features/lesson04_externals/en.html
+++ /dev/null
@@ -1,25 +0,0 @@
-<p>
- Sometimes in our projects we want to use code written in other languages, most
- commonly Erlang and JavaScript, depending on which runtime is being used.
- Gleam's <em>external functions</em> and <em>external types</em> allow us to
- import and use this non-Gleam code.
-</p>
-<p>
- An external type is one that has no constructors. Gleam doesn't know what
- shape it has or how to create one, it only knows that it exists.
-</p>
-<p>
- An external function is one that has the <code>@external</code> attribute on
- it, directing the compiler to use the specified module function as the
- implementation, instead of Gleam code.
-</p>
-<p>
- The compiler can't tell the types of functions written in other languages, so
- when the external attribute is given type annotations must be provided. Gleam
- trusts that the type given is correct so an inaccurate type annotation can
- result in unexpected behaviour and crashes at runtime. Be careful!
-</p>
-<p>
- External functions are useful but should be used sparingly. Prefer to write
- Gleam code where possible.
-</p>