go_router_path_builder

Description:

go router path builder

go_router_path_builder #
A flutter package to generate go_router path in functional style.
Getting Started #
Overview #
Obviously Flutter Team has already created a great library go_router_builder for explicit route definition. However the implementing steps are complicated for me, this package provided another approach.
The idea behind is very simple: instead of using String to navigate to a location:
context.go('/home/user/123/detail');
copied to clipboard
use builder to create navigating location with a help of code auto completion in order to avoid typos:
context.go(router.home.user(id: '123').detail.toString());
copied to clipboard
Source code #
Here is an instruction for using this builder. Importing go_router.dart is necessary (sure, we are using go_router) and including a part that references to the generated file. The generated file will always have a name [source_file].router.dart.
import 'package:go_router/go_router.dart';
import 'package:go_router_path_builder/go_router_path_builder.dart';

part 'this_file.router.dart';
copied to clipboard
Then, let's create top-level array containing RoutePathBuilder, RoutePathPageBuilder or RoutePathShellBuilder instance. Don't forget to mark it with GoRouterAnnotation annotation.
Example:
@GoRouterAnnotation()
const _routes = [
RoutePathBuilder(
'home',
pageClassType: UserPage,
routes: [
RoutePathBuilder(
'user',
pathArguments: {'id'},
pageClassType: UserPage,
routes: [
RoutePathBuilder('detail', pageClassType: UserDetailPage),
],
extra: true,
),
],
redirect: redirectHome,
),
];
copied to clipboard
After built, two variables router and route will be created. router is actually routerConfig that used as MaterialApp.router and route is for generating location. You can set those variable names in @GoRouterAnnotation arguments.
MaterialApp.router(
//...
routerConfig: router,
//...
);
copied to clipboard
Usage:
// Generate /home/user/123/detail
final String location = route.home.user(id: '123').detail.toString();
copied to clipboard
If RoutePathBuilder or RoutePathPageBuilder has no argument, the corresponding location in route must be treated as a property.
// Generate /home
final String location = route.home.toString();
copied to clipboard
If they have some arguments, now that location became function style. Just put values on them.
// Generate /home/user/123
final String location = route.home.user(id: '123').toString();
copied to clipboard
RoutePathBuilder and RoutePathPageBuilder
By using RoutePathBuilder, GoRoute instance will be generated with builder as page builder.
pageClassType is required, it is the class name of the page.
By using RoutePathPageBuilder, GoRoute instance will be generated with pageBuilder as page builder.
pageBuilder is required, it is the pageBuilder function of GoRoute.
pathArguments and arguments are optional Set<String>?. Set them values in order to add parameters into the location.
pathArguments is pathParameters and arguments is uri.queryParaments in GoRouterState.
Set extra to true if extra object will be used.
RoutePathShellBuilder
By using this, ShellRoute instance will be generated.
The function type arguments, like pageBuilder, onExit, redirect will be reflected directly into GoRoute. Only static or top-level variables available due to the limitation of code generation. Please look at redirectHome in example.
Run build_runner #
To do a one-time build:
dart run build_runner build
copied to clipboard
Or, to watch the changes while developing
dart run build_runner watch
copied to clipboard
Just watching a specific file for faster code-gen
dart run build_runner watch --build-filter 'lib/main.dart'
copied to clipboard
Read more about using
build_runner on pub.dev.
Dependencies #
To use go_router_path_builder, please add the following dependences into pubspec.yaml.
dependencies:
# ...
go_router: any

dev_dependencies:
# ...
build_runner: any
go_router_path_builder: ^0.0.1
copied to clipboard
TODO #

Add test cases
Support StatefulShellRoute