add notice to files

Makefile

@@ -1,3 +1,16 @@
+#------------------------------------------------------------------------------
+#
+# luTango - Lua binding for Tango
+#
+# Copyright (C) 2023 Grzegorz Kowalski
+# See LICENSE for legal information
+#
+# file:		Makefile
+#
+# Build configuration
+#
+#------------------------------------------------------------------------------
+
 VERSION=$(shell git describe --tags --always --dirty)\:$(shell date +'%Y%m%d')
 
 SRC_DIR := src

src/core/global.h

@@ -1,3 +1,16 @@
+//-----------------------------------------------------------------------------
+//
+// luTango - Lua binding for Tango
+//
+// Copyright (C) 2023 Grzegorz Kowalski
+// See LICENSE for legal information
+//
+// file:		global.h
+//
+// Global values
+//
+//-----------------------------------------------------------------------------
+
 #ifndef __GLOBAL_H__
 #	define __GLOBAL_H__
 

src/core/logging/log.cpp

@@ -1,3 +1,16 @@
+//-----------------------------------------------------------------------------
+//
+// luTango - Lua binding for Tango
+//
+// Copyright (C) 2023 Grzegorz Kowalski
+// See LICENSE for legal information
+//
+// file:		log.cpp
+//
+// Logging facilities for core
+//
+//-----------------------------------------------------------------------------
+
 #include "log.h"
 
 void _log(LogLevel level, const char* fmt, const char* _file, const char* _func, int _line, ...)

src/core/logging/log.h

@@ -1,3 +1,16 @@
+//-----------------------------------------------------------------------------
+//
+// luTango - Lua binding for Tango
+//
+// Copyright (C) 2023 Grzegorz Kowalski
+// See LICENSE for legal information
+//
+// file:		log.h
+//
+// Logging facilities for core
+//
+//-----------------------------------------------------------------------------
+
 #ifndef __LOG_H__
 #	define __LOG_H__
 

src/core/lua.h

@@ -1,3 +1,16 @@
+//-----------------------------------------------------------------------------
+//
+// luTango - Lua binding for Tango
+//
+// Copyright (C) 2023 Grzegorz Kowalski
+// See LICENSE for legal information
+//
+// file:		lua.h
+//
+// Lua includes
+//
+//-----------------------------------------------------------------------------
+
 #ifndef __LUA_INCLUDES_H__
 #	define __LUA_INCLUDES_H__
 

src/core/lua/load.cpp

@@ -1,3 +1,16 @@
+//-----------------------------------------------------------------------------
+//
+// luTango - Lua binding for Tango
+//
+// Copyright (C) 2023 Grzegorz Kowalski
+// See LICENSE for legal information
+//
+// file:		load.cpp
+//
+// Facilities for loading Lua code into core
+//
+//-----------------------------------------------------------------------------
+
 #include "load.h"
 
 void load_lua_lib(lua_State* L, const char* name)

src/core/lua/load.h

@@ -1,3 +1,16 @@
+//-----------------------------------------------------------------------------
+//
+// luTango - Lua binding for Tango
+//
+// Copyright (C) 2023 Grzegorz Kowalski
+// See LICENSE for legal information
+//
+// file:		load.h
+//
+// Facilities for loading Lua code into core
+//
+//-----------------------------------------------------------------------------
+
 #ifndef __LOAD_H__
 #	define __LOAD_H__
 

src/core/lua/object.cpp

@@ -1,3 +1,17 @@
+//-----------------------------------------------------------------------------
+//
+// luTango - Lua binding for Tango
+//
+// Copyright (C) 2023 Grzegorz Kowalski
+// See LICENSE for legal information
+//
+// file:		object.cpp
+//
+// Lua objects manipulation in C++
+//
+//-----------------------------------------------------------------------------
+
+
 #include "object.h"
 
 void *lut_getobj(lua_State *L, int idx)

src/core/lua/object.h

@@ -1,3 +1,16 @@
+//-----------------------------------------------------------------------------
+//
+// luTango - Lua binding for Tango
+//
+// Copyright (C) 2023 Grzegorz Kowalski
+// See LICENSE for legal information
+//
+// file:		object.h
+//
+// Lua objects manipulation in C++
+//
+//-----------------------------------------------------------------------------
+
 #ifndef __OBJECT_H__
 #	define __OBJECT_H__
 

src/core/lua/stack.cpp

