Simple Web SQLite Manager/Form/Report Application
Python
Latest commit 08277bf Apr 20, 2014 @nopri 1.50, session(s)
Permalink
Failed to load latest commit information.
README.rst 1.50, session(s) Apr 20, 2014
sqliteboy.py 1.50, session(s) Apr 20, 2014

README.rst

SQLiteBoy
Simple Web SQLite Manager/Form/Report Application
(c) Noprianto <nop@tedut.com>
2012-2014
License: GPL
Version: 1.50

SQLiteBoy is an independent product, developed separately from the
SQLite core library, which is maintained by SQLite.org.
Neither SQLiteBoy.com nor SQLite.org take any responsibility for the
work of the other.

What Is SQLiteBoy

  • Easy to use, python and web.py based, Web SQLite Manager with user-defined function and many extended features (Free/open source)

  • User-defined functions: number to words (multi language), number format, table lookup, hash, base64, random, additional date/time, additional string, regular expression, utility

  • If Extended feature is enabled:

    Multi user, simple (yet flexible) form (data entry) and reporting can be created by admin (simple JSON syntax), and can be run by admin/user (configurable). Very simple subform is also supported.

    Form field supports predefined values (options) from SQL Query or Python list. Also, default value can be result of function call, static value or SQL Query. Constraint is also supported, to check before save, to prevent saving invalid value (it's possible to call function before comparison). Onsave event is also supported, to execute SQL Query (and use the result) just before the data is saved.

    Reporting wizard also supports form field predefined values, default value and constraint (checking before reporting query is executed). Supported report format: PDF, HTML, HTML (printer friendly) and CSV.

    Form and Report support python handler, which will be automatically called, if provided. Python handler eases the integration with external system (for example: ERP system). Python handler also could be useful in, for example, complex database operation, reading from/writing to external devices, etc.

    User accounts, Notes, Files (with file sharing support), Page (home page), calculator, configurable hosts allowed, database backup, system configuration, Scripts, profile (with user-defined profile support) and others are available as extended features

    sqliteboy script (simple JSON syntax, single file) can be used to automate the creation of tables (including addition of columns, for existing table), forms, reports or user-defined profiles

  • If you are using Windows, standalone / portable application is available (single file executable). Run from Windows Explorer (double-click), no command line needed. Can be run from USB Flash Disk. Can be run by standard user.

Links

Features

  • Work with single SQLite database file

  • Single python file

  • Configurable port (default 11738 because it looks like sqliteboy)

  • SSL Support

  • Basic/Extended Feature

    • Basic: Database management + User-defined function

    • Extended: Form, Report, User/Login, etc

      • Completely optional

      • Can be enabled in menu

      • If enabled, one table:

        _sqliteboy_
        

        will be created. You can delete this table and extended feature will be disabled

  • Form Support (Extended feature, new in v0.12)

    • Simple data entry
    • Simple syntax (JSON)
    • Please read FORM CODE REFERENCE section (below)
    • Readonly field
    • Required field
    • Predefined values (field options) from SQL Query or Python list
    • Default value: function call or static value or SQL Query
    • Constraint: check before save, prevent saving invalid value (possible to call function before comparison)
    • Simple security setting
    • As of v0.21, onsave event is also supported, to execute SQL Query (and use the result) just before the data is saved. The SQL Query can be very complex and involves nested function calls.
    • As of v0.26, very simple subform is also supported. Subform can be used in one to many relationship. However, fields in subform is limited, compared to form.
    • As of v0.27, custom result message (based on SQL query result), is also supported.
    • As of v0.27, optional, additional SQL query statement(s) can be provided, and each of them will be executed in order, if you need to perform additional task(s), after the form data is saved (for example, write to another table). Previously, one might use report if need to write to several tables. Last insert rowid value is provided.
    • As of v0.75, insert into table can be disabled by setting insert key to zero/negative value. This is useful if you need to update/delete data in table(s), using additional SQL query statement(s). By default, form/subform save will insert new row(s) into table(s).
    • As of v0.98, form supports python handler, which will be automatically called, if provided. Python handler eases the integration with external system (for example: ERP system). Please read PYTHON HANDLER REFERENCE section.
    • As of v1.33, optional, (run before) additional SQL query statement(s) can be provided.
  • Report Support (Extended feature, new in v0.16)

    • Simple reporting (and data entry)
    • Simple syntax (JSON)
    • Please read REPORT CODE REFERENCE section (below)
    • Readonly field
    • Predefined values (field options) from SQL Query or Python list
    • Default value: function call or static value or SQL Query
    • Constraint: check before query, (possible to call function before comparison)
    • Flexible SQL query (and relation to wizard/user input) (free form query, You can use join, etc)
    • Custom header order
    • Simple security setting
    • As of v0.18, report also can be used as form/data entry, using insert SQL query. Custom result message (based on SQL query result), is also supported.
    • As of v0.60, headers and footers are supported. If not defined, a default one will be created. Plain text, SQL Query, and Image are supported.
    • As of v0.85, printer friendly version of report result is supported in default output format (HTML)
    • As of v1.00, report supports python handler, which will be automatically called, if provided. Python handler eases the integration with external system (for example: ERP system). Please read PYTHON HANDLER REFERENCE section.
    • As of v1.17, CSV output is supported
    • As of v1.28, PDF output (paper size, margins, image) is supported
    • As of v1.36, text align is supported (HTML and PDF only)
  • Files (Extended feature, new in v0.47)

    • System configuration: maximum number of files per user (admin: unlimited)
    • System configuration: maximum file size (admin: unlimited)
    • Multiple file upload (content type, filename, etc are saved)
    • Action: view
    • Action: download (disposition attachment)
    • Simple file sharing support
    • Human readable file size
    • URL: /fs
    • HTTP 404 Error: file not found or not shared
  • Page (Extended feature, new in v0.48)

    • Static page per user (home page)
    • URL: /page/<user>
    • Please read PAGE CODE REFERENCE section (below)
  • Scripts (Extended feature, new in v0.71)

    • Simple script, to automate the creation of tables (including addition of columns, for existing table), forms, reports or user-defined profiles
    • Solution can be deployed in form of script, that can be uploaded and run by admin
    • Simple syntax (JSON) in single file
    • Please read SCRIPT CODE REFERENCE section (below)
  • Profile (Extended feature, new in v0.91)

    • User profile
      • style
    • User-defined profile is also supported. Using this feature, custom field(s) in user profile can be added. This is useful, for example, in multi-company environment.
      • system configuration
      • Simple syntax (JSON)
      • Predefined values (field options) from SQL Query or Python list (as in form or report, is also supported)
      • Please read USER-DEFINED PROFILE REFERENCE section (below)
  • Browse table

    • Sort (asc/desc)
    • Download for BLOB type (if not NULL)
    • Multiple selection
    • Delete selected
    • Edit selected
    • Maintain last selected row(s)
    • Limit rows
    • Pagination
  • Insert into table

    • Default value hint
    • Work with default value(s)
    • Upload for BLOB type
  • Edit/Update table

    • Default value hint
    • Work with default value(s)
    • Download for BLOB type (if not NULL)
    • Upload for BLOB type
  • Column

    • Add column (with type and default value)
    • Multiple column addition
  • Rename table

  • Empty table

  • Drop table

  • CSV export/import

  • Schema (view schema, create new table)

  • Copy table

  • Create table

    • Support type, primary key, default value
    • Single or multiple primary key
    • Support for integer primary key autoincrement
    • Default value can be non-constant (for example: current_time, current_timestamp)
  • Query

    • Free form SQL Query
    • Automatically view query output (as integer or table)
    • Export query result to CSV (if applicable)
    • User-defined variable is also supported (max per user: 3). Please use the following functions: sqliteboy_var_set, sqliteboy_var_get, sqliteboy_var_del.
  • Vacuum

  • User account (Extended feature)

    • Type: admin (full access), standard (limited or configurable form/report access)
    • Change password
    • User management
  • Notes (Extended feature, new in v0.41)

    • Simple notes
    • Content as SQL Query (admin), calculator
  • Calculator (Extended feature, new in v0.50)

    • Simple calculator
    • Valid characters: 0123456789.-+*/()
    • Maximum length: 36
  • User-defined function

    • Prefix:

      sqliteboy_
      
    • Can be used in Query or Form or Report

    • Please read USER-DEFINED FUNCTION below

    • Will be added regularly (or by your request)

  • Easy to translate

  • Configurable hosts allowed (default: local) (Extended feature)

  • Database backup (admin) (Extended feature)

  • System configuration (admin) (Extended feature, new in v0.43)

  • Shortcut (form, report) (Extended feature, new in v0.84)

  • Human readable database size (GB, MB, KB, B)

  • Load time

  • Custom Template

  • Minimum use of Javascript in default/builtin template (only for confirmation dialog and toggle select all)

  • Table name limitation: could not handle table with whitespace in name

Requirements

  • python
  • web.py (http://webpy.org)
  • SQLite module (included as sqlite3, in python 2.5+)
  • JSON module (included as json, in python 2.6+)
  • Optional: ReportLab / PIL (PDF output)
  • Optional: pyOpenSSL (SSL support)

(or see below if you prefer standalone application on Windows)

Standalone Windows Application

  • Standalone / portable / run from USB Flash Disk
  • Can be run by standard user
  • There is no need to install Python / requirements above
  • Single file executable (+/- 6 MB)
  • Run from Windows Explorer (double-click), no command line needed
  • To quit properly, press CTRL-C in terminal (cmd) window
  • Documentation and source code are included
  • SSL support
  • Download: http://tedut.com/sqliteboy.exe

Default Admin User And Password

admin

SSL Support

To enable SSL support, please put the following files into current working directory:

  • sqliteboy.cert (SSL certificate)
  • sqliteboy.key (SSL private key)

If you need to create a self-signed test certificate, OpenSSL can be used:

openssl req -new -x509 -newkey rsa:1024 -keyout sqliteboy.key -out sqliteboy.cert -days 365 -nodes

How To Run

Command:

run sqliteboy.exe (double-click) from Windows Explorer, and select
database file (automatically create when opening a non-existent
file).

(if you are using Standalone Windows Application)

or

sqliteboy.exe <database_file> [port]

(if you are using Standalone Windows Application and prefer command
line or need to set port)

or

python sqliteboy.py <database_file> [port]

(if you are using source code)

or

python sqliteboy.py <database_file> [port] > LOGFILE 2>&1 &

(if you are using source code, sh compatible shell (with job control),
and want to run in the background. If applicable, You could use
/dev/null as LOGFILE if you don't care about the logs.)

then, using web browser, visit localhost:11738, or localhost:PORT, if PORT is specified

Please use https if SSL support is enabled

Custom Template

  • sqliteboy.html, if found in current working directory
  • For template example: T_BASE variable
  • Please do not put '$def with (data, content)' line in template

User-defined Function

  • sqliteboy_strs(s)

  • sqliteboy_as_integer(s)

  • sqliteboy_as_float(s)

  • sqliteboy_len(s)

  • sqliteboy_md5(s)

  • sqliteboy_sha1(s)

  • sqliteboy_sha224(s)

  • sqliteboy_sha256(s)

  • sqliteboy_sha384(s)

  • sqliteboy_sha512(s)

  • sqliteboy_b64encode(s)

  • sqliteboy_b64decode(s)

  • sqliteboy_randrange(a, b)

  • sqliteboy_randstr(s, a, b)

    random string
    argument    :
       s (set characters)
       a (min length, > 0)
       b (max length, > 0, >=a)
    
    example     :
       sqliteboy_randstr('abcdef123456', 3, 8)
       -> 'e2e6'
    
    tips        :
    - fix length: a = b
    - use sqliteboy_randstr2() or sqliteboy_randstr3() for predefined
      set characters
    - use sqliteboy_randstr_simple() for simple random string
    
  • sqliteboy_randstr2(a, b)

    random string (predefined set characters, letters + digits + punctuation)
    argument    :
       a (min length, > 0)
       b (max length, > 0, >=a)
    
    example     :
       sqliteboy_randstr2(3, 8)
       -> '"Z\@Z'
    
  • sqliteboy_randstr3(a, b)

    random string (predefined set characters, letters + digits)
    argument    :
       a (min length, > 0)
       b (max length, > 0, >=a)
    
    example     :
       sqliteboy_randstr3(3, 8)
       -> 'nItJ8'
    
  • sqliteboy_randstr_simple()

    random string (simple)
    example     :
       sqliteboy_randstr_simple()
       -> 'VUmDAQeJCpww9IjmiexrWRuRT6ZgpacKVdOA'
    
  • sqliteboy_is_datetime_format(s, fmt)

    is date time according to format
    argument    :
       s (input string)
       fmt (date time format string)
    
    example     :
       sqliteboy_is_datetime_format('2014', '%Y')
       -> 1
    
       sqliteboy_is_datetime_format('2014-01-01', '%Y-%m-%d')
       -> 1
    
       sqliteboy_is_datetime_format('2014-01-01', '%Y-%m-%d %H:%M:%S')
       -> 0
    
       sqliteboy_is_datetime_format('2014-01-01 01:02:03', '%Y-%m-%d %H:%M:%S')
       -> 1
    
    tips        :
    - use sqliteboy_is_datetime(), sqliteboy_is_date() or sqliteboy_is_time()
      for predefined date time format
    
  • sqliteboy_is_datetime(s)

  • sqliteboy_is_date(s)

  • sqliteboy_is_time(s)

  • sqliteboy_time()

  • sqliteboy_time2(s)

    get time from string (YYYY-MM-DD HH:MM:SS)
    argument    :
       s (date/time string)
    
    example     :
       sqliteboy_time2('2012-03-28 19:20:21')
       -> 1332937221.0
    
  • sqliteboy_time3(f)

    get string (YYYY-MM-DD HH:MM:SS) from time (local time)
    argument    :
       f (time)
    
    example     :
       sqliteboy_time3(1)
       -> 1970-01-01 07:00:01
       -> timezone is UTC+7
    
  • sqliteboy_time3a()

    alias for sqliteboy_time3(sqliteboy_time())
    
  • sqliteboy_time4(f)

    get string (YYYY-MM-DD HH:MM:SS) from time (UTC)
    argument    :
       f (time)
    
    example     :
       sqliteboy_time4(1)
       -> 1970-01-01 00:00:01
    
  • sqliteboy_time4a()

    alias for sqliteboy_time4(sqliteboy_time())
    
  • sqliteboy_time5(s1, s2, mode)

    calculate the difference between two dates in seconds, minutes, hours, days, or years
    (1 year = 365.2425 days)
    argument    :
       s1 (YYYY-MM-DD HH:MM:SS)
       s2 (YYYY-MM-DD HH:MM:SS)
       mode (1=seconds, 2=minutes, 3=hours, 4=days, 5=years)
    
    example     :
       sqliteboy_time5('2010-11-12 13:14:15', '2011-12-13 14:15:16', 1)
       -> 34218061.0
    
       sqliteboy_time5('2010-11-12 13:14:15', '2011-12-13 14:15:16', 2)
       -> 570301.016667
    
       sqliteboy_time5('2010-11-12 13:14:15', '2011-12-13 14:15:16', 3)
       -> 9505.01694444
    
       sqliteboy_time5('2010-11-12 13:14:15', '2011-12-13 14:15:16', 4)
       -> 396.042372685
    
       sqliteboy_time5('2010-11-12 13:14:15', '2011-12-13 14:15:16', 5)
       -> 1.08432718724
    
    tips        :
       empty/invalid s1 or s2: current date/time (localtime)
       use sqliteboy_number_format() to format the result
    
  • sqliteboy_time6(f, year, month, day, mode)

    format the difference between two dates in
    y (years) m (months) d (days) format
    argument    :
       f (number, in year, use sqliteboy_time5 function (mode=5) )
       year (year string)
       month (month string)
       day (day string)
       mode (1=30.44 days/month, 1=30 days/month, 2=31 days/month)
    
    example     :
       sqliteboy_time6(sqliteboy_time5('2010-11-12 01:02:03', '2011-12-13 11:12:13', 5), ' years ', ' months ', ' days ', 0)
       -> 1 years 1 months 1 days
    
       sqliteboy_time6(sqliteboy_time5('2010-11-12 01:02:03', '2011-10-11 11:12:13', 5), ' years ', ' months ', ' days ', 0)
       -> 0 years 10 months 29 days
    
       sqliteboy_time6(sqliteboy_time5('2013-01-01 10:20:30', '2013-01-02 10:20:30', 5), ' years ', ' months ', ' days ', 0)
       -> 0 years 0 months 1 days
    
       sqliteboy_time6(sqliteboy_time5('2013-01-02 10:20:30', '2013-01-01 10:20:30', 5), ' years ', ' months ', ' days ', 0)
       -> 0 years 0 months -1 days
    
       sqliteboy_time6(1000, ' years ', ' months ', ' days ', 0)
       -> 1000 years 0 months 0 days
    
       sqliteboy_time6(1.5, ' years ', ' months ', ' days ', 0)
       -> 1 years 6 months 0 days
    
       sqliteboy_time6(1.24, ' years ', ' months ', ' days ', 0)
       -> 1 years 2 months 27 days
    
       sqliteboy_time6(1.24, ' years ', ' months ', ' days ', 1)
       -> 1 years 2 months 26 days
    
       sqliteboy_time6(1.24, ' years, ', ' months, ', ' days', 0)
       -> 1 years, 2 months, 27 days
    
       sqliteboy_time6(1.24, ' tahun ', ' bulan ', ' hari ', 0)
       -> 1 tahun 2 bulan 27 hari
    
  • sqliteboy_is_leap(n)

    is leap year
    argument    :
       n (year)
    
    return value:
      1 (leap year) or 0 (not leap year)
    
  • sqliteboy_lower(s)

  • sqliteboy_upper(s)

  • sqliteboy_swapcase(s)

  • sqliteboy_capitalize(s, what)

    capitalize string
    argument    :
       s (input string)
       what (0=first word, 1=all)
    
    example     :
      sqliteboy_capitalize('hello world', 0)
      -> 'Hello world'
    
      sqliteboy_capitalize('hello world', 1)
      -> 'Hello World'
    
  • sqliteboy_justify(s, justify, length, padding)

    left, right, center justify string
    argument    :
       s (input string)
       justify (0=left, 1=right, 2=center)
       length (length)
       padding (single padding character)
    
    example     :
      sqliteboy_justify('hello', 0, 10, 'x')
      -> 'helloxxxxx'
    
      sqliteboy_justify('hello', 1, 10, 'x')
      -> 'xxxxxhello'
    
      sqliteboy_justify('hello', 2, 10, 'x')
      -> 'xxhelloxxx'
    
      sqliteboy_justify(12345, 1, 10, 0)
      -> '0000012345'
    
  • sqliteboy_find(s, sub, position, case)

    find index in s where substring sub is found
    argument    :
       s (input string)
       sub (substring)
       position (0=lowest index, 1=highest index)
       case (0=ignore case, 1=case sensitive)
    
    return value:
      -1 (not found) or > -1 (found, starts from 0)
    
    example     :
      sqliteboy_find('hello sqliteboy', 'e', 0, 0)
      -> 1
    
      sqliteboy_find('hello sqliteboy', 'e', 1, 0)
      -> 11
    
      sqliteboy_find('hello sqlitEboy', 'e', 1, 0)
      -> 11
    
      sqliteboy_find('hello sqlitEboy', 'e', 1, 1)
      -> 1
    
  • sqliteboy_reverse(s)

    reverse string
    argument    :
       s (input string)
    
    example     :
      sqliteboy_reverse('hello world')
      -> 'dlrow olleh'
    
      sqliteboy_reverse(12345)
      -> '54321'
    
  • sqliteboy_repeat(s, n)

    repeat s (n times)
    argument    :
       s (input string)
       n (n times)
    
    example     :
      sqliteboy_repeat('sqliteboy ', 5)
      -> 'sqliteboy sqliteboy sqliteboy sqliteboy sqliteboy'
    
      sqliteboy_repeat(1, 20)
      -> '11111111111111111111'
    
      sqliteboy_repeat('=', 10)
      -> '=========='
    
  • sqliteboy_count(s, sub, case)

    count substring sub in s
    argument    :
       s (input string)
       sub (substring)
       case (0=ignore case, 1=case sensitive)
    
    return value:
      0 (not found) or > 0 (found)
    
    example     :
      sqliteboy_count('hello sqliteboy', 'e', 0)
      -> 2
    
      sqliteboy_count('hello hello hello', 'Hello', 0)
      -> 3
    
      sqliteboy_count('hello hello hello', 'Hello', 1)
      -> 0
    
  • sqliteboy_is_valid_email(s)

    return value  :
        1 (valid) or 0 (invalid)
    
  • sqliteboy_match(s1, s2)

    regular expression match
    argument    :
       s1 (pattern string)
       s2 (test string)
    
    return value:
      1 (match) or 0 (not match)
    
  • sqliteboy_is_number(n)

    argument    :
       n (number or string to test)
    
    return value:
      1 (number) or 0 (not number)
    
  • sqliteboy_is_float(n)

    return value:
      1 (float) or 0 (not float)
    
  • sqliteboy_is_integer(n)

    return value:
      1 (integer) or 0 (not integer)
    
  • sqliteboy_normalize_separator(s, separator, remove_space, unique)

    argument    :
       separator (separator string)
       remove_space (remove space in s, 1 or 0)
       unique (1 or 0)
    
    example     :
      sqliteboy_normalize_separator
        (',,,,,1,1,,  2,  3,  4,,,,', ',', 1, 1)
      -> '1,2,3,4'
    
  • sqliteboy_split0(s, separator, index)

    split string s using separator as the delimiter string and
    return index (in list)
    argument    :
       s (input string)
       separator (separator string)
       index (index)
    
    return value:
      index (in list) or ''
    
    example     :
      sqliteboy_split0('s.q.l.i.t.e.b.o.y', '.', 1)
      -> 'q'
    
      sqliteboy_split0('s.q.l.i.t.e.b.o.y', '', 1)
      -> ''
    
      sqliteboy_split0('s.q.l.i.t.e.b.o.y', '.', -3)
      -> 'b'
    
      sqliteboy_split0('h e l l o', '', 1)
      -> 'e'
    
    tips        :
       empty separator: use whitespace
    
  • sqliteboy_chunk(s, n, separator, justify, padding)

    split string into evenly sized chunks
    argument    :
       s (string)
       n (length/size)
       separator (separator string)
       justify (0=left, 1=right)
       padding (single padding character)
    
    example     :
      select sqliteboy_chunk('123456789', 3, '-', 1, 'x')
      -> '123-456-789'
    
      select sqliteboy_chunk('123456789', 2, '-', 0, 'x')
      -> '12-34-56-78-9x'
    
      select sqliteboy_chunk('123456789', 2, '-', 1, 'x')
      -> 'x1-23-45-67-89'
    
      select sqliteboy_chunk('123456789', 4, ',', 1, '*')
      -> '***1,2345,6789'
    
  • sqliteboy_number_format(n, decimals, decimal_point, thousands_separator)

    format a number (or number as string) with grouped thousands and decimals
    (works with number in scientific notation (e))
    argument    :
       n (number or number as string), use string for very big number
       decimals (number of decimal points)
       decimal_point (separator for the decimal point)
       thousands_separator (thousands separator)
    
    example     :
      sqliteboy_number_format(12345, 3, '.', ',')
      -> '12,345'
    
      sqliteboy_number_format(12345, 3, ',', '.')
      -> '12.345'
    
      sqliteboy_number_format(12345.1234, 3, ',', '.')
      -> '12.345,123'
    
      sqliteboy_number_format(12345.1234, 0, ',', '.')
      -> '12.345'
    
      sqliteboy_number_format(12345.1234, 10, ',', '.')
      -> '12.345,1234000000'
    
      sqliteboy_number_format(12345.1234, 2, ',', ' ')
      -> '12 345,12'
    
      sqliteboy_number_format('-12345678912345678912345678912345678912.123', 10, ',', '.')
      -> '-12.345.678.912.345.678.912.345.678.912.345.678.912,1230000000'
    
  • sqliteboy_number_to_words(s, language)

    number to words
    Please read NUMBER TO WORDS REFERENCE section (below)
    
    argument    :
       s (number as string)
       language (language code)
    
    return value:
      number to words or '' (error/unsupported)
    
    example     :
      language  : 'id'
    
      sqliteboy_number_to_words('-0', 'id')
      -> 'nol'
    
      sqliteboy_number_to_words('11', 'id')
      -> 'sebelas'
    
      sqliteboy_number_to_words('1000', 'id')
      -> 'seribu'
    
      sqliteboy_number_to_words('1000000', 'id')
      -> 'satu juta'
    
      sqliteboy_number_to_words('-123456789123456789123456789.123456789', 'id')
      -> 'min seratus dua puluh tiga triliun empat ratus lima puluh enam milyar tujuh ratus delapan puluh sembilan juta seratus dua puluh tiga ribu empat ratus lima puluh enam triliun tujuh ratus delapan puluh sembilan milyar seratus dua puluh tiga juta empat ratus lima puluh enam ribu tujuh ratus delapan puluh sembilan koma satu dua tiga empat lima enam tujuh delapan sembilan'
    
      language  : 'en1'
    
      sqliteboy_number_to_words('-0', 'en1')
      -> 'zero'
    
      sqliteboy_number_to_words('11', 'en1')
      -> 'eleven'
    
      sqliteboy_number_to_words('1000', 'en1')
      -> 'one thousand'
    
      sqliteboy_number_to_words('1000000', 'en1')
      -> 'one million'
    
      sqliteboy_number_to_words('-123456789123456789123456789.123456789', 'en1')
      -> 'minus one hundred twenty-three trillion four hundred fifty-six billion seven hundred eighty-nine million one hundred twenty-three thousand four hundred fifty-six trillion seven hundred eighty-nine billion one hundred twenty-three million four hundred fifty-six thousand seven hundred eighty-nine point one two three four five six seven eight nine'
    
  • sqliteboy_lookup1(table, field, field1, value1, function, distinct)

    SELECT <function>(<field>) FROM <table> WHERE <field1>=<value1>
    and
    return function result
    argument    :
       table (table name)
       field (field name)
       field1 (where field)
       value1 (where field value)
       function (avg, count, group_concat, max, min, sum, total)
       distinct (0=non distinct, 1=distinct)
    
    return value:
      function result (as str) or '' (error)
    
    example     :
      data in 'lookup' table:
      | a | b |
      ---------
      |a  | 0 |
      |a  | 1 |
      |a1 | 2 |
      |a2 | 3 |
    
      sqliteboy_lookup1('lookup', 'b', 'a', 'a', 'avg', 0)
      -> '0.5'
    
      sqliteboy_lookup1('lookup', 'a', 'a', 'a', 'count', 0)
      -> '2'
    
      sqliteboy_lookup1('lookup', 'a', 'a', 'a', 'count', 1)
      -> '1'
    
      sqliteboy_lookup1('lookup', 'a', 'a', 'a', 'group_concat', 0)
      -> 'a,a'
    
      sqliteboy_lookup1('lookup', 'b', 'a', 'a', 'max', 0)
      -> '1'
    
      sqliteboy_lookup1('lookup', 'b', 'a', 'a', 'min', 0)
      -> '0'
    
      sqliteboy_lookup1('lookup', 'b', 'a', 'a', 'sum', 0)
      -> '1'
    
      sqliteboy_lookup1('lookup', 'b', 'a', 'a2', 'total', 0)
      -> '3.0'
    
  • sqliteboy_lookup2(table, field, field1, value1, order, default)

    lookup into table
    SELECT <field> FROM <table> WHERE <field1>=<value1> ORDER BY rowid asc
    or
    SELECT <field> FROM <table> WHERE <field1>=<value1> ORDER BY rowid desc
    and
    return first row
    argument    :
       table (table name)
       field (field name)
       field1 (where field)
       value1 (where field value)
       order (0=asc, 1=desc)
       default (default return value)
    
    example     :
      data in 'lookup' table:
      | a | b | c |
      -------------
      |a1 |b1 |c1 |
      |a2 |b2 |c2 |
    
      sqliteboy_lookup2('lookup', 'c', 'a', 'a1', 0, ':(')
      -> 'c1'
    
      sqliteboy_lookup2('lookup', 'c_notfound', 'a', 'a1', 0, ':(')
      -> ':('
    
      sqliteboy_lookup2('lookup', 'b', 'a', 'a1', 0, ':(')
      -> 'b1'
    
      sqliteboy_lookup2(12345, 'b', 'a', 'a1', 0, ':(')
      -> ':('
    
  • sqliteboy_lookup3(table, field, field1, value1, field2, value2, order, default)

    lookup into table
    SELECT <field> FROM <table> WHERE <field1>=<value1> and <field2>=<value2> ORDER BY rowid asc
    or
    SELECT <field> FROM <table> WHERE <field1>=<value1> and <field2>=<value2> ORDER BY rowid desc
    and
    return first row
    argument    :
       table (table name)
       field (field name)
       field1 (where field1)
       value1 (where field1 value)
       field2 (where field2)
       value2 (where field2 value)
       order (0=asc, 1=desc)
       default (default return value)
    
    example     :
      data in 'lookup' table:
      | a | b | c |
      -------------
      |a1 |b1 |c1 |
      |a2 |b2 |c2 |
    
      sqliteboy_lookup3('lookup', 'c', 'a', 'a1', 'b', 'b1', 0, ':(')
      -> 'c1'
    
      sqliteboy_lookup3('lookup', 'c', 'a', 'a1', 'b', 'b2', 0, ':(')
      -> ':('
    
      sqliteboy_lookup3(12345, 'c', 'a', 'a1', 'b', 'b1', 0, ':(')
      -> ':('
    
  • sqliteboy_split1(s, separator, table, column, convert)

    split string s using separator as the delimiter string and
    insert into table (column) for each member in list
    argument    :
       s (input string)
       separator (separator string)
       table (table to insert)
       column (column in table)
       convert(0=no conversion, 1=convert to column type if applicable (or to string) )
    
    return value:
      number of row(s) inserted into table, or 0
    
    example     :
      sqliteboy_split1('h.e.l.l.o.w.o.r.l.d', '.', 'test_split', 'c', 1)
      -> 10
    
      sqliteboy_split1('hello', '', 'test_split', 'c', 0)
      -> 1
    
    tips        :
       empty separator: use whitespace
    
  • sqliteboy_list_datetime1(s, n, interval, table, column, local)

    generate list of datetime starting with s (inclusive),
    as much as n, with interval,
    and insert into table (column) for each member in list
    argument    :
       s (YYYY-MM-DD HH:MM:SS)
       n (as much as, must be > 0)
       interval (interval in seconds, must not zero)
       table (table to insert)
       column (column in table)
       local (0=UTC, 1=local)
    
    return value:
      number of row(s) inserted into table, or 0
    
    example     :
      (local timezone is UTC+7)
    
      sqliteboy_list_datetime1('', 5, 60*60*24, 'test_date', 'a', 1)
      -> 5
      (data in table)
      2013-06-03 23:13:27
      2013-06-04 23:13:27
      2013-06-05 23:13:27
      2013-06-06 23:13:27
      2013-06-07 23:13:27
    
      sqliteboy_list_datetime1('', 5, 60*60*24, 'test_date', 'a', 0)
      -> 5
      (data in table)
      2013-06-03 16:14:09
      2013-06-04 16:14:09
      2013-06-05 16:14:09
      2013-06-06 16:14:09
      2013-06-07 16:14:09
    
      sqliteboy_list_datetime1('', 5, -60*60*24, 'test_date', 'a', 1)
      -> 5
      (data in table)
      2013-06-03 23:14:55
      2013-06-02 23:14:55
      2013-06-01 23:14:55
      2013-05-31 23:14:55
      2013-05-30 23:14:55
    
      sqliteboy_list_datetime1('2013-01-01 00:00:00', 5, 60*60, 'test_date', 'a', 1)
      -> 5
      (data in table)
      2013-01-01 00:00:00
      2013-01-01 01:00:00
      2013-01-01 02:00:00
      2013-01-01 03:00:00
      2013-01-01 04:00:00
    
    tips        :
       empty s: current date/time (localtime)
    
  • sqliteboy_http_remote_addr()

    return value  :
        http remote address
    
  • sqliteboy_http_user_agent()

    return value  :
        http user agent (for example: web browser)
    
  • sqliteboy_app_title()

    return value:
      application title
    
    example     :
      sqliteboy_app_title()
      -> 'sqliteboy 1.10'
    
  • sqliteboy_var_set(name, value)

    user-defined variable: set
    (max per user apply)
    argument    :
       name (variable name, underscore and alphanumeric only, not case-sensitive)
       value (value)
    
    return value:
      1 (ok) or 0
    
    example     :
      sqliteboy_var_set('a', 1000)
      -> 1
    
      sqliteboy_var_set('b', 'hello')
      -> 1
    
    tips        :
      to free some space, please use sqliteboy_var_del function below,
      setting to empty string or 0 does not delete the variable
    
  • sqliteboy_var_get(name)

    user-defined variable: get
    argument    :
       name (variable name, underscore and alphanumeric only, not case-sensitive)
    
    return value:
      value of variable or ''
    
    example     :
      sqliteboy_var_get('a')
      -> 1000
    
      sqliteboy_var_get('b')
      -> hello
    
  • sqliteboy_var_del(name)

    user-defined variable: delete
    argument    :
       name (variable name, underscore and alphanumeric only, not case-sensitive)
    
    return value:
      1 (ok) or 0
    
    example     :
      sqliteboy_var_del('a')
      -> 1
    
      sqliteboy_var_del('b')
      -> 1
    
  • sqliteboy_strip_html(s)

    strip html
    argument    :
       s (input string)
    
    example     :
      sqliteboy_strip_html('<b>hello</b>')
      -> 'hello'
    
  • sqliteboy_x_user()

    return value  :
        user name (if extended feature is enabled, or '')
    
  • sqliteboy_x_profile_all(u, field, system)

    read user profile (both system and user-defined)
    
    argument    :
       u (user)
       field (custom field)
       system (0=user-defined, 1=system)
    
    return value:
      field value (if extended feature is enabled and field is set,
      or '')
    
  • sqliteboy_x_profile(u, field)

    read custom field in user-defined profile for user u
    Please read USER-DEFINED PROFILE REFERENCE section (below)
    
    argument    :
       u (user)
       field (custom field)
    
    return value:
      field value (if extended feature is enabled and field is set,
      or '')
    
  • sqliteboy_x_profile_system(u, field)

    read system profile for user u
    Please read SYSTEM PROFILE REFERENCE section (below)
    
    argument    :
       u (user)
       field (field)
    
    return value:
      field value (if extended feature is enabled and field is set,
      or '')
    
  • sqliteboy_x_my(field)

    alias for sqliteboy_x_profile(sqliteboy_x_user(), field)
    
  • sqliteboy_x_my_system(field)

    alias for sqliteboy_x_profile_system(sqliteboy_x_user(), field)
    

Form Code Reference

  • Must be valid JSON syntax (json.org)
  • String (including keys below) must be double-quoted (between " and ")
  • No trailling comma in dict or list
  • Python dict (keys are case-sensitive)
  • Only single table is supported. If you need to write to another table after form data is saved, you can use additional SQL query statement(s) (see below).
  • Onsave event can be used to execute SQL Query (and use the result) just before the data is saved. The SQL Query can be very complex and involves nested function calls.
  • Very simple subform is also supported. Subform can be used in one to many relationship. However, fields in subform is limited, compared to form (only reference and default are supported; all is required; none is readonly; column(s) can be selected). When saving data, transaction is used.
  • Custom result message (based on SQL query result), is also supported.
  • Optional, additional SQL query statement(s) can be provided, and each of them will be executed in order, if you need to perform additional task(s), after the form data is saved (for example, write to another table). Previously, one might use report if need to write to several tables. Last insert rowid value is provided.
  • Insert into table can be disabled by setting insert key to zero/negative value. This is useful if you need to update/delete data in table(s), using additional SQL query statement(s). By default, form/subform save will insert new row(s) into table(s). Please note that setting insert key to zero/negative value will also set last insert rowid/query result to same value as insert value.
  • Please also read PYTHON HANDLER REFERENCE section
  • Keys:
Key Description Type Status Example
data form data list of dict required see: Keys (data)
security form security dict required see: Keys (security)
title form title str optional "My Form"
info

form information

(html is allowed)

str optional "Form Information"
sub

subform

  • must be list of five members: related table (str); related column in that table (str); list of [rows (int), required rows (int)]; list of list (column) [column (str), label (str), reference, default]; subform information (str)
  • see Keys (data) below for reference/default
  • return value of last_insert_rowid() will be written to related column (each row). Use ROWID column in master table to get the relation.
list optional
  • ["table2", "a", [5,3], [["b", "Column B", [ ["0", "NO"], ["1", "YES"] ], "1"], ["c", "Column C", "select a, b from table1", ""]], "My Subform"]
message

custom result message

  • not applicable to subform

  • must be list of three members (str)

    ["message res < 0", "message res = 0", "message res > 0"]

  • $result (in message) will be replaced by actual SQL Query result

  • $<column> will be replaced by user input value for that column

  • $last_insert_rowid will be replaced by last_insert_rowid() function call result (after insert to main table)

  • $python_handler will be replaced by return value of python handler (if provided, default: -1)

(html is allowed)

list optional
  • [

    "unknown result", "zero result", "success: $result"

    ]

sql0

additional sql query statement(s)

(run before)

(please see sql2)

list optional  
sql2

additional sql query statement(s)

(run after)

  • must be list of str
  • $<column> will be replaced by user input value for that column
  • $last_insert_rowid will be replaced by last_insert_rowid() function call result (after insert to main table) (sql2 only)
  • quoting is automatically done
  • each statement is executed in transaction
list optional
  • ["insert into table3( a, b, c, d, e) values( $a, $b, $c, $d, $e)", "insert into table4(x) values( $last_insert_rowid)"]
insert

prevent insert new row(s) into table(s) on form/subform save, if zero/negative value is given

(noted above)

int optional  
confirm confirmation message str optional  
  • Keys (data):
Key Description Type Status Example
table table name; only single table is supported, and first table found will be used, other table(s) will be ignored str required "table1"
column column str required "col1"
label label str optional "column 1"
required is required; (0 = not required, 1 = required) int optional 1
readonly is readonly; (0 = not readonly, 1 = readonly) int optional 0
reference

predefined value(s)

  • str: SQL query; returns 2 columns: a and b; HTML select
  • list: static value(s); contains list(s), which contains two members; HTML select
  • int: flag (2: HTML input password)
str, list or int optional
  • "select col1 as a, col2 as b from table1"
  • [ ["0", "NO"], ["1", "YES"] ]
  • 2
default

default value

  • str, int: use as is

  • list: SQL function call; at least one member; first member must be str (function name); return value will be used as default;

    format: [function_name, arg1, ...]

    do not put () in function_name

  • list (SQL query): must be list of two str members; first member: empty string; second member: SQL query (must return one column: a)

str, list or int optional
  • ["sqliteboy_md5", "hello"]
  • ["sqlite_version"]
constraint

check before save

  • must be list of four members

    ["function_name", as_str, "condition", "error_message"]

    function_name might be empty; as_str must be 1 (treat function call argument as string) or 0; condition must not empty; condition must contain boolean comparison; error_message might be empty;

  • if function_name is not empty, function_name will be called with column value as an argument; function result will be compared with condition

  • if function_name is empty, column value will be compared with condition

  • if comparison result is 0 (false), form saving will be cancelled; if error_message is specified, error_message will be displayed; else, generic error message with column name, function_name (if any) and condition will be displayed

list optional
  • ["", 0, "> 10", "must be larger than 10"]; check if column value is > 10
  • ["sqliteboy_len", 1, "> 10", ""]; check if sqliteboy_len (column value) is > 10
onsave

execute sql query just before the data is saved

  • sql query can be very complex and involves nested function calls
  • sql query must return one column: onsave
  • quoting is automatically done
  • $value will replaced with user input value
  • the returned value will be saved to table (not the user input value)
str optional
  • "select $value || ' : ' || sqliteboy_upper( sqliteboy_md5($value) ) as onsave"
  • In example above, md5 hash of user input will be calculated using sqliteboy_md5. Then the result will be uppercased using sqliteboy_upper. Then the result will be concatenated with another string (final).
  • Example (input=hello): hello : 5D41402ABC4B2A7 6B9719D911017C592
  • Keys (security):
Key Description Type Status Example
run

can run form; admin(s): always can run form

  • "": all users can run this form
  • list: only users in this list can run this form
"" or list required
  • []
  • ["user1", "user2"]
  • note:
    • if you are using primary key column in form data, '*' character will be added to column label
    • tips: use sqliteboy_as_integer function in constraint to do integer conversion/comparison
  • Example 1:
{
  "title" : "My Form (Simple)",
  "info"  : "Form Information",
  "data"  : [
              {
                "table"     : "table1",
                "column"    : "a"
              },
              {
                "table"     : "table1",
                "column"    : "d"
              },
              {
                "table"     : "table1",
                "column"    : "f"
              }
            ],
  "security" : {
                 "run" : ""
               }
}
  • Example 2:
{
  "title" : "My Form 1",
  "info"  : "Form Information",
  "sub"   : [
              "table2",
              "a",
              [5,3],
              [
                ["b", "Column B", [ ["0", "NO"], ["1", "YES"] ], "1"],
                ["c", "Column C", "select a, b from table1", ""]
              ],
              "My Subform"
            ],
  "sql2"  : [
              "insert into table3(a, b, c, d, e) values($a, $b, $c, $d, $e)",
              "insert into table4(x) values($last_insert_rowid)"
            ],
  "data"  : [
              {
                "table"     : "table1",
                "column"    : "a",
                "label"     : "column a",
                "required"  : 1,
                "reference" : [ ["0", "NO"], ["1", "YES"] ],
                "default"   : "1"
              },
              {
                "table"     : "table1",
                "column"    : "b",
                "reference" : "select sqliteboy_randrange(1, 100000000000) as a, 'hello ' || sqliteboy_time() as b from _sqliteboy_"
              },
              {
                "table"     : "table1",
                "column"    : "c",
                "default"   : ["sqliteboy_md5", "hello"],
                "constraint": ["sqliteboy_len", 1, "= 32", ""],
                "onsave"    : "select sqliteboy_upper($value) as onsave"
              },
              {
                "table"     : "table1",
                "column"    : "d",
                "label"     : "d (incorrect larger than 100)",
                "required"  : 1,
                "constraint": ["", 0, "> 100", "must be larger than 100"]
              },
              {
                "table"     : "table1",
                "column"    : "e",
                "label"     : "e (correct larger than 100)",
                "required"  : 1,
                "constraint": ["sqliteboy_as_integer", 1, "> 100", "must be larger than 100"]
              },
              {
                "table"     : "table1",
                "column"    : "f"
              }
            ],
  "message"  : ["unknown result", "zero result", "success: $result"],
  "security" : {
                 "run" : ""
               }
}

Report Code Reference

  • Must be valid JSON syntax (json.org)
  • String (including keys below) must be double-quoted (between " and ")
  • No trailling comma in dict or list
  • Python dict (keys are case-sensitive)
  • All key (HTML input) in data is required. See Keys (data) below.
  • Report also can be used as form/data entry, using insert SQL query. Custom result message (based on SQL query result), is also supported. Using free form SQL query, data entry can work with multiple table.
  • Headers and footers are supported. If not defined, a default one will be created. Plain text, SQL Query, and Image are supported. Headers and footers are rendered as tables (multiple rows/columns; one table for headers, one table for footers). If there is difference in number of columns for each row, largest one will be used.
  • Default headers:
    • First row: first column (report title), second column (report info)
    • Next row(s): first column (search key), second column (user input)
  • Default footers (SELECT SQL):
    • First row: first column (number of rows), second column ("row(s)"/translated)
  • Default footers (NON-SELECT SQL):
    • First row: first column (message or ""), second column ("")
  • Printer friendly version of report result is supported in default output format (HTML)
  • Keys:
Key Description Type Status Example
data wizard/search data list of dict required (might be empty list) see: Keys (data)
security reporting security dict required see: Keys (security)
sql free form sql query; please note that any placeholder must have relation with key in data (see Keys (data)) str required

"select a.a as 'column a of table1', a.e from table1 a where a.a = $input_a_a and a.e > $a_e"

For that example, you must define "input_a_a" and "a_e" key in data

title report title str optional "My Report"
info

report information

(html is allowed)

str optional "Report Information"
header

header order; header order for query result

  • if not specified, header order is unpredictable, because each row of query result is python dict and default header order will be read from first row
list optional
  • [

    "column a of table1", "e"

    ]

align

text align

(please see header; only applicable if header is set)

  • HTML and PDF only
  • must be list of int
  • 0: left
  • 1: center
  • 2: right
  • 3: justify
list optional
  • [1, 2]
message

custom result message; only for SQL query that returns integer (insert, update, etc). Useful for data entry function.

  • must be list of three members (str)

    ["message res < 0", "message res = 0", "message res > 0"]

  • $result (in message) will be replaced by actual SQL Query result

  • $<column> will be replaced by user input value for that column

list optional
  • [

    "unknown result", "zero result", "success: $result"

    ]

headers

custom headers

  • must be list of list (rows) of list (columns) of three members (each cell) (str, str/int, dict)
  • cell: [type, value, attr]
  • type: "" (plain text), "sql" (sql query), "files.image" (file number in user files)
  • value: any valid value for type (str is valid for types above)
  • attr: {}
  • for "sql" type, $result_row_count will be replaced by actual row count (or -1), $result will be replaced by sql query result (integer/ non-select, or -1), $result_message will be replaced by actual message (or "", for custom result message), and each key in data will be replaced by user input value; quoting is automatically done; sql query must return one column: a
list of list of list optional (please see Example 2 below)
footers

custom footers

(please see headers)

list of list of list optional  
paper

paper size in point (1/72 inch) (PDF)

  • must be list of two int/float members (width, height)
list optional  
margins

margins in point (1/72 inch) (PDF)

  • must be list of four int/float members (left, right, top, bottom)
list optional  
confirm confirmation message str optional  
  • Keys (data):
Key Description Type Status Example
key HTML input name; underscore and alphanumeric only str required "input_a_a"
label label str optional "column a ="
readonly is readonly; (0 = not readonly, 1 = readonly) int optional 0
reference

predefined value(s)

  • str: SQL query; returns 2 columns: a and b; HTML select
  • list: static value(s); contains list(s), which contains two members; HTML select
  • int: flag (2: HTML input password)
str, list or int optional
  • "select col1 as a, col2 as b from table1"
  • [ ["0", "NO"], ["1", "YES"] ]
  • 2
default

default value

  • str, int: use as is

  • list: SQL function call; at least one member; first member must be str (function name); return value will be used as default;

    format: [function_name, arg1, ...]

    do not put () in function_name

  • list (SQL query): must be list of two str members; first member: empty string; second member: SQL query (must return one column: a)

str, list or int optional
  • ["sqliteboy_md5", "hello"]
  • ["sqlite_version"]
type

type; cast input type as given type; currently, only "integer" is supported (default: str)

  • if integer is specified, input will be converted to integer using python's int()
str optional  
constraint

check before reporting

  • must be list of four members

    ["function_name", as_str, "condition", "error_message"]

    function_name might be empty; as_str must be 1 (treat function call argument as string) or 0; condition must not empty; condition must contain boolean comparison; error_message might be empty;

  • if function_name is not empty, function_name will be called with column value as an argument; function result will be compared with condition

  • if function_name is empty, column value will be compared with condition

  • if comparison result is 0 (false), reporting will be cancelled; if error_message is specified, error_message will be displayed; else, generic error message with column name, function_name (if any) and condition will be displayed

list optional
  • ["", 0, "> 10", "must be larger than 10"]; check if column value is > 10
  • ["sqliteboy_len", 1, "> 10", ""]; check if sqliteboy_len (column value) is > 10
  • Keys (security):
Key Description Type Status Example
run

can run report; admin(s): always can run report

  • "": all users can run this report
  • list: only users in this list can run this report
"" or list required
  • []
  • ["user1", "user2"]
  • note:
    • tips: use sqliteboy_as_integer function in constraint to do integer conversion/comparison
  • Example 1:
{
  "title" : "My Report",
  "info"  : "Report Information",
  "header": ["column a of table1", "e"],
  "sql"   : "select a.a as 'column a of table1', a.e from table1 a where a.a = $input_a_a and a.e > $a_e",
  "data"  : [
              {
                "key"       : "input_a_a",
                "label"     : "column a equals",
                "reference" : [ ["0", "NO"], ["1", "YES"] ],
                "default"   : "1"
              },
              {
                "key"       : "a_e",
                "label"     : "e (as integer) >",
                "constraint": ["sqliteboy_as_integer", 1, "> 0", "e must be integer"]
              }
            ],
  "security" : {
                 "run" : ""
               }
}
  • Example 2:
{
  "title" : "My Report",
  "info"  : "Report Information",
  "header": ["column a of table1", "e"],
  "sql"   : "select a.a as 'column a of table1', a.e from table1 a where a.a = $input_a_a and a.e > $a_e",
  "data"  : [
              {
                "key"       : "input_a_a",
                "label"     : "column a equals",
                "reference" : [ ["0", "NO"], ["1", "YES"] ],
                "default"   : "1"
              },
              {
                "key"       : "a_e",
                "label"     : "e (as integer) >",
                "constraint": ["sqliteboy_as_integer", 1, "> 0", "e must be integer"]
              }
            ],
  "headers"  : [
                  [
                      ["files.image", "31", {}],
                      ["", "My Report", {}]
                  ],
                  [
                      ["", "Date/Time", {}],
                      ["sql", "select sqliteboy_time3(sqliteboy_time()) as a", {}]
                  ],
                  [
                      ["", "User", {}],
                      ["sql", "select sqliteboy_x_user() as a", {}]
                  ],
                  [
                      ["", "column a equals", {}],
                      ["sql", "select $input_a_a as a", {}]
                  ],
                  [
                      ["", "e (as integer) >", {}],
                      ["sql", "select $a_e as a", {}]
                  ],
                  [
                      ["", "Rows", {}],
                      ["sql", "select $result_row_count as a", {}]
                  ]
               ],
  "security" : {
                 "run" : ""
               }
}

Page Code Reference

  • emphasis

    ~text~ -> <em>text</em>
    
  • strong

    *text* -> <strong>text</strong>
    
  • underline

    _text_ -> <u>text</u>
    
  • link

    [text|url] -> <a href="url">text</a>
    
  • Note: HTML tags will be stripped on page save

  • Note: rendered in <pre></pre> tag

Number To Words Reference

  • Supported languages:

    • id : Bahasa Indonesia
    • en1 : English (trillion billion million thousand scheme)
  • More languages will be added

  • Please let me know/correct me if there is something wrong in the implementation

  • Currently, highest supported large number name is trillion (short scale) or 10**12 or 1,000,000,000,000. And, number supported is ranged from: -999,999,999,999,999,999,999,999,999.99... (minus 999.999 999 999 999 999 999 999 999 trillion trillion plus digits after decimal point) to: 999,999,999,999,999,999,999,999,999.99... ( 999.999 999 999 999 999 999 999 999 trillion trillion plus digits after decimal point)

    (This is, however, might be different for each language)

  • Digits after the decimal point is limited only by python float (that is, very very long long number), so this is valid and supported number: 999999999999999999999999999.999999999999999999999999999999999999999999999999999999

Script Code Reference

  • Script can be used to automate the creation of tables (including addition of columns, for existing table), forms, reports or user-defined profiles
  • Solution can be deployed in form of script, that can be uploaded and run by admin
  • Notes on tables:
    • Multiple tables support
    • For each table, script developer must define valid columns
    • For each column, script developer must define valid name, type and flag
    • Valid column type: integer, real, char, varchar, text, blob, null
    • Valid column flag: 0, 1 (primary key), 2 (only for integer: primary key autoincrement)
    • Multiple primary key support (column flag 1 for multiple columns; do not use both flag 1 and 2 in same table)
    • Currently, default value is not supported
    • For existing table, addition of columns is supported
      • Developer could define columns and only non-existing ones will be added
      • Existing columns, if defined, will be compared. Error, if there is mismatch between new column type and existing column type.
  • Notes on forms, reports:
    • Multiple forms, reports support
    • Error, if there is existing form or report
    • Please read FORM CODE REFERENCE section (forms) or REPORT CODE REFERENCE section (reports)
  • Only valid value(s) will be read
  • Script could not be run if there is error
  • If there is exception while the script is running, any newly created table (if empty) will be explicitly deleted. However, newly added columns could not be deleted (easily).
  • Script is designed to be run only once
  • Must be valid JSON syntax (json.org)
  • Must be put in single file
  • String (including keys below) must be double-quoted (between " and ")
  • No trailling comma in dict or list
  • Python dict (keys are case-sensitive)
  • Keys:
Key Description Type Status Example
name script name str required "my script 1"
tables

tables definition

  • must be list of list (table) or []
  • for each table: ["tablename", [column], ...]
  • for each [column]: ["name", "type", flag] (please read notes above)
list of list required (please see Examples below)
forms

forms definition

  • must be list of list (form) or []
  • for each form: ["formname", {formcode}]
  • formcode: valid form code (dict)
list of list required (please see Examples below)
reports

reports definition

  • must be list of list (report) or []
  • for each report: ["reportname", {reportcode}]
  • reportcode: valid report code (dict)
list of list required (please see Examples below)
profiles user-defined profiles list optional (please see Examples below)
info script information str optional "Script Information"
author author information str optional "(c) Author <email>"
license license information str optional "license"
  • Example 1:
{
    "name": "my script",
    "info": "Script Information",
    "author": "(c) Author <email>",
    "license": "GPL",
    "tables": [
                    [
                        "new_table",
                        ["a", "integer", 1],
                        ["b", "integer", 1],
                        ["c", "integer", 1],
                        ["d", "text", 0]
                    ]
                ],
    "forms": [
                ],
    "reports": [
                ]
}
  • Example 2:
{
    "name": "my script 1",
    "info": "Script Information",
    "author": "(c) Author <email>",
    "license": "GPL",
    "tables": [
                    [
                        "new_table_1",
                        ["a", "integer", 1],
                        ["b", "integer", 1],
                        ["c", "integer", 1],
                        ["d", "text", 0]
                    ],
                    [
                        "new_table_2",
                        ["a", "integer", 2],
                        ["b", "integer", 0],
                        ["c", "integer", 0],
                        ["d", "text", 0]
                    ]
                ],
    "forms": [
                    [
                        "new_form_1",
                        {
                          "title" : "New Form 1",
                          "info"  : "Form Information",
                          "data"  : [
                                      {
                                        "table"     : "new_table_1",
                                        "column"    : "a"
                                      },
                                      {
                                        "table"     : "new_table_1",
                                        "column"    : "b"
                                      }
                                    ],
                          "security" : {
                                         "run" : ""
                                       }
                        }
                    ],
                    [
                        "new_form_2",
                        {
                          "title" : "New Form 2",
                          "info"  : "Form Information",
                          "data"  : [
                                      {
                                        "table"     : "new_table_2",
                                        "column"    : "c"
                                      },
                                      {
                                        "table"     : "new_table_2",
                                        "column"    : "d"
                                      }
                                    ],
                          "security" : {
                                         "run" : ""
                                       }
                        }
                    ]
                ],
    "reports": [
                    [
                        "new_report_1",
                        {
                          "title" : "New Report 1",
                          "info"  : "Report Information",
                          "header": ["a", "b"],
                          "sql"   : "select a,b from new_table_1 a where a > $input_a or b > $input_b",
                          "data"  : [
                                      {
                                        "key"       : "input_a",
                                        "label"     : "column a >",
                                        "default"   : "0"
                                      },
                                      {
                                        "key"       : "input_b",
                                        "label"     : "column b >",
                                        "default"   : "0"
                                      }
                                    ],
                          "security" : {
                                         "run" : ""
                                       }
                        }
                    ]
                ],
    "profiles": [
                  [
                     "company",
                     "Company",
                     "select id as a, name as b from company",
                     0
                  ],
                  [
                     "sqliteboy",
                     "Happy SQLiteBoy user?",
                     [ [0,"no :("], [1,"yes :)"] ],
                     1
                  ],
                  [
                     "signature",
                     "Signature",
                     0,
                     ""
                  ]
                ]

}

System Profile Reference

  • style: user interface style (int)
  • first_name: first name (str)
  • last_name: last name (str)
  • email: email (str)
  • website: website (str)

User-defined Profile Reference

  • Custom field(s) in user profile can be added. This is useful, for example, in multi-company environment.
  • System configuration
  • Must be valid JSON syntax (json.org)
  • String must be double-quoted (between " and ")
  • No trailling comma in list
  • Python list
  • Each member in list, must be list of 4 members:
    • field name (underscore and alphanumeric only)
    • field label
    • reference (please refer to reference in FORM CODE REFERENCE or REPORT CODE REFERENCE)
    • default or initial value
  • Field(s) in user-defined profile will always be saved as str. Conversion might be needed.
  • In Form/Report/Query, user-defined profile can be read using sqliteboy_x_profile or sqliteboy_x_my function
  • Example:
[
  [
     "company",
     "Company",
     "select id as a, name as b from company",
     0
  ],
  [
     "sqliteboy",
     "Happy SQLiteBoy user?",
     [ [0,"no :("], [1,"yes :)"] ],
     1
  ],
  [
     "signature",
     "Signature",
     0,
     ""
  ]
]
  • Example using sqliteboy_x_profile / sqliteboy_x_my function:
select sqliteboy_x_my('company')

select sqliteboy_x_profile('admin', 'company')

select sqliteboy_as_integer(sqliteboy_x_profile('admin', 'company'))

Python Handler Reference

  • Python handler eases the integration with external system (for example: ERP system). Python handler also could be useful in, for example, complex database operation, reading from/writing to external devices, etc.
  • Availability:
    • Form
    • Report
  • All handlers must be put in sqliteboy_user.py, in current working directory.
  • Form:
    • Only one handler is allowed for each form. If provided, it will be called, automatically.
    • function name: form_<form_name>. Please rename this function, if you need to temporarily disable python handler for that form.
    • function arguments:
      • user: current user (str)
      • db: database connection object (web.py database object)
      • parsed: parsed form data (list)
      • user_data: list of user input (list)
      • data: additional data (helper functions, UDFs, modules, etc) (dict)
    • Function must return an integer. To get this value, developer can use $python_handler in custom form message. If there is exception, -1 will be assigned to $python_handler.
    • Please note that python handler is an additional action, called at the end. It will not replace the default/built-in form handler.
    • Integration with external system, for example, can be done by reading user input value from SQLiteBoy, and writing to external system
  • Report:
    • Only one handler is allowed for each report. If provided, it will be called, automatically.
    • function name: report_<report_name>. Please rename this function, if you need to temporarily disable python handler for that report.
    • function arguments:
      • user: current user (str)
      • db: database connection object (web.py database object)
      • parsed: parsed report data (list)
      • user_data: list of user input (list)
      • data: additional data (helper functions, UDFs, modules, etc) (dict)
    • Function may return an integer, list of dict or web.py database query result
    • Please note that python handler is a replacement to the sql query. Return value of function will be used as report result.
    • Integration with external system, for example, can be done by reading from external system