Skip to content

Commit e277983

Browse files
committed
fix: Reformatted
1 parent eb509e5 commit e277983

6 files changed

Lines changed: 32 additions & 16 deletions

File tree

.markdownlint.json

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
11
{
22
"MD013": false,
33
"MD024": false,
4-
"MD033": false
4+
"MD033": false,
5+
"MD051": false
56
}

Fable.Literate/App.fs

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -464,6 +464,6 @@ dotnet fable Fable.Literate/ --lang python -o output/Fable.Literate/
464464
python output/Fable.Literate/app.py chapters/introduction.fs > docs/introduction.md
465465
```
466466
467-
That's it! A complete literate programming converter in under 200 lines of F`#`,
467+
That's it! A complete literate programming converter in under 200 lines of F#,
468468
compiled to Python, processing this very blog post.
469469
*)

chapters/AsyncProgramming.fs

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ F# provides two computation expressions that compile to Python's async model:
3232
- **`async { }`** - F#'s original async workflows (cold, composable, multi-target)
3333
- **`task { }`** - .NET-style tasks (hot in .NET, compiles to native `async def` in Python)
3434
35-
## F`#` Async Workflows
35+
## F# Async Workflows
3636
3737
The `async` computation expression has been part of F# since the beginning. It creates
3838
*cold* async operations - they don't start until explicitly run.

chapters/GettingStarted.fs

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ dotnet add package Fable.Core --version 5.0.0-beta.4
3737
Fable-generated Python code requires the `fable-library` runtime:
3838
3939
```bash
40-
pip install "fable-library==5.0.0a20"
40+
pip install "fable-library==5.0.0a21"
4141
```
4242
4343
---

chapters/Introduction.fs

Lines changed: 19 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,24 @@ this wonderful tradition that brings the F# community together every year!
1010
Welcome to this guide on [Fable.Python](https://github.com/fable-compiler/Fable.Python/) -
1111
a compiler that transforms F# code into Python.
1212
13+
## Table of Contents
14+
15+
1. [F# for Python Developers](#heading-are-you-a-python-developer) - Core concepts if you're coming from Python
16+
2. [Getting Started](#heading-getting-started-with-fablepython) - Installation and your first project
17+
3. [Python Interop](#heading-python-interop) - Calling Python libraries from F#
18+
4. [Creating Bindings](#heading-creating-python-bindings) - Type-safe wrappers for Python packages
19+
5. [F# Compatibility](#heading-f-compatibility-in-fablepython) - What works, what doesn't
20+
6. [Async Programming](#heading-async-programming) - F# async and Python asyncio
21+
7. [Testing](#heading-testing-fablepython-projects) - Using pytest with F# code
22+
8. [Fable v5](#heading-fable-v5-whats-new) - New features and the Rust core
23+
9. [Pydantic Integration](#heading-pydantic-interop) - Type-safe data validation
24+
10. [Units of Measure](#heading-units-of-measure) - Compile-time dimensional analysis
25+
11. [Fable.Literate](#heading-fableliterate-the-strange-loop) - The tool that wrote this post
26+
27+
**A teaser:** the final chapter reveals how this entire blog post was generated. The converter that transforms F#
28+
literate files into Markdown is itself written in F#, compiled to Python with Fable, and documented using its own
29+
output format. It's turtles all the way down.
30+
1331
## What is Fable?
1432
1533
[Fable](https://fable.io/) is a compiler that brings F# to different platforms and ecosystems. While
@@ -100,7 +118,5 @@ shape variant, the compiler will warn you about unhandled cases in the `area` fu
100118
## What's Next?
101119
102120
In the following chapters, we'll explore setting up your environment, working with Python libraries, and understanding
103-
F# compatibility with Fable.
104-
105-
Let's begin.
121+
F# compatibility with Fable. Let's begin.
106122
*)

chapters/Summary.fs

Lines changed: 8 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -7,13 +7,13 @@ module Summary
77
We've covered a lot of ground in this guide:
88
99
- **Introduction**: What Fable.Python is and why it matters
10-
- **F`#` for Python Developers**: Bridging the conceptual gap between languages
10+
- **F# for Python Developers**: Bridging the conceptual gap between languages
1111
- **Getting Started**: Setting up your first Fable.Python project
12-
- **Interop**: Seamlessly calling Python libraries from F`#`
12+
- **Interop**: Seamlessly calling Python libraries from F#
1313
- **Bindings**: Creating type-safe wrappers for Python code
14-
- **Compatibility**: Understanding what F`#` features work (and which don't)
15-
- **Async Programming**: Mapping F`#` async to Python's asyncio
16-
- **Testing**: Running F`#` code with pytest and other Python test runners
14+
- **Compatibility**: Understanding what F# features work (and which don't)
15+
- **Async Programming**: Mapping F# async to Python's asyncio
16+
- **Testing**: Running F# code with pytest and other Python test runners
1717
- **Fable v5**: The latest features including the Rust core and PyPI packages
1818
- **Pydantic**: Building validated data models with Python's favorite library
1919
- **Units of Measure**: Compile-time dimensional analysis that vanishes at runtime
@@ -24,7 +24,7 @@ We've covered a lot of ground in this guide:
2424
If you're reading this, the code worked.
2525
2626
This entire blog post - every chapter, every code example, every explanation -
27-
was processed by F`#` code compiled to Python, and output as Markdown.
27+
was processed by F# code compiled to Python, and output as Markdown.
2828
The proof is in the reading.
2929
3030
## Get Involved
@@ -34,7 +34,7 @@ The source code for this entire project is available on GitHub:
3434
**[github.com/cardamomcode/fable-python](https://github.com/cardamomcode/fable-python)**
3535
3636
The repository contains:
37-
- All the chapter source files (literate F`#`)
37+
- All the chapter source files (literate F#)
3838
- The Fable.Literate converter
3939
- Build scripts and configuration
4040
- The generated blog post
@@ -47,8 +47,7 @@ from the community make it better for everyone.
4747
4848
- [Fable Documentation](https://fable.io/docs/)
4949
- [Fable.Python on GitHub](https://github.com/fable-compiler/Fable.Python/)
50-
- [F`#` Software Foundation](https://fsharp.org/)
51-
- [Fable Discord](https://discord.gg/8c3Ng9N) - The Fable community is friendly and helpful
50+
- [F# Software Foundation](https://fsharp.org/)
5251
5352
Welcome to Fable.Python. Now go build something.
5453
*)

0 commit comments

Comments
 (0)