Updates

.readthedocs.yaml

@@ -0,0 +1,23 @@
+# .readthedocs.yaml
+# Read the Docs configuration file
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+
+# Required
+version: 2
+formats: all
+
+# Set the version of Python and other tools you might need
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3.11"
+
+# Build documentation in the docs/ directory with Sphinx
+sphinx:
+  configuration: docs/conf.py
+
+# We recommend specifying your dependencies to enable reproducible builds:
+# https://docs.readthedocs.io/en/stable/guides/reproducible-builds.html
+#python:
+#  install:
+#  - requirements: requirements.txt

Dockerfile

@@ -0,0 +1,26 @@
+FROM python:3.8-slim
+
+ENV DEBIAN_FRONTEND noninteractive
+RUN apt-get update && apt-get upgrade -y --no-install-recommends
+RUN apt-get install -y --no-install-recommends git libreoffice
+
+RUN git clone https://github.com/jam-py/jam-py.git /opt/jam-py
+WORKDIR /opt/jam-py
+RUN pip install .
+
+# RUN pip install jam.py==5.4.136
+# RUN mkdir -p /opt/jam-py
+# COPY demo /opt/jam-py/demo
+
+ENV PORT 8080
+ENV LOG_LEVEL info
+
+# remove debian stuff
+RUN apt-get autoremove -y && \
+    rm -rf /var/cache/apt/archives /var/lib/apt/lists/* /tmp/* /var/tmp/*
+
+RUN useradd -ms /bin/bash -d /app jampy
+
+COPY entrypoint.sh /opt/entrypoint.sh
+RUN chmod u+x /opt/entrypoint.sh
+ENTRYPOINT "/opt/entrypoint.sh"

README.rst

@@ -21,6 +21,9 @@
 Jam.py Application Builder (web framework)
 ================
 
+No longer actively developed, please use https://github.com/jam-py-v5/jam-py
+=================================================================================
+
 
 From an idea of a web database application to a live website in no time, for free
 =================================================================================
@@ -49,18 +52,20 @@ Please watch the
 `Jam.py framework applications <https://youtu.be/qkJvGlgoabU>`_  video
 to see some applications written in Jam.py.
 
-More demos on Heroku:
-
-* `The RedHat Satellite 5.x Dashboard utility Demo <https://redhatsatellite.herokuapp.com>`_
-* `The Postfix email aliases utility Demo <https://jampy-aliases.herokuapp.com>`_
-* `The Samba Shares utility Demo <https://sambashares.herokuapp.com>`_
-
-`Here <https://youtu.be/pQYer6po820>`_ is a video showing how to publish a
-Jam.py application from GitHub repo on Heroku
+More demos on PythonAnywhere:
 
-Demo on PythonAnywhere:
+* `SAP Theme Demo <https://jampyapp.pythonanywhere.com/>`_
+* `Personal Account Ledger from MS Access template <https://msaccess.pythonanywhere.com/>`_
+* `NorthWind Traders from MS Access template (wip) <https://northwind.pythonanywhere.com/>`_
+* `The ERP POC Demo with Italian and English translations <https://sem.pythonanywhere.com/>`_
+* `Assets/Parts Application (wip, currently Jam V7 Demo) <https://jampy.pythonanywhere.com>`_
+* `Machine Learning (wip) <https://mlearning.pythonanywhere.com>`_
+* `Auto Parts Sales for Brazilian Market (Portuguese) <https://carparts.pythonanywhere.com>`_
+* `Resourcing and Billing Application from MS Access DB (wip) <https://resourcingandbilling.pythonanywhere.com>`_
+* `Job Positions tracking App from MS Access DB (wip) <https://positionstracking.pythonanywhere.com>`_
+* `Kanban/Tasks Application <https://kanban.pythonanywhere.com>`_
+* `Assets Inventory Application (wip) <https://assetinventory.pythonanywhere.com>`_
 
-* `Jam.py Assets/Parts Application (wip) <https://jampy.pythonanywhere.com>`_
 
 Jam.py alternative site:
 
@@ -96,14 +101,14 @@ the client utilizes `JavaScript <https://developer.mozilla.org/en/docs/Web/JavaS
 * Open framework. You can use any Javascript/Python libraries.
 
 * Rich, informative reports. Band-oriented report generation based on
-  `LibreOffice <https://www.libreoffice.org/">`_ templates.
+  `LibreOffice <https://www.libreoffice.org/>`_ templates.
 
 * Charts. You can use free `jsCharts <http://www.jscharts.com/>`_ library
   or any javascript charting library to create charts to represent and analyze your application data.
 
 * Allows to save audit trail/change history made by users
 
-* Predifined css themes.
+* Predefined css themes.
 
 * Develop and test locally update remotely. Jam.py has Export and Import
   utilities that allow developer to store all metadata (database structures,

builder/js/app_builder.js

@@ -1167,7 +1167,8 @@ function Events3() { // sys_items
 				'client_module',
 				'server_module',
 				'divider',
-				'report_params'
+				'report_params',
+				'privileges'
 			]);
 		}
 	}
@@ -1694,7 +1695,7 @@ function Events3() { // sys_items
 			item = field.owner
 		if (item.is_new() && item.type_id.value != item.task.item_types.DETAIL_TYPE) {
 			if (field.field_name == 'f_item_name' && !item.f_virtual_table.value &&
-				item.type_id.value !== item.task.item_types.ITEMS_TYPE) {
+				!task._manual_update && item.type_id.value !== item.task.item_types.ITEMS_TYPE) {
 				names = item.task.server('get_new_table_name', field.value);
 				item.f_table_name.value = names[0];
 				if (item.task.db_options.NEED_GENERATOR) {
@@ -5338,13 +5339,14 @@ function Events26() { // app_builder.catalogs.sys_items.sys_fields
 	}
 
 	function on_edit_form_shown(item) {
-		var caption = 'Field Editor';
-
+		let caption = 'Field Editor',
+			link = task.help_badge('http://jam-py.com/docs/admin/items/field_editor_dialog.html');
 		if (item.f_field_name.value) {
-			item.edit_form.find('h4.modal-title').html(caption + ' <span class="editor-title">' + item.f_field_name.value + '</span>');
+			item.edit_form.find('h4.modal-title')
+				.html(caption + ' <span class="editor-title">' + item.f_field_name.value + '</span>' + link);
 		}
 		else {
-			item.edit_form.find('h4.modal-title').html(caption);
+			item.edit_form.find('h4.modal-title').html(caption + link);
 		}
 	}
 

demo/static/img/.gitignore

@@ -0,0 +1 @@
+JAMPY_Readme.gif

docs/.readthedocs.yaml

@@ -0,0 +1,23 @@
+# .readthedocs.yaml
+# Read the Docs configuration file
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+
+# Required
+version: 2
+formats: all
+
+# Set the version of Python and other tools you might need
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3.11"
+
+# Build documentation in the docs/ directory with Sphinx
+sphinx:
+  configuration: conf.py
+
+# We recommend specifying your dependencies to enable reproducible builds:
+# https://docs.readthedocs.io/en/stable/guides/reproducible-builds.html
+#python:
+#  install:
+#  - requirements: requirements.txt

docs/_static/jquery.js

@@ -3169,7 +3169,7 @@ jQuery.Callbacks = function( options ) {
 				return this;
 			},
 			// Check if a given callback is in the list.
-			// If no argument is given, return whether or not list has callbacks attached.
+			// If no argument is given, return whether or not list has callbacks attachd.
 			has: function( fn ) {
 				return fn ? jQuery.inArray( fn, list ) > -1 : !!( list && list.length );
 			},
@@ -4783,23 +4783,23 @@ if ( !support.focusinBubbles ) {
 		jQuery.event.special[ fix ] = {
 			setup: function() {
 				var doc = this.ownerDocument || this,
-					attaches = data_priv.access( doc, fix );
+					attachs = data_priv.access( doc, fix );
 
-				if ( !attaches ) {
+				if ( !attachs ) {
 					doc.addEventListener( orig, handler, true );
 				}
-				data_priv.access( doc, fix, ( attaches || 0 ) + 1 );
+				data_priv.access( doc, fix, ( attachs || 0 ) + 1 );
 			},
 			teardown: function() {
 				var doc = this.ownerDocument || this,
-					attaches = data_priv.access( doc, fix ) - 1;
+					attachs = data_priv.access( doc, fix ) - 1;
 
-				if ( !attaches ) {
+				if ( !attachs ) {
 					doc.removeEventListener( orig, handler, true );
 					data_priv.remove( doc, fix );
 
 				} else {
-					data_priv.access( doc, fix, attaches );
+					data_priv.access( doc, fix, attachs );
 				}
 			}
 		};
@@ -5485,7 +5485,7 @@ function actualDisplay( name, doc ) {
 	var style,
 		elem = jQuery( doc.createElement( name ) ).appendTo( doc.body ),
 
-		// getDefaultComputedStyle might be reliably used only on attached element
+		// getDefaultComputedStyle might be reliably used only on attachd element
 		display = window.getDefaultComputedStyle && ( style = window.getDefaultComputedStyle( elem[ 0 ] ) ) ?
 
 			// Use of this method is a temporary fix (more like optimization) until something better comes along,

docs/admin/accept_string.txt

@@ -11,7 +11,7 @@ Value	          Description
 file_extension	Specify the file extension(s) (e.g: .gif, .jpg, .png, .doc)
 audio/*	        All sound files
 video/*	        All video files
-image/*	        Aall image files
+image/*	        All image files
 ==============  ===========  
 
 For example::

docs/admin/code_editor.txt

@@ -18,7 +18,7 @@ By clicking on these buttons the Code Editor for the client or server
 module of the item will be opened. 
 (See :doc:`Working with modules </programming/modules>`)
 
-To the left of the **Edior** there is an information pane with four tabs: 
+To the left of the **Editor** there is an information pane with four tabs: 
 
 * **Module** - this tab displays all events and functions defined in the editor, 
   double-click on one of them to move the cursor to the proper function. 
@@ -39,11 +39,11 @@ Alt-F to display the
 
 Jam.py uses the `ace editor`_  editor to implement its code editor.
 
-`Hear are keyboard shortcuts for the ace editor`_.
+`Here are keyboard shortcuts for the ace editor`_.
 
 .. _ace editor: https://ace.c9.io
 
-.. _Hear are Keyboard Shortcuts for the ace editor: https://github.com/ajaxorg/ace/wiki/Default-Keyboard-Shortcuts
+.. _Here are Keyboard Shortcuts for the ace editor: https://github.com/ajaxorg/ace/wiki/Default-Keyboard-Shortcuts
 
 .. image:: _images/editor.png
 	:align: center

docs/admin/groups/item_group_editor.txt

@@ -27,7 +27,7 @@ The upper part of the **Item Group Editor** have the following fields:
   for items that the group will own. You have to create this field first, see below 
 
 In the center part of the **Item Group Editor** dialog there is a table 
-containing a list of fields, defined for the item. Thsese fields are 
+containing a list of fields, defined for the item. These fields are 
 :doc:`common </programming/data/common_fields>`
 to all items the group will own. 
 

docs/admin/groups/table_group_editor.txt

@@ -40,7 +40,7 @@ The upper part of the **Detail Group Editor** have the following fields:
   create this field first, see below 
 
 In the center part of the **Detail Group Editor** dialog there is a table 
-containing a list of fields, defined for the item. Thsese fields are 
+containing a list of fields, defined for the item. These fields are 
 :doc:`common </programming/data/common_fields>`
 to all items the group will own. 
 

docs/admin/index.txt

@@ -17,7 +17,7 @@ To run the Application builder go to a Web browser and type in the browser addre
 
 On the left side of the Application builder page there is a panel that contains the 
 project tree. When you select any node of the project tree, as a rule, its 
-content will be opend in the central part of the page, and the bottom and right 
+content will be opened in the central part of the page, and the bottom and right 
 side of the page may have buttons that allow you to modify the content.
 
 To see the changes made in Application builder go to the Project page and reload it. 

docs/admin/intergation_with_existing_database.txt

@@ -1,5 +1,5 @@
 ==================================
-Intergation with existing database
+Integration with existing database
 ==================================
 
 You can use Jam.py with existing database, that is supported by the framework.
@@ -30,17 +30,17 @@ You can use Jam.py with existing database, that is supported by the framework.
   You can import a subset of fields in the table.
 
   Before saving, specify the primary key field for the item and generator name, 
-  if nessesary.
+  if necessary.
 
 * After saving the imported item, go to the project page and check how it is 
   displayed.
 
-* After importing serveral tables, you can specify lookup fields (in DB manual mode).     
+* After importing several tables, you can specify lookup fields (in DB manual mode).     
 
 
 .. note::
 
-    Please, do be very carefull when performing this operations.
+    Please, do be very careful when performing this operations.
 
     When DB manual mode is removed any changes to the item will be reflected in
     the corresponding DB table. If you delete the item, the table will be dropped
@@ -57,4 +57,4 @@ You can use Jam.py with existing database, that is supported by the framework.
 .. note::
 
     This is a new feature, so if you have some comments, suggestions or found
-    some bugs please send a message.
+    some bugs please send a message.

docs/admin/items/field_editor_dialog.txt

@@ -91,7 +91,7 @@ Interface tab
 * **TextArea** - for text fields if this attribute is set the textarea element
   will be created for these fields in the :doc:`Edit Form Dialog <edit_form_dialog>`
 
-* **Do not sanitize** - set this attributeto prevent default sanitizing of the 
+* **Do not sanitize** - set this attribute to prevent default sanitizing of the 
   field value, see :doc:`Sanitizing </admin/sanitizing>`
 
 * **Alignment** - determines the alignment of text in the controls that display 
@@ -148,8 +148,8 @@ Interface tab for Image field
 * **Edit width**  - specifies the width of an image in pixels when it is displayed
   in the edit form. If it not specified the width is auto
 
-* **Edit height**  - specifies the heigth of an image in pixels when it is displayed
-  in the edit form. If it not specified the heigth is auto
+* **Edit height**  - specifies the height of an image in pixels when it is displayed
+  in the edit form. If it not specified the height is auto
 
 * **Capture from camera** - if this checkbox is set, the user will be able to 
   capture image from camera.
@@ -159,4 +159,4 @@ Interface tab for Image field
   Hold Ctrl key and double-click the image to clear the placeholder image.
 
 
-
+

docs/admin/items/item_editor_dialog.txt

@@ -80,7 +80,7 @@ In the bottom-right corner of the Dialog form there are two buttons:
 * **OK** - click this button to save change you made. If the **Virtual table** 
   checkbox is not checked and **DB manual update** parameter in the project 
   :doc:`Database Dialog</admin/project/database>` is not set, the application
-  will generate and execute SQL quesry to update the item table in the project
+  will generate and execute SQL query to update the item table in the project
   Database (changes made to the fields will be applied to the table). 
 
 * **Cancel** - click this buttons to cancel the operation.

docs/admin/project/database.txt

@@ -7,7 +7,7 @@ Database
 	:align: center
 	:alt: Database dialog
 
-In this dialog project database pararameters are displayed. When they have been 
+In this dialog project database parameters are displayed. When they have been 
 changed and OK button is clicked, the Application builder will check connection 
 to the database and if it failed to connect an error will be displayed.
 
@@ -23,7 +23,7 @@ automatically modified. For example, if we add a new field to some item in the
 is checked, no modifications to the database tables are made. 
 
 .. note::
-    Please be very carefull when using this option.
+    Please be very careful when using this option.
 
 Examples of database setups
 ===========================

docs/admin/project/parameters.txt

@@ -24,7 +24,7 @@ On the General tab, you can specify general parameters of the project:
   :doc:`Roles </admin/roles>`
   ). 
 
-* **Debugging** - if this checkbox is checked, the Werkzeug libarary bebugger will
+* **Debugging** - if this checkbox is checked, the Werkzeug library debugger will
   be invoked when an error on the server occurs.
 
 * **Language** - use it to open Language Dialog. See 
@@ -72,7 +72,7 @@ On the General tab, you can specify general parameters of the project:
   :doc:`importing project metadata <metadata_file>`
   , 
   otherwise it waits for 5 minutes or until all previous request 
-  to the serverin the current process will be processed.
+  to the server in the current process will be processed.
 
 * **Delete reports after (hours)** - if a value is specified the generated 
   reports that are located in the static/reports folder will be deleted after
@@ -87,7 +87,7 @@ On the General tab, you can specify general parameters of the project:
 
 .. note::
    When **Connection pool size** or **Persistent connection** parameters are 
-   changed, the server applicaton must be restarted for changes to take effect.
+   changed, the server application must be restarted for changes to take effect.
 
 
 Interface tab