VERSION: 0.16.0 - Error type, catch statement, default shared params, BSON.

- Please, see changelog.txt for commit details and changes
  and also have a look into Deprecation_and_Breaking_Changes.txt.

Author: Florian Thake

COPYRIGHT.TXT

@@ -1,6 +1,6 @@
 Except where otherwise noted all files included are copyrighted by Florian Thake.
 
-Copyright (C) 2024 Florian Thake <contact |at| tea-age.solutions>.
+Copyright (C) 2025 Florian Thake <contact |at| tea-age.solutions>.
 
 
 The TeaScript C++ Library 

Deprecation_and_Breaking_Changes.txt

@@ -3,6 +3,14 @@ TeaScript Breaking Changes in the actual release
 
     Changes in TeaScript language
     ------------------------------------
+    Introduced distinct Error type for a clean error handling.
+    Added catch statement for easy error handling similar as in Zig.
+    examples (assuming _strtonum returns an Error on error):
+    def number := _strtonum( "abc" ) catch 2 // on error number is 2
+    def number := _strtonum( "abc" ) catch( err ) return err // on error early return with err
+    see examples_v0.16.tea ore corelibrary_test06.tea for more examples.
+    
+    
     Function parameters without assign specifier are shared assign by default now.
     Furthermore, explicit shared function parameters without 'const' or 'def' specifier are set
     implicit to 'auto' now. They will be either 'const' or 'def' depending on the rhs argument/passed parameter.
@@ -37,7 +45,17 @@ TeaScript Breaking Changes in the actual release
     strtrim() first parameter was a const @= by accident. changed to correct def @=.
     Now the function will not take a const string as input parameter anymore!
     This worked because of a const correct bug, which has been fixed now (see C++ API level breaking changes below).
-
+    
+    Following functions are now returning Error instead of Bool(false):
+    _strtonum/_strtonumex
+    to_i64/to_f64
+    _strfromascii 
+    read[text]file
+    read[toml|json]file
+    read[toml|json]string
+    write[toml|json]string
+    read/writebsonbuffer
+    all _buf_get_x functions
 
     Changes on C++ API level
     ------------------------------------
@@ -57,6 +75,8 @@ TeaScript Breaking Changes in the actual release
     tuple::foreach_element/foreach_named_element are working now with either a const ValueObject or a mutable one.
     If the functor takes mutable objects all nested const objects (if any) will be skipped.
     This is a breaking change but the old behavior was faulty as it allowed to access const elements as mutable reference.
+    
+    fixed typo in Collection::RemoveValueByKeyWithPlaceholder()
 
 
     Visibility of Core Library functions
@@ -87,4 +107,7 @@ TeaScript list of deprecated parts
 
     class LibraryFunction0<> to LibraryFunction5<> are deprecated now.
     Please, use the new and generic one fits for all LibraryFunction<> instead.
+    
+    _f64toi64 is now deprecated.
+    Please, use the cast operator 'as' instead (recommended) (or alternatively to_i64).
 

TeaScript_SyntaxHighlighting_DarkMode_Notepad++.xml

@@ -24,8 +24,8 @@
             <Keywords name="Folders in comment, open"></Keywords>
             <Keywords name="Folders in comment, middle"></Keywords>
             <Keywords name="Folders in comment, close"></Keywords>
-            <Keywords name="Keywords1">if else repeat forall in is as typename typeof func def const undef is_defined debug with stop loop return mod not or and false true suspend yield _Exit</Keywords>
-            <Keywords name="Keywords2">TypeInfo i64 f64 u8 u64 Bool String Function Tuple IntegerSequence NaV Number Const Buffer</Keywords>
+            <Keywords name="Keywords1">if else repeat forall in is as typename typeof func def const undef is_defined debug with stop loop return mod not or and false true suspend yield _Exit catch</Keywords>
+            <Keywords name="Keywords2">TypeInfo i64 f64 u8 u64 Bool String Function Tuple IntegerSequence NaV Number Const Buffer Error</Keywords>
             <Keywords name="Keywords3"></Keywords>
             <Keywords name="Keywords4"></Keywords>
             <Keywords name="Keywords5"></Keywords>

TeaScript_SyntaxHighlighting_Notepad++.xml

@@ -24,8 +24,8 @@
             <Keywords name="Folders in comment, open"></Keywords>
             <Keywords name="Folders in comment, middle"></Keywords>
             <Keywords name="Folders in comment, close"></Keywords>
-            <Keywords name="Keywords1">if else repeat forall in is as typename typeof func def const undef is_defined debug with stop loop return mod not or and false true suspend yield _Exit</Keywords>
-            <Keywords name="Keywords2">TypeInfo i64 f64 u8 u64 Bool String Function Tuple IntegerSequence NaV Number Const Buffer</Keywords>
+            <Keywords name="Keywords1">if else repeat forall in is as typename typeof func def const undef is_defined debug with stop loop return mod not or and false true suspend yield _Exit catch</Keywords>
+            <Keywords name="Keywords2">TypeInfo i64 f64 u8 u64 Bool String Function Tuple IntegerSequence NaV Number Const Buffer Error</Keywords>
             <Keywords name="Keywords3"></Keywords>
             <Keywords name="Keywords4"></Keywords>
             <Keywords name="Keywords5"></Keywords>

