clipsruby 0.0.33 → 0.0.35

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eebbbd0b179f769e1bc079a0cedda8a3ba5198a83347bfb37abc48d6edfe8d41
-  data.tar.gz: 9adb9650801d7a7bbd290aac1f3c6666dfe6e2527b2fc022dc6285dfad6756f1
+  metadata.gz: f9bdca59f142899fe858cb253d57ce0d1b2d3eae763a57cb91d7278196e77f88
+  data.tar.gz: 5c958baae6e99acde4729fb3755bbfa9d8ec613e1dfd53b18b970c3824767872
 SHA512:
-  metadata.gz: 840d6111ab2c3b27d764a2bf2dea8b88b447f4730345e1e54ef22f0e3aa64edb21ee362e9c57088cbffc29d561106e28fbfd25acee381ef1d819d3297ae6a279
-  data.tar.gz: 4cd8587d33b239d66093cebdf12efda954adc37c620c1112a35295771f7ea3ccc74415e2a7303d7581fe0494c577f9200512f7a59d898c4e8077105b7157d099
+  metadata.gz: 5c57ac8a0cbc763881cfa3275d6f2e3550222e8d575865ce79c9aa0cfebf9eb5d6b66ccc5cae98555d6ba16fe6dca92de1560540cd6252bf5c42353ebdcaf774
+  data.tar.gz: 7c8914796e684ce973ba1058122ed1b4390d1b6043b3086abf70160b5aca79a1ce4e83286daed19a84ea77ff9a7b095f5bd707773763b33bc12e4c205d16635e

data/README.md

@@ -494,6 +494,20 @@ CLIPS::Environment::Defclass.defmodule_name(defclass)
 defclass.defmodule_name
 ```
 
+### `CLIPS::Environment::Defclass.get_instance_list`
+### `CLIPS::Environment::Defclass#get_instance_list`
+
+Return an array of Instances of the Defclass.
+Pass `true` as and argument to include instances of subclasses
+of this Defclass.
+
+```ruby
+CLIPS::Environment::Defclass.get_instance_list(defclass)
+CLIPS::Environment::Defclass.get_instance_list(defclass, true)
+defclass.get_instance_list
+defclass.get_instance_list(true)
+```
+
 ### `CLIPS::Environment.find_defrule`
 ### `CLIPS::Environment#find_defrule`
 
@@ -504,6 +518,24 @@ CLIPS::Environment.find_defrule(:a)
 env.find_defrule("foo")
 ```
 
+### `CLIPS::Environment.find_instance`
+### `CLIPS::Environment#find_instance`
+
+Finds an instance by name and returns a CLIPS::Environment::Instance object.
+Can take an optional second and third argument for Defmodule or Demodule name
+and a boolean that represents whether or not the instance should be searched for
+in imported modules.
+If the second argument is `nil`, `find_instance` will search the current module only.
+
+```ruby
+CLIPS::Environment.find_definstance(:a)
+env.find_definstance("foo")
+CLIPS::Environment.find_definstance(:a, :my_module)
+env.find_definstance("foo", "my_module")
+CLIPS::Environment.find_definstance(:a, :my_module, true)
+env.find_definstance("foo", nil, true)
+```
+
 ### `CLIPS::Environment::Defrule.name`
 ### `CLIPS::Environment::Defrule#name`
 
@@ -634,6 +666,57 @@ CLIPS::Environment::Defmodule.get_fact_list(defmodule)
 defmodule.get_fact_list
 ```
 
+### `CLIPS::Environment::Defmodule.find_instance`
+### `CLIPS::Environment::Defmodule#find_instance`
+
+Finds an instance by name and returns a CLIPS::Environment::Instance object.
+Can take an optional second argument
+of a boolean that represents whether or not the instance should be searched for
+in imported modules.
+
+```ruby
+CLIPS::Environment::Defmodule.find_instance(:a)
+defmodule.find_instance("foo")
+CLIPS::Environment::Defmodule.find_instance(:a, true)
+defmodule.find_instance("foo", true)
+```
+
+### `CLIPS::Environment.get_defclass_list`
+### `CLIPS::Environment#get_defclass_list`
+
+Return an array of Defclass names as symbols in the environment. Pass an argument of a
+symbol, string, or Defmodule object in order to only get Defclasss
+in that Defmodule. If you do not, it will return all Defclass names in all modules.
+
+```ruby
+CLIPS::Environment.get_defclass_list(env)
+env.get_defclass_list
+CLIPS::Environment.get_defclass_list(env, :MAIN)
+env.get_defclass_list(:MAIN)
+CLIPS::Environment.get_defclass_list(env, defmodule)
+env.get_defclass_list(defmodule)
+```
+
+### `CLIPS::Environment.get_instance_list`
+### `CLIPS::Environment#get_instance_list`
+
+Return an array of Instances in the environment. Pass an argument of a
+symbol, string, or Defclass object in order to only get Instances
+in that Defclass. If you do not, it will return all Instances of all Defclasses.
+If you do, you may also pass `true` as the second argument
+to include instances of subclasses of this Defclass.
+
+```ruby
+CLIPS::Environment.get_instance_list(env)
+env.get_instance_list
+CLIPS::Environment.get_instance_list(env, :foo_class)
+env.get_instance_list(:"my-class")
+CLIPS::Environment.get_instance_list(env, defclass)
+env.get_instance_list(defclass)
+CLIPS::Environment.get_instance_list(env, defclass, true)
+env.get_instance_list(defclass, true)
+```
+
 ### `CLIPS::Environment.get_deftemplate_list`
 ### `CLIPS::Environment#get_deftemplate_list`
 
