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

cobolget

v3.13.26

Published

COBOL Package Manager

Downloads

36

Readme

Features

  • List packages in the registry
  • Index (import new or update existing) packages from the repositories, such as
    • GitHub
    • GitLab
    • Gitee
  • Initialize and validate Manifest
  • Add, remove and resolve dependencies into Lockfile
  • Install COBOL packages
  • COBOL dialects
    • GnuCOBOL
    • IBM Enterprise COBOL
    • Fujitsu NetCOBOL
  • List licenses of the installed packages
  • Run scripts
$ cobolget
Usage: cobolget <command> [options]

Options:
  -v, --version                         output the version number
  -h, --help                            output usage information

Commands:
  list <keyword>                        List packages in the registry
  index [options] <name|url>            Import or update the package in the registry
  init                                  Create manifest file
  validate                              Validate manifest file
  add [options] <dependency> [version]  Add package to the manifest
  remove [options] <dependency>         Remove package from the manifest
  update                                Resolve dependencies and update lockfile
  install [options]                     Install dependencies from lockfile
  licenses                              List licenses of the installed packages
  run <script*>                         Run matching script(s) defined in the manifest

Requirements

  • NodeJS 8+

Installation

$ npm install -g cobolget

Package Management

The Registry helps you distribute and integrate COBOL libraries into your projects by using cobolget, an open-source command-line tool. You can transparently integrate packages from GitHub, GitLab or Gitee repositories, written in gnucobol, entcobol or netcobol COBOL dialects. As well as public packages, the Registry lets you import your own private packages making COBOL code shared within your Organization only. You can manage Teams and Team Tokens granting per-team installation rights for a limited period of time.

In contrast to other Package Managers, COBOLget only analyzes Manifest files in JSON format and does not clone nor crawl the source-code. Package installation will fail if the maintainer decides restrict access to the repository or revoke the Team Token. COBOLget protects packages from a malicious take-over. Organizations, packages and origins are enforced by the Registry reserving distinct names for the maintainer upon the first indexing, forever. Disadvantage of this security policy is an inability to have mirrors of the repositories and migrate the packages between them.

Using Packages

To start using cobolget in your project you need the Manifest file which describes the project and its dependencies.

$ npm install -g cobolget
$ cobolget init
Manifest modules.json created.

Now you can add a dependency which delivers additional functionality:

$ cobolget add core-datetime
Dependency 'core-datetime' has been added to the manifest.
$ cobolget add main-string
Dependency 'main-string' has been added to the manifest.
$ cobolget add fuji-bitwise
Dependency 'fuji-bitwise' has been added to the manifest.

By default, cobolget takes the latest (highest) version available in the Registry and adds it into modules.json.

$ cobolget update
Lockfile modules-lock.json updated.

The tool resolves direct and inherited dependencies in the Manifest and creates the Lockfile which contains exact versions of the packages. Keeping modules-lock.json under a version control is important to re-install the same dependencies in other environments, e.g. Continuous Integration.

Let's install the dependencies:

$ cobolget install
Downloading core-datetime 3.0.6
modules/core-datetime
modules/core-datetime/.gitignore
modules/core-datetime/.gitlab-ci.yml
modules/core-datetime/Dockerfile
modules/core-datetime/LICENSE
modules/core-datetime/README.md
modules/core-datetime/modules.json
modules/core-datetime/src/
modules/core-datetime/src/datetime.cbl
modules/core-datetime/tests/
modules/core-datetime/tests/datetime-test.cbl
modules/core-datetime/tests/modules.cpy
Modules modules.cpy and modules.cbl updated.

Directory modules contains source-code of the package and modules.cpy ready for inclusion into your project.

$ cobolget install
Downloading main-string 6.2.3
modules/main-string
modules/main-string/.github/
modules/main-string/.github/workflows/
modules/main-string/.github/workflows/nodejs.yml
modules/main-string/.gitignore
modules/main-string/LICENSE
modules/main-string/README.md
modules/main-string/modules.json
modules/main-string/src/
modules/main-string/src/string.cbl
modules/main-string/tests/
modules/main-string/tests/tests.cbl
modules/main-string/tests/tests.jcl
Modules modules.cpy and modules.cbl updated.

