Merge branch 'developement'

Author: evereux

.gitignore

@@ -141,4 +141,5 @@ pycatia-exe.dist
 zip_win32_dist.py
 win_32/pycatia
 pycatia-exe.py
-logo*
+logo*
+*.cgr

CHANGELOG.md

@@ -1,8 +1,23 @@
 # Changelog
 
+
+## 0.4.4
+Many thanks to Tian-Jionglu for his contributions.
+* Improved checks for malformed filenames.
+* Add method Application.setting_controllers.
+* Improvements to export_data.
+* Added Product.type.
+* Docstring fix for Measurable.get_minimum_distance.
+* Added __iter__ method to collections. 
+
+
 ## 0.4.3
 * Updated ViewPoint3D get methods so they now work.
 * Updated Viewer so Viewer2D and Viewer3D can be called.
+* Fix issue #58. 
+  * Change file_name argument so that it now expects Path().
+  * Log warning to console if full path isn't provided.
+  * Raise error if directory doesn't exist.
 
 ## 0.4.2
 * Added missing methods Parameter.rename(), Parameter.valuate_from_string(), 

README.rst

@@ -123,7 +123,7 @@ To run a specific test:
 
 To stop tests running after first failure.
 
-    py.text -vx
+    py.test -vx
 
 Release process
 ---------------

docs/conf.py

@@ -36,7 +36,7 @@ def __getattr__(cls, name):
 author = 'Paul Bourne'
 
 # The short X.Y version
-version = '0.4.3'
+version = '0.4.4'
 # The full version, including alpha/beta/rc tags
 release = version
 

docs/examples.rst

@@ -10,7 +10,7 @@ Example 1
 
 Get the center of gravity for the part body 'PartBody'.
 
-`Example 1 <https://github.com/evereux/pycatia/blob/master/example_001.py>`_
+`Example 1 <https://github.com/evereux/pycatia/blob/master/examples/example_001.py>`_
 
 
 Example 2
@@ -20,23 +20,23 @@ Get all the points in the geometrical set 'Points' and output co-ordinate to con
 
 Create your own CATPart with a Geometrical Set called construction_points. Add some points to the Geometrical Set.
 
-`Example 2 <https://github.com/evereux/pycatia/blob/master/example_002.py>`_
+`Example 2 <https://github.com/evereux/pycatia/blob/master/examples/example_002.py>`_
 
 
 Example 3
 ---------
 
 Find all points in the CATPart and print to console and export to csv.
 
-`Example 3 <https://github.com/evereux/pycatia/blob/master/example_003.py>`_
+`Example 3 <https://github.com/evereux/pycatia/blob/master/examples/example_003.py>`_
 
 
 Example 4
 ---------
 
 Loop through a CATProduct and find if sub component is a CATPart or CATProduct.
 
-`Example 4 <https://github.com/evereux/pycatia/blob/master/example_004.py>`_
+`Example 4 <https://github.com/evereux/pycatia/blob/master/examples/example_004.py>`_
 
 
 Example 5
@@ -49,7 +49,7 @@ Formatting of csv data should be:
 
     <point_name>,<x coordinate>,<y coordinate>,<z coordinate>
 
-`Example 5 <https://github.com/evereux/pycatia/blob/master/example_005.py>`_
+`Example 5 <https://github.com/evereux/pycatia/blob/master/examples/example_005.py>`_
 
 
 Example 6
@@ -61,31 +61,31 @@ Export catia file to igs.
 
 Close a catia file.
 
-`Example 6 <https://github.com/evereux/pycatia/blob/master/example_006.py>`_
+`Example 6 <https://github.com/evereux/pycatia/blob/master/examples/example_006.py>`_
 
 
 Example 7
 ---------
 
 Use the context manager to open CATIA documents and close.
 
-`Example 7 <https://github.com/evereux/pycatia/blob/master/example_007.py>`_
+`Example 7 <https://github.com/evereux/pycatia/blob/master/examples/example_007.py>`_
 
 
 Example 8
 ---------
 
 Open all CATParts in source directory and save to IGS in target directory.
 
