.\" Man page generated from reStructuredText.
.
.TH "PYQI" "1" "May 21, 2014" "" "pyqi"
.SH NAME
pyqi \- pyqi Documentation
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.SH WHAT IS PYQI?
.sp
pyqi (canonically pronounced \fIpie chee\fP) is a Python framework designed to support wrapping general \fIcommands\fP in multiple types of \fIinterfaces\fP, including at the command line, HTML, and API levels.
.sp
pyqi\(aqs only requirement is a working Python 2.7 or 3.3 installation.
.SH WHY SHOULD I CARE?
.sp
pyqi allows you to write your command once, and easily make it accessible to different types of users through different types of interfaces. In the context of pyqi, \fBa command is a class that takes some inputs, performs some function, and produces some outputs\fP\&. An interface is a light wrapper around that command that makes it accessible to users.
.sp
After defining and testing your command, you can \fBconfigure different types of interfaces\fP\&. This enables, for example, basic users to access your command through an \fBHTML interface\fP running on a local server, power or cluster users to access your command through a \fBcommand line interface\fP, and developers to access your command through an \fBapplication programmer interface (API)\fP\&. Because pyqi\(aqs interfaces are light wrappers around your underlying command, \fBusers of each of these interfaces will be guaranteed to be accessing the same underlying functionality\fP\&.
.sp
pyqi is currently in the early stages of development, and there is a lot to be done. We\(aqre very interested in having beta users, and we fully embrace collaborative development, so if you\(aqre interested in using or developing pyqi, you should get in touch.
.SH HOW DO I START USING PYQI?
.sp
First, install pyqi (it\(aqs easy) by following our \fIinstall instructions\fP\&. Then, you can start working through our tutorials, which are designed to help you evaluate the utility of pyqi, and then integrate pyqi into your project.
.sp
The \fIGetting Started\fP series of tutorials progress linearly through \fIhow to stub and build new commands\fP and \fIhow to stub and build new interfaces\fP\&. These will give you an idea of what pyqi is capable of and how it works.
.sp
The \fIusing\-pyqi\-in\-your\-project\fP series of tutorials will then give you an idea of how you could integrate pyqi into your project. This includes suggestions on \fIhow to organize your project\(aqs repository to look like other repositories that make use of pyqi\fP, and \fIhow to define a driver script\fP (similar to the \fBpyqi\fP command which you\(aqll become familiar with in the \fIGetting Started\fP tutorials) that will give your users access to the commands in your project.
.sp
As the pyqi project matures, we\(aqll include additional \fIdocumentation for advanced developers\fP, who are interested in things like defining new interface types (though this is not something that is ever required for most developers).
.SH HOW DO I GET HELP WITH PYQI?
.sp
For now, please direct questions to \fI\%gregcaporaso@gmail.com\fP\&. Please report bugs and feature requests on the \fI\%pyqi issue tracker\fP\&.
.SH CAN I HELP DEVELOP PYQI?
.sp
Yes! pyqi is open source software, available under the BSD license. All source code is hosted in the \fI\%pyqi GitHub repository\fP\&.
.sp
Development is primarily occurring in the \fI\%Caporaso Lab\fP (Northern Arizona University; Argonne National Laboratories) and \fI\%Knight Lab\fP  (University of Colorado; Howard Hughes Medical Institute), but the goal is for pyqi to be a very open development effort. We accept code submissions as \fI\%pull requests\fP\&.
.SH AUTHOR
The BiPy Development Team
.SH COPYRIGHT
2013, The BiPy Development Team
.\" Generated by docutils manpage writer.
.