changelog.txt

@@ -6,8 +6,57 @@ NOTE: The dates are not the release dates, but a last commit date.
 
 
 ================
-VERSION 0.16.0 (not released yet, pre-release)
-================
+VERSION 0.16.0, Sa Dec 20 12:24:43 2025
+================
+    VERSION: 0.16.0 - Error type, catch statement, default shared params, BSON.
+
+    EXAMPLES: added example_v0.16.tea for demo catch, Error and bson.
+    - added bson test to corelibrary_test05.tea
+    COLLECTION: fixed typo in RemoveValueByKeyWithPlaceholder().
+    ARITHMETIC: (optimized) don't check for overflow if types are same in Convert function.
+
+    CORELIB: raised API level to 1 (because changed to Error return).
+    CORELIB: made _f64toi64 DEPRECATED!
+    - removed all internal usage of _f64toi64.
+
+    CORELIB (BREAKING!): changed all _buf_get_x functions to return Error instead of Bool(false).    
+    CORELIB (BREAKING!): clean and proper Error handling for more functions which
+    ... returned Bool(false) on error but has a different type as Bool on success.
+    ... They will now return the new Error type on error.
+    - changed functions: _strfromascii, read[text]file, read[toml|json]file,
+      read[toml|json]string, write[toml|json]string, read/writebsonbuffer
+
+    CORELIB (BREAKING!): _strtonum/_strtonumex now return an Error instead of a Bool(false)
+    CORELIB (BREAKING!): changed to_i64/to_f64 return an Error instead of Bool(false).
+    - improved to_number() for Number input (and Error input)
+
+    TSVM: added TSVM instruction Catch for execute Error path if Error/NaV is on top stack.
+    TSVM: added TSVM instruction Swap for swapping top and top-1
+    FIXED: (in TSVM) stack cleanup for some early return cases, e.g. def x := 10 + return 123
+    ... needed for def n := foo() catch return -1  /  def m := baz() catch( err ) { return err }
+    FIXED: (in TSVM) broken stack after debug operator.
+
+    CORELIB: added _error_[get_code/get_name/get_message], make_runtime_error
+    TEST: added corelibrary_test06.tea and v0.16 test in test01
+    TEASCRIPT: as operator: added cast from NaV to Error, don't cast if type is same already
+    - as operator: Error cannot be casted and stays as Error.
+    MISC: Added syntaxhighlighting for catch and Error.
+
+    TEASCRIPT: added catch statement for easy error handling similar as in Zig.
+    - examples (assuming _strtonum returns an Error on error):
+      def number := _strtonum( "abc" ) catch 2 // on error number is 2
+      def number := _strtonum( "abc" ) catch( err ) return err // on error early return with err
+
+    TEASCRIPT: Introduced distinct Error type for a clean error handling.
+    - Errors consist of an error code and a message.
+    - Errors can be created via make_runtime_error(s) or simply cast a String into Error.
+    - Errors can be concatenated to strings and in boolean contexts they evaluate to false.
+    - For the time being all Error related classes and functions are considered EXPERIMENTAL.
+    PROJ: split class TypeInfo and TypePtr into new TypeIinfo.hpp.
+
+    HOST: added :inspect function command printing AST or TSVM instruction of a function.
+
+    BUILD: Support VS 17.14 by targeting latest installed WinSDK
     BUILD: Support Visual Studio 2022 17.13 with C++23 preview.
     FIX: C++23 - Printing without libfmt. Use std::print again instead of std::vprint_unicode.
     ... On Linux it just works, 
@@ -19,6 +68,10 @@ VERSION 0.16.0 (not released yet, pre-release)
     - added readbsonbuffer and writebsonbuffer to core library for ...
     ... Tuple <--> BSON Buffer conversion.
 
+    HOST: added ascii/uttf-8 art logo to welcome screen of interactive shell.
+    - can be suppressed with --no-logo
+    - fixed default eval mode for some implicit interactive shell launches, e.g., -i or --silent.
+
     CLEAN: finally removed deprecated CoreLibrary::ExitScript().
     - Please, use _Exit val instead or directly throw teascript::control::Exit_Script from C++.
 
@@ -63,6 +116,7 @@ VERSION 0.16.0 (not released yet, pre-release)
     ASTNODE: as operator - optimized the ifs to a switch.
     HOST: changed copyright year to 2025
 
+
 ================
 VERSION 0.15.1, Sun Nov 03 13:25:32 2024
 ================

demo/compile_clang.sh