@@ -686,6 +769,16 @@ CLIPS::Environment.find_deftemplate(:a)
 env.find_deftemplate("foo")
 ```
 
+### `CLIPS::Environment.find_defclass`
+### `CLIPS::Environment#find_defclass`
+
+Finds a defclass by name and returns a CLIPS::Environment::Defclass object
+
+```ruby
+CLIPS::Environment.find_defclass(:a)
+env.find_defclass("foo")
+```
+
 ### `CLIPS::Environment::Deftemplate.name`
 ### `CLIPS::Environment::Deftemplate#name`
 
@@ -874,6 +967,16 @@ CLIPS::Environment::Deftemplate.slot_defaultp(deftemplate, :foo)
 deftemplate.slot_defaultp('bar')
 ```
 
+### `CLIPS::Environment::Defmodule.get_defclass_list`
+### `CLIPS::Environment::Defmodule#get_defclass_list`
+
+Return an array of Defclass names as symbols in the Defmodule
+
+```ruby
+CLIPS::Environment::Defmodule.get_defclass_list(defmodule)
+defmodule.get_defclass_list
+```
+
 ### `CLIPS::Environment::Defmodule.get_deftemplate_list`
 ### `CLIPS::Environment::Defmodule#get_deftemplate_list`
 

data/ext/clipsruby/clipsruby.c

@@ -293,6 +293,92 @@ static VALUE clips_environment_defclass_static_pp_form(VALUE self, VALUE rbDefcl
 	return clips_environment_defclass_pp_form(rbDefclass);
 }
 
