Refactor Builder API before documentation (Avaiga#977)

- Refactor Builder API
- Added doc
- Fix circular dependency

doc/examples/broadcast.py

@@ -19,10 +19,11 @@
 # The text of the button that starts or stops the thread is updated on every client's browser
 # using a direct assignment of the state property because the variable is declared 'shared'.
 # -----------------------------------------------------------------------------------------
-from taipy.gui import Gui, State, broadcast_callback
-from threading import Thread, Event
+from threading import Event, Thread
 from time import sleep
 
+from taipy.gui import Gui, State, broadcast_callback
+
 counter = 0
 
 # Thread management

doc/examples/charts/advanced-selection.py

@@ -13,10 +13,12 @@
 # Python environment and run:
 #     python <script>
 # -----------------------------------------------------------------------------------------
-from taipy.gui import Gui
-import numpy
 import random
 
+import numpy
+
+from taipy.gui import Gui
+
 # x = [0..20]
 x = list(range(0, 21))
 

doc/examples/charts/bar-facing.py

@@ -14,9 +14,10 @@
 #     python <script>
 # -----------------------------------------------------------------------------------------
 # Face-to-face bar charts example
-from taipy.gui import Gui
 import numpy
 
+from taipy.gui import Gui
+
 n_years = 10
 
 proportions_female = numpy.zeros(n_years)

doc/examples/charts/bar-multiple.py

@@ -14,9 +14,10 @@
 #     python <script>
 # -----------------------------------------------------------------------------------------
 # Two data sets as a bar chart
-from taipy.gui import Gui
 import pandas
 
+from taipy.gui import Gui
+
 # Source https://en.wikipedia.org/wiki/List_of_United_States_presidential_elections_by_popular_vote_margin
 percentages = [
     (1852, 50.83),

doc/examples/charts/bar-simple.py

@@ -13,9 +13,10 @@
 # Python environment and run:
 #     python <script>
 # -----------------------------------------------------------------------------------------
-from taipy.gui import Gui
 import pandas
 
+from taipy.gui import Gui
+
 # Source https://en.wikipedia.org/wiki/List_of_United_States_presidential_elections_by_popular_vote_margin
 percentages = [
     (1852, 50.83),

doc/examples/charts/bar-stacked.py

@@ -13,9 +13,10 @@
 # Python environment and run:
 #     python <script>
 # -----------------------------------------------------------------------------------------
-from taipy.gui import Gui
 import pandas
 
+from taipy.gui import Gui
+
 # Source https://en.wikipedia.org/wiki/List_of_United_States_presidential_elections_by_popular_vote_margin
 percentages = [
     (1852, 50.83),

doc/examples/charts/basics-timeline.py

@@ -13,10 +13,11 @@
 # Python environment and run:
 #     python <script>
 # -----------------------------------------------------------------------------------------
-from taipy.gui import Gui
 import numpy
 import pandas
 
+from taipy.gui import Gui
+
 # Generate a random value for every hour on a given day
 data = {"Date": pandas.date_range("2023-01-04", periods=24, freq="H"), "Value": pandas.Series(numpy.random.randn(24))}
 

doc/examples/charts/candlestick-simple.py

@@ -14,9 +14,10 @@
 #     python <script>
 # You may need to install the yfinance package as well.
 # -----------------------------------------------------------------------------------------
-from taipy import Gui
 import yfinance
 
+from taipy import Gui
+
 # Extraction of a month of stock data for AAPL using the
 # yfinance package (see https://pypi.org/project/yfinance/).
 ticker = yfinance.Ticker("AAPL")

doc/examples/charts/candlestick-styling.py

@@ -14,9 +14,10 @@
 #     python <script>
 # You may need to install the yfinance package as well.
 # -----------------------------------------------------------------------------------------
-from taipy.gui import Gui
 import yfinance
 
+from taipy.gui import Gui
+
 # Extraction of a few days of stock historical data for AAPL using
 # the yfinance package (see https://pypi.org/project/yfinance/).
 # The returned value is a Pandas DataFrame.

doc/examples/charts/candlestick-timeseries.py

@@ -13,9 +13,10 @@
 # Python environment and run:
 #     python <script>
 # -----------------------------------------------------------------------------------------
-from taipy.gui import Gui
 import datetime
 
+from taipy.gui import Gui
+
 # Retrieved history:
 # (Open, Close, Low, High)
 stock_history = [

doc/examples/charts/continuous-error-multiple.py

@@ -13,10 +13,12 @@
 # Python environment and run:
 #     python <script>
 # -----------------------------------------------------------------------------------------
-from taipy.gui import Gui
 import datetime
+
 import dateutil.relativedelta
 
+from taipy.gui import Gui
+
 # Data is collected from January 1st, 2010, every month
 start_date = datetime.datetime(year=2010, month=1, day=1)
 period = dateutil.relativedelta.relativedelta(months=1)

doc/examples/charts/continuous-error-simple.py

@@ -13,9 +13,10 @@
 # Python environment and run:
 #     python <script>
 # -----------------------------------------------------------------------------------------
-from taipy.gui import Gui
 import random
 
+from taipy.gui import Gui
+
 # Common axis for all data: [1..10]
 x = list(range(1, 11))
 # Sample data

doc/examples/charts/error-bars-asymmetric.py

@@ -13,9 +13,10 @@
 # Python environment and run:
 #     python <script>
 # -----------------------------------------------------------------------------------------
-from taipy.gui import Gui
 import random
 
+from taipy.gui import Gui
+
 # Number of samples
 n_samples = 10
 # y values: [0..n_samples-1]

doc/examples/charts/error-bars-simple.py

@@ -13,10 +13,11 @@
 # Python environment and run:
 #     python <script>
 # -----------------------------------------------------------------------------------------
-from taipy.gui import Gui
 import math
 import random
 
+from taipy.gui import Gui
+
 # Number of samples
 max_x = 20
 # x values: [0..max_x-1]

doc/examples/charts/gantt-simple.py

@@ -13,9 +13,10 @@
 # Python environment and run:
 #     python <script>
 # -----------------------------------------------------------------------------------------
-from taipy.gui import Gui
 import datetime
 
+from taipy.gui import Gui
+
 # Tasks definitions
 tasks = ["Plan", "Research", "Design", "Implement", "Test", "Deliver"]
 # Task durations, in days

doc/examples/charts/heatmap-drawing-on-top.py

@@ -13,9 +13,10 @@
 # Python environment and run:
 #     python <script>
 # -----------------------------------------------------------------------------------------
-from taipy.gui import Gui
 import numpy
 
+from taipy.gui import Gui
+
 
 # Return the x and y coordinates of the spiral for the given angle
 def spiral(th):

doc/examples/charts/heatmap-unequal-cell-sizes.py

@@ -13,10 +13,12 @@
 # Python environment and run:
 #     python <script>
 # -----------------------------------------------------------------------------------------
-from taipy.gui import Gui
-import numpy as np
 from itertools import accumulate
 
+import numpy as np
+
+from taipy.gui import Gui
+
 grid_size = 10
 data = [
     {

doc/examples/charts/histogram-cumulative.py

@@ -13,9 +13,10 @@
 # Python environment and run:
 #     python <script>
 # -----------------------------------------------------------------------------------------
-from taipy.gui import Gui
 import random
 
+from taipy.gui import Gui
+
 # Random data set
 data = [random.random() for i in range(500)]
 

doc/examples/charts/histogram-horizontal.py

@@ -13,9 +13,10 @@
 # Python environment and run:
 #     python <script>
 # -----------------------------------------------------------------------------------------
-from taipy.gui import Gui
 import random
 
+from taipy.gui import Gui
+
 # Random data set
 data = {"Count": [random.random() for i in range(100)]}
 

doc/examples/charts/histogram-nbins.py

@@ -13,9 +13,10 @@
 # Python environment and run:
 #     python <script>
 # -----------------------------------------------------------------------------------------
-from taipy.gui import Gui
 import random
 
+from taipy.gui import Gui
+
 # Random set of 100 samples
 samples = {"x": [random.gauss() for i in range(100)]}
 

doc/examples/charts/histogram-normalized.py

@@ -13,9 +13,10 @@
 # Python environment and run:
 #     python <script>
 # -----------------------------------------------------------------------------------------
-from taipy.gui import Gui
 import random
 
+from taipy.gui import Gui
+
 # Random data set
 data = [random.random() for i in range(100)]
 

doc/examples/charts/histogram-overlay.py

@@ -13,9 +13,10 @@
 # Python environment and run:
 #     python <script>
 # -----------------------------------------------------------------------------------------
-from taipy.gui import Gui
 import random
 
+from taipy.gui import Gui
+
 # Data set made of two series of random numbers
 data = [{"x": [random.random() + 1 for i in range(100)]}, {"x": [random.random() + 1.1 for i in range(100)]}]
 

doc/examples/charts/histogram-simple.py

@@ -13,9 +13,10 @@
 # Python environment and run:
 #     python <script>
 # -----------------------------------------------------------------------------------------
-from taipy import Gui
 import random
 
+from taipy import Gui
+
 # Random data set
 data = [random.gauss(0, 5) for i in range(1000)]
 

doc/examples/charts/histogram-stacked.py

@@ -13,9 +13,10 @@
 # Python environment and run:
 #     python <script>
 # -----------------------------------------------------------------------------------------
-from taipy.gui import Gui
 import random
 
+from taipy.gui import Gui
+
 # Data set made of two series of random numbers
 data = {"A": [random.random() for i in range(200)], "B": [random.random() for i in range(200)]}
 

doc/examples/charts/line-style.py

@@ -13,9 +13,10 @@
 # Python environment and run:
 #     python <script>
 # -----------------------------------------------------------------------------------------
-from taipy.gui import Gui
 import pandas
 
+from taipy.gui import Gui
+
 dates = pandas.date_range("2023-01-01", periods=365, freq="D")
 temp = [
     -11.33333333,

doc/examples/charts/line-texts.py

@@ -13,10 +13,11 @@
 # Python environment and run:
 #     python <script>
 # -----------------------------------------------------------------------------------------
-from taipy.gui import Gui
 import numpy
 import pandas
 
+from taipy.gui import Gui
+
 dates = pandas.date_range("2023-01-01", periods=365, freq="D")
 temp = [
     -11.33333333,

doc/examples/charts/map-bubbles.py

@@ -13,10 +13,11 @@
 # Python environment and run:
 #     python <script>
 # -----------------------------------------------------------------------------------------
-from taipy.gui import Gui
 import numpy
 import pandas
 
+from taipy.gui import Gui
+
 # Largest cities: name, location and population
 # Source: https://simplemaps.com/data/world-cities
 cities = [

doc/examples/charts/polar-area.py

@@ -13,9 +13,10 @@
 # Python environment and run:
 #     python <script>
 # -----------------------------------------------------------------------------------------
-from taipy.gui import Gui
 import math
 
+from taipy.gui import Gui
+
 # One data point for each degree
 theta = range(0, 360)
 

doc/examples/charts/polar-multiple.py

@@ -13,9 +13,10 @@
 # Python environment and run:
 #     python <script>
 # -----------------------------------------------------------------------------------------
-from taipy.gui import Gui
 import math
 
+from taipy.gui import Gui
+
 # One data point for each degree
 theta = range(0, 360)
 

doc/examples/charts/polar-simple.py

@@ -13,9 +13,10 @@
 # Python environment and run:
 #     python <script>
 # -----------------------------------------------------------------------------------------
-from taipy.gui import Gui
 import math
 
+from taipy.gui import Gui
+
 # One data point for each degree
 theta = range(0, 360)
 

doc/examples/charts/polar-tick-texts.py

@@ -13,10 +13,12 @@
 # Python environment and run:
 #     python <script>
 # -----------------------------------------------------------------------------------------
-from taipy.gui import Gui
 from datetime import datetime
+
 import numpy
 
+from taipy.gui import Gui
+
 
 def generate_hand_shapes():
     # Retrieve and store the current, local time