Updated the version numbers for the v0.1.8 release.
This commit is contained in:
parent
bdfb450ba9
commit
2dd6841bae
|
@ -19,7 +19,7 @@ Using CadQuery, you can write short, simple scripts that produce high quality CA
|
||||||
Getting Started With CadQuery
|
Getting Started With CadQuery
|
||||||
========================================
|
========================================
|
||||||
|
|
||||||
The easiest way to get started with CadQuery is to Install FreeCAD ( version 14 recommended ) (http://www.freecadweb.org/) , and then to use Jeremy's Great CadQuery-FreeCAD plugin here:
|
The easiest way to get started with CadQuery is to Install FreeCAD ( version 14 recommended ) (http://www.freecadweb.org/), and then to use our great CadQuery-FreeCAD plugin here:
|
||||||
|
|
||||||
https://github.com/jmwright/cadquery-freecad-module
|
https://github.com/jmwright/cadquery-freecad-module
|
||||||
|
|
||||||
|
@ -32,8 +32,9 @@ It has tons of awesome features like integration with FreeCAD so you can see you
|
||||||
Recently Added Features
|
Recently Added Features
|
||||||
========================================
|
========================================
|
||||||
|
|
||||||
* 12/5/14 -- New FreeCAD/CadQuery Module! https://github.com/jmwright/cadquery-freecad-module
|
* 02/21/15 -- Multiple bug fixes and tests added, including a bugfix for moveTo (thanks @xix-xeaon)
|
||||||
* 10/25/14 -- Added Revolution Feature ( thanks Jeremy ! )
|
* 12/31/14 -- Added Travis CI config to automatically test our code (thanks @krasin)
|
||||||
|
* 12/05/14 -- New FreeCAD/CadQuery Module! https://github.com/jmwright/cadquery-freecad-module
|
||||||
|
|
||||||
|
|
||||||
Why CadQuery instead of OpenSCAD?
|
Why CadQuery instead of OpenSCAD?
|
||||||
|
|
|
@ -1,6 +1,6 @@
|
||||||
Metadata-Version: 1.1
|
Metadata-Version: 1.1
|
||||||
Name: cadquery
|
Name: cadquery
|
||||||
Version: 0.1.7
|
Version: 0.1.8
|
||||||
Summary: CadQuery is a parametric scripting language for creating and traversing CAD models
|
Summary: CadQuery is a parametric scripting language for creating and traversing CAD models
|
||||||
Home-page: https://github.com/dcowden/cadquery
|
Home-page: https://github.com/dcowden/cadquery
|
||||||
Author: David Cowden
|
Author: David Cowden
|
||||||
|
@ -8,103 +8,103 @@ Author-email: dave.cowden@gmail.com
|
||||||
License: LGPL
|
License: LGPL
|
||||||
Description: What is a CadQuery?
|
Description: What is a CadQuery?
|
||||||
========================================
|
========================================
|
||||||
|
|
||||||
CadQuery is an intuitive, easy-to-use python based language for building parametric 3D CAD models. CadQuery is for 3D CAD what jQuery is for javascript. Imagine selecting Faces of a 3d object the same way you select DOM objects with JQuery!
|
CadQuery is an intuitive, easy-to-use python based language for building parametric 3D CAD models. CadQuery is for 3D CAD what jQuery is for javascript. Imagine selecting Faces of a 3d object the same way you select DOM objects with JQuery!
|
||||||
|
|
||||||
CadQuery has several goals:
|
CadQuery has several goals:
|
||||||
|
|
||||||
* Build models with scripts that are as close as possible to how you'd describe the object to a human.
|
* Build models with scripts that are as close as possible to how you'd describe the object to a human.
|
||||||
* Create parametric models that can be very easily customized by end users
|
* Create parametric models that can be very easily customized by end users
|
||||||
* Output high quality CAD formats like STEP and AMF in addition to traditional STL
|
* Output high quality CAD formats like STEP and AMF in addition to traditional STL
|
||||||
* Provide a non-proprietary, plain text model format that can be edited and executed with only a web browser
|
* Provide a non-proprietary, plain text model format that can be edited and executed with only a web browser
|
||||||
|
|
||||||
Using CadQuery, you can write short, simple scripts that produce high quality CAD models. It is easy to make many different objects using a single script that can be customized.
|
Using CadQuery, you can write short, simple scripts that produce high quality CAD models. It is easy to make many different objects using a single script that can be customized.
|
||||||
|
|
||||||
Why CadQuery instead of OpenSCAD?
|
Why CadQuery instead of OpenSCAD?
|
||||||
========================================
|
========================================
|
||||||
|
|
||||||
CadQuery is based on OpenCasCade. CadQuery shares many features with OpenSCAD, another open source, script based, parametric model generator.
|
CadQuery is based on OpenCasCade. CadQuery shares many features with OpenSCAD, another open source, script based, parametric model generator.
|
||||||
|
|
||||||
The primary advantage of OpenSCAD is the large number of already existing model libaries that exist already. So why not simply use OpenSCAD?
|
The primary advantage of OpenSCAD is the large number of already existing model libaries that exist already. So why not simply use OpenSCAD?
|
||||||
|
|
||||||
CadQuery scripts have several key advantages over OpenSCAD:
|
CadQuery scripts have several key advantages over OpenSCAD:
|
||||||
|
|
||||||
1. **The scripts use a standard programming language**, python, and thus can benefit from the associated infrastructure.
|
1. **The scripts use a standard programming language**, python, and thus can benefit from the associated infrastructure.
|
||||||
This includes many standard libraries and IDEs
|
This includes many standard libraries and IDEs
|
||||||
|
|
||||||
2. **More powerful CAD kernel** OpenCascade is much more powerful than CGAL. Features supported natively
|
2. **More powerful CAD kernel** OpenCascade is much more powerful than CGAL. Features supported natively
|
||||||
by OCC include NURBS, splines, surface sewing, STL repair, STEP import/export, and other complex operations,
|
by OCC include NURBS, splines, surface sewing, STL repair, STEP import/export, and other complex operations,
|
||||||
in addition to the standard CSG operations supported by CGAL
|
in addition to the standard CSG operations supported by CGAL
|
||||||
|
|
||||||
3. **Ability to import/export STEP** We think the ability to begin with a STEP model, created in a CAD package,
|
3. **Ability to import/export STEP** We think the ability to begin with a STEP model, created in a CAD package,
|
||||||
and then add parametric features is key. This is possible in OpenSCAD using STL, but STL is a lossy format
|
and then add parametric features is key. This is possible in OpenSCAD using STL, but STL is a lossy format
|
||||||
|
|
||||||
4. **Less Code and easier scripting** CadQuery scripts require less code to create most objects, because it is possible to locate
|
4. **Less Code and easier scripting** CadQuery scripts require less code to create most objects, because it is possible to locate
|
||||||
features based on the position of other features, workplanes, vertices, etc.
|
features based on the position of other features, workplanes, vertices, etc.
|
||||||
|
|
||||||
5. **Better Performance** CadQuery scripts can build STL, STEP, and AMF faster than OpenSCAD.
|
5. **Better Performance** CadQuery scripts can build STL, STEP, and AMF faster than OpenSCAD.
|
||||||
|
|
||||||
License
|
License
|
||||||
========
|
========
|
||||||
|
|
||||||
CadQuery is licensed under the terms of the LGPLv3. http://www.gnu.org/copyleft/lesser.html
|
CadQuery is licensed under the terms of the LGPLv3. http://www.gnu.org/copyleft/lesser.html
|
||||||
|
|
||||||
Where is the GUI?
|
Where is the GUI?
|
||||||
==================
|
==================
|
||||||
|
|
||||||
CadQuery does not provide a stand-alone gui yet, though this is one of the projects we hope to tackle.
|
CadQuery does not provide a stand-alone gui yet, though this is one of the projects we hope to tackle.
|
||||||
|
|
||||||
CadQuery provides the backbone of http://parametricparts.com, so the easiest way to see it in action is to review the samples and objects there.
|
CadQuery provides the backbone of http://parametricparts.com, so the easiest way to see it in action is to review the samples and objects there.
|
||||||
|
|
||||||
Installing
|
Installing
|
||||||
============
|
============
|
||||||
|
|
||||||
1. install FreeCAD, version 0.12 or greater for your platform. http://sourceforge.net/projects/free-cad/.
|
1. install FreeCAD, version 0.12 or greater for your platform. http://sourceforge.net/projects/free-cad/.
|
||||||
|
|
||||||
2. adjust your path if necessary. FreeCAD bundles a python interpreter, but you'll probably want to use your own,
|
2. adjust your path if necessary. FreeCAD bundles a python interpreter, but you'll probably want to use your own,
|
||||||
preferably one that has virtualenv available. To use FreeCAD from any python interpreter, just append the FreeCAD
|
preferably one that has virtualenv available. To use FreeCAD from any python interpreter, just append the FreeCAD
|
||||||
lib directory to your path. On (*Nix)::
|
lib directory to your path. On (*Nix)::
|
||||||
|
|
||||||
import sys
|
import sys
|
||||||
sys.path.append('/usr/lib/freecad/lib')
|
sys.path.append('/usr/lib/freecad/lib')
|
||||||
|
|
||||||
or on Windows::
|
or on Windows::
|
||||||
|
|
||||||
import sys
|
import sys
|
||||||
sys.path.append('/c/apps/FreeCAD/bin')
|
sys.path.append('/c/apps/FreeCAD/bin')
|
||||||
|
|
||||||
*NOTE* FreeCAD on Windows will not work with python 2.7-- you must use pthon 2.6.X!!!!
|
*NOTE* FreeCAD on Windows will not work with python 2.7-- you must use pthon 2.6.X!!!!
|
||||||
|
|
||||||
3. install cadquery::
|
3. install cadquery::
|
||||||
|
|
||||||
pip install cadquery
|
pip install cadquery
|
||||||
|
|
||||||
3. test your installation::
|
3. test your installation::
|
||||||
|
|
||||||
from cadquery import *
|
from cadquery import *
|
||||||
box = Workplane("XY").box(1,2,3)
|
box = Workplane("XY").box(1,2,3)
|
||||||
exporters.toString(box,'STL')
|
exporters.toString(box,'STL')
|
||||||
|
|
||||||
You're up and running!
|
You're up and running!
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
Where does the name CadQuery come from?
|
Where does the name CadQuery come from?
|
||||||
========================================
|
========================================
|
||||||
|
|
||||||
CadQuery is inspired by ( `jQuery <http://www.jquery.com>`_ ), a popular framework that
|
CadQuery is inspired by ( `jQuery <http://www.jquery.com>`_ ), a popular framework that
|
||||||
revolutionized web development involving javascript.
|
revolutionized web development involving javascript.
|
||||||
|
|
||||||
If you are familiar with how jQuery, you will probably recognize several jQuery features that CadQuery uses:
|
If you are familiar with how jQuery, you will probably recognize several jQuery features that CadQuery uses:
|
||||||
|
|
||||||
* A fluent api to create clean, easy to read code
|
* A fluent api to create clean, easy to read code
|
||||||
* Language features that make selection and iteration incredibly easy
|
* Language features that make selection and iteration incredibly easy
|
||||||
*
|
*
|
||||||
* Ability to use the library along side other python libraries
|
* Ability to use the library along side other python libraries
|
||||||
* Clear and complete documentation, with plenty of samples.
|
* Clear and complete documentation, with plenty of samples.
|
||||||
|
|
||||||
|
|
||||||
Platform: any
|
Platform: any
|
||||||
Classifier: Development Status :: 3 - Alpha
|
Classifier: Development Status :: 3 - Alpha
|
||||||
Classifier: Intended Audience :: Developers
|
Classifier: Intended Audience :: Developers
|
||||||
|
|
|
@ -16,4 +16,4 @@ __all__ = [
|
||||||
'Shape','Vertex','Edge','Wire','Solid','Shell','Compound','exporters', 'importers', 'NearestToPointSelector','ParallelDirSelector','DirectionSelector','PerpendicularDirSelector','TypeSelector','DirectionMinMaxSelector','StringSyntaxSelector','Selector','plugins'
|
'Shape','Vertex','Edge','Wire','Solid','Shell','Compound','exporters', 'importers', 'NearestToPointSelector','ParallelDirSelector','DirectionSelector','PerpendicularDirSelector','TypeSelector','DirectionMinMaxSelector','StringSyntaxSelector','Selector','plugins'
|
||||||
]
|
]
|
||||||
|
|
||||||
__version__ = "0.1.7"
|
__version__ = "0.1.8"
|
||||||
|
|
|
@ -15,7 +15,7 @@ v0.1.7
|
||||||
* Added revolve operation and supporting tests
|
* Added revolve operation and supporting tests
|
||||||
* Fixed minor documentation errors
|
* Fixed minor documentation errors
|
||||||
|
|
||||||
v0.1.8 (Unreleased)
|
v0.1.8
|
||||||
-----
|
-----
|
||||||
* Added toFreecad() function as a convenience for val().wrapped
|
* Added toFreecad() function as a convenience for val().wrapped
|
||||||
* Converted all examples to use toFreecad()
|
* Converted all examples to use toFreecad()
|
||||||
|
|
2
setup.py
2
setup.py
|
@ -2,7 +2,7 @@ from setuptools import setup
|
||||||
|
|
||||||
setup(
|
setup(
|
||||||
name='cadquery',
|
name='cadquery',
|
||||||
version='0.1.7',
|
version='0.1.8',
|
||||||
url='https://github.com/dcowden/cadquery',
|
url='https://github.com/dcowden/cadquery',
|
||||||
license='LGPL',
|
license='LGPL',
|
||||||
author='David Cowden',
|
author='David Cowden',
|
||||||
|
|
Loading…
Reference in New Issue
Block a user