License and readme

Author: amarcu

.gitignore

@@ -0,0 +1 @@
+/vendor/

CONTRIBUTING.md

@@ -0,0 +1,39 @@
+# Contributing to Hack Codegen
+We want to make contributing to this project as easy and transparent as
+possible.
+
+## Our Development Process
+We will continue developing Hack Codegen in Facebook and synchronizing
+periodically our internal repository with this github repository.
+We will also accept pull requests in this repository and incorporate
+them in our internal repository.
+
+## Pull Requests
+We actively welcome your pull requests.
+1. Fork the repo and create your branch from `master`.
+2. If you've added code that should be tested, add tests
+3. Ensure the test suite passes and the example still work
+4. If you haven't already, complete the Contributor License Agreement ("CLA").
+
+## Contributor License Agreement ("CLA")
+In order to accept your pull request, we need you to submit a CLA. You only need
+to do this once to work on any of Facebook's open source projects.
+
+Complete your CLA here: <https://code.facebook.com/cla>
+
+## Issues
+We use GitHub issues to track public bugs. Please ensure your description is
+clear and has sufficient instructions to be able to reproduce the issue.
+
+Facebook has a [bounty program](https://www.facebook.com/whitehat/) for the safe
+disclosure of security bugs. In those cases, please go through the process
+outlined on that page and do not file a public issue.
+
+## Coding Style
+* 2 spaces for indentation rather than tabs
+* 80 character line length
+* Please be consistent with the coding style
+
+## License
+By contributing Hack Codegen, you agree that your contributions will be licensed
+under its BSD license.

LICENSE

@@ -0,0 +1,30 @@
+BSD License
+
+For Hack Codegen software
+
+Copyright (c) 2015-present, Facebook, Inc. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+ * Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+ * Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+ * Neither the name Facebook nor the names of its contributors may be used to
+   endorse or promote products derived from this software without specific
+   prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE

README.md

@@ -0,0 +1,55 @@
+# Hack Codegen
+Hack Codegen is a library for easily generating Hack code and writing it
+into signed files that prevent undesired modifications.
+The idea behind writing code that writes code is to raise the level of
+abstraction and reduce coupling.  You can use your own way of describing
+a problem and generate the corresponding code.  E.g. see examples/dorm.
+In this example, we use a schema to describe the structure of the data,
+and we use Hack Codegen to write the matching code.
+
+
+## Examples
+The DORM example shows how to use the different aspects of the code
+generation in a simplified real-life example.
+The included tests also exemplify the usage of the different components.
+
+
+## Requirements
+Hack Codegen requires:
+* HHVM
+* Composer
+
+## Installing Hack Codegen
+To install this package via composer, just add the package to require and start using it.
+
+```json
+{
+    "require": {
+        "facebook/hackcodegen": "*"
+    }
+}
+```
+
+## Usage
+Include the autoload file generated by composer and you are set.  For example:
+
+```php
+require 'vendor/autoload.php';
+
+echo codegen_file('HelloWorld.php')
+  ->addClass(
+    codegen_class('HelloWorld')
+      ->addMethod(
+        codegen_method('sayHi')
+          ->setBody('echo "hello world\n";')
+      )
+  )->save();
+
+```
+
+## Configuration
+You can configure some options such as the maximum line width, spacing and
+headers by editing the file src/HackCodegenConfig.php
+
+## License
+Hack Codegen is BSD-licensed. We also provide an additional patent grant.