Installation guide

Below you can find some generic instructions for setting up a proper environment to install Basico, the install instructions (for both end users and developers) and the basic settings for correct execution.

Setup environment

Please, consider this info as a guide. In GNU/Linux systems shouldn’t be any problem to execute Basico but for Windows systems is different because Python and GTK+ are not installed by default.


Linux

This application is being developed with modern Linux distros like Ubuntu 16.04. If you are using another distro like Fedora, OpenSuSE, etc., just make sure that you have Python 3 installed and the GTK+ libraries are available for this version of Python:

import gi
gi.require_version('Gtk', '3.0')
gi.require_version('WebKit', '3.0')

If you don’t get any error executing these lines you’re done in this phase.


Windows

Windows OS doesn’t bring the Python interpreter or the GTK+ libs installed by default, so you’ll need to take some extra steps to install Basico.

Python

Install Python 3.4

  • Please, do not install 3.5 version (I haven’t tested in Windows yet)
    python-344-win32
  • Make sure you add Python to Global path:python-344-win32_inst_path

PyGObject for Windows

Install PyGObject for Windows:

pygobjectwin32

Next step, execute the installer:

pygi_inst_01

Choose NO if you have installed Python:

pygi_inst_02

Select installed Python path:

pygi_inst_03

Choose main PyGObject components:

pygi_inst_04

Make sure that you select, at least, the following options:

  • Base packages
  • GDK-Pixbuf 2.34.0
  • GTK+ 3.18.9
  • Notify 0.7.6
  • Pango 1.40.1
  • Webkit2GTK 2.2.8

Do not choose any non-GNOME library to install in the next screen.

Mark the first one if you only want to execute the application. If you plan to devel, please, mark all of them for a better experience:

pygi_inst_05

You’re done:

pygi_inst_06


Installation


SAP Consultants

pypi-aboutAt this point, there is no installer for Windows systems. That’s not a problem. Python has its own software repository: Pypi.

Basico is available in Pypi aswell.

Both for Windows and Linux users, the command to install Basico in your system is:

pip install --upgrade basico --user

Note: If you have several versions of Python installed, just make sure that you run Python 3:

pip3 install --upgrade basico --user

Once installed, you can try Basico by executing the command ‘basico’ from the Start menu of typing ‘basico’ from a command-line window. If you have any problems with Basico and want to see the logs in Windows just type the following:

C:\basico>python c:\Python34\Scripts\basico-script.pyw
   INFO |   40  |         Basico | 2016-05-27 18:39:20,506 | Starting Basico
  DEBUG |   55  |            SAP | 2016-05-27 18:39:20,526 | Service SAP loaded
  DEBUG |   55  |            GUI | 2016-05-27 18:39:21,000 | Service GUI loaded
  DEBUG |   48  |            GUI | 2016-05-27 18:39:21,000 | Setting up GUI
  DEBUG |  333  |            SAP | 2016-05-27 18:39:21,000 | Loaded 1 notes
  DEBUG |   18  |            UIF | 2016-05-27 18:39:21,019 | Loading common UI Funcs service
  DEBUG |   29  |      Callbacks | 2016-05-27 18:39:21,019 | Loading UI Callbacks
  DEBUG |   55  |         Notify | 2016-05-27 18:39:21,019 | Service Notify loaded
  DEBUG |   55  |          Stats | 2016-05-27 18:39:21,019 | Service Stats loaded
  DEBUG |   55  |      Callbacks | 2016-05-27 18:39:21,038 | Service Callbacks loaded
  DEBUG |   55  |             IM | 2016-05-27 18:39:21,038 | Service IM loaded
  DEBUG |   55  |            UIF | 2016-05-27 18:39:21,038 | Service UIF loaded
  DEBUG |   55  |          Tasks | 2016-05-27 18:39:21,038 | Service Tasks loaded
  DEBUG |  167  |            SAP | 2016-05-27 18:39:21,038 | {'SV': 1}
  DEBUG |   55  |       Settings | 2016-05-27 18:39:24,114 | Service Settings loaded
  DEBUG |   55  |          Menus | 2016-05-27 18:39:24,222 | Service Menus loaded
  DEBUG |   47  |        Plugins | 2016-05-27 18:39:24,225 | Looking for plugins in: C:\Users\ADMIN\.basico\var\plugins\
  DEBUG |   92  |        Plugins | 2016-05-27 18:39:24,228 | Plugin system initialited: 0 plugins loaded
  DEBUG |   55  |        Plugins | 2016-05-27 18:39:24,230 | Service Plugins loaded
  DEBUG |  303  |   GtkAppWindow | 2016-05-27 18:39:24,260 | GUI loaded
  DEBUG |  118  |       Settings | 2016-05-27 18:39:24,261 | CONFIG[Settings][View] = components
  DEBUG |  118  |       Settings | 2016-05-27 18:39:24,265 | CONFIG[Settings][View] = components
  DEBUG |  222  |      Callbacks | 2016-05-27 18:39:24,267 | Searching in search
  DEBUG |  227  |      Callbacks | 2016-05-27 18:39:24,269 | Looking for ''
  DEBUG |  326  |    SAPNoteView | 2016-05-27 18:39:24,270 | View 'components' populated with 1 SAP Notes
  DEBUG |   68  |            GUI | 2016-05-27 18:39:26,934 | GUI terminated
   INFO |  404  |            SAP | 2016-05-27 18:39:26,934 | Saved 1 notes to C:\Users\ADMIN\.basico\var\db\sapnotes.json
   INFO |  192  |         Basico | 2016-05-27 18:39:26,934 | Basico finished

If you want to report a bug just send a traceback and small guide with the steps to reproduce it.


Developers

To get the most recent version of the software, you can download the code from my Subversion repository:

svn co http://subversion.t00mlabs.net/basico/trunk basico

Also you can explore this repo from your browser.

Basico’s source code will live here until I finish setting up my Github repository.


Settings


SAP section

In order to use Basico, you need to login in Launchpad and apply for your Single Sign-On SAP Passport. Then, import it to Firefox.

From Options -> Advanced:

  1. View certificates:View certificates
  2. Import certificate:
  3. Auto select certificate:

That’s it.