@@ -1,11 +1,19 @@
 #   -stdlib=libc++ 
 #   -stdlib=libstdc++
 #
-#   for color + format support: -I../../fmt/fmt-11.0.2/include/
-#   for TOML support: -I../../tomlplusplus/tomlplusplus-3.4.0/include/
+#   for color + format support: -I../../fmt/fmt-11.1.4/include/
+#   for TOML support:           -I../../tomlplusplus/tomlplusplus-3.4.0/include/
+#   extensions include          -I../extensions/include/
+#   modules include             -I../modules/include/
+#   nlohmann:                   -I../../nlohmann/nlohmann_3.11.3/include/
+#   Boost:                      -I../../boost_1_86_0/
+#   Rapid:                      -I../../rapidjson/include/
+#
+# example with webpreview enabled:
+# clang++-14 -std=c++20 -stdlib=libc++ -Wall -O2 -DNDEBUG -DTEASCRIPT_ENGINE_USE_WEB_PREVIEW=1 -I../modules/include/ -I../../fmt/fmt-11.1.4/include/ -I../include/ ../modules/source/Webpreview.cpp <other .cpp>
 
 clang++-14 -std=c++20 -stdlib=libc++ -Wall -O2 -DNDEBUG \
-           -I../../fmt/fmt-11.0.2/include/     \
+           -I../../fmt/fmt-11.1.4/include/     \
            -I../include/                       \
            suspend_thread_demo.cpp             \
            coroutine_demo.cpp                  \

demo/compile_gcc.sh

@@ -1,7 +1,15 @@
-# for color + format support: -I../../fmt/fmt-11.0.2/include/
-# for TOML support: -I../../tomlplusplus/tomlplusplus-3.4.0/include/
+# for color + format support: -I../../fmt/fmt-11.1.4/include/
+# for TOML support:           -I../../tomlplusplus/tomlplusplus-3.4.0/include/
+# extensions include          -I../extensions/include/
+# modules include             -I../modules/include/
+# nlohmann:                   -I../../nlohmann/nlohmann_3.11.3/include/
+# Boost:                      -I../../boost_1_86_0/
+# Rapid:                      -I../../rapidjson/include/
+#
+# example with webpreview enabled:
+# g++ -std=c++20 -Wall -O2 -DNDEBUG -DTEASCRIPT_ENGINE_USE_WEB_PREVIEW=1 -I../modules/include/ -I../../fmt/fmt-11.1.4/include/ -I../include/ ../modules/source/Webpreview.cpp <other .cpp>
 
-g++ -std=c++20 -Wall -O2 -DNDEBUG -I../../fmt/fmt-11.0.2/include/ -I../include/  \
+g++ -std=c++20 -Wall -O2 -DNDEBUG -I../../fmt/fmt-11.1.4/include/ -I../include/  \
     suspend_thread_demo.cpp           \
     coroutine_demo.cpp                \
     teascript_demo.cpp                \

demo/corelibrary_test05.tea

@@ -473,8 +473,7 @@ print_success( "ok.\n" )
 
 print( "testing bigger json structure ... " )
 
-{
-    const json_str := """"
+const json_str := """"
 {
   "type": "FeatureCollection",
   "features": [
@@ -513,6 +512,7 @@ print( "testing bigger json structure ... " )
 } 
 """"
 
+{
     def json := readjsonstring( json_str )
     TEST_EQ( typeof json, Tuple, "wrong json value type!" )
     _out( "\n" )
@@ -605,4 +605,31 @@ contributors = [
     print_warning( "\nTOML is not present! TOML test skipped!\n" )
 }
 
+print( "testing BSON extensions ... " )
+
+// You must use nlohmann as JSON adapter for have BSON support!
+def bson_present := is_defined readbsonbuffer and is_defined writebsonbuffer
+if( bson_present ) {
+    // first create some json tuple.
+    def json := readjsonstring( json_str )
+    // json tuple to bson
+    def bson_buffer := writebsonbuffer( json )
+    TEST_EQ( typeof bson_buffer, Buffer, "unexpected BSON type!" )
+    
+    //println( "\nContent:\n%(bson_buffer)" )
+    
+    def json_new := readbsonbuffer( bson_buffer )
+    TEST_EQ( typeof json_new, typeof json, "roundtrip failed! wrong type!" )
+    TEST_EQ( json_new, json, "roundtrip failed! not equal structure!" )
+    
+    print_success( "ok.\n" )
+} else {
+    print_warning( "\nBSON support is not present. BSON test skipped!\n")
+    print_warning( "You need ")
+    maybe_cprint( make_rgb( 210, 170, 90 ), "nlohmann::json" )
+    print_warning( " as JSON adapter, you have " )
+    maybe_cprint( make_rgb( 210, 170, 90 ), features.json_adapter % "\n" )
+}
+
+
 print_success( "=== TEST PASSED ===\n" )