@@ -1,3 +1,16 @@
+//-----------------------------------------------------------------------------
+//
+// luTango - Lua binding for Tango
+//
+// Copyright (C) 2023 Grzegorz Kowalski
+// See LICENSE for legal information
+//
+// file:		stack.cpp
+//
+// Lua stack manipulation
+//
+//-----------------------------------------------------------------------------
+
 #include "stack.h"
 
 void push_bool_table(lua_State* L, std::vector<bool> v)

src/core/lua/stack.h

@@ -1,3 +1,17 @@
+//-----------------------------------------------------------------------------
+//
+// luTango - Lua binding for Tango
+//
+// Copyright (C) 2023 Grzegorz Kowalski
+// See LICENSE for legal information
+//
+// file:		stack.h
+//
+// Lua stack manipulation
+//
+//-----------------------------------------------------------------------------
+
+
 #ifndef __STACK_H__
 #	define __STACK_H__
 

src/core/lutango_core.cpp

@@ -1,3 +1,16 @@
+//-----------------------------------------------------------------------------
+//
+// luTango - Lua binding for Tango
+//
+// Copyright (C) 2023 Grzegorz Kowalski
+// See LICENSE for legal information
+//
+// file:		lutango_core.cpp
+//
+// Core module entry point
+//
+//-----------------------------------------------------------------------------
+
 #include "lutango_core.h"
 
 #ifdef __cplusplus

src/core/lutango_core.h

@@ -1,3 +1,16 @@
+//-----------------------------------------------------------------------------
+//
+// luTango - Lua binding for Tango
+//
+// Copyright (C) 2023 Grzegorz Kowalski
+// See LICENSE for legal information
+//
+// file:		lutango_core.h
+//
+// Core module entry point
+//
+//-----------------------------------------------------------------------------
+
 #ifndef __LUTANGO_H__
 #	define __LUTANGO_H__
 

src/core/sys/sys.cpp

@@ -1,3 +1,16 @@
+//-----------------------------------------------------------------------------
+//
+// luTango - Lua binding for Tango
+//
+// Copyright (C) 2023 Grzegorz Kowalski
+// See LICENSE for legal information
+//
+// file:		sys.cpp
+//
+// System utilities
+//
+//-----------------------------------------------------------------------------
+
 #include "sys.h"
 
 void lut_lua_register_sys(lua_State* L)

src/core/sys/sys.h

@@ -1,3 +1,16 @@
+//-----------------------------------------------------------------------------
+//
+// luTango - Lua binding for Tango
+//
+// Copyright (C) 2023 Grzegorz Kowalski
+// See LICENSE for legal information
+//
+// file:		sys.h
+//
+// System utilities
+//
+//-----------------------------------------------------------------------------
+
 #ifndef __SYS_H__
 #	define __SYS_H__
 

src/core/tango.h

@@ -1,3 +1,16 @@
+//-----------------------------------------------------------------------------
+//
+// luTango - Lua binding for Tango
+//
+// Copyright (C) 2023 Grzegorz Kowalski
+// See LICENSE for legal information
+//
+// file:		tango.h
+//
+// Tango includes
+//
+//-----------------------------------------------------------------------------
+
 #ifndef __TANGO_INCLUDES_H__
 #	define __TANGO_INCLUDES_H__
 

src/core/tango/AttributeProxy/lut_AttributeProxy.cpp

@@ -1,3 +1,16 @@
+//-----------------------------------------------------------------------------
+//
+// luTango - Lua binding for Tango
+//
+// Copyright (C) 2023 Grzegorz Kowalski
+// See LICENSE for legal information
+//
+// file:		lut_AttributeProxy.cpp
+//
+// Binding for AttributeProxy class
+//
+//-----------------------------------------------------------------------------
+
 #include "lut_AttributeProxy.h"
 
 // WRAPPER CLASS --------------------------------------------------------------

src/core/tango/AttributeProxy/lut_AttributeProxy.h

@@ -1,3 +1,16 @@
+//-----------------------------------------------------------------------------
+//
+// luTango - Lua binding for Tango
+//
+// Copyright (C) 2023 Grzegorz Kowalski
+// See LICENSE for legal information
+//
+// file:		lut_AttributeProxy.h
+//
+// Binding for AttributeProxy class
+//
+//-----------------------------------------------------------------------------
+
 #ifndef __LUT_ATTRIBUTEPROXY_H__
 #	define __LUT_ATTRIBUTEPROXY_H__
 

src/core/tango/DevFailed/lut_DevFailed.cpp

