uv/docs/reference
Zanie Blue bc5b069a61
Add --app and --lib options to uv init (#6689)
Changes the `uv init` experience with a focus on working for more
use-cases out of the box.

- Adds `--app` and `--lib` options to control the created project style
- Changes the default from a library with `src/` and a build backend
(`--lib`) to an application that is not packaged (`--app`)
- Hides the `--virtual` option and replaces it with `--package` and
`--no-package`
- `--no-package` is not allowed with `--lib` right now, but it could be
in the future once we understand a use-case
- Creates a runnable project
- Applications have a `hello.py` file which you can run with `uv run
hello.py`
- Packaged applications, e.g., `uv init --app --package` create a
package and script entrypoint, which you can run with `uv run hello`
- Libraries provide a demo API function, e.g., `uv run python -c "import
name; print(name.hello())"` — this is unchanged

Closes #6471
2024-08-27 18:08:09 +00:00
..
benchmarks.md Add link to benchmarks in documentation (#6257) 2024-08-20 12:54:46 -04:00
cli.md Add --app and --lib options to uv init (#6689) 2024-08-27 18:08:09 +00:00
index.md Disable collapsible navigation in the documentation (#5674) 2024-08-16 18:09:21 -05:00
platforms.md Move some documents to relevant sections (#5968) 2024-08-09 17:31:10 +00:00
resolver-internals.md docs: use python to highlight requirements and use more content tabs (#6549) 2024-08-27 06:05:14 -05:00
settings.md Add support for virtual projects (#6585) 2024-08-27 13:42:46 -04:00
versioning.md Move some documents to relevant sections (#5968) 2024-08-09 17:31:10 +00:00