npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@rimac-technology/semantic-release-monorepo

v1.2.4

Published

Enhanced semantic-release by enabling simplified and automatic package publishing in multi-package repositories

Downloads

959

Readme

@rimac-technology/semantic-release-monorepo

Commitizen friendly Conventional Changelog semantic-release: angular Formatted with Biome

Overview

This project is a TypeScript-enhanced version of the original semantic-release-monorepo. It leverages TypeScript for improved type safety and includes updates to dependencies, codebase simplification, and support for ECMAScript Modules (ESM).

Installation

Ensure both semantic-release and semantic-release-monorepo are accessible in each package of your monorepo.

Install the package as a development dependency using yarn:

  yarn add --dev @rimac-technology/semantic-release-monorepo

or npm:

npm install --dev @rimac-technology/semantic-release-monorepo

Configuration

It is designed to integrate seamlessly with your current semantic-release workflow. Simply replace instances where you call the semantic-release CLI command with semantic-release-monorepo. For example, in your package.json's release script:

{
    "scripts": {
        "release": "semantic-release-monorepo"
    }
}

Or, when using it in the CLI:

semantic-release-monorepo --extends @semantic-release/gitlab-config --dry-run

ℹ️ As the allowUnknownFlags is enabled, all flags will be passed to internal semantic-release call as options argument.

How it works

This library modifies the context object passed to semantic-release plugins in the following way to make them compatible with a monorepo.

| Step | Description | | ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | analyzeCommits | Filters context.commits to only include the given monorepo package's commits. Additionally, it checks whether any workspace that has been modified in the commits is listed as a dependency, devDependency, or peerDependency of the current workspace, and includes those commits as well. | | generateNotes | Filters context.commits to only include the given monorepo package's commits.Modifies context.nextRelease.version to use the monorepo git tag format. The wrapped (default) generateNotes implementation uses this variable as the header for the release notes. Since all release notes end up in the same Git repository, using just the version as a header introduces ambiguity. |

In more detail, this library runs the npm query .workspaces command to retrieve a list of all package.json files across the workspaces in the monorepo. It then checks if any commits from the last release have modified any workspace listed as a dependency, devDependency, or peerDependency for the current workspace.

If such modifications are found, those commits are included in the list of commits for the dependent workspace, even if the workspace itself was not directly changed.

tagFormat

To prevent version conflicts, git tags are created with a namespace that incorporates the name of the package, such as [email protected]. To change this default setting, specify a tagFormat key in the .releaserc.

⚠️ Remember, it's essential to choose a format that ensures each workspace/release is unique.

Custom Release Logic with processCommits

The .releaserc configuration allows an optional processCommits function, enabling you to define custom logic to include additional commits based on specific requirements. This function provides flexibility for more advanced use cases where the default commit filtering behavior doesn't cover your needs.

How it Works

The processCommits function receives an array of CommitWithFilePaths objects. Each object contains the usual commit data, plus a filePaths array listing all the file paths changed in the commit. You can use this information to add custom conditions for determining whether certain commits should trigger a release.

For example, you may want to include specific commits based on custom file path patterns, metadata in commit messages, or some external conditions.

Example Use Case

Imagine you have a monorepo and want to trigger a release not only when relevant files are changed but also based on specific commit messages or tags that are used for triggering feature-specific releases.

In the following example, the processCommits function will include additional commits if they contain a specific tag in the commit message, such as [release:docs], to force a release for documentation updates:

export default {
    branches: ['main'],
    plugins: [
        '@semantic-release/commit-analyzer', 
        '@semantic-release/release-notes-generator'
    ],
    processCommits(commitsWithFilePaths) {
        const customTriggerCommits = commitsWithFilePaths.filter((commit) => {
            // Include commits with a specific tag in the message for custom releases
            return commit.message.includes('[release:docs]') || 
                   commit.message.includes('[release:hotfix]');
        });

        // You can also perform additional checks based on file paths or other conditions
        const filePathFilteredCommits = commitsWithFilePaths.filter((commitWithFilePath) => {
            return commitWithFilePath.filePaths.some((filePath) =>
                filePath.startsWith('docs/') || filePath.startsWith('hotfix/')
            );
        });

        // Combine custom-triggered commits with those affected by file paths
        return [...customTriggerCommits, ...filePathFilteredCommits];
    },
}