René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Improve semantics of library organization","articleBody":"Currently, the directory `Library/` is treated as a hard-coded special case by the `lean project-create` and `lean library add` commands. Given that projects list the names and paths of their library dependencies and that libraries also have `config.json` files, it seems that dropping the hard-coded value in favor of more explicit settings/flags would be cleaner and allow users more flexibility for code organization.\n\nThis assumes that the runtime doesn't treat `Library/`paths as special, which I have not checked.\n\n**Current status:**\n[`is_lean_library()`](https://github.com/QuantConnect/lean-cli/blob/master/lean/components/util/library_manager.py#L64) checks whether the argument to library add starts with `\"Library/\"` to determine its return value, and this is what the `library add` command [uses](https://github.com/QuantConnect/lean-cli/blob/master/lean/commands/library/add.py#L318) to determine whether to add a local library or to install from pypi/nuget.\n\nThe [docs](https://www.quantconnect.com/docs/v2/lean-cli/projects/libraries/project-libraries#02-Create-Libraries\n) say to use `project-create` to create a new library. [`project_create`] looks at whether the path to the project contains `\"Library/\"` and if so, uses the library template and puts it in `Library.py` (instead of `main.py` with the usual algo contents)\nhttps://github.com/QuantConnect/lean-cli/blob/master/lean/commands/create_project.py#L428-L434\nhttps://github.com/QuantConnect/lean-cli/blob/master/lean/commands/create_project.py#L455-L457\n\n**Proposed changes:**\n- introduce an argument to `project-create`, `--library` to indicate that the project is intended to be a library\n- when `\"Library/\"` is in the path according to current logic, but `--library` is not set to true, emit warning log message\n- `is_library_project = is-library-arg OR current logic`\n- modify `project-create` so that it also sets `is-library` in `config.json` when creating a library\n- modify `is_lean_library()` in to use the field in the config rather than the path\n\n**Optional / nice-to-have changes:**\n- introduce `library-create` command, analogous to `project-create`, but for creating libraries\n- factor out common logic between the two commands\n- add a deprecation warning log message to project-create in the library-creation path\n- introduce an argument to the `library add` to explicitly indicate whether the library is local or to be installed from pypi/nuget ","author":{"url":"https://github.com/rz","@type":"Person","name":"rz"},"datePublished":"2025-06-24T00:44:24.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":0},"url":"https://github.com/579/lean-cli/issues/579"}