-`Example 8 <https://github.com/evereux/pycatia/blob/master/example_008.py>`_
+`Example 8 <https://github.com/evereux/pycatia/blob/master/examples/example_008.py>`_
 
 
 Example 9
 ---------
 
 Get the position matrix of products (CATPart or CATProduct) in product.
 
-`Example 9 <https://github.com/evereux/pycatia/blob/master/example_009.py>`_
+`Example 9 <https://github.com/evereux/pycatia/blob/master/examples/example_009.py>`_
 
 
 Example 10
@@ -95,15 +95,15 @@ Loop through a CATProduct and analyse children if CATPart.
 
 Only goes two levels deep.
 
-`Example 10 <https://github.com/evereux/pycatia/blob/master/example_010.py>`_
+`Example 10 <https://github.com/evereux/pycatia/blob/master/examples/example_010.py>`_
 
 
 Example 11
 ----------
 
 Move the first child in product.
 
-`Example 11 <https://github.com/evereux/pycatia/blob/master/example_011.py>`_
+`Example 11 <https://github.com/evereux/pycatia/blob/master/examples/example_011.py>`_
 
 
 Example 12
@@ -114,31 +114,31 @@ each parameter along with its name, value and its associated parameter set.
 
 # todo: need to create a source part to support this example.
 
-`Example 12 <https://github.com/evereux/pycatia/blob/master/example_012.py>`_
+`Example 12 <https://github.com/evereux/pycatia/blob/master/examples/example_012.py>`_
 
 
 Example 13
 ----------
 
 3D Points, Spline, Extrusion and Generate Thickness.
 
-`Example 13 <https://github.com/evereux/pycatia/blob/master/example_013.py>`_
+`Example 13 <https://github.com/evereux/pycatia/blob/master/examples/example_013.py>`_
 
 
 Example 14
 ----------
 
 Logging.
 
-`Example 14 <https://github.com/evereux/pycatia/blob/master/example_014.py>`_
+`Example 14 <https://github.com/evereux/pycatia/blob/master/examples/example_014.py>`_
 
 
 Example 15
 ----------
 
 Draw a line between two points.
 
-`Example 15 <https://github.com/evereux/pycatia/blob/master/example_016.py>`_
+`Example 15 <https://github.com/evereux/pycatia/blob/master/examples/example_016.py>`_
 
 
 Example 16
@@ -147,7 +147,7 @@ Example 16
 Creates a square in a sketch and fully constrains it. Sketch then used to pad.
 
 
-`Example 16 <https://github.com/evereux/pycatia/blob/master/example_016.py>`_
+`Example 16 <https://github.com/evereux/pycatia/blob/master/examples/example_016.py>`_
 
 
 Example 17
@@ -156,7 +156,7 @@ Example 17
 Drafting: create a border template in the background view of the currently opened A0 landscape CATDrawing.
 
 
-`Example 17 <https://github.com/evereux/pycatia/blob/master/example_017.py>`_
+`Example 17 <https://github.com/evereux/pycatia/blob/master/examples/example_017.py>`_
 
 
 Example 18
@@ -174,7 +174,7 @@ Example 18
 Assembly Design: Reorder a Product tree alphabetically. The Product shall
 already be loaded.
 
-`Example 18 <https://github.com/evereux/pycatia/blob/master/example_018.py>`_
+`Example 18 <https://github.com/evereux/pycatia/blob/master/examples/example_018.py>`_
 
 
 Example 19
@@ -183,15 +183,15 @@ Example 19
 Searching and changing visual properties. Find all Red points and make them
 Pink.
 
-`Example 19 <https://github.com/evereux/pycatia/blob/master/example_019.py>`_
+`Example 19 <https://github.com/evereux/pycatia/blob/master/examples/example_019.py>`_
 
 
 Example 20
 ----------
 
 This creates a message box with the buttons abort, retry ignore and displays the Warning Query icon.
 
-`Example 20 <https://github.com/evereux/pycatia/blob/master/example_020.py>`_
+`Example 20 <https://github.com/evereux/pycatia/blob/master/examples/example_020.py>`_
 
 
 Example 21
@@ -200,7 +200,7 @@ Example 21
 Sequentially rename all points in geometric set (hybrid body) Points in the geometric set MasterGeometry.
 
 
