clipsruby 0.0.34 → 0.0.35

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5d62cc0e5ccc41bfc4e88590c7a3873859271163fa5dd73b416c0cf2d61b7ed1
-  data.tar.gz: d3cd61d58609c516b8c952dbc32393d54251f09bdc3a8a5f15f531cdf2d707ee
+  metadata.gz: f9bdca59f142899fe858cb253d57ce0d1b2d3eae763a57cb91d7278196e77f88
+  data.tar.gz: 5c958baae6e99acde4729fb3755bbfa9d8ec613e1dfd53b18b970c3824767872
 SHA512:
-  metadata.gz: c6473260b0da57bb78894841385c6cc1b4ecddb4448dc80edf7c0542e654b8dca6884efdc37b9be976d6b0bed22fadd24da5313ef8ba59b5cd71639a18cd2f42
-  data.tar.gz: 90af7d185f0ca31b1d543e0550cf4520d021525225e3bba8087d5f449591ffe40fa6a34380293b689876ec9d84dc9b3d8860c18b50b525610b3ca890ff727c5a
+  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,21 @@ 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`
 
@@ -650,6 +697,26 @@ 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`
 

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;
@@ -2159,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;
@@ -3506,12 +3999,16 @@ void Init_clipsruby(void)
 	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);
@@ -3649,6 +4146,8 @@ void Init_clipsruby(void)
 	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);
@@ -3700,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.34
+  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