Shimoku docs
Search…
⌃K

v.0.2

On 2022.01.10
To get the new version
🚀
pip install --upgrade shimoku-api-python

Fixes

  • Indicators shimoku.plt.indicator() are now responsive to Mobile & Tablet.
  • Indicators shimoku.plt.indicator() can have other Reports in the same row.
  • The variable menu_path used for all the shimoku.plt objects now replaces _ for - for html standards

Improvements

  • The API has an official URL: https://api.shimoku.io/external/v1/
  • The dataset for a Table Report shimoku.plt.table() accepts empty values.
  • For Indicators Report shimoku.plt.indicator() now you can specify how many indicators you want by row with the parameter multi_column
shimoku.plt.indicator(
data=data_,
menu_path='test/indicator-test',
row=1, column=1,
value='value',
header='title',
footer='description',
multi_column=2, # It will put 2 indicators by row
)
  • When a Report is created with shimoku.plt it updates (replaces) what existed in the same grid position before. For instance in the following example you will end up having a Line chart in the position 1, 1 of the ‘test’ menu path (there would not be sign of a Bar chart in the FE).
shimoku.plt.bar(
data=data,
x='date', y=['x', 'y'],
title='Test Bar test',
menu_path='test',
row=1, column=1,
)
shimoku.plt.line(
data=data,
x='date', y=['x', 'y'],
title='Test Line test',
menu_path='test',
row=1, column=1,
)
After execute the Bar creation:
After execute it all (the Bar chart has been removed):
Thus shimoku.plt.update() is no longer necessary and is marked to be deprecated.
  • The Barchart Report shimoku.plt.bar() is not creating the X-Zoom by default (which is not an expected behavior for bar-charts in general)
  • The Order of the Paths is by creation order.
In the following example first reports for the path ‘Overview’ where created, then ' Business detail' and so on…
s.plt.table(menu_path='shimoku-backoffice/overview', ...)
s.plt.bar(menu_path='shimoku-backoffice/business-detail', ...)

New

  • A method to check if the API is available: shimoku.ping() returns True if the API is alive.
  • The object suite has been created shimoku.suite that creates whole Apps in a single command line. Currently you have the following:
    • Shimoku Backoffice shimoku.suite.shimoku_backoffice() creates a Back Office of your universe.
  • Charts catalog shimoku.suite.charts_catalog() creates an App with all the available Reports in Shimoku.

Coming

Through the following weeks we will advance in:
  • The multi-environment (prod & staging).
  • Order all paths in an App a posteriori with shimoku.plt.set_path_orders()
  • Multi filter feature that will allow to apply multiple Filters to all the reports (right now it is only available for Table).
  • Input Reports that accept input data.
  • The following Reports:
    • Cohorts
    • Themeriver
    • Candlestick
    • Scatter with confidence area
    • Line with confidence area
    • Bubble chart
  • New single line suites
    🧙♂
Last modified 6mo ago