+static VALUE clips_environment_defclass_get_instance_list(int argc, VALUE *argv, VALUE rbDefclass)
+{
+	VALUE rbEnvironment, rbInstance, include_subclasses, returnArray;
+	Defclass *defclass;
+	Instance *theInstance;
+	UDFValue iterator;
+
+	rbEnvironment = rb_iv_get(rbDefclass, "@environment");
+
+	returnArray = rb_ary_new2(0);
+
+	rb_scan_args(argc, argv, "01", &include_subclasses);
+
+	TypedData_Get_Struct(rbDefclass, Defclass, &Defclass_type, defclass);
+
+	if (include_subclasses != Qtrue) {
+		for (
+			theInstance = GetNextInstanceInClass(defclass,NULL);
+			theInstance != NULL;
+			theInstance = GetNextInstanceInClass(defclass,theInstance)
+		) {
+			rbInstance =
+				TypedData_Wrap_Struct(rb_const_get(CLASS_OF(rbEnvironment), rb_intern("Instance")), &Instance_type, theInstance);
+
+			rb_iv_set(rbInstance, "@environment", rbEnvironment);
+			rb_ary_push(returnArray, rbInstance);
+		}
+	} else {
+		for (
+			theInstance = GetNextInstanceInClassAndSubclasses(&defclass,NULL,&iterator);
+			theInstance != NULL;
+			theInstance = GetNextInstanceInClassAndSubclasses(&defclass,theInstance,&iterator)
+		) {
+			rbInstance =
+				TypedData_Wrap_Struct(rb_const_get(CLASS_OF(rbEnvironment), rb_intern("Instance")), &Instance_type, theInstance);
+
+			rb_iv_set(rbInstance, "@environment", rbEnvironment);
+			rb_ary_push(returnArray, rbInstance);
+		}
+	}
+	return returnArray;
+}
+
+static VALUE clips_environment_defclass_static_get_instance_list(int argc, VALUE *argv, VALUE rbDefclass)
+{
+	VALUE rbEnvironment, rbInstance, include_subclasses, returnArray;
+	Defclass *defclass;
+	Instance *theInstance;
+	UDFValue iterator;
+
+	returnArray = rb_ary_new2(0);
+
+	rb_scan_args(argc, argv, "11", &rbDefclass, &include_subclasses);
+
+	rbEnvironment = rb_iv_get(rbDefclass, "@environment");
+
+	TypedData_Get_Struct(rbDefclass, Defclass, &Defclass_type, defclass);
+
+	if (include_subclasses != Qtrue) {
+		for (
+			theInstance = GetNextInstanceInClass(defclass,NULL);
+			theInstance != NULL;
+			theInstance = GetNextInstanceInClass(defclass,theInstance)
+		) {
+			rbInstance =
+				TypedData_Wrap_Struct(rb_const_get(CLASS_OF(rbEnvironment), rb_intern("Instance")), &Instance_type, theInstance);
+
+			rb_iv_set(rbInstance, "@environment", rbEnvironment);
+			rb_ary_push(returnArray, rbInstance);
+		}
+	} else {
+		for (
+			theInstance = GetNextInstanceInClassAndSubclasses(&defclass,NULL,&iterator);
+			theInstance != NULL;
+			theInstance = GetNextInstanceInClassAndSubclasses(&defclass,theInstance,&iterator)
+		) {
+			rbInstance =
+				TypedData_Wrap_Struct(rb_const_get(CLASS_OF(rbEnvironment), rb_intern("Instance")), &Instance_type, theInstance);
+
+			rb_iv_set(rbInstance, "@environment", rbEnvironment);
+			rb_ary_push(returnArray, rbInstance);
+		}
+	}
+	return returnArray;
+}
+
 static VALUE clips_environment_make_instance(VALUE self, VALUE string)
 {
 	Environment *env;
@@ -787,8 +873,13 @@ static void CLIPSValue_to_VALUE(CLIPSValue *from, VALUE *value, VALUE *rbEnviron
 
 			rb_iv_set(*value, "@environment", *rbEnvironment);
 			break;
-		case EXTERNAL_ADDRESS_TYPE:
 		case INSTANCE_ADDRESS_TYPE:
+			*value =
+				TypedData_Wrap_Struct(rb_const_get(CLASS_OF(*rbEnvironment), rb_intern("Instance")), &Instance_type, from->instanceValue);
+
+			rb_iv_set(*value, "@environment", *rbEnvironment);
+			break;
+		case EXTERNAL_ADDRESS_TYPE:
 		default:
 			WriteString(env,STDERR,"Unsupported data type returned from function\n");
 			*value = Qnil;
@@ -839,8 +930,13 @@ static void UDFValue_to_VALUE(UDFValue *from, VALUE *value, VALUE *rbEnvironment
 
 			rb_iv_set(*value, "@environment", *rbEnvironment);
 			break;
-		case EXTERNAL_ADDRESS_TYPE:
 		case INSTANCE_ADDRESS_TYPE:
+			*value =
+				TypedData_Wrap_Struct(rb_const_get(CLASS_OF(*rbEnvironment), rb_intern("Instance")), &Instance_type, from->instanceValue);
+
+			rb_iv_set(*value, "@environment", *rbEnvironment);
+			break;
+		case EXTERNAL_ADDRESS_TYPE:
 		default:
 			WriteString(env,STDERR,"Unsupported data type returned from function\n");
 			*value = Qnil;
@@ -1925,6 +2021,223 @@ static VALUE clips_environment_static_find_defmodule(VALUE self, VALUE rbEnviron
 	return clips_environment_find_defmodule(rbEnvironment, defmodule_name);
 }
 
+static VALUE clips_environment_find_instance(int argc, VALUE *argv, VALUE rbEnvironment) {
+	VALUE instanceName, search_imports, rbInstance, rbDefmodule;
+	Defmodule *defmodule;
+	Environment *env;
+	Instance *instance;
+
+	TypedData_Get_Struct(rbEnvironment, Environment, &Environment_type, env);
+
+	rb_scan_args(argc, argv, "12", &instanceName, &rbDefmodule, &search_imports);
+
+	const char *cinstanceName;
+	switch(TYPE(instanceName))
+	{
+		case T_SYMBOL:
+			cinstanceName = rb_id2name(SYM2ID(instanceName));
+			break;
+		case T_STRING:
+			cinstanceName = StringValueCStr(instanceName);
+			break;
+		default:
+			rb_warn("instance name must be a String or a Symbol");
+			return Qnil;
+	}
+
+	switch (TYPE(rbDefmodule)) {
+		case T_NIL:
+			defmodule = NULL;
+			break;
+		case T_STRING:
+		case T_SYMBOL:
+			rbDefmodule = clips_environment_find_defmodule(rbEnvironment, rbDefmodule);
+			if (rbDefmodule == Qnil) {
+				return Qnil;
+			}
+			TypedData_Get_Struct(rbDefmodule, Defmodule, &Defmodule_type, defmodule);
+			break;
+		case T_DATA:
+			TypedData_Get_Struct(rbDefmodule, Defmodule, &Defmodule_type, defmodule);
+			break;
+                default:
+			rb_warn("defmodule name must be a symbol or string");
+			return Qnil;
+        }
+
+	instance = FindInstance(
+		env,
+		defmodule,
+		cinstanceName,
+		RTEST(search_imports));
+
+	if (instance == NULL) {
+		return Qnil;
+	} else {
+		rbInstance =
+			TypedData_Wrap_Struct(rb_const_get(CLASS_OF(rbEnvironment), rb_intern("Instance")), &Instance_type, instance);
+
+		rb_iv_set(rbInstance, "@environment", rbEnvironment);
+
+		return rbInstance;
+	}
+}
+
+static VALUE clips_environment_static_find_instance(int argc, VALUE *argv, VALUE klass) {
+	VALUE rbEnvironment, instanceName, rbInstance, rbDefmodule, search_imports;
+	Defmodule *defmodule;
+	Environment *env;
+	Instance *instance;
+
+	rb_scan_args(argc, argv, "22", &rbEnvironment, &instanceName, &rbDefmodule, &search_imports);
+
+	TypedData_Get_Struct(rbEnvironment, Environment, &Environment_type, env);
+
+	const char *cinstanceName;
+	switch(TYPE(instanceName))
+	{
+		case T_SYMBOL:
+			cinstanceName = rb_id2name(SYM2ID(instanceName));
+			break;
+		case T_STRING:
+			cinstanceName = StringValueCStr(instanceName);
+			break;
+		default:
+			rb_warn("instance name must be a String or a Symbol");
+			return Qnil;
+	}
+
+	switch (TYPE(rbDefmodule)) {
+		case T_NIL:
+			defmodule = NULL;
+			break;
+		case T_STRING:
+		case T_SYMBOL:
+			rbDefmodule = clips_environment_find_defmodule(rbEnvironment, rbDefmodule);
+			if (rbDefmodule == Qnil) {
+				return Qnil;
+			}
+			TypedData_Get_Struct(rbDefmodule, Defmodule, &Defmodule_type, defmodule);
+			break;
+		case T_DATA:
+			TypedData_Get_Struct(rbDefmodule, Defmodule, &Defmodule_type, defmodule);
+			break;
+                default:
+			rb_warn("defmodule name must be a symbol or string");
+			return Qnil;
+        }
+
+	instance = FindInstance(
+		env,
+		defmodule,
+		cinstanceName,
+		RTEST(search_imports));
+
+	if (instance == NULL) {
+		return Qnil;
+	} else {
+		rbInstance =
+			TypedData_Wrap_Struct(rb_const_get(CLASS_OF(rbEnvironment), rb_intern("Instance")), &Instance_type, instance);
+
+		rb_iv_set(rbInstance, "@environment", rbEnvironment);
+
+		return rbInstance;
+	}
+}
+
+static VALUE clips_environment_defmodule_find_instance(int argc, VALUE *argv, VALUE rbDefmodule) {
+	VALUE instanceName, search_imports, rbInstance, rbEnvironment;
+	Defmodule *defmodule;
+	Environment *env;
+	Instance *instance;
+	const char *cinstanceName;
+
+	TypedData_Get_Struct(rbDefmodule, Defmodule, &Defmodule_type, defmodule);
+
+	rbEnvironment = rb_iv_get(rbDefmodule, "@environment");
+
+	TypedData_Get_Struct(rbEnvironment, Environment, &Environment_type, env);
+	TypedData_Get_Struct(rbDefmodule, Defmodule, &Defmodule_type, defmodule);
+
+	rb_scan_args(argc, argv, "11", &instanceName, &search_imports);
+
+	switch(TYPE(instanceName))
+	{
+		case T_SYMBOL:
+			cinstanceName = rb_id2name(SYM2ID(instanceName));
+			break;
+		case T_STRING:
+			cinstanceName = StringValueCStr(instanceName);
+			break;
+		default:
+			rb_warn("instance name must be a String or a Symbol");
+			return Qnil;
+	}
+
+	instance = FindInstance(
+		env,
+		defmodule,
+		cinstanceName,
+		RTEST(search_imports));
+
+	if (instance == NULL) {
+		return Qnil;
+	} else {
+		rbInstance =
+			TypedData_Wrap_Struct(rb_const_get(CLASS_OF(rbEnvironment), rb_intern("Instance")), &Instance_type, instance);
+
+		rb_iv_set(rbInstance, "@environment", rbEnvironment);
+
+		return rbInstance;
+	}
+}
+
+static VALUE clips_environment_defmodule_static_find_instance(int argc, VALUE *argv, VALUE klass) {
+	VALUE rbDefmodule, rbEnvironment, instanceName, search_imports, rbInstance;
+	Defmodule *defmodule;
+	Environment *env;
+	Instance *instance;
+	const char *cinstanceName;
+
+	rb_scan_args(argc, argv, "21", &rbDefmodule, &instanceName, &search_imports);
+
+	rbEnvironment = rb_iv_get(rbDefmodule, "@environment");
+
+	TypedData_Get_Struct(rbEnvironment, Environment, &Environment_type, env);
+	TypedData_Get_Struct(rbDefmodule, Defmodule, &Defmodule_type, defmodule);
+
+	switch(TYPE(instanceName))
+	{
+		case T_SYMBOL:
+			cinstanceName = rb_id2name(SYM2ID(instanceName));
+			break;
+		case T_STRING:
+			cinstanceName = StringValueCStr(instanceName);
+			break;
+		default:
+			rb_warn("instance name must be a String or a Symbol");
+			return Qnil;
+	}
+
+	instance = FindInstance(
+		env,
+		defmodule,
+		cinstanceName,
+		RTEST(search_imports));
+
+	if (instance == NULL) {
+		return Qnil;
+	} else {
+		rbInstance =
+			TypedData_Wrap_Struct(rb_const_get(CLASS_OF(rbEnvironment), rb_intern("Instance")), &Instance_type, instance);
+
+		rb_iv_set(rbInstance, "@environment", rbEnvironment);
+
+		return rbInstance;
+	}
+}
+
+
 static VALUE clips_environment_find_deftemplate(VALUE self, VALUE deftemplate_name)
 {
 	Environment *env;
@@ -1959,6 +2272,40 @@ static VALUE clips_environment_static_find_deftemplate(VALUE self, VALUE rbEnvir
 	return clips_environment_find_deftemplate(rbEnvironment, deftemplate_name);
 }
 
+static VALUE clips_environment_find_defclass(VALUE self, VALUE defclass_name)
+{
+	Environment *env;
+	Defclass *class;
+
+	TypedData_Get_Struct(self, Environment, &Environment_type, env);
+
+	switch (TYPE(defclass_name)) {
+		case T_STRING:
+			class = FindDefclass(env, StringValueCStr(defclass_name));
+			break;
+		case T_SYMBOL:
+			class = FindDefclass(env, rb_id2name(SYM2ID(defclass_name)));
+			break;
+                default:
+			rb_warn("defclass name must be a symbol or string");
+			return Qnil;
+        }
+
+	if (class == NULL) {
+		return Qnil;
+	} else {
+		VALUE rbDefclass;
+		rbDefclass = TypedData_Wrap_Struct(rb_const_get(CLASS_OF(self), rb_intern("Defclass")), &Defclass_type, class);
+		rb_iv_set(rbDefclass, "@environment", self);
+		return rbDefclass;
+	}
+}
+
+static VALUE clips_environment_static_find_defclass(VALUE self, VALUE rbEnvironment, VALUE defclass_name)
+{
+	return clips_environment_find_defclass(rbEnvironment, defclass_name);
+}
+
 static VALUE clips_environment_deftemplate_name(VALUE self)
 {
 	Deftemplate *deftemplate;
@@ -2125,6 +2472,186 @@ static VALUE clips_environment_static_get_fact_list(int argc, VALUE *argv, VALUE
 	return out;
 }
 
+static VALUE clips_environment_get_instance_list(int argc, VALUE *argv, VALUE rbEnvironment) {
+	VALUE rbDefclass_or_defclass_name, rbDefclass, include_subclasses, rbInstance, returnArray;
+	Environment *env;
+	Defclass *defclass;
+	UDFValue iterator;
+	Instance *theInstance;
+
+	returnArray = rb_ary_new2(0);
+
+	TypedData_Get_Struct(rbEnvironment, Environment, &Environment_type, env);
+
+	rb_scan_args(argc, argv, "02", &rbDefclass_or_defclass_name, &include_subclasses);
+	// defclass is undefined, ignore include_subclasses
+	if (rbDefclass_or_defclass_name == Qnil) {
+		for (
+			theInstance = GetNextInstance(env,NULL);
+			theInstance != NULL;
+			theInstance = GetNextInstance(env,theInstance)
+		) {
+			rbInstance =
+				TypedData_Wrap_Struct(rb_const_get(CLASS_OF(rbEnvironment), rb_intern("Instance")), &Instance_type, theInstance);
+
+			rb_iv_set(rbInstance, "@environment", rbEnvironment);
+			rb_ary_push(returnArray, rbInstance);
+		}
+	} else if (include_subclasses != Qtrue) {
+		switch (TYPE(rbDefclass_or_defclass_name)) {
+			case T_STRING:
+			case T_SYMBOL:
+				if (Qnil == (rbDefclass = clips_environment_find_defclass(rbEnvironment, rbDefclass_or_defclass_name))) {
+					rb_warn("could not find defclass");
+					return Qnil;
+				}
+				TypedData_Get_Struct(rbDefclass, Defclass, &Defclass_type, defclass);
+				break;
+			case T_DATA:
+				TypedData_Get_Struct(rbDefclass_or_defclass_name, Defclass, &Defclass_type, defclass);
+				break;
+			default:
+				rb_warn("defclass name must be a symbol or string");
+				return Qnil;
+		}
+		for (
+			theInstance = GetNextInstanceInClass(defclass,NULL);
+			theInstance != NULL;
+			theInstance = GetNextInstanceInClass(defclass,theInstance)
+		) {
+			rbInstance =
+				TypedData_Wrap_Struct(rb_const_get(CLASS_OF(rbEnvironment), rb_intern("Instance")), &Instance_type, theInstance);
+
+			rb_iv_set(rbInstance, "@environment", rbEnvironment);
+			rb_ary_push(returnArray, rbInstance);
+		}
+	} else if (include_subclasses == Qtrue) {
+		switch (TYPE(rbDefclass_or_defclass_name)) {
+			case T_STRING:
+			case T_SYMBOL:
+				if (Qnil == (rbDefclass = clips_environment_find_defclass(rbEnvironment, rbDefclass_or_defclass_name))) {
+					rb_warn("could not find defclass");
+					return Qnil;
+				}
+				TypedData_Get_Struct(rbDefclass, Defclass, &Defclass_type, defclass);
+				break;
+			case T_DATA:
+				TypedData_Get_Struct(rbDefclass_or_defclass_name, Defclass, &Defclass_type, defclass);
+				break;
+			default:
+				rb_warn("defclass name must be a symbol or string");
+				return Qnil;
+		}
+		for (
+			theInstance = GetNextInstanceInClassAndSubclasses(&defclass,NULL,&iterator);
+			theInstance != NULL;
+			theInstance = GetNextInstanceInClassAndSubclasses(&defclass,theInstance,&iterator)
+		) {
+			rbInstance =
+				TypedData_Wrap_Struct(rb_const_get(CLASS_OF(rbEnvironment), rb_intern("Instance")), &Instance_type, theInstance);
+
+			rb_iv_set(rbInstance, "@environment", rbEnvironment);
+			rb_ary_push(returnArray, rbInstance);
+		}
+	// unexpected input of some kind...
+	} else {
+		rb_warn("unexpected arguments sent to get_instance_list!");
+		return Qnil;
+	}
+
+	return returnArray;
+}
+
+static VALUE clips_environment_static_get_instance_list(int argc, VALUE *argv, VALUE klass) {
+	VALUE rbEnvironment, rbDefclass_or_defclass_name, rbDefclass, include_subclasses, rbInstance, returnArray;
+	Environment *env;
+	Defclass *defclass;
+	UDFValue iterator;
+	Instance *theInstance;
+
+	returnArray = rb_ary_new2(0);
+
+	rb_scan_args(argc, argv, "12", &rbEnvironment, &rbDefclass_or_defclass_name, &include_subclasses);
+
+	TypedData_Get_Struct(rbEnvironment, Environment, &Environment_type, env);
+	// defclass is undefined, ignore include_subclasses
+	if (rbDefclass_or_defclass_name == Qnil) {
+		for (
+			theInstance = GetNextInstance(env,NULL);
+			theInstance != NULL;
+			theInstance = GetNextInstance(env,theInstance)
+		) {
+			rbInstance =
+				TypedData_Wrap_Struct(rb_const_get(CLASS_OF(rbEnvironment), rb_intern("Instance")), &Instance_type, theInstance);
+
+			rb_iv_set(rbInstance, "@environment", rbEnvironment);
+			rb_ary_push(returnArray, rbInstance);
+		}
+	} else if (include_subclasses != Qtrue) {
+		switch (TYPE(rbDefclass_or_defclass_name)) {
+			case T_STRING:
+			case T_SYMBOL:
+				if (Qnil == (rbDefclass = clips_environment_find_defclass(rbEnvironment, rbDefclass_or_defclass_name))) {
+					rb_warn("could not find defclass");
+					return Qnil;
+				}
+				TypedData_Get_Struct(rbDefclass, Defclass, &Defclass_type, defclass);
+				break;
+			case T_DATA:
+				TypedData_Get_Struct(rbDefclass_or_defclass_name, Defclass, &Defclass_type, defclass);
+				break;
+			default:
+				rb_warn("defclass name must be a symbol or string");
+				return Qnil;
+		}
+		for (
+			theInstance = GetNextInstanceInClass(defclass,NULL);
+			theInstance != NULL;
+			theInstance = GetNextInstanceInClass(defclass,theInstance)
+		) {
+			rbInstance =
+				TypedData_Wrap_Struct(rb_const_get(CLASS_OF(rbEnvironment), rb_intern("Instance")), &Instance_type, theInstance);
+
+			rb_iv_set(rbInstance, "@environment", rbEnvironment);
+			rb_ary_push(returnArray, rbInstance);
+		}
+	} else if (include_subclasses == Qtrue) {
+		switch (TYPE(rbDefclass_or_defclass_name)) {
+			case T_STRING:
+			case T_SYMBOL:
+				if (Qnil == (rbDefclass = clips_environment_find_defclass(rbEnvironment, rbDefclass_or_defclass_name))) {
+					rb_warn("could not find defclass");
+					return Qnil;
+				}
+				TypedData_Get_Struct(rbDefclass, Defclass, &Defclass_type, defclass);
+				break;
+			case T_DATA:
+				TypedData_Get_Struct(rbDefclass_or_defclass_name, Defclass, &Defclass_type, defclass);
+				break;
+			default:
+				rb_warn("defclass name must be a symbol or string");
+				return Qnil;
+		}
+		for (
+			theInstance = GetNextInstanceInClassAndSubclasses(&defclass,NULL,&iterator);
+			theInstance != NULL;
+			theInstance = GetNextInstanceInClassAndSubclasses(&defclass,theInstance,&iterator)
+		) {
+			rbInstance =
+				TypedData_Wrap_Struct(rb_const_get(CLASS_OF(rbEnvironment), rb_intern("Instance")), &Instance_type, theInstance);
+
+			rb_iv_set(rbInstance, "@environment", rbEnvironment);
+			rb_ary_push(returnArray, rbInstance);
+		}
+	// unexpected input of some kind...
+	} else {
+		rb_warn("unexpected arguments sent to get_instance_list!");
+		return Qnil;
+	}
+
+	return returnArray;
+}
+
 static VALUE clips_environment_get_deftemplate_list(int argc, VALUE *argv, VALUE rbEnvironment) {
 	VALUE defmodule_or_defmodule_name;
 	Environment *env;
@@ -2193,6 +2720,74 @@ static VALUE clips_environment_static_get_deftemplate_list(int argc, VALUE *argv
 	return out;
 }
 
+static VALUE clips_environment_get_defclass_list(int argc, VALUE *argv, VALUE rbEnvironment) {
+	VALUE defmodule_or_defmodule_name;
+	Environment *env;
+	Defmodule *module;
+	CLIPSValue value;
+	VALUE out;
+
+	TypedData_Get_Struct(rbEnvironment, Environment, &Environment_type, env);
+
+	rb_scan_args(argc, argv, "01", &defmodule_or_defmodule_name);
+	switch (TYPE(defmodule_or_defmodule_name)) {
+		case T_NIL:
+			module = NULL;
+			break;
+		case T_STRING:
+		case T_SYMBOL:
+			TypedData_Get_Struct(
+				clips_environment_find_defmodule(rbEnvironment, defmodule_or_defmodule_name),
+				Defmodule, &Defmodule_type, module);
+			break;
+		case T_DATA:
+			TypedData_Get_Struct(defmodule_or_defmodule_name, Defmodule, &Defmodule_type, module);
+			break;
+                default:
+			rb_warn("defmodule name must be a symbol or string");
+			return Qnil;
+        }
+	GetDefclassList(env, &value, module);
+
+	CLIPSValue_to_VALUE(&value, &out, &rbEnvironment);
+
+	return out;
+}
+
+static VALUE clips_environment_static_get_defclass_list(int argc, VALUE *argv, VALUE klass) {
+	VALUE rbEnvironment, defmodule_or_defmodule_name;
+	Environment *env;
+	Defmodule *module;
+	CLIPSValue value;
+	VALUE out;
+
+	rb_scan_args(argc, argv, "11", &rbEnvironment, &defmodule_or_defmodule_name);
+
+	TypedData_Get_Struct(rbEnvironment, Environment, &Environment_type, env);
+	switch (TYPE(defmodule_or_defmodule_name)) {
+		case T_NIL:
+			module = NULL;
+			break;
+		case T_STRING:
+		case T_SYMBOL:
+			TypedData_Get_Struct(
+				clips_environment_find_defmodule(rbEnvironment, defmodule_or_defmodule_name),
+				Defmodule, &Defmodule_type, module);
+			break;
+		case T_DATA:
+			TypedData_Get_Struct(defmodule_or_defmodule_name, Defmodule, &Defmodule_type, module);
+			break;
+                default:
+			rb_warn("defmodule name must be a symbol or string");
+			return Qnil;
+        }
+	GetDefclassList(env, &value, module);
+
+	CLIPSValue_to_VALUE(&value, &out, &rbEnvironment);
+
+	return out;
+}
+
 static VALUE clips_environment_get_defrule_list(int argc, VALUE *argv, VALUE rbEnvironment) {
 	VALUE defmodule_or_defmodule_name;
 	Environment *env;
@@ -2333,6 +2928,30 @@ static VALUE clips_environment_defmodule_static_get_fact_list(VALUE self, VALUE
 	return clips_environment_defmodule_get_fact_list(rbDefmodule);
 }
 
+static VALUE clips_environment_defmodule_get_defclass_list(VALUE self)
+{
+	Defmodule *module;
+	Environment *env;
+	CLIPSValue value;
+	VALUE out;
+
+	VALUE rbEnvironment = rb_iv_get(self, "@environment");
+
+	TypedData_Get_Struct(self, Defmodule, &Defmodule_type, module);
+	TypedData_Get_Struct(rbEnvironment, Environment, &Environment_type, env);
+
+	GetDefclassList(env, &value, module);
+
+	CLIPSValue_to_VALUE(&value, &out, &rbEnvironment);
+
+	return out;
+}
+
+static VALUE clips_environment_defmodule_static_get_defclass_list(VALUE self, VALUE rbDefmodule)
+{
+	return clips_environment_defmodule_get_defclass_list(rbDefmodule);
+}
+
 static VALUE clips_environment_defmodule_get_deftemplate_list(VALUE self)
 {
 	Defmodule *module;
@@ -3378,14 +3997,22 @@ void Init_clipsruby(void)
 	rb_define_method(rbEnvironment, "find_defmodule", clips_environment_find_defmodule, 1);
 	rb_define_singleton_method(rbEnvironment, "find_deftemplate", clips_environment_static_find_deftemplate, 2);
 	rb_define_method(rbEnvironment, "find_deftemplate", clips_environment_find_deftemplate, 1);
+	rb_define_singleton_method(rbEnvironment, "find_defclass", clips_environment_static_find_defclass, 2);
+	rb_define_method(rbEnvironment, "find_defclass", clips_environment_find_defclass, 1);
+	rb_define_singleton_method(rbEnvironment, "find_instance", clips_environment_static_find_instance, -1);
+	rb_define_method(rbEnvironment, "find_instance", clips_environment_find_instance, -1);
 	rb_define_singleton_method(rbEnvironment, "get_current_module", clips_environment_static_get_current_module, 1);
 	rb_define_method(rbEnvironment, "get_current_module", clips_environment_get_current_module, 0);
 	rb_define_singleton_method(rbEnvironment, "set_current_module", clips_environment_static_set_current_module, 2);
 	rb_define_method(rbEnvironment, "set_current_module", clips_environment_set_current_module, 1);
 	rb_define_singleton_method(rbEnvironment, "get_fact_list", clips_environment_static_get_fact_list, -1);
 	rb_define_method(rbEnvironment, "get_fact_list", clips_environment_get_fact_list, -1);
+	rb_define_singleton_method(rbEnvironment, "get_instance_list", clips_environment_static_get_instance_list, -1);
+	rb_define_method(rbEnvironment, "get_instance_list", clips_environment_get_instance_list, -1);
 	rb_define_singleton_method(rbEnvironment, "get_deftemplate_list", clips_environment_static_get_deftemplate_list, -1);
 	rb_define_method(rbEnvironment, "get_deftemplate_list", clips_environment_get_deftemplate_list, -1);
+	rb_define_singleton_method(rbEnvironment, "get_defclass_list", clips_environment_static_get_defclass_list, -1);
+	rb_define_method(rbEnvironment, "get_defclass_list", clips_environment_get_defclass_list, -1);
 	rb_define_singleton_method(rbEnvironment, "get_defrule_list", clips_environment_static_get_defrule_list, -1);
 	rb_define_method(rbEnvironment, "get_defrule_list", clips_environment_get_defrule_list, -1);
 	rb_define_singleton_method(rbEnvironment, "get_defmodule_list", clips_environment_static_get_defmodule_list, 1);
@@ -3511,12 +4138,16 @@ void Init_clipsruby(void)
 	rb_define_method(rbDefmodule, "pp_form", clips_environment_defmodule_pp_form, 0);
 	rb_define_singleton_method(rbDefmodule, "set_current", clips_environment_defmodule_static_set_current, 1);
 	rb_define_method(rbDefmodule, "set_current", clips_environment_defmodule_set_current, 0);
+	rb_define_singleton_method(rbDefmodule, "get_defclass_list", clips_environment_defmodule_static_get_defclass_list, 1);
+	rb_define_method(rbDefmodule, "get_defclass_list", clips_environment_defmodule_get_defclass_list, 0);
 	rb_define_singleton_method(rbDefmodule, "get_fact_list", clips_environment_defmodule_static_get_fact_list, 1);
 	rb_define_method(rbDefmodule, "get_fact_list", clips_environment_defmodule_get_fact_list, 0);
 	rb_define_singleton_method(rbDefmodule, "get_deftemplate_list", clips_environment_defmodule_static_get_deftemplate_list, 1);
 	rb_define_method(rbDefmodule, "get_deftemplate_list", clips_environment_defmodule_get_deftemplate_list, 0);
 	rb_define_singleton_method(rbDefmodule, "get_defrule_list", clips_environment_defmodule_static_get_defrule_list, 1);
 	rb_define_method(rbDefmodule, "get_defrule_list", clips_environment_defmodule_get_defrule_list, 0);
+	rb_define_singleton_method(rbDefmodule, "find_instance", clips_environment_defmodule_static_find_instance, -1);
+	rb_define_method(rbDefmodule, "find_instance", clips_environment_defmodule_find_instance, -1);
 
 	VALUE rbFact = rb_define_class_under(rbEnvironment, "Fact", rb_cObject);
 	rb_define_alloc_func(rbFact, fact_alloc);
@@ -3568,6 +4199,8 @@ void Init_clipsruby(void)
 	rb_define_method(rbDefclass, "defmodule_name", clips_environment_defclass_defmodule_name, 0);
 	rb_define_singleton_method(rbDefclass, "pp_form", clips_environment_defclass_static_pp_form, 1);
 	rb_define_method(rbDefclass, "pp_form", clips_environment_defclass_pp_form, 0);
+	rb_define_singleton_method(rbDefclass, "get_instance_list", clips_environment_defclass_static_get_instance_list, -1);
+	rb_define_method(rbDefclass, "get_instance_list", clips_environment_defclass_get_instance_list, -1);
 
 	VALUE rbInstance = rb_define_class_under(rbEnvironment, "Instance", rb_cObject);
 	rb_define_alloc_func(rbInstance, instance_alloc);

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: clipsruby
 version: !ruby/object:Gem::Version
-  version: 0.0.33
+  version: 0.0.35
 platform: ruby
 authors:
 - Ryan Johnston
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-09-25 00:00:00.000000000 Z
+date: 2024-09-27 00:00:00.000000000 Z
 dependencies: []
 description: Calling the CLIPS programming language from within Ruby
 email: mrryanjohnston@gmail.com