Directory modules contains source-code of the package and modules.cbl ready for compilation and linking with your project.

$ cobolget install
Downloading fuji-bitwise 3.2.1
modules/fuji-bitwise
modules/fuji-bitwise/.gitignore
modules/fuji-bitwise/LICENSE
modules/fuji-bitwise/README.md
modules/fuji-bitwise/modules.json
modules/fuji-bitwise/src/
modules/fuji-bitwise/src/bitwise.cbl
Modules modules.cpy and modules.cbl updated.

Directory modules contains source-code of the package and modules.cbl ready for compilation and linking with your project.

For installing a private package you need the Team Token from your Organization:

$ cobolget add core-network
$ cobolget update
$ cobolget -t bca12d6c4efed0627c87f2e576b72bdb5ab88e34 install
$ cobolget add main-bitwise
$ cobolget update
$ cobolget -t bca12d6c4efed0627c87f2e576b72bdb5ab88e34 install

Publishing Packages

To start using cobolget in your library you need the Manifest file which describes the library and its dependencies.

$ npm install -g cobolget
$ cobolget init

Open modules.json in text editor, fix default values and validate the Manifest:

$ cobolget validate

Make sure, that in your Manifest

  • all dependencies are valid COBOLget packages;
  • all dependencies-debug are valid COBOLget packages;
  • all modules are COBOL modules (programs and functions) in desired dialect, without termination statements e.g. STOP RUN.

Commit and push modules.json to your repository. After release, you can import the package into the Registry by a link:

$ cobolget index https://gitlab.com/OlegKunitsyn/core-datetime
$ cobolget index https://github.com/OlegKunitsyn/main-string
$ cobolget index https://github.com/OlegKunitsyn/fuji-bitwise

New releases of the package you can index by a name:

$ cobolget index core-datetime
$ cobolget index main-string
$ cobolget index fuji-bitwise

For indexing private packages you must submit Repository Token to associate a package with the Organization. Follow GitLab, GitHub or Gitee instructions. In the example below Organization is cobolget, but use your own.

$ cobolget -t DMNZpM9LzMyvswqE6yzz -o cobolget index https://gitlab.com/OlegKunitsyn/core-network
$ cobolget -t DMNZpM9LzMyvswqE6yzz -o cobolget index https://gitlab.com/OlegKunitsyn/main-bitwise

Versioning

COBOLget implements SemVer versioning standard. You can specify constraints in the Manifest to satisfy concrete versions of the dependencies.

| Operator | Constraint | Example | |----------|------------------------|--------------------------| | * | Any (default) | "core-string": "*" | | < | Less than | "core-string": "<1.0.2" | | <= | Less or equal to | "core-string": "<=1.0.2" | | > | Greater than | "core-string": ">1.0.2" | | >= | Greater or equal to | "core-string": ">=1.0.2" | | = | Equal | "core-string": "=1.0.2" | | x | Stand in | "core-string": "1.0.x" | | ~ | Approximately equal to | "core-string": "~1.0.1" |

Scripting

You can specify a command within scripts property and run it

$ cobolget run <script>

or specify a script that runs several commands at once

{
  ...
  "scripts": {
    "cobolget": "cobolget update && cobolget install"
  }  
}

or specify nested automation scenarios grouping scripts by a name:

{
  ...
  "scripts": {
    "build:docs": "coboldoc generate src/* -o docs",
    "build:package:update": "cobolget update",
    "build:package:install": "cobolget install",
    "build:upload": "zowe zos-files upload file-to-data-set modules/modules.cbl <USER ID>.CBL",
    "tests:upload": "zowe zos-files upload file-to-data-set tests/tests.cbl <USER ID>.CBL",
    "tests:run": "zowe jobs submit local-file tests/tests.jcl --view-all-spool-content"
  }
}

Delimiter can be any. In this example argument build:package will match two scripts, and next example will execute all build scripts one by one:

$ cobolget run b

The batch of commands stops upon the first failure (non-zero exit code).

Development

Roadmap

  • Inline copybooks in modules.cbl.

Your contribution is always welcome!