Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge branch 'master' of https://github.com/architecture-building-sys…
- Loading branch information
Showing
1 changed file
with
76 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,76 @@ | ||
# RevitPythonShell | ||
|
||
The RevitPythonShell adds an IronPython interpreter to Autodesk Revit and Vasari. | ||
|
||
The RevitPythonShell (RPS) lets you to write plugins for Revit in Python, my favourite scripting language! But even better, it provide you with an | ||
interactive shell that lets you see the results of your code *as you type it*. This is great for exploring the Revit API while | ||
writing your Revit Addins - use this in combination with the (RevitLookup)[https://github.com/jeremytammik/RevitLookup] to | ||
become a Revit API Ninja :) | ||
|
||
## Features | ||
|
||
- interactive IronPython interpreter for exploring the API | ||
- with syntax highlighting | ||
- autocompletion (press CTRL+SPACE after a period) | ||
- based on the [IronLab](http://code.google.com/p/ironlab/) project | ||
- batteries included! (Python standard library is bundled as a resource in the `RpsRuntime.dll`) | ||
- full access to the .NET framework and the Revit API | ||
- configurable "environment" variables that can be used in your scripts | ||
- save "external scripts" for reuse and start collecting your awesome hacks! | ||
- run scripts at Revit startup | ||
- deploy scripts as standalone Revit Addins | ||
|
||
## Installation | ||
|
||
## Contribute | ||
|
||
- Issue Tracker: https://github.com/architecture-building-systems/revitpythonshell/issues | ||
- Source Code: https://github.com/architecture-building-systems/revitpythonshell | ||
|
||
## Support | ||
|
||
- [RevitPythonShell discussion group](http://groups.google.com/group/RevitPythonShell) | ||
- [stackoverflow](http://stackoverflow.com) (Note: use the ```revit```, ``revit-api`` and ``revitpythonshell`` tags) | ||
|
||
## Getting started: | ||
|
||
Learn some python: | ||
|
||
* [The Python Tutorial](https://docs.python.org/2/tutorial/) | ||
* [Dive Into Python](http://www.diveintopython.net/) | ||
|
||
Learn about the Revit API: | ||
|
||
* [Autodesk Developer Network](T) | ||
* [Jeremy Tammiks blog "The Building Coder"](http://thebuildingcoder.typepad.com/) | ||
|
||
You can find sample scripts here: | ||
|
||
* [Sample RPS Scripts on GitHub](https://github.com/daren-thomas/rps-sample-scripts) | ||
* feel free to send me your own scripts for inclusion! | ||
* [Nathan's Revit API Notebook using the RevitPythonShell](http://wiki.theprovingground.org/revit-api) | ||
* Nathan Miller even has a [Mobius Surface for Vasari](http://wiki.theprovingground.org/revit-api-py-parametric) sample | ||
* [dp stuff (Python Scripts Archives)](http://dp-stuff.org/category/python-scripts) | ||
* lots of scripts | ||
* [my own blog](http://darenatwork.blogspot.com/) contains the odd sample script | ||
|
||
## License | ||
|
||
This project is licensed under the terms of the [MIT License](http://opensource.org/licenses/MIT). | ||
|
||
## Credits | ||
|
||
* Daren Thomas (original version, maintainer) | ||
* Zachary Kron (original port to Vasari) | ||
* Akimitsu Hogge (original port to Vasari) | ||
* Joe Moorhouse (interactive shell was taken from his project [IronLab](http://ironlab.net/)) | ||
* Jason Schaeffer (port to Revit 2011) | ||
* many, many users with questions, bug reports etc! | ||
|
||
Also, many thanks to the | ||
[Chair for Architecture & Building Systems](http://systems.arch.ethz.ch) for making this project possible. | ||
|
||
**NOTE**: If you are not on this list, but believe you should be, please contact me! | ||
|
||
|
||
|