Difference between revisions of "LavishScript"

From Lavish Software Wiki
Jump to navigation Jump to search
 
(23 intermediate revisions by 2 users not shown)
Line 2: Line 2:
 
LavishScript is a command shell and fully-featured scripting engine.  Its goal is to be an easy to learn (very few syntactical rules, as few operators as possible, and so on) command-based language.  It is [http://searchwebservices.techtarget.com/sDefinition/0,290660,sid26_gci212681,00.html object-oriented] and [http://whatis.techtarget.com/definition/0,,sid9_gci213058,00.html strongly typed].  It is designed to be embedded, and interfaces directly with native system data.
 
LavishScript is a command shell and fully-featured scripting engine.  Its goal is to be an easy to learn (very few syntactical rules, as few operators as possible, and so on) command-based language.  It is [http://searchwebservices.techtarget.com/sDefinition/0,290660,sid26_gci212681,00.html object-oriented] and [http://whatis.techtarget.com/definition/0,,sid9_gci213058,00.html strongly typed].  It is designed to be embedded, and interfaces directly with native system data.
  
LavishScript is designed with the idea that most scripting languages munge too many extra rules and operators to do different things.  We believe that simplicity is key.  Not necessarily simplicity in the range of available functionality, but simplicity in the structure of the language itself.  The complete [[LavishScript:Syntax|syntax for commands and data sequences]] is defined [[LavishScript:Syntax|here]].  [[LavishScript:Script Syntax|Script structure]] is also quite simple, and is defined [[LavishScript:Script Syntax|here]].
+
LavishScript is designed with the idea that most scripting languages munge too many extra rules and operators to do different things.  We believe that simplicity is key.  Not necessarily simplicity in the range of available functionality, but simplicity in the structure of the language itself.  The complete [[LavishScript:Command_Syntax|syntax for commands]] is defined [[LavishScript:Command_Syntax|here]].  [[LavishScript:Language_and_Engine_Overview|Script structure]] is also quite simple, and is defined [[LavishScript:Language_and_Engine_Overview|here]].
  
 
LavishScript is generally designed with non-programmers in mind (though logical thinking helps...).  LavishScript isn't meant to be a replacement for other general-purpose languages, it is simply meant to be easy to use.  If a "real" programming language is what you're looking for, maybe you should be using one instead of a scripting language, right?  Most simple tasks can be completed with minimal research, but of course developing scripts will require some learning.
 
LavishScript is generally designed with non-programmers in mind (though logical thinking helps...).  LavishScript isn't meant to be a replacement for other general-purpose languages, it is simply meant to be easy to use.  If a "real" programming language is what you're looking for, maybe you should be using one instead of a scripting language, right?  Most simple tasks can be completed with minimal research, but of course developing scripts will require some learning.
Line 17: Line 17:
  
 
== Getting Started ==
 
== Getting Started ==
We are reworking the documentation of LavishScript. In the meantime, the existing documentation is found under "Older information". It is still generally valid and correct information, just being re-done!
+
* [https://github.com/LavishSoftware/LERN LavishScript Example Repository Node (LERN)] is a great resource full of tutorials to help LavishScript beginners.
 +
* The [https://github.com/LavishSoftware/LS1-Platform-Specifications LS1 Platform Specifications] is kept up-to-date and include LavishScript API references for [https://github.com/LavishSoftware/LS1-Platform-Specifications/blob/master/Reference/IS-Uplink.md Inner Space Uplink], [https://github.com/LavishSoftware/LS1-Platform-Specifications/blob/master/Reference/IS-Session.md Inner Space Sessions], [https://github.com/LavishSoftware/LS1-Platform-Specifications/blob/master/Reference/JMB-Uplink.md Joe Multiboxer Uplink] and [https://github.com/LavishSoftware/LS1-Platform-Specifications/blob/master/Reference/JMB-Session.md Joe Multiboxer Sessions].
  
 
=== Using LavishScript consoles ===
 
=== Using LavishScript consoles ===
* Command Syntax
+
* [[LavishScript:Command Syntax|Command Syntax]]
* Using "data sequences"
+
* [[LavishScript:Installing and Running Scripts|Installing and Running Scripts]]
* Running Scripts
+
* [[LavishScript:Installing and Loading Modules|Installing and Loading Modules]]
* Loading Modules
+
* Using "[[LavishScript:Data Sequences|Data Sequences]]"
  
=== Developing Scripts ===
+
=== Developing in LavishScript ===
* Engine Overview
+
* [[LavishScript:Language and Engine Overview|Language and Engine Overview]]
** Scheduling
+
** [[LavishScript:Language and Engine Overview#Preprocessor|Preprocessor]]
* Language Overview
+
** [[LavishScript:Language and Engine Overview#Comments|Comments]]
** Preprocessor
+
** [[LavishScript:Language and Engine Overview#Keywords|Keywords]]
** Comments
+
** [[LavishScript:Language and Engine Overview#Functions|Functions]]
** Keywords
+
** [[LavishScript:Language and Engine Overview#Control Structures|Control Structures]]
** Control Structures
+
** [[LavishScript:Language and Engine Overview#Variables|Variables]]
* Object Types
+
** [[LavishScript:Mathematical_Formulae|Math operators]]
** Object Operations (Data Sequences)
+
* [[LavishScript:Commands|Commands]]
*** Methods
+
* [[LavishScript:Object Types|Object Types]]
*** Members
+
** [[LavishScript:Data_Sequences|Object Operations]] (Data Sequences)
*** Indices
+
*** [[LavishScript:Data_Sequences#Methods|Methods]]
*** Type-casting
+
*** [[LavishScript:Data_Sequences#Members|Members]]
** Built-in Object Types
+
*** [[LavishScript:Data_Sequences#Indices|Indices]]
*** Lists and iteration
+
*** [[LavishScript:Data_Sequences#Type-casting|Type-casting]]
** Script-defined Object Types
+
*** Reduction (To Text)
 +
** [[LavishScript:Object_Types#Built-in_Object_Types|Built-in Object Types]]
 +
*** [[LavishScript:Object_Types#Containers and iteration|Containers]]
 +
** [[LavishScript:Script-Defined_Object_Types|Script-Defined_Object_Types]]
 +
** [[LavishScript:Object References and Persistence|Object References and Persistence]]
 
* Objects
 
* Objects
** Built-in Objects
+
** [[LavishScript:Top-Level_Objects|Built-in Objects]]
 
** Variables
 
** Variables
* Functions
+
* [[LavishScript:Functions|Functions]]
** Atomic Functions (atoms)
+
** [[LavishScript:Atoms|Atomic Functions (atoms)]]
* Special Functions
+
* [[LavishScript:Events|Events]]
* Events
+
* [[LavishScript:Object Queries|Object Queries]]
* Triggers
+
* [[LavishScript:MetaScripts|MetaScripts]]
 +
* [[LavishScript:Triggers|Triggers]]
 +
* [[LavishScript:Tasks|Tasks]]
 +
* [[LavishScript:Command Queue|Command Queue]]
  
 
=== Developing Modules ===
 
=== Developing Modules ===
 
* LavishScript Module Development Kit
 
* LavishScript Module Development Kit
 +
 +
Download here: http://www.lavishsoft.com/downloads.php
  
 
== Older information ==
 
== Older information ==

Latest revision as of 16:10, 21 September 2022

Overview

LavishScript is a command shell and fully-featured scripting engine. Its goal is to be an easy to learn (very few syntactical rules, as few operators as possible, and so on) command-based language. It is object-oriented and strongly typed. It is designed to be embedded, and interfaces directly with native system data.

LavishScript is designed with the idea that most scripting languages munge too many extra rules and operators to do different things. We believe that simplicity is key. Not necessarily simplicity in the range of available functionality, but simplicity in the structure of the language itself. The complete syntax for commands is defined here. Script structure is also quite simple, and is defined here.

LavishScript is generally designed with non-programmers in mind (though logical thinking helps...). LavishScript isn't meant to be a replacement for other general-purpose languages, it is simply meant to be easy to use. If a "real" programming language is what you're looking for, maybe you should be using one instead of a scripting language, right? Most simple tasks can be completed with minimal research, but of course developing scripts will require some learning.

LavishScript allows any number of persistent scripts simultaneously, each of which are given a time slice per "pulse". Pulse timing is defined by the application (such as Fury or Inner Space), so each pulse may be defined as once per frame in a game (as in frames per second), or may simply be as soon as possible after the previous pulse, or can be distributed evenly at specific intervals. The priority level, dictating how much of a time slice is given per pulse, for a script may be set using the Turbo command.

Geek Notes

  • LavishScript is interpreted, object-oriented, strongly typed, reflective, imperative, and dynamic
  • LavishScript has a pre-emptive scheduler to process scripts, and additionally supports atomic functions, which execute to completion without being scheduled. The scheduler runs scripts during explicitly stated times (such as when a game redraws its display)
  • LavishScript can access internal (e.g. script-defined variables and objects) and external data (e.g. game state information) via the same object system
  • References to objects exist only within explicitly defined data sequences, thus allowing external objects to be lost gracefully while a script is waiting for a timeslice (e.g. a character in a game may disappear before the next timeslice, and this will not cause synchronization problems)
  • Multiple-use expressions (such as data sequences to be evaluated each frame for display on a user interface) can be pre-parsed to improve performance
  • Internally, LavishScript uses C++ objects to perform the scripting duties. By design, every command takes the same form as a standard C console application (i.e. int main(int argc, char *argv[])), as does every built-in variable (called Top-Level Objects) to a lesser extent. This means that developing a LavishScript module is just as painless as developing a console app

Getting Started

Using LavishScript consoles

Developing in LavishScript

Developing Modules

  • LavishScript Module Development Kit

Download here: http://www.lavishsoft.com/downloads.php

Older information

LavishScript encompasses these basic parts

Extending LavishScript

See Also