More changes in preparation for beta.

Author: kmeht

CONTRIBUTING.md

@@ -0,0 +1,34 @@
+# Contributing to PyReact
+
+## Development Process
+
+The majority of development on PyReact will occur through GitHub. Accordingly, the process for contributing will follow standard GitHub protocol.
+
+### Bugs
+
+We will be using GitHub Issues for our public bugs. Before filing a new task, try to make sure your problem doesn't already exist. Then, provide clear repro steps, with examples if possible.
+
+### Pull Requests
+
+Please submit your patches to PyReact via pull requests. *Before* submitting a pull request, please make sure the following is done:
+
+1. Fork the repo and create your branch from `master`.
+2. If you've added code that should be tested, add tests!
+3. If you've changed APIs, update the documentation.
+4. Make sure your code follows PEP8 style guidelines.
+5. If you haven't already, complete the 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, so if you've done this for another Facebook open source project, you're good to go. If you are submitting a pull request for the first time, just let us know that you have completed the CLA and we can cross-check with your GitHub username.
+
+Complete your CLA here: <https://developers.facebook.com/opensource/cla>
+
+## How to Get in Touch
+
+* IRC - [#reactjs on freenode](http://webchat.freenode.net/?channels=reactjs)
+* Mailing list - [reactjs on Google Groups](http://groups.google.com/group/reactjs)
+
+## License
+
+By contributing to PyReact, you agree that your contributions will be licensed under the [Apache License Version 2.0 (APLv2)](LICENSE).

DESCRIPTION

@@ -0,0 +1,8 @@
+PyReact
+=======
+
+PyReact is a Python wrapper around the `React <https://facebook.github.io/react/>`_ JavaScript library and `JSX <https://facebook.github.io/react/docs/jsx-in-depth.html>`_. 
+
+Specifically, it provides an API to transform JSX files into JavaScript from within your Python application, as well as providing access to the latest React build.
+
+For more information, please visit the `PyReact project on GitHub <https://github.com/facebook/react-python/>`_.

MANIFEST.in

@@ -1,3 +1,3 @@
-include README.rst VERSIONS.rst
-include LICENSE
+include *.md
+include LICENSE DESCRIPTION
 recursive-include react js *.js

README.md

@@ -0,0 +1,49 @@
+# PyReact
+
+PyReact is a Python wrapper around the [React](http://facebook.github.io/react/) JavaScript library and [JSX](http://facebook.github.io/react/docs/jsx-in-depth.html). 
+
+Specifically, it provides an API to transform JSX files into JavaScript from within your Python application, as well as providing access to the latest React build.
+
+
+## Installation
+
+**PyPI**: PyReact is hosted on PyPI, and can be installed with `pip`:
+
+    $ pip install PyReact
+
+Alternatively, add it into your `requirements` file:
+
+    PyReact==0.1.0
+
+
+**Dependencies**: PyReact uses [PyExecJS](https://github.com/doloopwhile/PyExecJS) to execute the bundled React code, which requires that a JS runtime environment is installed on your machine. We don't explicitly set a dependency on a runtime environment; Mac OS X comes bundled with one. If you're on a different platform, we recommend [PyV8](https://code.google.com/p/pyv8/).
+
+## Usage
+
+Transform your JSX files via the provided `jsx` module::
+
+```python    
+from react import jsx
+
+# For multiple paths, use the JSXTransformer class.
+transformer = jsx.JSXTransformer()
+for jsx_path, js_path in my_paths:
+    transformer.transform(jsx_path, js_path)
+
+# For a single file, you can use a shortcut method.
+jsx.transform('path/to/input/file.jsx', 'path/to/output/file.js')
+```
+
+**Django**: PyReact includes a JSX compiler for [django-pipeline](https://github.com/cyberdelia/django-pipeline). Add it to your project's pipeline settings like this:
+
+```python
+PIPELINE_COMPILERS = (
+  'react.utils.pipeline.JSXCompiler',
+)
+```
+
+
+## License
+
+Copyright (c) 2013 Facebook, Inc.
+Released under the [Apache License, Version 2.0](LICENSE).

README.rst

@@ -1,9 +1,7 @@
-Bundled Versions
-================
+## Bundled Versions
+
 This file lists the version(s) of React that are bundled with each version of PyReact.
 
-+---------+-------+ 
 | PyReact | React |
-+=========+=======+
+|---------|-------|
 | 0.1.0   | 0.4.1 |
-+---------+-------+

VERSIONS.rst VERSIONS.md

@@ -12,8 +12,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-import jsx, source
 
-
-VERSION = '0.1.0'
+VERSION = '0.1.1'
 REACT_VERSION = '0.4.1'

react/__init__.py

@@ -0,0 +1,35 @@
+# Copyright 2013 Facebook, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from pipeline.compilers import CompilerBase
+from pipeline.exceptions import CompilerError
+from react.jsx import JSXTransformer, TransformError
+
+class JSXCompiler(CompilerBase):
+    output_extension = '.js'
+
+    def __init__(self):
+        CompilerBase.__init__(self)
+        self.transformer = JSXTransformer()
+
+    def match_file(self, filename):
+        return path.endswith('.jsx')
+
+    def compile(self, infile, outfile, outdated=False, force=False):
+        if not outdated and not force:
+            return
+        try:
+            return self.transformer.transform(infile, outfile)
+        except TransformError as e:
+            raise CompilerError(e.message)

react/utils/__init__.py

@@ -7,16 +7,25 @@
     version=VERSION,
     author='Kunal Mehta',
     author_email='[email protected]',
+    url='https://github.com/facebook/PyReact',
+    license='Apache-2.0',
+    description='Python bridge to JSX & the React JavaScript library.',
+    long_description=open('DESCRIPTION').read(),
+    classifiers =[
+        'Development Status :: 4 - Beta',
+        'Intended Audience :: Developers',
+        'License :: OSI Approved :: Apache Software License',
+        'Programming Language :: Python',
+        'Programming Language :: Python :: 2.7',
+        'Topic :: Software Development :: Code Generators',
+        'Topic :: Software Development :: Libraries :: Python Modules',
+    ],
     packages=find_packages(),
     package_data={'js': [
         'js/react.js',
         'js/react.min.js',
         'js/JSXTransformer.js',
     ]},
-    url='https://github.com/facebook/PyReact',
-    license='Apache-2.0',
-    description='Python bridge to JSX & the React JavaScript library.',
-    long_description=open('README.rst').read(),
     install_requires=[
         'PyExecJS >= 1.0.4',
     ]