Add readme for each example

Author: dbrattli

examples/README.md

@@ -0,0 +1,16 @@
+# Fable Python Examples
+
+See the `README.md` in each directory on how to run them. Some examples
+use project references against the top-level `Fable.Python.fsproj` while
+others reference the
+[`Fable.Python`](https://www.nuget.org/packages/Fable.Python/) NuGet
+instead.
+
+- BBC micro:bit, use Fable Python with MicroPython and the BBC micro:bit
+
+- Flask, use Fable Python to make web applications
+
+- Timeflies, use Fable Python with Tkinter and AsyncRx
+
+NOTE: If you make demos or examples with Fable Python then please
+consider providing a PR so we can add it here.

examples/flask/README.md

@@ -0,0 +1,23 @@
+# Fable Python on Flask
+
+## Install Dependencies
+
+```sh
+> dotnet tool restore
+> dotnet restore
+
+> pip install flask
+> rehash # so you can run flask below
+```
+
+## Build
+
+```
+> dotnet fable-py
+```
+
+## Run
+
+```sh
+> flask run
+```

examples/flask/pyproject.toml

@@ -8,7 +8,6 @@ license = "MIT"
 
 [tool.poetry.dependencies]
 python = "^3.8"
-fable-library = "^0.0.1"
 Flask = "^2.0.1"
 
 [tool.poetry.dev-dependencies]

examples/microbit/README.md

@@ -16,6 +16,9 @@ These tools are needed by the Build script:
 ```sh
 pip install uflash
 pip install microfs
+
+dotnet tool restore
+dotnet restore
 ```
 
 ## Build
@@ -30,4 +33,12 @@ dotnet run Build
 dotnet run Flash
 ```
 
+## Copy Fable Library
+
+Flashing will not copy the Fable Library (just `util.py` for now), so it
+needs to be transferred separately:
+
+```sh
+dotnet run FableLibrary
+```
 

examples/timeflies/README.md

@@ -0,0 +1,26 @@
+# Time Flies Like An Arrow
+
+Demo using Tkinter with AsyncRx. Fully self-contained and only
+references NuGet packages.
+
+## Install Dependencies
+
+```sh
+> pip install tkinter
+
+> dotnet tool restore
+> dotnet restore
+```
+
+## Build
+
+```sh
+> dotnet fable-py
+```
+
+
+## Run
+
+```sh
+> python program.py
+```

examples/timeflies/TimeFlies.fsproj

@@ -9,11 +9,8 @@
     <Compile Include="Program.fs" />
   </ItemGroup>
   <ItemGroup>
-    <PackageReference Include="Fable.Python" Version="0.5.0" />
+    <PackageReference Include="Fable.Python" Version="0.9.0" />
+    <PackageReference Include="Fable.Core.Experimental" Version="4.0.0-alpha-003" />
     <PackageReference Include="FSharp.Control.AsyncRx" Version="1.6.0" />
   </ItemGroup>
-  <ItemGroup>
-    <ProjectReference Include="../GitHub/Fable/src/Fable.Core/Fable.Core.fsproj" />
-  </ItemGroup>
-  <Import Project="..\..\.paket\Paket.Restore.targets" />
-</Project>
+  </Project>

src/stdlib/Builtins.fs

@@ -1,3 +1,4 @@
+/// Type bindings for Python builtins: https://docs.python.org/3/library/functions.html#built-in-funcs
 module Fable.Python.Builtins
 
 open System.Collections.Generic
@@ -107,11 +108,11 @@ type IExports =
     abstract map : ('T1 * 'T2 * 'T3 -> 'T4) * IEnumerable<'T1> * IEnumerable<'T2> * IEnumerable<'T3> -> IEnumerable<'T4>
     /// Return the Unicode code point for a one-character string.
     abstract ord : char -> int
-    // Object to string
+    /// Object to string
     abstract str : obj -> string
-    // Object to int
+    /// Object to int
     abstract int : obj -> int
-    // Object to float
+    /// Object to float
     abstract float : obj -> float
     abstract print : obj: obj -> unit
     abstract read : file: _OpenFile -> TextIOWrapper
@@ -129,6 +130,10 @@ type IExports =
 [<ImportAll("builtins")>]
 let builtins: IExports = nativeOnly
 
+// NOTE: Below we can add builtins that don't require overloads, and do not
+// conflict with common F# or .NET functions. If they do we keep them in
+// `IExports` above.
+
 [<Emit("__name__")>]
 let __name__: string = nativeOnly