@@ -1,3 +1,16 @@
+//-----------------------------------------------------------------------------
+//
+// luTango - Lua binding for Tango
+//
+// Copyright (C) 2023 Grzegorz Kowalski
+// See LICENSE for legal information
+//
+// file:		lut_DevFailed.cpp
+//
+// Binding for DevFailed exceptions
+//
+//-----------------------------------------------------------------------------
+
 #include "lut_DevFailed.h"
 
 int lut_DevFailed(lua_State* L, Tango::DevFailed e, const char* source)

src/core/tango/DevFailed/lut_DevFailed.h

@@ -1,3 +1,16 @@
+//-----------------------------------------------------------------------------
+//
+// luTango - Lua binding for Tango
+//
+// Copyright (C) 2023 Grzegorz Kowalski
+// See LICENSE for legal information
+//
+// file:		lut_DevFailed.h
+//
+// Binding for DevFailed exceptions
+//
+//-----------------------------------------------------------------------------
+
 #ifndef __LUT_DEVFAILED_H__
 #	define __LUT_DEVFAILED_H__
 

src/core/tango/DevState/lut_DevState.cpp

@@ -1,3 +1,16 @@
+//-----------------------------------------------------------------------------
+//
+// luTango - Lua binding for Tango
+//
+// Copyright (C) 2023 Grzegorz Kowalski
+// See LICENSE for legal information
+//
+// file:		lut_DevState.cpp
+//
+// Binding for DevState type
+//
+//-----------------------------------------------------------------------------
+
 #include "lut_DevState.h"
 
 void lut_DevState(lua_State* L, Tango::DevState state)

src/core/tango/DevState/lut_DevState.h

@@ -1,3 +1,16 @@
+//-----------------------------------------------------------------------------
+//
+// luTango - Lua binding for Tango
+//
+// Copyright (C) 2023 Grzegorz Kowalski
+// See LICENSE for legal information
+//
+// file:		lut_DevState.h
+//
+// Binding for DevState type
+//
+//-----------------------------------------------------------------------------
+
 #ifndef __LUT_DEVSTATE_H__
 #	define __LUT_DEVSTATE_H__
 

src/core/tango/DeviceProxy/lut_DeviceProxy.cpp

@@ -1,3 +1,16 @@
+//-----------------------------------------------------------------------------
+//
+// luTango - Lua binding for Tango
+//
+// Copyright (C) 2023 Grzegorz Kowalski
+// See LICENSE for legal information
+//
+// file:		lut_DeviceProxy.cpp
+//
+// Binding for DeviceProxy class
+//
+//-----------------------------------------------------------------------------
+
 #include "lut_DeviceProxy.h"
 
 // WRAPPER CLASS --------------------------------------------------------------

src/core/tango/DeviceProxy/lut_DeviceProxy.h

@@ -1,3 +1,16 @@
+//-----------------------------------------------------------------------------
+//
+// luTango - Lua binding for Tango
+//
+// Copyright (C) 2023 Grzegorz Kowalski
+// See LICENSE for legal information
+//
+// file:		lut_DeviceProxy.h
+//
+// Binding for DeviceProxy class
+//
+//-----------------------------------------------------------------------------
+
 #ifndef __LUT_DEVICEPROXY_H__
 #	define __LUT_DEVICEPROXY_H__
 

src/core/tango/attrdata.cpp

@@ -1,3 +1,16 @@
+//-----------------------------------------------------------------------------
+//
+// luTango - Lua binding for Tango
+//
+// Copyright (C) 2023 Grzegorz Kowalski
+// See LICENSE for legal information
+//
+// file:		attrdata.cpp
+//
+// Attribute data handling, type conversions
+//
+//-----------------------------------------------------------------------------
+
 #include "attrdata.h"
 
 void unpack_attr_data(lua_State* L, Tango::DeviceAttribute attr)

src/core/tango/attrdata.h

@@ -1,3 +1,16 @@
+//-----------------------------------------------------------------------------
+//
+// luTango - Lua binding for Tango
+//
+// Copyright (C) 2023 Grzegorz Kowalski
+// See LICENSE for legal information
+//
+// file:		attrdata.h
+//
+// Attribute data handling, type conversions
+//
+//-----------------------------------------------------------------------------
+
 #ifndef __ATTRDATA_H__
 #	define __ATTRDATA_H__
 

src/core/tango/cmddata.cpp

@@ -1,3 +1,16 @@
+//-----------------------------------------------------------------------------
+//
+// luTango - Lua binding for Tango
+//
+// Copyright (C) 2023 Grzegorz Kowalski
+// See LICENSE for legal information
+//
+// file:		cmddata.cpp
+//
+// Command data handling, type conversions
+//
+//-----------------------------------------------------------------------------
+
 #include "cmddata.h"
 
 void unpack_cmd_data(lua_State* L, Tango::DeviceData data, long type)

