mason

• fix: loop rendering when parameters contains an empty list (#1611)
• refactor: address pana issues (#1613)
• refactor: upgrade analysis options (#1539)

• fix: loop rendering when parameters contains an empty list (#1611)
• refactor: address pana issues (#1613)
• refactor: upgrade analysis options (#1539)

• chore(deps): upgrade pkg:archive to ^4.0.0 (#1532)

• chore(deps): upgrade pkg:archive to ^4.0.0 (#1532)

• chore: bump to stable v0.1.0 🎉

• chore: add platforms to pubspec.yaml (#1420)

• deps: loosen pkg:collection constraint for Flutter compat (#1411)

• deps: tighten dependency constraints (#1401)
  • bumps the Dart SDK minimum version up to 3.5.0
• chore: add funding to pubspec.yaml (#1371)

• fix: compile hooks to AOT when using AOT runtime (#1331)
• fix: nested hooks execution (#1348)

• revert: fix: compile hooks to AOT when using AOT runtime (#1331)
  • fix was incomplete and resulted in hook execution to break in JIT mode in some situations

• fix: nested hooks execution (#1334)

• fix: compile hooks to AOT when using AOT runtime (#1331)

• chore(deps): upgrade pkg:mason_logger to ^0.2.15 (#1302)
  • bumps the Dart SDK minimum version up to 3.3.0

• fix: update hook run to support long Dart formats (#1164)
• docs: include reference to DirectoryGeneratorTarget (#1098)
• chore: fix malformed doc template

• deps: upgrade to mason_logger v0.2.9
  • fix: arrow keys on windows (#816)
• chore: improve lint rules
• chore: dart fix --apply
• chore(deps): upgrade dependencies

• feat: support for type list in brick.yaml vars

  vars:
    languages:
      type: list
      description: Your favorite languages
      prompt: What are your favorite languages?
  

• deps: allow latest version of package:http

• feat: add PascalDotCase lambda and String extension
• deps: integrate package:recase

• fix: git brick install across file systems
• refactor: use Isolate.run

• fix: loop detection in runSubstitution
• test: use private mocks

• fix: MasonBundle use fieldRename: FieldRename.snake

• feat: add publishTo to MasonBundle

• feat: support optional publish_to in brick.yaml

• fix: sort contents of bricks.json
• fix: brick git installation algorithm

• feat: improve generated file output
• deps: upgrade to Dart >=2.19, mason_logger ^0.2.5, and very_good_analysis ^4.0.0

• deps: upgrade to Dart >=2.17, mason_logger ^0.2.4, and very_good_analysis ^3.1.0
• fix: createBundle and unpackBundle normalize bundled file paths.

• feat: export StringCaseExtensions

• BREAKING refactor!: remove GeneratorHooks.fromBundle in favor of GeneratorHooks.fromBrickYaml.
• feat: support relative imports in hooks
• feat: support non-ascii characters in hooks
• feat: support bricks with no __brick__ directory
• feat: hook artifacts are stored in the build/hooks directory within the corresponding hooks directory
• feat: bundled artifacts from MasonGenerator.fromBundle are stored in the bundled directory within the mason cache.
• fix: avoid bundling extraneous hook files (e.g. coverage files)

• perf: compile hooks
• fix: allow optional __brick__ directory

• fix: hook execution after pub cache clean

• fix: support mp3 binary file types

• BREAKING feat!: avoid templating hook contents
• chore(deps): upgrade to mason_logger ^0.2.2

• chore(deps): upgrade to mason_logger ^0.2.0

• refactor: use mason_logger ^0.1.3

• fix: use file descriptor pooling
• chore: add additional pubspec.yaml metadata

• fix: render asymmetrical shorthand lambda expressions correctly

• refactor(deps): remove pkg:universal_io
• refactor: use mason_logger ^0.1.1

• fix: improve lambda shorthand syntax flexibility
• perf: speed up hooks execution
• refactor: use mason_logger ^0.1.0

• fix: override toString on MasonException

• perf: run substitutions in isolate and improve render specificity
• chore: use mason_logger ^0.1.0-dev.14

• fix: file path looping array resolution

• feat: brick.yaml vars array support

  vars:
    color:
      type: array
      description: Your desired build flavors
      defaults:
        - production
      prompt: What build flavors would you like?
      values:
        - development
        - staging
        - production
  

• fix: do not prompt when overwrite rule is alwaysOverwrite

• feat: brick.yaml vars enum support

  vars:
    color:
      type: enum
      description: Your favorite color
      default: green
      prompt: What is your favorite color?
      values:
        - red
        - green
        - blue
  

• fix: rendering shorthand lambdas within loops

• chore: use mason_logger ^0.1.0-dev.9

• feat: add mustacheCase lambda

• feat: expose OverwriteRule

• feat: expose GeneratorTarget

• refactor: improve brick location serialization for hosted bricks

  # before
  hello:
    version: ^0.1.0
  
  # after
  hello: ^0.1.0
  

• fix: HookContext vars mutation

• fix: lambda shorthand conditional interop
• fix: lambda shorthand partials interop

• fix: lambda shorthand syntax interop

• feat: introduce shorthand lambda syntax
  • {{name.upperCase()}} <-> {{#upperCase}}{{name}}{{/upperCase}}
• chore: use mason_logger ^0.1.0-dev.8

• feat: add optional repository field to brick.yaml

• BREAKING: feat: BricksJson.add returns CachedBrick instead of String location.
• feat: add MasonLockJson
• feat: export CachedBrick, GeneratorHooks, MasonLockJson, Version, VersionConstraint, and VersionRange

• feat: include README, CHANGELOG, and LICENSE in MasonBundle

• fix: Yaml.encode handle escape characters

• BREAKING: feat: run fromUniversalBundle in Isolate (async)
• feat: expose Yaml encoding utility
• feat: add fromDartBundle to MasonBundle

• feat: expose MasonBundledFile

• feat: add environment to brick.yaml

  name: example
  description: An example brick
  version: 0.1.0+1
  
  environment:
    mason: ">=0.1.0-dev.1 <0.1.0"
  

• feat: add isBrickCompatibleWithMason

• BREAKING: feat: add MasonGenerator.fromBrick
  • refactor: remove MasonGenerator.fromGitPath (use fromBrick instead)
  • refactor: remove MasonGenerator.fromBrickYaml (use fromBrick instead)
• BREAKING: refactor: Brick named constructors
  • Brick.path, Brick.git, Brick.version
• BREAKING: refactor: remove WriteBrickException
• BREAKING: refactor: simplify bricks.json format
• refactor: git cache directory location
• feat: add fromUniversalBundle and toUniversalBundle on MasonBundle
• feat: add BrickLocation
• feat: add unpackBundle to convert universal bundle bytes to a MasonBundle
• fix: yaml string encoding for semver
• fix: BrickNotFoundException message when git path is empty
• chore: upgrade to mason_logger ^0.1.0-dev.5
• chore: upgrade to Dart 2.16

• BREAKING feat: return list of GeneratedFile from generate

import 'dart:io';

import 'package:mason/mason.dart';

Future<void> main() async {
  final generator = await MasonGenerator.fromGitPath(
    const GitPath(
      'https://github.com/felangel/mason.git',
      path: 'bricks/greeting',
    ),
  );
  final files = await generator.generate(
    DirectoryGeneratorTarget(Directory.current),
    vars: <String, dynamic>{'name': 'Dash'},
  );
}

• feat: expose packageVersion

• BREAKING feat: add computed vars support via HookContext

// pre_gen.dart

import 'package:mason/mason.dart';

// Every hook must contain a run method which accepts a `HookContext`
// from package:mason/mason.dart.
void run(HookContext context) {
  // Read/Write vars
  context.vars = {...context.vars, 'custom_var': 'foo'};

  // Use the logger
  context.logger.info('hello from pre_gen.dart');
}

• BREAKING feat: restructure brick.yaml vars to support type, description, and default:

name: example
description: An example brick.

# The following defines the version and build number for your brick.
# A version number is three numbers separated by dots, like 1.2.34
# followed by an optional build number (separated by a +).
version: 0.1.0+1

# Variables specify dynamic values that your brick depends on.
# Zero or more variables can be specified for a given brick.
# Each variable has:
#  * a type (string, number, or boolean)
#  * an optional short description
#  * an optional default value
#  * an optional prompt phrase used when asking for the variable.
vars:
  name:
    type: string
    description: Your name
    default: Dash
    prompt: What is your name?

• BREAKING feat: add version to bundle

• BREAKING refactor: API improvements to MasonBundle, MasonGenerator, and DirectoryGeneratorTarget

  • MasonBundle
    • Use named constructor parameters instead of positional parameters
  • MasonGenerator.generate(...)
    • Accepts optional Logger and FileConflictResolution
  • DirectoryGeneratorTarget
    • No longer accepts optional Logger and FileConflictResolution (moved to generate API above)

  Before

  final generator = MasonGenerator.fromBundle(myBundle);
  final target = DirectoryGeneratorTarget(dir, Logger(), FileConflictResolution.skip);
  await generator.generate(target, vars: {...});
  

  After

  final generator = MasonGenerator.fromBundle(myBundle);
  final target = DirectoryGeneratorTarget(dir);
  await generator.generate(
    DirectoryGeneratorTarget(tempDir),
    vars: {...},
    logger: Logger(), // optional logger
    fileConflictResolution: FileConflictResolution.skip, // optional conflict resolution strategy
  );
  

• fix: ignore FileConflictResolution when there are no conflicts

• docs: README updates and upgrade example bricks

• chore: upgrade to mason_logger: v0.1.0-dev.4