-`Example 21 <https://github.com/evereux/pycatia/blob/master/example_021.py>`_
+`Example 21 <https://github.com/evereux/pycatia/blob/master/examples/example_021.py>`_
 
 
 Example 22
@@ -215,7 +215,7 @@ Requires an active part document open with a geometrical set called
 and line generated using HybridShapeLinePtPt
 
 
-`Example 22 <https://github.com/evereux/pycatia/blob/master/example_022.py>`_
+`Example 22 <https://github.com/evereux/pycatia/blob/master/examples/example_022.py>`_
 
 
 Example 23
@@ -224,21 +224,21 @@ Example 23
 Fix the first Sub Product in Product using constraints. The Sketch examples
 also show further usage of constraints.
 
-`Example 23 <https://github.com/evereux/pycatia/blob/master/example_023.py>`_
+`Example 23 <https://github.com/evereux/pycatia/blob/master/examples/example_023.py>`_
 
 Example 24
 ----------
 
 Basic license checking.
 
-`Example 24 <https://github.com/evereux/pycatia/blob/master/example_024.py>`_
+`Example 24 <https://github.com/evereux/pycatia/blob/master/examples/example_024.py>`_
 
 Example 25
 ----------
 
 Write the contents of a product to a html file.
 
-`Example 25 <https://github.com/evereux/pycatia/blob/master/example_025.py>`_
+`Example 25 <https://github.com/evereux/pycatia/blob/master/examples/example_025.py>`_
 
 Example 26
 ----------
@@ -252,7 +252,7 @@ Prompt the user to select a product and get it's bounding box parameters
     product you have selected.
 
 
-`Example 26 <https://github.com/evereux/pycatia/blob/master/example_026.py>`_
+`Example 26 <https://github.com/evereux/pycatia/blob/master/examples/example_026.py>`_
 
 
 Example 27
@@ -264,4 +264,4 @@ END VIEW and ISO pngs for each part.
 The tree is turned off and the background turned white for the screen
 capture and then turned back on.
 
-`Example 27 <https://github.com/evereux/pycatia/blob/master/example_027.py>`_
+`Example 27 <https://github.com/evereux/pycatia/blob/master/examples/example_027.py>`_

example_001.py renamed to examples/example_001.py

@@ -8,6 +8,15 @@
 
 """
 
+##########################################################
+# insert syspath to project folder so examples can be run.
+# for development purposes.
+import os
+import sys
+
+sys.path.insert(0, os.path.abspath('..\\pycatia'))
+##########################################################
+
 from pycatia import catia
 
 # initialise the catia automation application

example_002.py renamed to examples/example_002.py

@@ -9,6 +9,16 @@
     Create your own CATPart with a Geometrical Set called construction_points. Add some points to the Geometrical Set.
 
 """
+
+##########################################################
+# insert syspath to project folder so examples can be run.
+# for development purposes.
+import os
+import sys
+
+sys.path.insert(0, os.path.abspath('..\\pycatia'))
+##########################################################
+
 from pycatia import catia
 
 caa = catia()

example_003.py renamed to examples/example_003.py

@@ -8,6 +8,15 @@
 
 """
 
+##########################################################
+# insert syspath to project folder so examples can be run.
+# for development purposes.
+import os
+import sys
+
+sys.path.insert(0, os.path.abspath('..\\pycatia'))
+##########################################################
+
 import csv
 
 from pycatia import catia

example_004.py renamed to examples/example_004.py

@@ -8,6 +8,15 @@
 
 """
 
+##########################################################
+# insert syspath to project folder so examples can be run.
+# for development purposes.
+import os
+import sys
+
+sys.path.insert(0, os.path.abspath('..\\pycatia'))
+##########################################################
+
 from pycatia import catia
 from pycatia.enumeration.enumeration_types import cat_work_mode_type
 

example_005.py renamed to examples/example_005.py

@@ -13,6 +13,15 @@
 
 """
 
+##########################################################
+# insert syspath to project folder so examples can be run.
+# for development purposes.
+import os
+import sys
+
+sys.path.insert(0, os.path.abspath('..\\pycatia'))
+##########################################################
+
 from pycatia import catia
 from pycatia.scripts.csv_tools import create_points