src/core/tango/cmddata.h

@@ -1,3 +1,16 @@
+//-----------------------------------------------------------------------------
+//
+// luTango - Lua binding for Tango
+//
+// Copyright (C) 2023 Grzegorz Kowalski
+// See LICENSE for legal information
+//
+// file:		cmddata.h
+//
+// Command data handling, type conversions
+//
+//-----------------------------------------------------------------------------
+
 #ifndef __CMDDATA_H__
 #	define __CMDDATA_H__
 

src/core/utils.cpp

@@ -1,3 +1,16 @@
+//-----------------------------------------------------------------------------
+//
+// luTango - Lua binding for Tango
+//
+// Copyright (C) 2023 Grzegorz Kowalski
+// See LICENSE for legal information
+//
+// file:		utils.cpp
+//
+// Various utilities
+//
+//-----------------------------------------------------------------------------
+
 #include "utils.h"
 
 std::string build_name(std::string dev_name, std::string name, bool cmd)

src/core/utils.h

@@ -1,3 +1,16 @@
+//-----------------------------------------------------------------------------
+//
+// luTango - Lua binding for Tango
+//
+// Copyright (C) 2023 Grzegorz Kowalski
+// See LICENSE for legal information
+//
+// file:		utils.h
+//
+// Various utilities
+//
+//-----------------------------------------------------------------------------
+
 #ifndef __UTILS_H__
 #	define __UTILS_H__
 

src/init.lua

@@ -1,4 +1,17 @@
-local log = require "lutango.lutLog"
+-------------------------------------------------------------------------------
+--
+-- luTango - Lua binding for Tango
+--
+-- Copyright (C) 2023 Grzegorz Kowalski
+-- See LICENSE for legal information
+--
+-- file:		init.lua
+--
+-- Lua module entry point
+--
+-------------------------------------------------------------------------------
+
+local log = require "lutango.log"
 local core = require "lutango.core"
 local utils = require "lutango.utils"
 local lutObject = require "lutango.lutObject"

src/log.lua

@@ -1,3 +1,16 @@
+-------------------------------------------------------------------------------
+--
+-- luTango - Lua binding for Tango
+--
+-- Copyright (C) 2023 Grzegorz Kowalski
+-- See LICENSE for legal information
+--
+-- file:		log.lua
+--
+-- Logging facilities for Lua part
+--
+-------------------------------------------------------------------------------
+
 local core = require "lutango.core"
 local utils = require "lutango.utils"
 

src/lutDevState.lua

@@ -1,5 +1,18 @@
+-------------------------------------------------------------------------------
+--
+-- luTango - Lua binding for Tango
+--
+-- Copyright (C) 2023 Grzegorz Kowalski
+-- See LICENSE for legal information
+--
+-- file:		lutDevState.lua
+--
+-- DevState type implementation
+--
+-------------------------------------------------------------------------------
+
 local utils = require "lutango.utils"
