Scaffold a Forge app end-to-end: forge new -> create DB -> forge migrate -> forge bootstrap -> forge serve
| Tier | tools |
| Role | unclassified (baselined) |
| Path | crates/tools/new-app |
| Edition | 2021 |
| Targets | tools-new-app, tools_new_app |
| Public items | 8 across 0 modules |
| Tests | 17 |
What it is for
This crate does not document itself. No //! block on its entry point. The facts below are complete; the reason this crate exists is not written down anywhere, and belongs in src/lib.rs rather than here.
Capabilities
crate root
_No module-level documentation is present in the source._
| Item |
|---|
pub const USAGE: & str |
pub const DEFAULT_VERTICAL: & str |
pub const MAX_ENV_FILE_BYTES: u64 |
fn validate_app_name(name : & str) -> Result <()> |
fn db_name_from_url(url : & str) -> Result <String> |
fn parse_env_contents(contents : & str) -> HashMap <String, String> |
ParsedArgs
_No module-level documentation is present in the source._
| Item |
|---|
pub struct ParsedArgs |
fn parse_args(args : & String) -> Result <ParsedArgs> |
How to use it
No examples/ target and no doctest in this crate's rustdoc. The tests listed under Verification are the closest executable usage.
Module structure
No public modules: the crate root is its whole surface.
Public surface
`crate root`
| Item | What it is |
|---|---|
pub const USAGE: & str | — |
pub const DEFAULT_VERTICAL: & str | — |
pub const MAX_ENV_FILE_BYTES: u64 | — |
pub struct ParsedArgs | — |
fn parse_args(args : & String) -> Result <ParsedArgs> | — |
fn validate_app_name(name : & str) -> Result <()> | — |
fn db_name_from_url(url : & str) -> Result <String> | — |
fn parse_env_contents(contents : & str) -> HashMap <String, String> | — |
No pub use re-exports: every item above is declared in this crate.
Boundary
Depends on no other workspace tier.
Shares tier tools with 84 other crates: tools-advisory-reach, tools-archive-guard, tools-artifact-scaffold, tools-ask-ai-core, tools-ask-ais, tools-ask-gemini, tools-book, tools-book-report, … (84 total).
_What this crate deliberately does NOT own is a judgment. No committed registry records one for it, so none is stated here._
Where it sits
| Tier (ontology) | tools |
| Architectural role (taxonomy) | unclassified (baselined) |
| Location | crates/tools/new-app |
| Vocabulary in force (lexicon) | current |
Dependencies
Runtime, from outside the workspace.
| Crate | Requirement | Features | Optional | Only on |
|---|---|---|---|---|
anyhow | ^1 | — | no | always |
Development. None.
Build. None.
Depended on by. Nothing in this workspace.
Feature flags
No Cargo features are defined: every capability is unconditional, so no consumer can receive a half-wired crate.
Targets
| Kind | Name | Source |
|---|---|---|
| bin | tools-new-app | `src/main.rs` |
| lib | tools_new_app | `src/lib.rs` |
Error model
No public error type was detected: no public item declares a type named *Error, and no public signature returns one.
Operational characteristics
| Property | Evidence |
|---|---|
| async public surface | none detected |
| async runtime | none detected |
| database access | none detected |
| network I/O | none detected |
| unsafe code | none detected |
| environment variables | yes |
No unsafe block, unsafe fn, unsafe impl or unsafe trait was found by the parser anywhere in this crate's source.
Configuration
| Variable | Read in |
|---|---|
ADMIN_PASSWORD | src/main.rs |
Related capabilities
No workspace crate depends on this one.
Verification
| Kind | Count |
|---|---|
| Unit tests | 17 |
| Integration tests | 0 |
| Examples | 0 |
| Doctests | 0 |
Evidence by module. How often each public module is named by something executable.
| Module | Tests | Examples | Consumers |
|---|---|---|---|
crate root | 8 | 0 | 0 |
What the tests establish, by name:
db_name_from_url_empty_errors—src/lib.rsdb_name_from_url_simple—src/lib.rsdb_name_from_url_trailing_slash—src/lib.rsdb_name_from_url_with_query—src/lib.rsparse_args_defaults—src/lib.rsparse_args_empty_app_errors—src/lib.rsparse_args_missing_app_errors—src/lib.rsparse_args_missing_flag_value_errors—src/lib.rsparse_args_unknown_flag_errors—src/lib.rsparse_args_with_flags—src/lib.rsparse_env_contents_basic—src/lib.rsparse_env_contents_ignores_lines_without_equals—src/lib.rsparse_env_contents_skips_comments_and_blanks—src/lib.rsparse_env_contents_strips_quotes_and_export—src/lib.rsvalidate_app_name_accepts_normal_name—src/lib.rsvalidate_app_name_rejects_empty—src/lib.rsvalidate_app_name_rejects_traversal—src/lib.rs
Documentation coverage
| Measure | Documented | Total |
|---|---|---|
| Public items with rustdoc | 0 | 8 |
Public modules with a //! block | 0 | 0 |
pie showData
title Public items with rustdoc
"Documented" : 0
"No rustdoc detected" : 8
Metrics
| Metric | Value |
|---|---|
| Rust source files | 2 |
| Source lines | 386 |
| Code lines | 337 |
| Public API items | 8 |
| Public modules | 0 |
| Tests | 17 |
| Examples | 0 |
| Cargo features | 0 |
| Direct runtime dependencies | 1 |
| Workspace reverse dependencies | 0 |
pie showData
title Public API by kind
"constant" : 3
"function" : 4
"struct" : 1
pie showData
title Rust source composition
"Code" : 337
"Blank or comment" : 49
Generation
Rendered by tools-corpus corpus readme from repository evidence alone, renderer schema 2, lexicon current. No model, network service or database was consulted. Regenerate with tools-corpus corpus readme --write; verify with --check.