Partas.Tools.SepochSemver 0.4.1

Configuration

Design

• Output type
  • Splitting
    • Mono file
    • File per scope
    • File per epoch
  • Formatting
    • Scope grouping
    • Scope prefixing
      • Prefix per scope
    • Epoch grouping
• Output path
  • Output name (implicit to above)
  • fine grained per project
• Project type
  • Fsharp
    • Ignore projects
  • General
    • Defining scopes to paths
• Scoping names
• Autobump error (error on attempt to create the file if it requires bumping)
• Forced bump
  • Bump for scope
  • Bump target
  • Bump all by patch/minor/major/epoch
• Author specific
  • ignore author (for bots etc)
• Generate 'Release' notes for releases piped to output pre-formatted
  • GH auto release
• Assembly file management
• Scope settings
  • no scoping (just normal commit logging)
  • explicit scopes (only log scoped)
  • autoscope (makes scopes for those not ignored)
  • explicit scopes and noscoping (log explicit scopes, and bundle the rest, no version management though)
• type/description keyword/footer → bump type
• grouping matcher
• format groupings
• format content in general
• exclude paths
• initial versions if unset
• github url

Implementation

• Output type
  • Splitting
    • Mono file
    • File per scope
    • File per epoch
  • Formatting
    • Scope grouping
    • Scope prefixing
      • Prefix per scope
    • Epoch grouping
• Output path
  • Output name (implicit to above)
  • fine grained per project
• Project type
  • Fsharp
    • Ignore projects
  • General
    • Defining scopes to paths
• Scoping names
• Autobump error (error on attempt to create the file if it requires bumping)
• Forced bump
  • Bump for scope
  • Bump target
  • Bump all by patch/minor/major/epoch
• Author specific
  • ignore author (for bots etc)
• Generate 'Release' notes for releases piped to output pre-formatted
  • GH auto release
• Assembly file management
• Scope settings
  • no scoping (just normal commit logging)
  • explicit scopes (only log scoped)
  • autoscope (makes scopes for those not ignored)
  • explicit scopes and noscoping (log explicit scopes, and bundle the rest, no version management though)
• type/description keyword/footer → bump type
• grouping matcher
• format groupings
• format content in general
• exclude paths
• initial versions if unset
• github url
• Temporarily version projects during build time so they reference each other correctly.

API Brainstorming

let config =
    // make config
let runtime = new GitNetRuntime(config)
let bumps,output =
    runtime.Run()
    |> runtime.WriteAssemblyFiles
// bumps - dictionary of scopes to their
//         new sepoch semvers
// output - markdown output for the changelogs

runtime.VersionProjects(bumps) (* takes the
bumps and uses that to match the projects
which have their version and packageVersion
fields overwritten.

Disposal functions can be used to revert
the changes if desired.
`runtime.RevertVersionProjects()`
This can be dangerous, as you might accidentally use
old package versions in your build process.

If this is done in a CI process, you'll want
to commit the changes.
*)