-local log = require "lutango.lutLog"
+local log = require "lutango.log"
 
 local lutDevState = {
 	labels = {[0] = "ON", "OFF", "CLOSE", "OPEN", "INSERT", "EXTRACT", "MOVING", "STANDBY", "FAULT", "INIT", "RUNNING", "ALARM", "DISABLE", "UNKNOWN"}

src/lutObject.lua

@@ -1,10 +1,23 @@
+-------------------------------------------------------------------------------
+--
+-- luTango - Lua binding for Tango
+--
+-- Copyright (C) 2023 Grzegorz Kowalski
+-- See LICENSE for legal information
+--
+-- file:		lutObject.lua
+--
+-- Generic Lua object for interacting with C++ objects
+--
+-------------------------------------------------------------------------------
+
 local core = require "lutango.core"
-local log = require "lutango.lutLog"
+local log = require "lutango.log"
 local try = require "lutango.try"
 
 local lutObject = {}
 
-function create_lutObject(type)
+local function create_lutObject(type)
 	log(log.level.TRACE, "New lutObject for "..type)
 	local o = {
 		__is_instance = false,

src/try.lua

@@ -1,4 +1,15 @@
-local log = require "lutango.lutLog"
+-------------------------------------------------------------------------------
+--
+-- luTango - Lua binding for Tango
+--
+-- Copyright (C) 2023 Grzegorz Kowalski
+-- See LICENSE for legal information
+--
+-- file:		try.lua
+--
+-- Exception handling
+--
+-------------------------------------------------------------------------------
 
 local function default_handler(e)
 	io.stderr:write("\n=================================== EXCEPTION ===================================\n")

src/utils.lua

@@ -1,3 +1,16 @@
+-------------------------------------------------------------------------------
+--
+-- luTango - Lua binding for Tango
+--
+-- Copyright (C) 2023 Grzegorz Kowalski
+-- See LICENSE for legal information
+--
+-- file:		utils.lua
+--
+-- Various utilities
+--
+-------------------------------------------------------------------------------
+
 local utils = {}
 
 function utils.get_key_by_value(t, value)

tests/attributeproxy.lua

@@ -1,3 +1,16 @@
+-------------------------------------------------------------------------------
+--
+-- luTango - Lua binding for Tango
+--
+-- Copyright (C) 2023 Grzegorz Kowalski
+-- See LICENSE for legal information
+--
+-- file:		attributeproxy.lua
+--
+-- Test script for AttributeProxy class
+--
+-------------------------------------------------------------------------------
+
 local lut = require "lutango"
 lut.log:set_log_level(lut.log.level.WARNING)
 

tests/invalid_actions.lua

@@ -1,3 +1,16 @@
+-------------------------------------------------------------------------------
+--
+-- luTango - Lua binding for Tango
+--
+-- Copyright (C) 2023 Grzegorz Kowalski
+-- See LICENSE for legal information
+--
+-- file:		invalid_actions.lua
+--
+-- Test script attempting to perform various invalid actions
+--
+-------------------------------------------------------------------------------
+
 local lut = require "lutango"
 lut.log:set_log_level(lut.log.level.TRACE)
 
@@ -14,3 +27,14 @@ dp.SwitchStates = 0
 
 print("Attempting to write read-only attribute")
 dp.short_scalar_ro = 100
+
+print("Attempting to access non-existent attribute")
+local invalid2 = lut.AttributeProxy("sys/tg_test/1/nonexistent")
+
+print("Attempting to write read-only attribute via AttributeProxy")
+local attr_name = "sys/tg_test/1/short_scalar_ro"
+if arg[1] and arg[2] then
+	attr_name = arg[1].."/"..arg[2]
+end
+local ap = lut.AttributeProxy(attr_name)
+ap(100)

tests/print_versions.lua

@@ -1,3 +1,16 @@
+-------------------------------------------------------------------------------
+--
+-- luTango - Lua binding for Tango
+--
+-- Copyright (C) 2023 Grzegorz Kowalski
+-- See LICENSE for legal information
+--
+-- file:		print_versions.lua
+--
+-- Test script printing libraries, interpreter and compiler versions
+--
+-------------------------------------------------------------------------------
+
 local lut = require "lutango"
 
 print("luTango "..lut.sys.version())

tests/read_attrs.lua

@@ -1,3 +1,16 @@
+-------------------------------------------------------------------------------
+--
+-- luTango - Lua binding for Tango
+--
+-- Copyright (C) 2023 Grzegorz Kowalski
+-- See LICENSE for legal information
+--
+-- file:		read_attrs.lua
+--
+-- Test script for reading attributes
+--
+-------------------------------------------------------------------------------
+
 local lut = require "lutango"
 
 lut.log:set_log_level(lut.log.level.WARNING)

tests/run_cmds.lua

@@ -1,3 +1,16 @@
+-------------------------------------------------------------------------------
+--
+-- luTango - Lua binding for Tango
+--
+-- Copyright (C) 2023 Grzegorz Kowalski
+-- See LICENSE for legal information
+--
+-- file:		run_cmds.lua
+--
+-- Test script for running commands
+--
+-------------------------------------------------------------------------------
+
 local lut = require "lutango"
 lut.log:set_log_level(lut.log.level.WARNING)
 

tests/test_state.lua

@@ -1,3 +1,16 @@
+-------------------------------------------------------------------------------
+--
+-- luTango - Lua binding for Tango
+--
+-- Copyright (C) 2023 Grzegorz Kowalski
+-- See LICENSE for legal information
+--
+-- file:		test_state.lua
+--
+-- Test script for DevState class
+--
+-------------------------------------------------------------------------------
+
 local lut = require "lutango"
 
 local states = {}

tests/write_attrs.lua

@@ -1,3 +1,16 @@
+-------------------------------------------------------------------------------
+--
+-- luTango - Lua binding for Tango
+--
+-- Copyright (C) 2023 Grzegorz Kowalski
+-- See LICENSE for legal information
+--
+-- file:		write_attrs.lua
+--
+-- Test script for writing attributes
+--
+-------------------------------------------------------------------------------
+
 local lut = require "lutango"
 lut.log:set_log_level(lut.log.level.WARNING)