python-fasthtml 0.2.0__tar.gz → 0.2.1__tar.gz

python-fasthtml-0.2.1/PKG-INFO

@@ -0,0 +1,146 @@
+Metadata-Version: 2.1
+Name: python-fasthtml
+Version: 0.2.1
+Summary: The fastest way to create an HTML app
+Home-page: https://github.com/AnswerDotAI/fasthtml
+Author: Jeremy Howard
+Author-email: github@jhoward.fastmail.fm
+License: Apache Software License 2.0
+Keywords: nbdev jupyter notebook python
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Natural Language :: English
+Classifier: Programming Language :: Python :: 3.10
+Classifier: License :: OSI Approved :: Apache Software License
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: fastcore>=1.6.0
+Requires-Dist: python-dateutil
+Requires-Dist: starlette>0.33
+Requires-Dist: oauthlib
+Requires-Dist: itsdangerous
+Requires-Dist: uvicorn[standard]>=0.30
+Requires-Dist: httpx
+Requires-Dist: fastlite>=0.0.6
+Requires-Dist: python-multipart
+Requires-Dist: beautifulsoup4
+Provides-Extra: dev
+Requires-Dist: ipython; extra == "dev"
+Requires-Dist: lxml; extra == "dev"
+
+# FastHTML
+
+
+<!-- WARNING: THIS FILE WAS AUTOGENERATED! DO NOT EDIT! -->
+
+Welcome to the official FastHTML documentation.
+
+FastHTML is a new next-generation web framework for fast, scalable web
+applications with minimal, compact code. It’s designed to be:
+
+- Powerful and expressive enough to build the most advanced, interactive
+  web apps you can imagine.
+- Fast and lightweight, so you can write less code and get more done.
+- Easy to learn and use, with a simple, intuitive syntax that makes it
+  easy to build complex apps quickly.
+
+FastHTML apps are just Python code, so you can use FastHTML with the
+full power of the Python language and ecosystem.
+
+## Installation
+
+Since `fasthtml` is a Python library, you can install it with:
+
+``` sh
+pip install python-fasthtml
+```
+
+In the near future, we hope to add component libraries that can likewise
+be installed via `pip`.
+
+## Usage
+
+For a minimal app, create a file “main.py” as follows:
+
+<div class="code-with-filename">
+
+**main.py**
+
+``` python
+from fasthtml.common import *
+
+app,rt = fast_app()
+
+@rt('/')
+def get(): return Div(P('Hello World!'), hx_get="/change")
+
+serve()
+```
+
+</div>
+
+Running the app with `python main.py` prints out a link to your running
+app: `http://localhost:5001/`. Visit that link in your browser and you
+should see a page with the title “FastHTML” and the text “Let’s do
+this!”. Congratulations - you’ve just created your first `fasthtml` app!
+
+Adding interactivity is surprisingly easy, thanks to HTMX. If you modify
+the file to add this function…:
+
+<div class="code-with-filename">
+
+**main.py**
+
+``` python
+@rt('/change')
+def get(): return P('Nice to be here!')
+```
+
+</div>
+
+…you’ll now have a page with a clickable element that changes the text
+when clicked. When clicking on this link, the server will respond with
+an “HTML partial”—that is, just a snippet of HTML which will be inserted
+into the existing page. In this case, the returned element will replace
+the original P element (since that’s the default behavior of HTMX) with
+the new version returned by the second route.
+
+This “hypermedia-based” approach to web development is a powerful way to
+build web applications.
+
+## Next Steps
+
+Start with the official sources to learn more about FastHTML:
+
+- [About](https://about.fastht.ml): Learn about the core ideas behind
+  FastHTML
+- [Documentation](https://docs.fastht.ml): Learn from examples how to
+  write FastHTML code
+- [Idiomatic
+  app](https://github.com/AnswerDotAI/fasthtml/blob/main/examples/adv_app.py):
+  Heavily commented source code walking through a complete application,
+  including custom authentication, JS library connections, and database
+  use.
+
+The capabilities of FastHTML are vast and growing, and not all the
+features and patterns have been documented yet. Be prepared to invest
+time into studying and modifying source code, such as the main FastHTML
+repo’s notebooks and the official FastHTML examples repo:
+
+- [FastHTML Examples Repo on
+  GitHub](https://github.com/AnswerDotAI/fasthtml-example)
+- [FastHTML Repo on GitHub](https://github.com/AnswerDotAI/fasthtml)
+
+Then explore the small but growing third-party ecosystem of FastHTML
+tutorials, notebooks, libraries, and components:
+
+- [Creating Custom FastHTML Tags for Markdown
+  Rendering](https://isaac-flath.github.io/website/posts/boots/FasthtmlTutorial.html)
+  by Isaac Flath
+- Your tutorial here!
+
+Finally, join the FastHTML community to ask questions, share your work,
+and learn from others:
+
+- [Discord](https://discord.gg/qcXvcxMhdP)

python-fasthtml-0.2.1/README.md

@@ -0,0 +1,115 @@
+# FastHTML
+
+
+<!-- WARNING: THIS FILE WAS AUTOGENERATED! DO NOT EDIT! -->
+
+Welcome to the official FastHTML documentation.
+
+FastHTML is a new next-generation web framework for fast, scalable web
+applications with minimal, compact code. It’s designed to be:
+
+- Powerful and expressive enough to build the most advanced, interactive
+  web apps you can imagine.
+- Fast and lightweight, so you can write less code and get more done.
+- Easy to learn and use, with a simple, intuitive syntax that makes it
+  easy to build complex apps quickly.
+
+FastHTML apps are just Python code, so you can use FastHTML with the
+full power of the Python language and ecosystem.
+
+## Installation
+
+Since `fasthtml` is a Python library, you can install it with:
+
+``` sh
+pip install python-fasthtml
+```
+
+In the near future, we hope to add component libraries that can likewise
+be installed via `pip`.
+
+## Usage
+
+For a minimal app, create a file “main.py” as follows:
+
+<div class="code-with-filename">
+
+**main.py**
+
+``` python
+from fasthtml.common import *
+
+app,rt = fast_app()
+
+@rt('/')
+def get(): return Div(P('Hello World!'), hx_get="/change")
+
+serve()
+```
+
+</div>
+
+Running the app with `python main.py` prints out a link to your running
+app: `http://localhost:5001/`. Visit that link in your browser and you
+should see a page with the title “FastHTML” and the text “Let’s do
+this!”. Congratulations - you’ve just created your first `fasthtml` app!
+
+Adding interactivity is surprisingly easy, thanks to HTMX. If you modify
+the file to add this function…:
+
+<div class="code-with-filename">
+
+**main.py**
+
+``` python
+@rt('/change')
+def get(): return P('Nice to be here!')
+```
+
+</div>
+
+…you’ll now have a page with a clickable element that changes the text
+when clicked. When clicking on this link, the server will respond with
+an “HTML partial”—that is, just a snippet of HTML which will be inserted
+into the existing page. In this case, the returned element will replace
+the original P element (since that’s the default behavior of HTMX) with
+the new version returned by the second route.
+
+This “hypermedia-based” approach to web development is a powerful way to
+build web applications.
+
+## Next Steps
+
+Start with the official sources to learn more about FastHTML:
+
+- [About](https://about.fastht.ml): Learn about the core ideas behind
+  FastHTML
+- [Documentation](https://docs.fastht.ml): Learn from examples how to
+  write FastHTML code
+- [Idiomatic
+  app](https://github.com/AnswerDotAI/fasthtml/blob/main/examples/adv_app.py):
+  Heavily commented source code walking through a complete application,
+  including custom authentication, JS library connections, and database
+  use.
+
+The capabilities of FastHTML are vast and growing, and not all the
+features and patterns have been documented yet. Be prepared to invest
+time into studying and modifying source code, such as the main FastHTML
+repo’s notebooks and the official FastHTML examples repo:
+
+- [FastHTML Examples Repo on
+  GitHub](https://github.com/AnswerDotAI/fasthtml-example)
+- [FastHTML Repo on GitHub](https://github.com/AnswerDotAI/fasthtml)
+
+Then explore the small but growing third-party ecosystem of FastHTML
+tutorials, notebooks, libraries, and components:
+
+- [Creating Custom FastHTML Tags for Markdown
+  Rendering](https://isaac-flath.github.io/website/posts/boots/FasthtmlTutorial.html)
+  by Isaac Flath
+- Your tutorial here!
+
+Finally, join the FastHTML community to ask questions, share your work,
+and learn from others:
+
+- [Discord](https://discord.gg/qcXvcxMhdP)

{python-fasthtml-0.2.0 → python-fasthtml-0.2.1}/fasthtml/__init__.py

@@ -1,4 +1,4 @@
-__version__ = "0.2.0"
+__version__ = "0.2.1"
 from .core import *
 from .authmw import *
 from .components import *

{python-fasthtml-0.2.0 → python-fasthtml-0.2.1}/fasthtml/cli.py

@@ -43,4 +43,5 @@ def railway_deploy(
     _run(f"railway up -c".split())
     _run(f"railway domain".split())
     railway_link.__wrapped__()
-    _run(f"railway volume add -m /app/data".split())    
+    if mount: _run(f"railway volume add -m /app/data".split())
+    _run(f"railway up -c".split())

python-fasthtml-0.2.1/python_fasthtml.egg-info/PKG-INFO

@@ -0,0 +1,146 @@
+Metadata-Version: 2.1
+Name: python-fasthtml
+Version: 0.2.1
+Summary: The fastest way to create an HTML app
+Home-page: https://github.com/AnswerDotAI/fasthtml
+Author: Jeremy Howard
+Author-email: github@jhoward.fastmail.fm
+License: Apache Software License 2.0
+Keywords: nbdev jupyter notebook python
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Natural Language :: English
+Classifier: Programming Language :: Python :: 3.10
+Classifier: License :: OSI Approved :: Apache Software License
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: fastcore>=1.6.0
+Requires-Dist: python-dateutil
+Requires-Dist: starlette>0.33
+Requires-Dist: oauthlib
+Requires-Dist: itsdangerous
+Requires-Dist: uvicorn[standard]>=0.30
+Requires-Dist: httpx
+Requires-Dist: fastlite>=0.0.6
+Requires-Dist: python-multipart
+Requires-Dist: beautifulsoup4
+Provides-Extra: dev
+Requires-Dist: ipython; extra == "dev"
+Requires-Dist: lxml; extra == "dev"
+
+# FastHTML
+
+
+<!-- WARNING: THIS FILE WAS AUTOGENERATED! DO NOT EDIT! -->
+
+Welcome to the official FastHTML documentation.
+
+FastHTML is a new next-generation web framework for fast, scalable web
+applications with minimal, compact code. It’s designed to be:
+
+- Powerful and expressive enough to build the most advanced, interactive
+  web apps you can imagine.
+- Fast and lightweight, so you can write less code and get more done.
+- Easy to learn and use, with a simple, intuitive syntax that makes it
+  easy to build complex apps quickly.
+
+FastHTML apps are just Python code, so you can use FastHTML with the
+full power of the Python language and ecosystem.
+
+## Installation
+
+Since `fasthtml` is a Python library, you can install it with:
+
+``` sh
+pip install python-fasthtml
+```
+
+In the near future, we hope to add component libraries that can likewise
+be installed via `pip`.
+
+## Usage
+
+For a minimal app, create a file “main.py” as follows:
+
+<div class="code-with-filename">
+
+**main.py**
+
+``` python
+from fasthtml.common import *
+
+app,rt = fast_app()
+
+@rt('/')
+def get(): return Div(P('Hello World!'), hx_get="/change")
+
+serve()
+```
+
+</div>
+
+Running the app with `python main.py` prints out a link to your running
+app: `http://localhost:5001/`. Visit that link in your browser and you
+should see a page with the title “FastHTML” and the text “Let’s do
+this!”. Congratulations - you’ve just created your first `fasthtml` app!
+
+Adding interactivity is surprisingly easy, thanks to HTMX. If you modify
+the file to add this function…:
+
+<div class="code-with-filename">
+
+**main.py**
+
+``` python
+@rt('/change')
+def get(): return P('Nice to be here!')
+```
+
+</div>
+
+…you’ll now have a page with a clickable element that changes the text
+when clicked. When clicking on this link, the server will respond with
+an “HTML partial”—that is, just a snippet of HTML which will be inserted
+into the existing page. In this case, the returned element will replace
+the original P element (since that’s the default behavior of HTMX) with
+the new version returned by the second route.
+
+This “hypermedia-based” approach to web development is a powerful way to
+build web applications.
+
+## Next Steps
+
+Start with the official sources to learn more about FastHTML:
+
+- [About](https://about.fastht.ml): Learn about the core ideas behind
+  FastHTML
+- [Documentation](https://docs.fastht.ml): Learn from examples how to
+  write FastHTML code
+- [Idiomatic
+  app](https://github.com/AnswerDotAI/fasthtml/blob/main/examples/adv_app.py):
+  Heavily commented source code walking through a complete application,
+  including custom authentication, JS library connections, and database
+  use.
+
+The capabilities of FastHTML are vast and growing, and not all the
+features and patterns have been documented yet. Be prepared to invest
+time into studying and modifying source code, such as the main FastHTML
+repo’s notebooks and the official FastHTML examples repo:
+
+- [FastHTML Examples Repo on
+  GitHub](https://github.com/AnswerDotAI/fasthtml-example)
+- [FastHTML Repo on GitHub](https://github.com/AnswerDotAI/fasthtml)
+
+Then explore the small but growing third-party ecosystem of FastHTML
+tutorials, notebooks, libraries, and components:
+
+- [Creating Custom FastHTML Tags for Markdown
+  Rendering](https://isaac-flath.github.io/website/posts/boots/FasthtmlTutorial.html)
+  by Isaac Flath
+- Your tutorial here!
+
+Finally, join the FastHTML community to ask questions, share your work,
+and learn from others:
+
+- [Discord](https://discord.gg/qcXvcxMhdP)

{python-fasthtml-0.2.0 → python-fasthtml-0.2.1}/settings.ini

@@ -1,7 +1,7 @@
 [DEFAULT]
 repo = fasthtml
 lib_name = fasthtml
-version = 0.2.0
+version = 0.2.1
 min_python = 3.10
 license = apache2
 requirements = fastcore>=1.6.0 python-dateutil starlette>0.33 oauthlib itsdangerous uvicorn[standard]>=0.30 httpx fastlite>=0.0.6 python-multipart beautifulsoup4