COMPAS 2.1.1__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- compas/__init__.py +274 -0
- compas/__main__.py +31 -0
- compas/_iotools.py +80 -0
- compas/_os.py +746 -0
- compas/colors/__init__.py +14 -0
- compas/colors/cmcrameri/acton.txt +256 -0
- compas/colors/cmcrameri/actonS.txt +100 -0
- compas/colors/cmcrameri/bam.txt +256 -0
- compas/colors/cmcrameri/bamO.txt +256 -0
- compas/colors/cmcrameri/bamako.txt +256 -0
- compas/colors/cmcrameri/bamakoS.txt +100 -0
- compas/colors/cmcrameri/batlow.txt +256 -0
- compas/colors/cmcrameri/batlowK.txt +256 -0
- compas/colors/cmcrameri/batlowS.txt +100 -0
- compas/colors/cmcrameri/batlowW.txt +256 -0
- compas/colors/cmcrameri/berlin.txt +256 -0
- compas/colors/cmcrameri/bilbao.txt +256 -0
- compas/colors/cmcrameri/bilbaoS.txt +100 -0
- compas/colors/cmcrameri/broc.txt +256 -0
- compas/colors/cmcrameri/brocO.txt +256 -0
- compas/colors/cmcrameri/buda.txt +256 -0
- compas/colors/cmcrameri/budaS.txt +100 -0
- compas/colors/cmcrameri/bukavu.txt +256 -0
- compas/colors/cmcrameri/cork.txt +256 -0
- compas/colors/cmcrameri/corkO.txt +256 -0
- compas/colors/cmcrameri/davos.txt +256 -0
- compas/colors/cmcrameri/davosS.txt +100 -0
- compas/colors/cmcrameri/devon.txt +256 -0
- compas/colors/cmcrameri/devonS.txt +100 -0
- compas/colors/cmcrameri/fes.txt +256 -0
- compas/colors/cmcrameri/grayC.txt +256 -0
- compas/colors/cmcrameri/grayCS.txt +100 -0
- compas/colors/cmcrameri/hawaii.txt +256 -0
- compas/colors/cmcrameri/hawaiiS.txt +100 -0
- compas/colors/cmcrameri/imola.txt +256 -0
- compas/colors/cmcrameri/imolaS.txt +100 -0
- compas/colors/cmcrameri/lajolla.txt +256 -0
- compas/colors/cmcrameri/lajollaS.txt +100 -0
- compas/colors/cmcrameri/lapaz.txt +256 -0
- compas/colors/cmcrameri/lapazS.txt +100 -0
- compas/colors/cmcrameri/lisbon.txt +256 -0
- compas/colors/cmcrameri/nuuk.txt +256 -0
- compas/colors/cmcrameri/nuukS.txt +100 -0
- compas/colors/cmcrameri/oleron.txt +256 -0
- compas/colors/cmcrameri/oslo.txt +256 -0
- compas/colors/cmcrameri/osloS.txt +100 -0
- compas/colors/cmcrameri/roma.txt +256 -0
- compas/colors/cmcrameri/romaO.txt +256 -0
- compas/colors/cmcrameri/tofino.txt +256 -0
- compas/colors/cmcrameri/tokyo.txt +256 -0
- compas/colors/cmcrameri/tokyoS.txt +100 -0
- compas/colors/cmcrameri/turku.txt +256 -0
- compas/colors/cmcrameri/turkuS.txt +100 -0
- compas/colors/cmcrameri/vanimo.txt +256 -0
- compas/colors/cmcrameri/vik.txt +256 -0
- compas/colors/cmcrameri/vikO.txt +256 -0
- compas/colors/color.py +1118 -0
- compas/colors/colordict.py +103 -0
- compas/colors/colormap.py +306 -0
- compas/colors/html_colors.py +149 -0
- compas/colors/mpl_colormap.py +1064 -0
- compas/data/__init__.py +31 -0
- compas/data/coercion.py +71 -0
- compas/data/conftest.py +10 -0
- compas/data/data.py +342 -0
- compas/data/encoders.py +240 -0
- compas/data/exceptions.py +2 -0
- compas/data/json.py +240 -0
- compas/data/samples/boxes.obj +250 -0
- compas/data/samples/butt_model.obj +2829 -0
- compas/data/samples/cone.stl +0 -0
- compas/data/samples/cube.off +16 -0
- compas/data/samples/cube_ascii.stl +56114 -0
- compas/data/samples/cube_binary.stl +0 -0
- compas/data/samples/cube_binary_2.stl +0 -0
- compas/data/samples/doosabin.json +1 -0
- compas/data/samples/faces.obj +63 -0
- compas/data/samples/faces_big.obj +9663 -0
- compas/data/samples/faces_reversed.obj +63 -0
- compas/data/samples/fink.obj +135 -0
- compas/data/samples/grid_irregular.obj +303 -0
- compas/data/samples/hypar.obj +148 -0
- compas/data/samples/lines.json +1 -0
- compas/data/samples/lines.obj +282 -0
- compas/data/samples/lines_big.obj +40322 -0
- compas/data/samples/lines_bigger.obj +161282 -0
- compas/data/samples/lines_noleaves.obj +422 -0
- compas/data/samples/mesh.obj +874 -0
- compas/data/samples/mesh_100_faces.json +1893 -0
- compas/data/samples/mesh_110_faces.json +2081 -0
- compas/data/samples/open_edges.obj +424 -0
- compas/data/samples/point.json +1 -0
- compas/data/samples/quadmesh.obj +183 -0
- compas/data/samples/quadmesh_planar.obj +181 -0
- compas/data/samples/saddle.obj +314 -0
- compas/data/samples/spline.obj +72 -0
- compas/data/samples/tubemesh.json +1 -0
- compas/data/samples/tubemesh.obj +378 -0
- compas/data/samples/tubemesh.off +374 -0
- compas/data/samples/tubemesh.ply +551 -0
- compas/data/schema.py +137 -0
- compas/data/validators.py +243 -0
- compas/datastructures/__init__.py +75 -0
- compas/datastructures/_mutablemapping.py +148 -0
- compas/datastructures/assembly/__init__.py +0 -0
- compas/datastructures/assembly/assembly.py +234 -0
- compas/datastructures/assembly/exceptions.py +6 -0
- compas/datastructures/assembly/part.py +228 -0
- compas/datastructures/attributes.py +85 -0
- compas/datastructures/cell_network/__init__.py +0 -0
- compas/datastructures/cell_network/cell_network.py +4190 -0
- compas/datastructures/datastructure.py +309 -0
- compas/datastructures/graph/__init__.py +0 -0
- compas/datastructures/graph/duality.py +197 -0
- compas/datastructures/graph/graph.py +2478 -0
- compas/datastructures/graph/operations/__init__.py +0 -0
- compas/datastructures/graph/operations/join.py +124 -0
- compas/datastructures/graph/operations/split.py +63 -0
- compas/datastructures/graph/planarity.py +292 -0
- compas/datastructures/graph/smoothing.py +59 -0
- compas/datastructures/mesh/__init__.py +0 -0
- compas/datastructures/mesh/conway.py +553 -0
- compas/datastructures/mesh/duality.py +104 -0
- compas/datastructures/mesh/mesh.py +5103 -0
- compas/datastructures/mesh/operations/__init__.py +0 -0
- compas/datastructures/mesh/operations/collapse.py +350 -0
- compas/datastructures/mesh/operations/extrude.py +0 -0
- compas/datastructures/mesh/operations/insert.py +120 -0
- compas/datastructures/mesh/operations/merge.py +83 -0
- compas/datastructures/mesh/operations/split.py +263 -0
- compas/datastructures/mesh/operations/substitute.py +37 -0
- compas/datastructures/mesh/operations/swap.py +62 -0
- compas/datastructures/mesh/operations/weld.py +107 -0
- compas/datastructures/mesh/remesh.py +234 -0
- compas/datastructures/mesh/slice.py +170 -0
- compas/datastructures/mesh/smoothing.py +187 -0
- compas/datastructures/mesh/subdivision.py +754 -0
- compas/datastructures/tree/__init__.py +0 -0
- compas/datastructures/tree/tree.py +504 -0
- compas/datastructures/volmesh/__init__.py +0 -0
- compas/datastructures/volmesh/volmesh.py +4203 -0
- compas/files/__init__.py +27 -0
- compas/files/_xml/__init__.py +0 -0
- compas/files/_xml/xml_cli.py +213 -0
- compas/files/_xml/xml_cpython.py +32 -0
- compas/files/_xml/xml_pre_38.py +58 -0
- compas/files/_xml/xml_shared.py +40 -0
- compas/files/gltf/__init__.py +0 -0
- compas/files/gltf/constants.py +59 -0
- compas/files/gltf/data_classes.py +657 -0
- compas/files/gltf/extensions.py +317 -0
- compas/files/gltf/gltf.py +92 -0
- compas/files/gltf/gltf_children.py +64 -0
- compas/files/gltf/gltf_content.py +615 -0
- compas/files/gltf/gltf_exporter.py +465 -0
- compas/files/gltf/gltf_mesh.py +273 -0
- compas/files/gltf/gltf_node.py +348 -0
- compas/files/gltf/gltf_parser.py +115 -0
- compas/files/gltf/gltf_reader.py +310 -0
- compas/files/gltf/gltf_scene.py +125 -0
- compas/files/gltf/helpers.py +59 -0
- compas/files/obj.py +680 -0
- compas/files/off.py +296 -0
- compas/files/ply.py +697 -0
- compas/files/stl.py +436 -0
- compas/files/xml.py +328 -0
- compas/geometry/__init__.py +772 -0
- compas/geometry/_core/__init__.py +0 -0
- compas/geometry/_core/_algebra.py +2826 -0
- compas/geometry/_core/angles.py +408 -0
- compas/geometry/_core/centroids.py +573 -0
- compas/geometry/_core/distance.py +895 -0
- compas/geometry/_core/normals.py +149 -0
- compas/geometry/_core/nurbs.py +367 -0
- compas/geometry/_core/predicates_2.py +582 -0
- compas/geometry/_core/predicates_3.py +1111 -0
- compas/geometry/_core/quaternions.py +196 -0
- compas/geometry/_core/size.py +204 -0
- compas/geometry/_core/tangent.py +56 -0
- compas/geometry/_core/transformations.py +1121 -0
- compas/geometry/_core/transformations_numpy.py +279 -0
- compas/geometry/bbox.py +145 -0
- compas/geometry/bbox_numpy.py +306 -0
- compas/geometry/bestfit.py +77 -0
- compas/geometry/bestfit_numpy.py +259 -0
- compas/geometry/booleans.py +297 -0
- compas/geometry/booleans_shapely.py +147 -0
- compas/geometry/brep/__init__.py +112 -0
- compas/geometry/brep/brep.py +1131 -0
- compas/geometry/brep/edge.py +302 -0
- compas/geometry/brep/errors.py +22 -0
- compas/geometry/brep/face.py +329 -0
- compas/geometry/brep/loop.py +87 -0
- compas/geometry/brep/trim.py +46 -0
- compas/geometry/brep/vertex.py +46 -0
- compas/geometry/contours.py +32 -0
- compas/geometry/curves/__init__.py +0 -0
- compas/geometry/curves/arc.py +429 -0
- compas/geometry/curves/bezier.py +345 -0
- compas/geometry/curves/circle.py +500 -0
- compas/geometry/curves/conic.py +16 -0
- compas/geometry/curves/curve.py +614 -0
- compas/geometry/curves/ellipse.py +408 -0
- compas/geometry/curves/hyperbola.py +336 -0
- compas/geometry/curves/line.py +431 -0
- compas/geometry/curves/nurbs.py +412 -0
- compas/geometry/curves/parabola.py +256 -0
- compas/geometry/curves/polyline.py +724 -0
- compas/geometry/frame.py +769 -0
- compas/geometry/geometry.py +296 -0
- compas/geometry/hull.py +146 -0
- compas/geometry/hull_numpy.py +82 -0
- compas/geometry/icp_numpy.py +104 -0
- compas/geometry/interpolation_barycentric.py +38 -0
- compas/geometry/interpolation_coons.py +102 -0
- compas/geometry/interpolation_tweening.py +87 -0
- compas/geometry/intersection.py +121 -0
- compas/geometry/intersections.py +1105 -0
- compas/geometry/kdtree.py +153 -0
- compas/geometry/offset.py +208 -0
- compas/geometry/pca_numpy.py +87 -0
- compas/geometry/plane.py +657 -0
- compas/geometry/point.py +664 -0
- compas/geometry/pointcloud.py +409 -0
- compas/geometry/polygon.py +473 -0
- compas/geometry/polyhedron.py +650 -0
- compas/geometry/projection.py +155 -0
- compas/geometry/quadmesh_planarize.py +30 -0
- compas/geometry/quadmesh_planarize_none.py +114 -0
- compas/geometry/quaternion.py +544 -0
- compas/geometry/reflection.py +102 -0
- compas/geometry/rotation.py +354 -0
- compas/geometry/scale.py +100 -0
- compas/geometry/shapes/__init__.py +0 -0
- compas/geometry/shapes/box.py +747 -0
- compas/geometry/shapes/capsule.py +472 -0
- compas/geometry/shapes/cone.py +309 -0
- compas/geometry/shapes/cylinder.py +355 -0
- compas/geometry/shapes/shape.py +300 -0
- compas/geometry/shapes/sphere.py +362 -0
- compas/geometry/shapes/torus.py +294 -0
- compas/geometry/shear.py +115 -0
- compas/geometry/surfaces/__init__.py +0 -0
- compas/geometry/surfaces/conical.py +166 -0
- compas/geometry/surfaces/cylindrical.py +251 -0
- compas/geometry/surfaces/extrusion.py +0 -0
- compas/geometry/surfaces/nurbs.py +380 -0
- compas/geometry/surfaces/planar.py +223 -0
- compas/geometry/surfaces/revolution.py +0 -0
- compas/geometry/surfaces/spherical.py +259 -0
- compas/geometry/surfaces/surface.py +689 -0
- compas/geometry/surfaces/toroidal.py +198 -0
- compas/geometry/transformation.py +554 -0
- compas/geometry/translation.py +104 -0
- compas/geometry/triangulation_delaunay.py +102 -0
- compas/geometry/triangulation_earclip.py +300 -0
- compas/geometry/trimesh_curvature.py +113 -0
- compas/geometry/trimesh_descent_numpy.py +26 -0
- compas/geometry/trimesh_geodistance.py +35 -0
- compas/geometry/trimesh_gradient_numpy.py +74 -0
- compas/geometry/trimesh_isolines.py +41 -0
- compas/geometry/trimesh_matrices.py +31 -0
- compas/geometry/trimesh_matrices_numpy.py +191 -0
- compas/geometry/trimesh_parametrisation.py +55 -0
- compas/geometry/trimesh_pull_points_numpy.py +216 -0
- compas/geometry/trimesh_remeshing.py +97 -0
- compas/geometry/trimesh_samplepoints_numpy.py +108 -0
- compas/geometry/trimesh_slicing.py +28 -0
- compas/geometry/trimesh_smoothing_numpy.py +34 -0
- compas/geometry/vector.py +889 -0
- compas/itertools.py +441 -0
- compas/linalg.py +634 -0
- compas/matrices.py +314 -0
- compas/plugins.py +488 -0
- compas/rpc/__init__.py +20 -0
- compas/rpc/__main__.py +77 -0
- compas/rpc/dispatcher.py +181 -0
- compas/rpc/errors.py +11 -0
- compas/rpc/proxy.py +437 -0
- compas/rpc/server.py +79 -0
- compas/rpc/services/__init__.py +0 -0
- compas/rpc/services/default.py +87 -0
- compas/rpc/services/watcher.py +43 -0
- compas/scene/__init__.py +56 -0
- compas/scene/assemblyobject.py +3 -0
- compas/scene/context.py +154 -0
- compas/scene/descriptors/__init__.py +0 -0
- compas/scene/descriptors/attribute.py +30 -0
- compas/scene/descriptors/color.py +91 -0
- compas/scene/descriptors/colordict.py +101 -0
- compas/scene/descriptors/protocol.py +12 -0
- compas/scene/exceptions.py +7 -0
- compas/scene/geometryobject.py +58 -0
- compas/scene/graphobject.py +173 -0
- compas/scene/meshobject.py +238 -0
- compas/scene/scene.py +144 -0
- compas/scene/sceneobject.py +253 -0
- compas/scene/volmeshobject.py +252 -0
- compas/tolerance.py +879 -0
- compas/topology/__init__.py +45 -0
- compas/topology/combinatorics.py +108 -0
- compas/topology/connectivity.py +129 -0
- compas/topology/orientation.py +204 -0
- compas/topology/traversal.py +567 -0
- compas/utilities/__init__.py +25 -0
- compas/utilities/azync.py +155 -0
- compas/utilities/datetime.py +40 -0
- compas/utilities/decorators.py +136 -0
- compas/utilities/remote.py +54 -0
- compas/utilities/ssh.py +169 -0
- compas-2.1.1.dist-info/AUTHORS.md +42 -0
- compas-2.1.1.dist-info/LICENSE +21 -0
- compas-2.1.1.dist-info/METADATA +132 -0
- compas-2.1.1.dist-info/RECORD +468 -0
- compas-2.1.1.dist-info/WHEEL +5 -0
- compas-2.1.1.dist-info/entry_points.txt +2 -0
- compas-2.1.1.dist-info/top_level.txt +4 -0
- compas_blender/__init__.py +250 -0
- compas_blender/collections.py +130 -0
- compas_blender/conversions/__init__.py +48 -0
- compas_blender/conversions/breps.py +0 -0
- compas_blender/conversions/colors.py +23 -0
- compas_blender/conversions/curves.py +125 -0
- compas_blender/conversions/geometry.py +161 -0
- compas_blender/conversions/meshes.py +148 -0
- compas_blender/conversions/surfaces.py +48 -0
- compas_blender/conversions/transformations.py +46 -0
- compas_blender/data.py +30 -0
- compas_blender/geometry/__init__.py +14 -0
- compas_blender/geometry/booleans.py +100 -0
- compas_blender/install.py +338 -0
- compas_blender/objects.py +326 -0
- compas_blender/print_python_path.py +18 -0
- compas_blender/scene/__init__.py +116 -0
- compas_blender/scene/boxobject.py +64 -0
- compas_blender/scene/capsuleobject.py +73 -0
- compas_blender/scene/circleobject.py +53 -0
- compas_blender/scene/coneobject.py +70 -0
- compas_blender/scene/curveobject.py +58 -0
- compas_blender/scene/cylinderobject.py +70 -0
- compas_blender/scene/frameobject.py +105 -0
- compas_blender/scene/graphobject.py +257 -0
- compas_blender/scene/lineobject.py +60 -0
- compas_blender/scene/meshobject.py +508 -0
- compas_blender/scene/planeobject.py +81 -0
- compas_blender/scene/pointcloudobject.py +67 -0
- compas_blender/scene/pointobject.py +71 -0
- compas_blender/scene/polygonobject.py +57 -0
- compas_blender/scene/polyhedronobject.py +57 -0
- compas_blender/scene/polylineobject.py +54 -0
- compas_blender/scene/sceneobject.py +249 -0
- compas_blender/scene/sphereobject.py +72 -0
- compas_blender/scene/surfaceobject.py +54 -0
- compas_blender/scene/torusobject.py +73 -0
- compas_blender/scene/vectorobject.py +69 -0
- compas_blender/scene/volmeshobject.py +475 -0
- compas_blender/utilities/__init__.py +38 -0
- compas_blender/utilities/drawing.py +768 -0
- compas_ghpython/__init__.py +124 -0
- compas_ghpython/components/Compas_FromJson/code.py +18 -0
- compas_ghpython/components/Compas_Info/code.py +15 -0
- compas_ghpython/components/Compas_RpcCall/code.py +31 -0
- compas_ghpython/components/Compas_ToJson/code.py +19 -0
- compas_ghpython/components/Compas_ToRhinoGeometry/code.py +15 -0
- compas_ghpython/components/__init__.py +99 -0
- compas_ghpython/install.py +29 -0
- compas_ghpython/scene/__init__.py +115 -0
- compas_ghpython/scene/boxobject.py +40 -0
- compas_ghpython/scene/brepobject.py +40 -0
- compas_ghpython/scene/capsuleobject.py +41 -0
- compas_ghpython/scene/circleobject.py +40 -0
- compas_ghpython/scene/coneobject.py +40 -0
- compas_ghpython/scene/curveobject.py +42 -0
- compas_ghpython/scene/cylinderobject.py +38 -0
- compas_ghpython/scene/ellipseobject.py +40 -0
- compas_ghpython/scene/frameobject.py +67 -0
- compas_ghpython/scene/graphobject.py +77 -0
- compas_ghpython/scene/lineobject.py +39 -0
- compas_ghpython/scene/meshobject.py +137 -0
- compas_ghpython/scene/planeobject.py +61 -0
- compas_ghpython/scene/pointobject.py +38 -0
- compas_ghpython/scene/polygonobject.py +48 -0
- compas_ghpython/scene/polyhedronobject.py +48 -0
- compas_ghpython/scene/polylineobject.py +39 -0
- compas_ghpython/scene/sceneobject.py +12 -0
- compas_ghpython/scene/sphereobject.py +39 -0
- compas_ghpython/scene/surfaceobject.py +42 -0
- compas_ghpython/scene/torusobject.py +39 -0
- compas_ghpython/scene/vectorobject.py +51 -0
- compas_ghpython/scene/volmeshobject.py +154 -0
- compas_ghpython/sets.py +83 -0
- compas_ghpython/timer.py +36 -0
- compas_ghpython/uninstall.py +31 -0
- compas_ghpython/utilities/__init__.py +33 -0
- compas_ghpython/utilities/drawing.py +457 -0
- compas_rhino/__init__.py +607 -0
- compas_rhino/conduits/__init__.py +16 -0
- compas_rhino/conduits/base.py +121 -0
- compas_rhino/conduits/faces.py +91 -0
- compas_rhino/conduits/labels.py +102 -0
- compas_rhino/conduits/lines.py +109 -0
- compas_rhino/conduits/points.py +111 -0
- compas_rhino/conversions/__init__.py +168 -0
- compas_rhino/conversions/breps.py +122 -0
- compas_rhino/conversions/curves.py +453 -0
- compas_rhino/conversions/docobjects.py +0 -0
- compas_rhino/conversions/exceptions.py +7 -0
- compas_rhino/conversions/extrusions.py +80 -0
- compas_rhino/conversions/geometry.py +187 -0
- compas_rhino/conversions/meshes.py +281 -0
- compas_rhino/conversions/shapes.py +291 -0
- compas_rhino/conversions/surfaces.py +355 -0
- compas_rhino/conversions/transformations.py +45 -0
- compas_rhino/geometry/__init__.py +44 -0
- compas_rhino/geometry/booleans.py +118 -0
- compas_rhino/geometry/brep/__init__.py +40 -0
- compas_rhino/geometry/brep/brep.py +554 -0
- compas_rhino/geometry/brep/builder.py +184 -0
- compas_rhino/geometry/brep/edge.py +202 -0
- compas_rhino/geometry/brep/face.py +285 -0
- compas_rhino/geometry/brep/loop.py +129 -0
- compas_rhino/geometry/brep/trim.py +99 -0
- compas_rhino/geometry/brep/vertex.py +76 -0
- compas_rhino/geometry/curves/__init__.py +43 -0
- compas_rhino/geometry/curves/curve.py +382 -0
- compas_rhino/geometry/curves/nurbs.py +298 -0
- compas_rhino/geometry/surfaces/__init__.py +50 -0
- compas_rhino/geometry/surfaces/nurbs.py +370 -0
- compas_rhino/geometry/surfaces/surface.py +407 -0
- compas_rhino/geometry/trimesh_curvature.py +344 -0
- compas_rhino/geometry/trimesh_slicing.py +65 -0
- compas_rhino/install.py +382 -0
- compas_rhino/install_plugin.py +169 -0
- compas_rhino/install_with_pip.py +20 -0
- compas_rhino/layers.py +347 -0
- compas_rhino/objects.py +1141 -0
- compas_rhino/print_python_path.py +18 -0
- compas_rhino/scene/__init__.py +123 -0
- compas_rhino/scene/boxobject.py +44 -0
- compas_rhino/scene/brepobject.py +41 -0
- compas_rhino/scene/capsuleobject.py +45 -0
- compas_rhino/scene/circleobject.py +43 -0
- compas_rhino/scene/coneobject.py +43 -0
- compas_rhino/scene/curveobject.py +43 -0
- compas_rhino/scene/cylinderobject.py +43 -0
- compas_rhino/scene/ellipseobject.py +44 -0
- compas_rhino/scene/frameobject.py +99 -0
- compas_rhino/scene/graphobject.py +364 -0
- compas_rhino/scene/helpers.py +33 -0
- compas_rhino/scene/lineobject.py +43 -0
- compas_rhino/scene/meshobject.py +673 -0
- compas_rhino/scene/planeobject.py +71 -0
- compas_rhino/scene/pointobject.py +43 -0
- compas_rhino/scene/polygonobject.py +45 -0
- compas_rhino/scene/polyhedronobject.py +45 -0
- compas_rhino/scene/polylineobject.py +43 -0
- compas_rhino/scene/sceneobject.py +123 -0
- compas_rhino/scene/sphereobject.py +43 -0
- compas_rhino/scene/surfaceobject.py +42 -0
- compas_rhino/scene/torusobject.py +43 -0
- compas_rhino/scene/vectorobject.py +49 -0
- compas_rhino/scene/volmeshobject.py +518 -0
- compas_rhino/ui.py +114 -0
- compas_rhino/uninstall.py +243 -0
- compas_rhino/uninstall_plugin.py +91 -0
- compas_rhino/utilities/__init__.py +37 -0
- compas_rhino/utilities/constructors.py +71 -0
- compas_rhino/utilities/drawing.py +1081 -0
compas/plugins.py
ADDED
|
@@ -0,0 +1,488 @@
|
|
|
1
|
+
"""
|
|
2
|
+
COMPAS has an extensible architecture based on plugins that allows to
|
|
3
|
+
customize and extend the functionality of the core framework.
|
|
4
|
+
"""
|
|
5
|
+
|
|
6
|
+
# The COMPAS plugin system owes a lot to pluggy, the pytest plugin framework
|
|
7
|
+
# There are portions of code loosely based on pluggy's
|
|
8
|
+
# and while it is not strictly derivative work, we include
|
|
9
|
+
# their license and copyright notice to give credit where credit is due.
|
|
10
|
+
#
|
|
11
|
+
# MIT license
|
|
12
|
+
# Copyright (c) 2015 holger krekel (rather uses bitbucket/hpk42)
|
|
13
|
+
#
|
|
14
|
+
# https://github.com/pytest-dev/pluggy
|
|
15
|
+
|
|
16
|
+
from __future__ import absolute_import
|
|
17
|
+
from __future__ import division
|
|
18
|
+
from __future__ import print_function
|
|
19
|
+
|
|
20
|
+
import functools
|
|
21
|
+
import inspect
|
|
22
|
+
import pkgutil
|
|
23
|
+
import threading
|
|
24
|
+
|
|
25
|
+
__all__ = [
|
|
26
|
+
"pluggable",
|
|
27
|
+
"plugin",
|
|
28
|
+
"plugin_manager",
|
|
29
|
+
"IncompletePluginImplError",
|
|
30
|
+
"PluginManager",
|
|
31
|
+
"PluginNotInstalledError",
|
|
32
|
+
"PluginValidator",
|
|
33
|
+
"PluginDefaultNotAvailableError",
|
|
34
|
+
]
|
|
35
|
+
|
|
36
|
+
|
|
37
|
+
class PluginNotInstalledError(Exception):
|
|
38
|
+
"""Exception raised when an extension point is invoked but no plugin is available."""
|
|
39
|
+
|
|
40
|
+
pass
|
|
41
|
+
|
|
42
|
+
|
|
43
|
+
class PluginDefaultNotAvailableError(Exception):
|
|
44
|
+
"""Exception raised when an extension point is invoked but no plugin is available, and the default implementation is also not available.
|
|
45
|
+
|
|
46
|
+
The most likely circumstance for this error is when the default implementation is based on Numpy, Scipy, or similar,
|
|
47
|
+
and the pluggable is invoked in a context where these packages are not available.
|
|
48
|
+
|
|
49
|
+
"""
|
|
50
|
+
|
|
51
|
+
pass
|
|
52
|
+
|
|
53
|
+
|
|
54
|
+
def _get_extension_point_url_from_name(domain, category, pluggable_name):
|
|
55
|
+
"""Get the extension point URL based on a pluggable method name"""
|
|
56
|
+
return "{}/{}/{}".format(domain, category, pluggable_name).replace("//", "/")
|
|
57
|
+
|
|
58
|
+
|
|
59
|
+
def _get_extension_point_url_from_method(domain, category, plugin_method):
|
|
60
|
+
"""Get the extension point URL based on a method instance"""
|
|
61
|
+
name = getattr(plugin_method, "__name__", None) or str(id(plugin_method))
|
|
62
|
+
return "{}/{}/{}".format(domain, category, name).replace("//", "/")
|
|
63
|
+
|
|
64
|
+
|
|
65
|
+
class IncompletePluginImplError(Exception):
|
|
66
|
+
"""Exception raised when a plugin does not have implementations for all abstract methods of its base class."""
|
|
67
|
+
|
|
68
|
+
pass
|
|
69
|
+
|
|
70
|
+
|
|
71
|
+
class PluginImpl(object):
|
|
72
|
+
"""Internal data class to keep track of a loaded plugin implementation.
|
|
73
|
+
|
|
74
|
+
Parameters
|
|
75
|
+
----------
|
|
76
|
+
plugin : module
|
|
77
|
+
Instance of the module containing one or more plugin implementations.
|
|
78
|
+
method : method
|
|
79
|
+
Method implementing the a plugin's behavior.
|
|
80
|
+
plugin_opts : dict
|
|
81
|
+
Dictionary containing plugin options.
|
|
82
|
+
|
|
83
|
+
"""
|
|
84
|
+
|
|
85
|
+
def __init__(self, plugin, method, plugin_opts):
|
|
86
|
+
self.plugin = plugin
|
|
87
|
+
self.method = method
|
|
88
|
+
self.opts = plugin_opts
|
|
89
|
+
|
|
90
|
+
if plugin_opts["tryfirst"]:
|
|
91
|
+
self.key = 1
|
|
92
|
+
elif plugin_opts["trylast"]:
|
|
93
|
+
self.key = 3
|
|
94
|
+
else:
|
|
95
|
+
self.key = 2
|
|
96
|
+
|
|
97
|
+
@property
|
|
98
|
+
def id(self):
|
|
99
|
+
"""Identifier of the plugin implementation."""
|
|
100
|
+
return "{}.{}".format(self.plugin.__name__, self.method.__name__)
|
|
101
|
+
|
|
102
|
+
def __repr__(self):
|
|
103
|
+
return "<PluginImpl id={}, plugin_module={}>".format(self.id, self.plugin)
|
|
104
|
+
|
|
105
|
+
|
|
106
|
+
class PluginManager(object):
|
|
107
|
+
"""Plugin Manager handles discovery and registry of plugins.
|
|
108
|
+
|
|
109
|
+
Usually there is only one instance of a plugin manager per host.
|
|
110
|
+
|
|
111
|
+
"""
|
|
112
|
+
|
|
113
|
+
DEBUG = False
|
|
114
|
+
|
|
115
|
+
def __init__(self):
|
|
116
|
+
self.importer = Importer()
|
|
117
|
+
self._registry = {}
|
|
118
|
+
self._discovery_done = False
|
|
119
|
+
self._discovery_lock = threading.Lock()
|
|
120
|
+
|
|
121
|
+
@property
|
|
122
|
+
def registry(self):
|
|
123
|
+
"""Plugin registry.
|
|
124
|
+
|
|
125
|
+
Lazy-loaded dictionary of all plugins available in the system.
|
|
126
|
+
|
|
127
|
+
Returns
|
|
128
|
+
-------
|
|
129
|
+
dict
|
|
130
|
+
Dictionary of available plugins. The keys are extension point URLs
|
|
131
|
+
and the values are instances of :class:`PluginImpl`.
|
|
132
|
+
|
|
133
|
+
"""
|
|
134
|
+
if not self._discovery_done:
|
|
135
|
+
self.load_plugins()
|
|
136
|
+
|
|
137
|
+
return self._registry
|
|
138
|
+
|
|
139
|
+
def load_plugins(self):
|
|
140
|
+
"""Load available plugin modules.
|
|
141
|
+
|
|
142
|
+
Returns
|
|
143
|
+
-------
|
|
144
|
+
int
|
|
145
|
+
Number of loaded plugins.
|
|
146
|
+
|
|
147
|
+
"""
|
|
148
|
+
# Since we modify global state,
|
|
149
|
+
# let's lock around this.
|
|
150
|
+
with self._discovery_lock:
|
|
151
|
+
count = 0
|
|
152
|
+
|
|
153
|
+
modules = [module_name for _importer, module_name, is_pkg in pkgutil.iter_modules() if is_pkg and module_name.startswith("compas")]
|
|
154
|
+
|
|
155
|
+
modules_to_inspect = dict()
|
|
156
|
+
|
|
157
|
+
for module_name in modules:
|
|
158
|
+
module = self.importer.try_import(module_name)
|
|
159
|
+
if module:
|
|
160
|
+
modules_to_inspect[module_name] = module
|
|
161
|
+
else:
|
|
162
|
+
if self.DEBUG:
|
|
163
|
+
print("Error importing module {}, skipping entire package.".format(module_name))
|
|
164
|
+
continue
|
|
165
|
+
|
|
166
|
+
if "__all_plugins__" in dir(module):
|
|
167
|
+
for plugin_module_name in module.__all_plugins__:
|
|
168
|
+
plugin_module = self.importer.try_import(plugin_module_name)
|
|
169
|
+
if plugin_module:
|
|
170
|
+
modules_to_inspect[plugin_module_name] = plugin_module
|
|
171
|
+
else:
|
|
172
|
+
if self.DEBUG:
|
|
173
|
+
print("Error importing plugin {}, skipping.".format(plugin_module_name))
|
|
174
|
+
|
|
175
|
+
if self.DEBUG:
|
|
176
|
+
print("Will inspect modules: {}".format(list(modules_to_inspect.keys())))
|
|
177
|
+
|
|
178
|
+
for plugin_module in modules_to_inspect.values():
|
|
179
|
+
count += self.register_module(plugin_module)
|
|
180
|
+
|
|
181
|
+
self._discovery_done = True
|
|
182
|
+
|
|
183
|
+
return count
|
|
184
|
+
|
|
185
|
+
def register_module(self, plugin_module):
|
|
186
|
+
"""Register a module that potentially contains plugin implementations.
|
|
187
|
+
|
|
188
|
+
Parameters
|
|
189
|
+
----------
|
|
190
|
+
plugin_module : module
|
|
191
|
+
Module instance to inspect for plugins.
|
|
192
|
+
|
|
193
|
+
Returns
|
|
194
|
+
-------
|
|
195
|
+
int
|
|
196
|
+
Count of successfully registered plugins in the module.
|
|
197
|
+
"""
|
|
198
|
+
count = 0
|
|
199
|
+
|
|
200
|
+
# Iterate over the plugin to locate specific @plugin decorated methods
|
|
201
|
+
for name in dir(plugin_module):
|
|
202
|
+
plugin_method = getattr(plugin_module, name)
|
|
203
|
+
plugin_opts = self._parse_plugin_opts(plugin_method)
|
|
204
|
+
|
|
205
|
+
if plugin_opts is not None:
|
|
206
|
+
plugin_impl = PluginImpl(plugin_module, plugin_method, plugin_opts)
|
|
207
|
+
plugins_list = self._registry.setdefault(plugin_opts["extension_point_url"], [])
|
|
208
|
+
plugins_list.append(plugin_impl)
|
|
209
|
+
plugins_list.sort(key=lambda p: p.key)
|
|
210
|
+
|
|
211
|
+
if self.DEBUG:
|
|
212
|
+
print('Registered plugin with ID "{}" for extension point: {}'.format(plugin_impl.id, plugin_opts["extension_point_url"]))
|
|
213
|
+
count += 1
|
|
214
|
+
|
|
215
|
+
return count
|
|
216
|
+
|
|
217
|
+
def _parse_plugin_opts(self, plugin_method):
|
|
218
|
+
if not inspect.isroutine(plugin_method):
|
|
219
|
+
return
|
|
220
|
+
try:
|
|
221
|
+
res = getattr(plugin_method, "__plugin_spec__", None)
|
|
222
|
+
except Exception:
|
|
223
|
+
res = {}
|
|
224
|
+
if res is not None and not isinstance(res, dict):
|
|
225
|
+
# false positive
|
|
226
|
+
res = None
|
|
227
|
+
return res
|
|
228
|
+
|
|
229
|
+
|
|
230
|
+
def pluggable(
|
|
231
|
+
pluggable_method=None,
|
|
232
|
+
category=None,
|
|
233
|
+
selector="first_match",
|
|
234
|
+
domain="https://plugins.compas.dev/",
|
|
235
|
+
):
|
|
236
|
+
"""Decorator to mark a method as a pluggable extension point.
|
|
237
|
+
|
|
238
|
+
A pluggable interface is uniquely identifiable/locatable via a URL
|
|
239
|
+
derived from the parameters ``domain``, ``category`` and name ``pluggable_method``.
|
|
240
|
+
In the example below, the URL of the pluggable definition is::
|
|
241
|
+
|
|
242
|
+
https://plugins.compas.dev/triangulation/triangulate_mesh
|
|
243
|
+
|
|
244
|
+
Parameters
|
|
245
|
+
----------
|
|
246
|
+
pluggable_method : callable
|
|
247
|
+
The method to decorate as ``pluggable``.
|
|
248
|
+
category : str, optional
|
|
249
|
+
An optional string to group or categorize extension points.
|
|
250
|
+
selector : str, optional
|
|
251
|
+
String that determines the selection mode of extension points.
|
|
252
|
+
|
|
253
|
+
- ``"first_match"``: (str) Execute the first matching implementation.
|
|
254
|
+
- ``"collect_all"``: (str) Executes all matching implementations and return list of its return values.
|
|
255
|
+
|
|
256
|
+
domain : str, optional
|
|
257
|
+
Domain name that "owns" the pluggable extension point.
|
|
258
|
+
This is useful to avoid name collisions between extension points
|
|
259
|
+
of different packages.
|
|
260
|
+
|
|
261
|
+
Examples
|
|
262
|
+
--------
|
|
263
|
+
>>> @pluggable(category="triangulation")
|
|
264
|
+
... def triangulate_mesh(mesh):
|
|
265
|
+
... pass
|
|
266
|
+
|
|
267
|
+
"""
|
|
268
|
+
|
|
269
|
+
def pluggable_decorator(func):
|
|
270
|
+
@functools.wraps(func)
|
|
271
|
+
def wrapper(*args, **kwargs):
|
|
272
|
+
extension_point_url = _get_extension_point_url_from_method(domain, category, func)
|
|
273
|
+
|
|
274
|
+
# Select first matching plugin
|
|
275
|
+
if selector == "first_match":
|
|
276
|
+
plugin_impl = _select_plugin(extension_point_url)
|
|
277
|
+
if plugin_impl is None:
|
|
278
|
+
try:
|
|
279
|
+
return func(*args, **kwargs)
|
|
280
|
+
except NotImplementedError:
|
|
281
|
+
raise PluginNotInstalledError("Plugin not found and no default implementation for extension point URL: {}".format(extension_point_url))
|
|
282
|
+
except ImportError:
|
|
283
|
+
raise PluginDefaultNotAvailableError(
|
|
284
|
+
"Plugin not found and the default implementation is not available in your environment for extension point URL: {}".format(extension_point_url)
|
|
285
|
+
)
|
|
286
|
+
|
|
287
|
+
# Invoke plugin
|
|
288
|
+
return plugin_impl.method(*args, **kwargs)
|
|
289
|
+
|
|
290
|
+
# Collect all matching plugins
|
|
291
|
+
elif selector == "collect_all":
|
|
292
|
+
results = []
|
|
293
|
+
|
|
294
|
+
for plugin_impl in _collect_plugins(extension_point_url):
|
|
295
|
+
try:
|
|
296
|
+
result = plugin_impl.method(*args, **kwargs)
|
|
297
|
+
results.append(result)
|
|
298
|
+
except Exception as e:
|
|
299
|
+
results.append(e)
|
|
300
|
+
|
|
301
|
+
return results
|
|
302
|
+
else:
|
|
303
|
+
raise ValueError("Unexpected selector type. Must be either: first_match or collect_all")
|
|
304
|
+
|
|
305
|
+
return wrapper
|
|
306
|
+
|
|
307
|
+
if pluggable_method is None:
|
|
308
|
+
return pluggable_decorator
|
|
309
|
+
else:
|
|
310
|
+
return pluggable_decorator(pluggable_method)
|
|
311
|
+
|
|
312
|
+
|
|
313
|
+
def plugin(
|
|
314
|
+
method=None,
|
|
315
|
+
category=None,
|
|
316
|
+
requires=None,
|
|
317
|
+
tryfirst=False,
|
|
318
|
+
trylast=False,
|
|
319
|
+
pluggable_name=None,
|
|
320
|
+
domain="https://plugins.compas.dev/",
|
|
321
|
+
):
|
|
322
|
+
"""Decorator to declare a plugin.
|
|
323
|
+
|
|
324
|
+
A plugin decorator marks a method as a plugin for a specified
|
|
325
|
+
:meth:`pluggable` extension point. Plugins are matched to their pluggable
|
|
326
|
+
counterparts by a combination of the name of the plugin method, the category
|
|
327
|
+
and the domain specified. These 3 parts form the **extension point URL** used
|
|
328
|
+
for matching.
|
|
329
|
+
|
|
330
|
+
Parameters
|
|
331
|
+
----------
|
|
332
|
+
method : callable
|
|
333
|
+
The method to decorate as ``plugin``.
|
|
334
|
+
category : str, optional
|
|
335
|
+
An optional string to group or categorize plugins.
|
|
336
|
+
requires : list, optional
|
|
337
|
+
Optionally defines a list of requirements that should be fulfilled
|
|
338
|
+
for this plugin to be used. The requirement can either be a package
|
|
339
|
+
name (``str``) or a ``callable`` with a boolean return value,
|
|
340
|
+
in which any arbitrary check can be implemented.
|
|
341
|
+
tryfirst : bool, optional
|
|
342
|
+
Plugins can declare a preferred priority by setting this to ``True``.
|
|
343
|
+
By default ``False``.
|
|
344
|
+
trylast : bool, optional
|
|
345
|
+
Alternatively, a plugin can demote itself to be least preferable
|
|
346
|
+
setting ``trylast`` to ``True``. By default ``False``.
|
|
347
|
+
pluggable_name : str, optional
|
|
348
|
+
Usually, the name of the decorated plugin method matches that of the
|
|
349
|
+
pluggable interface. When that is not the case, the pluggable name can be
|
|
350
|
+
specified via this parameter.
|
|
351
|
+
domain : str, optional
|
|
352
|
+
Domain name that "owns" the pluggable extension point.
|
|
353
|
+
This is useful to disambiguate name collisions between extension points
|
|
354
|
+
of different packages.
|
|
355
|
+
"""
|
|
356
|
+
|
|
357
|
+
def setattr_hookspec_opts(func):
|
|
358
|
+
if tryfirst and trylast:
|
|
359
|
+
raise ValueError("You cannot set a plugin to try first and last at the same time.")
|
|
360
|
+
|
|
361
|
+
name = pluggable_name or getattr(func, "__name__", None)
|
|
362
|
+
extension_point_url = _get_extension_point_url_from_name(domain, category, name)
|
|
363
|
+
|
|
364
|
+
setattr(
|
|
365
|
+
func,
|
|
366
|
+
"__plugin_spec__",
|
|
367
|
+
dict(
|
|
368
|
+
extension_point_url=extension_point_url,
|
|
369
|
+
pluggable_name=name,
|
|
370
|
+
requires=requires,
|
|
371
|
+
tryfirst=tryfirst,
|
|
372
|
+
trylast=trylast,
|
|
373
|
+
),
|
|
374
|
+
)
|
|
375
|
+
return func
|
|
376
|
+
|
|
377
|
+
if method is not None:
|
|
378
|
+
return setattr_hookspec_opts(method)
|
|
379
|
+
else:
|
|
380
|
+
return setattr_hookspec_opts
|
|
381
|
+
|
|
382
|
+
|
|
383
|
+
class Importer(object):
|
|
384
|
+
"""Internal class to help importing modules."""
|
|
385
|
+
|
|
386
|
+
def __init__(self):
|
|
387
|
+
# dictionary of module_name => bool (importable yes/no)
|
|
388
|
+
self._cache = {}
|
|
389
|
+
|
|
390
|
+
def try_import(self, module_name):
|
|
391
|
+
"""Attempt to import a module, but do not raise in case of error.
|
|
392
|
+
|
|
393
|
+
Parameters
|
|
394
|
+
----------
|
|
395
|
+
module_name : str
|
|
396
|
+
Module to try to import.
|
|
397
|
+
|
|
398
|
+
Returns
|
|
399
|
+
-------
|
|
400
|
+
module
|
|
401
|
+
If importable, it returns the imported module, otherwise ``None``.
|
|
402
|
+
"""
|
|
403
|
+
module = None
|
|
404
|
+
|
|
405
|
+
try:
|
|
406
|
+
module = __import__(module_name, fromlist=["__name__"], level=0)
|
|
407
|
+
self._cache[module_name] = True
|
|
408
|
+
|
|
409
|
+
# There are two types of possible failure modes:
|
|
410
|
+
# 1) cannot be imported, or
|
|
411
|
+
# 2) is a python 3 module and we're in IPY, which causes a SyntaxError
|
|
412
|
+
except (ImportError, SyntaxError):
|
|
413
|
+
self._cache[module_name] = False
|
|
414
|
+
|
|
415
|
+
return module
|
|
416
|
+
|
|
417
|
+
def check_importable(self, module_name):
|
|
418
|
+
"""Check if a module is importable.
|
|
419
|
+
|
|
420
|
+
Parameters
|
|
421
|
+
----------
|
|
422
|
+
module_name : str
|
|
423
|
+
Name of the module to check for importability.
|
|
424
|
+
|
|
425
|
+
Returns
|
|
426
|
+
-------
|
|
427
|
+
bool
|
|
428
|
+
``True`` if the module can be imported correctly, otherwise ``False``.
|
|
429
|
+
"""
|
|
430
|
+
if module_name not in self._cache:
|
|
431
|
+
self.try_import(module_name)
|
|
432
|
+
|
|
433
|
+
return self._cache[module_name]
|
|
434
|
+
|
|
435
|
+
|
|
436
|
+
class PluginValidator(object):
|
|
437
|
+
"""Plugin Validator handles validation of plugins."""
|
|
438
|
+
|
|
439
|
+
def __init__(self, manager):
|
|
440
|
+
self.manager = manager
|
|
441
|
+
|
|
442
|
+
def verify_requirement(self, requirement):
|
|
443
|
+
if callable(requirement):
|
|
444
|
+
return requirement()
|
|
445
|
+
|
|
446
|
+
return self.manager.importer.check_importable(requirement)
|
|
447
|
+
|
|
448
|
+
def is_plugin_selectable(self, plugin):
|
|
449
|
+
if plugin.opts["requires"]:
|
|
450
|
+
importable_requirements = (self.verify_requirement(requirement) for requirement in plugin.opts["requires"])
|
|
451
|
+
|
|
452
|
+
if not all(importable_requirements):
|
|
453
|
+
if self.manager.DEBUG:
|
|
454
|
+
print("Requirements not satisfied. Plugin will not be used: {}".format(plugin.id))
|
|
455
|
+
return False
|
|
456
|
+
|
|
457
|
+
return True
|
|
458
|
+
|
|
459
|
+
def select_plugin(self, extension_point_url):
|
|
460
|
+
if self.manager.DEBUG:
|
|
461
|
+
print("Extension Point URL {} invoked. Will select a matching plugin".format(extension_point_url))
|
|
462
|
+
|
|
463
|
+
plugins = self.manager.registry.get(extension_point_url) or []
|
|
464
|
+
for plugin in plugins:
|
|
465
|
+
if self.is_plugin_selectable(plugin):
|
|
466
|
+
return plugin
|
|
467
|
+
|
|
468
|
+
# Nothing found, raise
|
|
469
|
+
# raise PluginNotInstalledError("Plugin not found for extension point URL: {}".format(extension_point_url))
|
|
470
|
+
|
|
471
|
+
def collect_plugins(self, extension_point_url):
|
|
472
|
+
if self.manager.DEBUG:
|
|
473
|
+
print("Extension Point URL {} invoked. Will select a matching plugin".format(extension_point_url))
|
|
474
|
+
|
|
475
|
+
plugins = self.manager.registry.get(extension_point_url) or []
|
|
476
|
+
return [plugin for plugin in plugins if self.is_plugin_selectable(plugin)]
|
|
477
|
+
|
|
478
|
+
@staticmethod
|
|
479
|
+
def ensure_implementations(cls):
|
|
480
|
+
for name, value in inspect.getmembers(cls):
|
|
481
|
+
if inspect.isfunction(value) or inspect.ismethod(value):
|
|
482
|
+
if hasattr(value, "__isabstractmethod__"):
|
|
483
|
+
raise IncompletePluginImplError("Abstract method not implemented: {}".format(value))
|
|
484
|
+
|
|
485
|
+
|
|
486
|
+
plugin_manager = PluginManager()
|
|
487
|
+
_select_plugin = PluginValidator(plugin_manager).select_plugin
|
|
488
|
+
_collect_plugins = PluginValidator(plugin_manager).collect_plugins
|
compas/rpc/__init__.py
ADDED
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
"""
|
|
2
|
+
COMPAS runs in many different environments, but in some environments the availablity of libraries is limited.
|
|
3
|
+
For example, when running COMPAS in an IronPython-based environment like Rhino/Grasshopper,
|
|
4
|
+
plenty of CPython libraries such as `numpy` and `scipy` are not available.
|
|
5
|
+
To workaround this limitation, COMPAS provides a mechanisms to access the functionality of a CPython environment
|
|
6
|
+
seemlessly from any other Python environment through a "Remote Procedure Call" or RPC.
|
|
7
|
+
Through RPC, COMPAS can be used as a server for remote clients, and as a client for remote servers.
|
|
8
|
+
A typical use case is to run algorithms that require packages like ``numpy`` or ``scipy`` on a remote server,
|
|
9
|
+
when working in Rhino. Or to use COMPAS in a browser application.
|
|
10
|
+
"""
|
|
11
|
+
|
|
12
|
+
from __future__ import absolute_import
|
|
13
|
+
|
|
14
|
+
from .errors import RPCClientError, RPCServerError
|
|
15
|
+
from .proxy import Proxy
|
|
16
|
+
from .server import Server
|
|
17
|
+
from .dispatcher import Dispatcher
|
|
18
|
+
|
|
19
|
+
|
|
20
|
+
__all__ = ["RPCClientError", "RPCServerError", "Proxy", "Server", "Dispatcher"]
|
compas/rpc/__main__.py
ADDED
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
import time
|
|
2
|
+
|
|
3
|
+
from compas.rpc.services.default import start_service
|
|
4
|
+
|
|
5
|
+
try:
|
|
6
|
+
from xmlrpclib import ServerProxy # type: ignore
|
|
7
|
+
except ImportError:
|
|
8
|
+
from xmlrpc.client import ServerProxy
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
def start(port, autoreload, **kwargs):
|
|
12
|
+
start_service(port, autoreload)
|
|
13
|
+
|
|
14
|
+
|
|
15
|
+
def stop(port, **kwargs):
|
|
16
|
+
print("Trying to stop remote RPC proxy...")
|
|
17
|
+
server = ServerProxy("http://127.0.0.1:{}".format(port))
|
|
18
|
+
|
|
19
|
+
success = False
|
|
20
|
+
count = 5
|
|
21
|
+
while count:
|
|
22
|
+
try:
|
|
23
|
+
server.ping()
|
|
24
|
+
except Exception:
|
|
25
|
+
time.sleep(0.1)
|
|
26
|
+
count -= 1
|
|
27
|
+
print(" {} attempts left.".format(count))
|
|
28
|
+
else:
|
|
29
|
+
success = True
|
|
30
|
+
break
|
|
31
|
+
|
|
32
|
+
if not success:
|
|
33
|
+
print("RPC server did not respond. Maybe already stopped.")
|
|
34
|
+
else:
|
|
35
|
+
server.remote_shutdown()
|
|
36
|
+
print("RPC server stopped")
|
|
37
|
+
|
|
38
|
+
|
|
39
|
+
def main():
|
|
40
|
+
import argparse
|
|
41
|
+
|
|
42
|
+
parser = argparse.ArgumentParser(description="COMPAS RPC command-line utility")
|
|
43
|
+
|
|
44
|
+
commands = parser.add_subparsers(help="Valid RPC commands")
|
|
45
|
+
|
|
46
|
+
# Command: start
|
|
47
|
+
start_command = commands.add_parser("start", help="Start RPC server")
|
|
48
|
+
start_command.add_argument("--port", "-p", action="store", default=1753, type=int, help="RPC port number")
|
|
49
|
+
start_command.add_argument(
|
|
50
|
+
"--autoreload",
|
|
51
|
+
dest="autoreload",
|
|
52
|
+
action="store_true",
|
|
53
|
+
help="Autoreload modules",
|
|
54
|
+
)
|
|
55
|
+
start_command.add_argument(
|
|
56
|
+
"--no-autoreload",
|
|
57
|
+
dest="autoreload",
|
|
58
|
+
action="store_false",
|
|
59
|
+
help="Do not autoreload modules",
|
|
60
|
+
)
|
|
61
|
+
start_command.set_defaults(autoreload=True, func=start)
|
|
62
|
+
|
|
63
|
+
# Command: stop
|
|
64
|
+
stop_command = commands.add_parser("stop", help="Try to stop a remote RPC server")
|
|
65
|
+
stop_command.add_argument("--port", "-p", action="store", default=1753, type=int, help="RPC port number")
|
|
66
|
+
stop_command.set_defaults(func=stop)
|
|
67
|
+
|
|
68
|
+
# Invoke
|
|
69
|
+
args = parser.parse_args()
|
|
70
|
+
if hasattr(args, "func"):
|
|
71
|
+
args.func(**vars(args))
|
|
72
|
+
else:
|
|
73
|
+
parser.print_help()
|
|
74
|
+
|
|
75
|
+
|
|
76
|
+
if __name__ == "__main__":
|
|
77
|
+
main()
|