v.0.2

On 2022.01.10

This version has been deprecated. If used with the current API version it can produce unexpected behaviour or errors.

The package shimoku-api-python is no longer maintained

To get the new version 🚀

pip install --upgrade shimoku-api-python

Fixes

• Indicators s.plt.indicator() are now responsive to Mobile & Tablet.

• Indicators s.plt.indicator() can have other Reports in the same row.

• The variable menu_path used for all the s.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 s.plt.table() accepts empty values.

• For Indicators Report s.plt.indicator() now you can specify how many indicators you want by row with the parameter multi_column

s.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 s.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).

s.plt.bar(
  data=data,
  x='date', y=['x', 'y'],
  title='Test Bar test',
  menu_path='test',
  row=1, column=1,
)

s.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 s.plt.update() is no longer necessary and is marked to be deprecated.

• The Barchart Report s.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: s.ping() returns True if the API is alive.

• The object suite has been created s.suite that creates whole Apps in a single command line. Currently you have the following:

  • Shimoku Backoffice s.suite.shimoku_backoffice() creates a Back Office of your universe.

• Charts catalog s.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 s.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 🧙‍♂️