build(release): merge branch develop (release 0.2.0)

.gitignore

@@ -1,3 +1,4 @@
 __pycache__
 /docs/build
-/.vscode
+/.vscode
+/tests/temp

bin/tests.sh

@@ -0,0 +1,46 @@
+#!/bin/sh
+
+revitVersion=2022
+glob="test_*.py"
+
+cd "`dirname $0`/.."
+revitronDir=`pwd`
+testsPy="$revitronDir/tests/run.py"
+testsTemp="$revitronDir/tests/temp"
+testsRvt="$testsTemp/tests.rvt"
+testsLog="$testsTemp/tests.log"
+testsConfig="$testsTemp/config.json"
+
+mkdir -p $testsTemp
+
+while getopts 'g:r:' opt; do
+	case $opt in
+		g)
+			glob=$OPTARG
+			;;
+		r)
+			revitVersion=$OPTARG
+			;;
+		\?)
+			echo "$opt is not a valid option"
+			exit 0
+	esac
+done
+
+echo "{ \"glob\": \"$glob\" }" > $testsConfig
+
+cd "$revitronDir/../.."
+
+bin/pyrevit run $testsPy $testsRvt --revit=$revitVersion --purge
+
+clear 
+
+echo
+echo "Revitron Unit Tests"
+echo "======================================================================"
+echo "Test pattern:   $glob"
+echo "Revit version:  $revitVersion"
+echo "----------------------------------------------------------------------"
+echo
+
+cat $testsLog

docs/source/_static/custom.css

@@ -1,3 +1,7 @@
+html.dark {
+	--bg-highlight: transparent;
+}
+
 .landing .headerlink:after {
 	display: none !important;
 }

docs/source/conf.py

@@ -46,7 +46,7 @@
 
 napoleon_google_docstring = True
 napoleon_include_init_with_doc = True
-napoleon_include_private_with_doc = True
+napoleon_include_private_with_doc = False
 napoleon_include_special_with_doc = True
 napoleon_use_admonition_for_examples = False
 napoleon_use_admonition_for_notes = True

docs/source/index.rst

@@ -32,6 +32,5 @@ Revitron
 
    Revitron UI <https://revitron-ui.readthedocs.io/>
    User Guide <https://revitron-ui.readthedocs.io/en/latest/user-guide.html>
-   Unit Tests <https://github.com/revitron/revitron-tests>
    GitHub <https://github.com/revitron/revitron>
    ♡ Sponsor <https://github.com/sponsors/marcantondahmen>

docs/source/revitron.grid.rst

@@ -0,0 +1,9 @@
+revitron.grid
+=============
+
+.. automodule:: revitron.grid
+   :members:
+   :undoc-members:
+   :inherited-members:
+   :show-inheritance:
+   :autosummary:

docs/source/revitron.rst

@@ -23,6 +23,7 @@ Submodules
    revitron.failure
    revitron.filter
    revitron.geometry
+   revitron.grid
    revitron.link
    revitron.parameter
    revitron.raytrace

revitron/__init__.py

@@ -96,6 +96,7 @@
 from revitron.failure import *
 from revitron.filter import *
 from revitron.geometry import *
+from revitron.grid import *
 from revitron.link import *
 from revitron.parameter import *
 from revitron.raytrace import *
@@ -121,7 +122,7 @@
 DB = Autodesk.Revit.DB
 LIB_DIR = parent(parent(__file__))
 REVIT_VERSION = pyrevit.HOST_APP.uiapp.Application.VersionNumber
-REVITRON_VERSION = '0.1.8'
+REVITRON_VERSION = '0.2.0'
 
 
 def _(element):

revitron/create.py

@@ -95,7 +95,31 @@ def familyInstance(familySymbolId, location, structuralType = False):
 		if not familySymbol.IsActive:
 			familySymbol.Activate()
 		return revitron.DOC.Create.NewFamilyInstance(location, familySymbol, structuralType)
-
+
+
+	@staticmethod
+	def GridLineLinear(start, end, name):
+		"""
+		Create a new linear grid line.
+
+		Args:
+			start (object): A Revit ``XYZ`` element
+			end (object): A Revit ``XYZ`` element
+			name (string): The grid name
+
+		Returns:
+			object: A Revit grid element
+		"""
+		import revitron
+		line = revitron.DB.Line.CreateBound(start, end)
+		try:
+			grid = revitron.DB.Grid.Create(revitron.DOC, line)
+			grid.Name = name
+			return grid
+		except:
+			revitron.Log().error('Can\'t create grid line "{}"'.format(name))
+			return None
+
 
 	@staticmethod
 	def roomTag(room, location, typeId = False, viewId = False):
@@ -130,7 +154,7 @@ def roomTag(room, location, typeId = False, viewId = False):
 			if tag.IsValidType(typeId):
 				tag.ChangeTypeId(typeId)
 
-		return tag        
+		return tag
 
 
 	@staticmethod

revitron/filter.py

@@ -199,6 +199,9 @@ def byClass(self, cls):
 		"""
 		Filters the collection by class.
 
+		Args:
+			cls (class): A class to filter the elements
+
 		Returns:
 			object: The Filter instance
 		"""