Package: everyapp.bootstrap
ContentsAboutFeaturesStatusInstallationBasic UsageDocumentation and SupportContributingLicenceCreditsAbouteveryapp.bootstrapprovides an enhanced and customizablevirtualenvbootstrap script.  It aims to make it easy to bootstrap a virtual environment
for your project.This project includes a tool to generate a bootstrap script that will
automatically create the virtual environment when run.  By placing the
bootstrap script in the root of your project’s source tree and making it
available on a fresh checkout/clone from your version control repository, you
make it easy for anyone who wants to hack on your project (including yourself!)
to work in a consistent development environment.Additionally, this enhanced bootstrap script can read a configuration file and
perform additional actions beyond just creating a bare-bones virtual
environment.FeaturesEasy creation of avirtualenvbootstrap script.Better defaults forvirtualenv, like usingdistributeinstead ofsetuptoolsand always unzipping EGGs.Easy customization of the bootstrapping process.Automatic installation of additional distributions usingpipand/oreasy_install.Easy customization ofpipandeasy_installbehaviour during distribution
installation.Automatic execution of additional commands after the bootstrapping is
complete.Adherence toSemantic Versioningin
order to be a well behaved dependency.StatusThis project is very young and the code should be consideredAlphaquality.
It has been minimally tested on Linux and Windows, underPython2.6 and 2.7,
but has not yet been seriously tested on any platform.That said, it is largely just a wrapper and a few customizations on the
production-gradevirtualenvproject[1], so it should be reasonably
stable.  It should also be mostly feature complete.InstallationThe easiest way to install this distribution is:pip install everyapp.bootstrapor:easy_install everyapp.bootstrapFor additional information on installing and upgrading, see theinstallation
documentation.Basic UsageIn your project’s root directory, run:mkbootstrapThis will generate abootstrap.pyscript and abootstrap.cfgconfiguration file.  Editbootstrap.cfgas desired, then run:python bootstrap.pyThis will create the virtual environment in the root directory for your
project.For additional bootstrap script options and usage information see theusage
documentation.Documentation and SupportHome page:http://pypi.python.org/pypi/everyapp.bootstrapDownloads:http://pypi.python.org/pypi/everyapp.bootstrap#downloadsDocumentation:In the source distribution, or online in the following formats:HTML,EPUB,
andPDF.Bug/issue tracker:http://bitbucket.org/everyapp/bootstrap/issuesSource code repository:http://bitbucket.org/everyapp/bootstrapContributingThere is always room for improvement in this project and contributions are
certainly welcome.  The easiest way to contribute is simply to file a bug
report in theissue trackerwhenever you find a problem or want to suggest
an improvement.If you would like to participate in a more substantial way, check out theissue tracker, thelist of known bugsand theTo Do
listto find out about the work that still needs to be
done.NoteIf you submit a bug report, patch or other code, you automatically agree to
licence the contribution.  See thelicensing informationfor details on contribution licensing.See also thedeveloper documentationfor more
information on developing/hacking oneveryapp.bootstrap.Licenceeveryapp.bootstrapis licensed under theGNU General Public License version
3or later (GPLv3+).  This is free software: you are free to change and
redistribute it under certain conditions.  There is NO WARRANTY, to the extent
permitted by law.  For full licensing information, see thelicensing
information.Creditseveryapp.bootstrapwas created by Krys Lawrence <everyapp at krys ca>.See thelist of authorsfor the full list of
contributors to this project.This project would not be what it is without the efforts of many people.
Acknowledgements for their efforts can be found in thelist of
acknowledgements.Footnotes[1]Strictly speaking,virtualenvclassifies itself as Beta
quality, but many consider it to be production-grade.