Create app.py instead of hello.py in uv init

crates/uv/src/commands/project/init.rs

@@ -775,12 +775,13 @@ impl InitProjectKind {
             // Generate `src` files
             generate_package_scripts(name, path, build_backend, false)?;
         } else {
-            // Create `hello.py` if it doesn't exist
-            // TODO(zanieb): Only create `hello.py` if there are no other Python files?
-            let hello_py = path.join("hello.py");
-            if !hello_py.try_exists()? {
+            // Create `app.py` if it doesn't exist
+            // (This isn't intended to be a particularly special or magical filename, just nice)
+            // TODO(zanieb): Only create `app.py` if there are no other Python files?
+            let app_py = path.join("app.py");
+            if !app_py.try_exists()? {
                 fs_err::write(
-                    path.join("hello.py"),
+                    path.join("app.py"),
                     indoc::formatdoc! {r#"
                     def main():
                         print("Hello from {name}!")

crates/uv/tests/it/init.rs

@@ -73,7 +73,7 @@ fn init_application() -> Result<()> {
     child.create_dir_all()?;
 
     let pyproject_toml = child.join("pyproject.toml");
-    let hello_py = child.join("hello.py");
+    let app_py = child.join("app.py");
 
     uv_snapshot!(context.filters(), context.init().current_dir(&child).arg("--app"), @r###"
     success: true
@@ -101,7 +101,7 @@ fn init_application() -> Result<()> {
         );
     });
 
-    let hello = fs_err::read_to_string(hello_py)?;
+    let hello = fs_err::read_to_string(app_py)?;
     insta::with_settings!({
         filters => context.filters(),
     }, {
@@ -117,7 +117,7 @@ fn init_application() -> Result<()> {
         );
     });
 
-    uv_snapshot!(context.filters(), context.run().current_dir(&child).arg("hello.py"), @r###"
+    uv_snapshot!(context.filters(), context.run().current_dir(&child).arg("app.py"), @r###"
     success: true
     exit_code: 0
     ----- stdout -----
@@ -134,7 +134,7 @@ fn init_application() -> Result<()> {
     Ok(())
 }
 
-/// When `hello.py` already exists, we don't create it again
+/// When `app.py` already exists, we don't create it again
 #[test]
 fn init_application_hello_exists() -> Result<()> {
     let context = TestContext::new("3.12");
@@ -143,8 +143,8 @@ fn init_application_hello_exists() -> Result<()> {
     child.create_dir_all()?;
 
     let pyproject_toml = child.join("pyproject.toml");
-    let hello_py = child.child("hello.py");
-    hello_py.touch()?;
+    let app_py = child.child("app.py");
+    app_py.touch()?;
 
     uv_snapshot!(context.filters(), context.init().current_dir(&child).arg("--app"), @r###"
     success: true
@@ -172,7 +172,7 @@ fn init_application_hello_exists() -> Result<()> {
         );
     });
 
-    let hello = fs_err::read_to_string(hello_py)?;
+    let hello = fs_err::read_to_string(app_py)?;
     insta::with_settings!({
         filters => context.filters(),
     }, {
@@ -184,7 +184,7 @@ fn init_application_hello_exists() -> Result<()> {
     Ok(())
 }
 
-/// When other Python files already exists, we still create `hello.py`
+/// When other Python files already exists, we still create `app.py`
 #[test]
 fn init_application_other_python_exists() -> Result<()> {
     let context = TestContext::new("3.12");
@@ -193,7 +193,7 @@ fn init_application_other_python_exists() -> Result<()> {
     child.create_dir_all()?;
 
     let pyproject_toml = child.join("pyproject.toml");
-    let hello_py = child.join("hello.py");
+    let app_py = child.join("app.py");
     let other_py = child.child("foo.py");
     other_py.touch()?;
 
@@ -223,7 +223,7 @@ fn init_application_other_python_exists() -> Result<()> {
         );
     });
 
-    let hello = fs_err::read_to_string(hello_py)?;
+    let hello = fs_err::read_to_string(app_py)?;
     insta::with_settings!({
         filters => context.filters(),
     }, {
@@ -407,15 +407,15 @@ fn init_script() -> Result<()> {
     let child = context.temp_dir.child("foo");
     child.create_dir_all()?;
 
-    let script = child.join("hello.py");
+    let script = child.join("app.py");
 
-    uv_snapshot!(context.filters(), context.init().current_dir(&child).arg("--script").arg("hello.py"), @r###"
+    uv_snapshot!(context.filters(), context.init().current_dir(&child).arg("--script").arg("app.py"), @r###"
     success: true
     exit_code: 0
     ----- stdout -----
 
     ----- stderr -----
-    Initialized script at `hello.py`
+    Initialized script at `app.py`
     "###);
 
     let script = fs_err::read_to_string(&script)?;
@@ -431,7 +431,7 @@ fn init_script() -> Result<()> {
 
 
         def main() -> None:
-            print("Hello from hello.py!")
+            print("Hello from app.py!")
 
 
         if __name__ == "__main__":
@@ -440,11 +440,11 @@ fn init_script() -> Result<()> {
         );
     });
 
-    uv_snapshot!(context.filters(), context.run().current_dir(&child).arg("python").arg("hello.py"), @r###"
+    uv_snapshot!(context.filters(), context.run().current_dir(&child).arg("python").arg("app.py"), @r###"
     success: true
     exit_code: 0
     ----- stdout -----
-    Hello from hello.py!
+    Hello from app.py!
 
     ----- stderr -----
     "###);
@@ -818,7 +818,7 @@ fn init_application_current_dir() -> Result<()> {
     "###);
 
     let pyproject = fs_err::read_to_string(dir.join("pyproject.toml"))?;
-    let hello_py = fs_err::read_to_string(dir.join("hello.py"))?;
+    let app_py = fs_err::read_to_string(dir.join("app.py"))?;
 
     insta::with_settings!({
         filters => context.filters(),
@@ -840,7 +840,7 @@ fn init_application_current_dir() -> Result<()> {
         filters => context.filters(),
     }, {
         assert_snapshot!(
-            hello_py, @r###"
+            app_py, @r###"
         def main():
             print("Hello from foo!")
 

docs/concepts/projects/init.md

@@ -22,15 +22,15 @@ Applications are the default target for `uv init`, but can also be specified wit
 $ uv init example-app
 ```
 
-The project includes a `pyproject.toml`, a sample file (`hello.py`), a readme, and a Python version
+The project includes a `pyproject.toml`, a sample file (`app.py`), a readme, and a Python version
 pin file (`.python-version`).
 
 ```console
 $ tree example-app
 example-app
 ├── .python-version
 ├── README.md
-├── hello.py
+├── app.py
 └── pyproject.toml
 ```
 
@@ -49,7 +49,7 @@ dependencies = []
 
 The sample file defines a `main` function with some standard boilerplate:
 
-```python title="hello.py"
+```python title="app.py"
 def main():
     print("Hello from example-app!")
 
@@ -61,7 +61,7 @@ if __name__ == "__main__":
 Python files can be executed with `uv run`:
 
 ```console
-$ uv run hello.py
+$ uv run app.py
 Hello from example-project!
 ```
 

docs/guides/projects.md

@@ -25,14 +25,14 @@ uv will create the following files:
 .
 ├── .python-version
 ├── README.md
-├── hello.py
+├── app.py
 └── pyproject.toml
 ```
 
-The `hello.py` file contains a simple "Hello world" program. Try it out with `uv run`:
+The `app.py` file contains a simple "Hello world" program. Try it out with `uv run`:
 
 ```console
-$ uv run hello.py
+$ uv run app.py
 Hello from hello-world!
 ```
 
@@ -53,7 +53,7 @@ A complete listing would look like:
 │   └── pyvenv.cfg
 ├── .python-version
 ├── README.md
-├── hello.py
+├── app.py
 ├── pyproject.toml
 └── uv.lock
 ```