laipeng/reflex
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update Readme (#76)

Browse Source
This commit is contained in:
叶子 2022-12-12 16:28:32 +08:00 committed by GitHub
parent c176c0e0d7
commit 2c683a0dcd
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 23 additions and 15 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
README.md
View File

@ -1,9 +1,8 @@
<div align="center"> <div align="center">
<h1 align="center"> <h1 align="center">
<img width="600" src="docs/images/logo.svg#gh-light-mode-only" alt="Pynecone"> <img width="600" src="docs/images/logo.svg#gh-light-mode-only" alt="Pynecone Logo">
<img width="600" src="docs/images/logo_white.svg#gh-dark-mode-only" alt="Pynecone"> <img width="600" src="docs/images/logo_white.svg#gh-dark-mode-only" alt="Pynecone Logo">
</h1> </h1>
**Build performant, customizable web apps in minutes just using Python.** **Build performant, customizable web apps in minutes just using Python.**
@ -28,15 +27,17 @@ Pynecone is a full-stack Python framework that makes it easy to build and deploy
## Installation ## Installation
Pynecone requires to following to get started: Pynecone requires to following to get started:
* Python 3.7+ * Python 3.7+
* [NodeJS 12.22.0+](https://nodejs.org/en/) * [Node.js 12.22.0+](https://nodejs.org/en/) (Don't worry, you'll never have to write any Javascript)
``` ```
$ pip install pynecone-io $ pip install pynecone-io
``` ```
## Create your first Pynecone app *NOTE:* Make sure you install the correct package: `pynecone-io`, not `pynecone`.
Installing Pynecone also installs the pc command line tool. Test that the install was successful by creating a new project. ## Create your first Pynecone App
Installing Pynecone also installs the `pc` command line tool. Test that the install was successful by creating a new project.
Replace my_app_name with your project name: Replace my_app_name with your project name:
@ -46,13 +47,15 @@ $ cd my_app_name
$ pc init $ pc init
``` ```
This initializes a template app in your new directory. When you run this command for the first time, we will download and install `bun` automatically.
This command initializes a template app in your new directory.
You can run this app in development mode: You can run this app in development mode:
``` ```
$ pc run $ pc run
``` ```
You should see your app running at http://localhost:3000. (Note that the port may be different if you have another app running on port 3000) You should see your app running at http://localhost:3000. (Note that the port may be different if you have another app running on port 3000, please notice the terminal output)
Now you can modify the source code in `my_app_name/my_app_name.py`. Pynecone has fast refreshes so you can see your changes instantly when you save your code. Now you can modify the source code in `my_app_name/my_app_name.py`. Pynecone has fast refreshes so you can see your changes instantly when you save your code.
@ -133,7 +136,8 @@ app.compile()
``` ```
Let's break this down. Let's break this down.
### **UI In Pynecone** ### **UI In Pynecone**
Lets start by talking about the UI this Pynecone App. Lets start by talking about the UI this Pynecone App.
```python ```python
@ -160,6 +164,7 @@ The state defines all the variables (called vars) in an app that can change and
Here the state is comprised of a `prompt` and `image_url`. There are also the booleans `image_processing` and `image_made` to indicate when to show the circular progress and image. Here the state is comprised of a `prompt` and `image_url`. There are also the booleans `image_processing` and `image_made` to indicate when to show the circular progress and image.
### **Event Handlers** ### **Event Handlers**
```python ```python
def process_image(self): def process_image(self):
"""Set the image processing flag to true and indicate image is not made yet.""" """Set the image processing flag to true and indicate image is not made yet."""
@ -191,6 +196,7 @@ app.compile()
You can create a multi-page app by adding more routes. You can create a multi-page app by adding more routes.
## Status ## Status
As of December 2022, Pynecone has just been released publicly and is in the **Alpha Stage**. As of December 2022, Pynecone has just been released publicly and is in the **Alpha Stage**.
- :large_orange_diamond: **Public Alpha**: Anyone can install and use Pynecone. There may be issues, but we are working to resolve them activly. - :large_orange_diamond: **Public Alpha**: Anyone can install and use Pynecone. There may be issues, but we are working to resolve them activly.
@ -212,10 +218,12 @@ Want to join our Pynecone team or learn more about our framework? Send us an ema
We are actively looking for contributors, no matter your skill level or experience. We are actively looking for contributors, no matter your skill level or experience.
## More Information ## More Information
More information about Pynecone can be found on our website: More information about Pynecone can be found on our website:
- [Pynecone.io](https://pynecone.io) - [Pynecone.io](https://pynecone.io)
## License ## License
Pynecone is open-source and licensed under the [Apache License 2.0](LICENSE). Pynecone is open-source and licensed under the [Apache License 2.0](LICENSE).
## Contributors ## Contributors