https://github.com/italia/publiccode-parser-orb

CircleCI Orb for publiccode.yml validation
https://github.com/italia/publiccode-parser-orb

circleci-orb orb publiccode publiccode-parser

Last synced: about 1 month ago
JSON representation

CircleCI Orb for publiccode.yml validation

• Host: GitHub
• URL: https://github.com/italia/publiccode-parser-orb
• Owner: italia
• License: mit
• Created: 2020-10-04T16:54:00.000Z (about 4 years ago)
• Default Branch: master
• Last Pushed: 2021-02-22T08:52:31.000Z (almost 4 years ago)
• Last Synced: 2024-08-03T02:05:13.779Z (5 months ago)
• Topics: circleci-orb, orb, publiccode, publiccode-parser
• Language: Shell
• Homepage: https://circleci.com/developer/orbs/orb/italia/publiccode-parser
• Size: 38.1 KB
• Stars: 3
• Watchers: 7
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• .github - publiccode-parser-orb

README

        
# CircleCI Orb for publiccode.yml validation

[![CircleCI](https://img.shields.io/circleci/build/github/italia/publiccode-parser-orb)](https://circleci.com/gh/italia/publiccode-parser)

[![CircleCI Orb Version](https://img.shields.io/badge/endpoint.svg?url=https://badges.circleci.io/orb/italia/publiccode-parser)](https://circleci.com/orbs/registry/orb/italia/publiccode-parser)

[![GitHub License](https://img.shields.io/badge/license-MIT-lightgrey.svg)](https://github.com/italia/publiccode-parser-orb/blob/master/LICENSE)

## Usage

This orb validates [`publiccode.yml`](https://github.com/italia/publiccode.yml) files

using [publiccode-parser-go](https://github.com/italia/publiccode-parser-go)

You can use it in your workflow to check if `publiccode.yml` in your repo is valid.

Example:

```yml

orbs:

    publiccode-parser: italia/[email protected]

workflows:

  test_my_app:

    jobs:

      - publiccode-parser/validate

```

see the [orb registry listing](https://circleci.com/orbs/registry/orb/italia/publiccode-parser)

for the full documentation and examples.

## How to release (for developers of this orb)

1. Create a feature branch and work on changes

1. Check for errors with `circleci config validate`

1. Put `[semver:patch]` in your commit subject to automatically bump the orb

   version (or `[semver:minor]` or `[semver:major]`)

1. Push the feature branch to **`italia/publiccode-parser-orb`**, not your own fork.

1. Open a PR, the build scripts will start

1. If the build errors out with

   `"Cannot find italia/publiccode-parser@dev:alpha in the orb registry"`.

    1. ```shell

       circleci orb pack src > file.yml

       circleci orb validate file.yml

       circleci orb publish file.yml italia/publiccode-parser@dev:alpha

       ```

    1. Rerun the build

1. Approve the `hold-for-dev-publish` job in CircleCI

1. The `publish-dev` job will publish a new development orb (`italia/publiccode-parser@dev:alpha`)

1. If the `integration-dev` workflow passes, get review and merge to master

1. Approve `hold-for-dev-publish` again when the pipeline on master runs

1. Check the new version is published and create a new PR bumping the version

   in the README as well