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

cdklabs-projen-project-types

v0.1.214

Published

This repository stores custom project types extended from `projen` with cdklabs defaults baked in. This is meant to serve as a hook for continuous management of all repos we own. With cdklabs projen types, we can add new configuration as they come up and

Downloads

32,285

Readme

Cdklabs Projen Project Types

This repository stores custom project types extended from projen with cdklabs defaults baked in. This is meant to serve as a hook for continuous management of all repos we own. With cdklabs projen types, we can add new configuration as they come up and have it propagate to all repositories using the type.

CdklabsConstructLibrary

This type extends projen's awscdk.AwsConstructLibrary project type and should be used in place of that type.

Usage

From the command line:

npx projen new --from cdklabs-projen-project-types cdklabs-construct-lib

From inside cdk-ops:

this.cdklabs.addPreApprovedRepo({
  repo: 'cdk-new-lib',
  owner: '[email protected]',
  createWith: {
    projectType: ProjectType.CDKLABS_MANAGED_CONSTRUCT_LIB,
  },
});

Features

  • cdklabsPublishingDefaults

By default, this is turned on. cdklabsPublishingDefaults provides publishing defaults based off of the project's name. Specifically, the defaults look like this:

return {
  publishToPypi: {
    distName: npmPackageName,
    module: changeDelimiter(npmPackageName, '_'),
  },
  publishToMaven: {
    javaPackage: `io.github.cdklabs.${changeDelimiter(npmPackageName, '.')}`,
    mavenGroupId: 'io.github.cdklabs',
    mavenArtifactId: npmPackageName,
    mavenEndpoint: 'https://s01.oss.sonatype.org',
  },
  publishToNuget: {
    dotNetNamespace: `Cdklabs${upperCaseName(npmPackageName)}`,
    packageId: `Cdklabs${upperCaseName(npmPackageName)}`,
  },
  publishToGo: {
    moduleName: `${npmPackageName}-go`,
  },
};

Additionally, we also require that we publish to all jsii language targets (including go) when we specify a library as stable.

  • private

By default, a project is created as private. Turning this off simply means setting private: false. A project being private means it gets certain properties set as default that are true for private projects. Today, that means setting private: true in package.json, removing .mergify.yml from the project, and removing .npmignore.

  • releasableCommits

By default this project type releases ReleasableCommits.featuresAndFixes, to not release a new version every day on a package that only sees devDependency updates. You may want to override this if you need something more specific.

CdklabsTypeScriptProject

This type extends projen's typescript.TypeScriptProject project type and should be used in place of that type.

Usage

npx projen new --from cdklabs-projen-project-types cdklabs-ts-proj

From inside cdk-ops:

this.cdklabs.addPreApprovedRepo({
  repo: 'cdk-new-lib',
  owner: '[email protected]',
  createWith: {
    projectType: ProjectType.CDKLABS_MANAGED_TS_PROJECT,
  },
});

Features

  • private

By default, a project is created as private. Turning this off simply means setting private: false. A project being private means it gets certain properties set as default that are true for private projects. Today, that means setting private: true in package.json, removing .mergify.yml from the project, and removing .npmignore.

CdklabsMonorepo

A TypeScript monorepo using Yarn Workspaces. Individual workspaces can be added with yarn.TypeScriptWorkspace which extends projen's typescript.TypeScriptProject.

Usage

npx projen new --from cdklabs-projen-project-types cdklabs-yarn-monorepo

Features

const project = new yarn.CdkLabsMonorepo({
  defaultReleaseBranch: "main",
  devDeps: ["cdklabs-projen-project-types"],
  name: "monorepo",
});
  • Workspace commands: projen build|compile|package|test|upgrade
    Will run the specific command in all workspaces and the root if applicable.

  • Workspace run: projen run <command>
    Executes the given command in all workspaces

  • Automatic dependency installation
    The monorepo will know if a dependency has been added for a workspace and run yarn install as part of projen

  • projen at any level
    The default projen command can be run in any workspace and will execute the monorepo synth command.

  • Release
    This feature is not supported at this time. Any release functionality must be implemented.

  • vscodeWorkspace: boolean
    You can specify if a VSCode Workspace file should be created for the monorepo.

Workspaces

new yarn.TypeScriptWorkspace({
  parent: project,
  name: 'workspace'
})
  • parent: yarn.Monorepo
    Workspaces (aka subprojects) must be added using the parent option.

  • workspaceScope: string
    The location the workspace is placed at. Defaults to ./packages

  • excludeDepsFromUpgrade: Array<string>
    List any dependencies that should not be updated in the workspace.