Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/workflows/spectral.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ jobs:
- uses: bfabio/spectral-action@5af95a6a2985901bd5e689c663b4f93c660f0d2c
id: lint
with:
file_glob: software-catalog-api.oas.yaml
file_glob: open-catalog-api.oas.yaml
spectral_ruleset: .spectral.yml
repo_token: ${{ secrets.GITHUB_TOKEN }}

Expand Down
14 changes: 7 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,17 +1,17 @@
<!-- markdownlint-disable no-inline-html -->

<h1 align="center">Software Catalog API</h1>
<h1 align="center">Open Catalog API</h1>

<p align="center">
<img width="200" src=".github/logo.png" alt="software-catalog-api logo">
<img width="200" src=".github/logo.png" alt="open-catalog-api logo">
</p>

<p align="center">
<a href="https://www.bestpractices.dev/projects/14158">
<img src="https://www.bestpractices.dev/projects/14158/badge">
</a>

<img alt="License" src="https://img.shields.io/github/license/italia/developers-italia-api?color=brightgreen">
<img alt="License" src="https://img.shields.io/github/license/italia/open-catalog-api?color=brightgreen">
</p>

<div align="center">
Expand All @@ -23,7 +23,7 @@
</div>

<p align="center">
<strong>Software Catalog API</strong> is a RESTful API for public software catalogs.
<strong>Open Catalog API</strong> is a RESTful API for public software catalogs.
It powers national open source catalogs for public administrations:
</p>

Expand Down Expand Up @@ -64,7 +64,7 @@ You can configure the API with environment variables:
and a token with the built-in subcommand:

```console
developers-italia-api token create
open-catalog-api token create
```

Pass `--key` to use an existing key, `--sub` to identify the caller,
Expand All @@ -85,9 +85,9 @@ You can configure the API with environment variables:
This project exists also thanks to your contributions! Here is a list of people
who already contributed to this repository:

<a href="https://github.com/italia/developers-italia-api/graphs/contributors">
<a href="https://github.com/italia/open-catalog-api/graphs/contributors">
<img
src="https://contributors-img.web.app/image?repo=italia/developers-italia-api"
src="https://contributors-img.web.app/image?repo=italia/open-catalog-api"
/>
</a>

Expand Down
2 changes: 1 addition & 1 deletion SECURITY.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ patched, so upgrade to the latest tag before reporting a problem.
## Reporting a vulnerability

Report security vulnerabilities via [GitHub private vulnerability
reporting](https://github.com/italia/developers-italia-api/security/advisories/new).
reporting](https://github.com/italia/open-catalog-api/security/advisories/new).
The report stays private between you and the maintainers until a fix is
released.

Expand Down
4 changes: 2 additions & 2 deletions software-catalog-api.oas.yaml → open-catalog-api.oas.yaml
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
openapi: 3.0.0
info:
title: Software Catalog API
title: Open Catalog API
version: 1.0.0
x-summary: Software Catalog API
x-summary: Open Catalog API
description: |
REST API for public software catalogs.

Expand Down Expand Up @@ -736,7 +736,7 @@
in: query
name: to
description: Only logs before this time (RFC 3339 datetime)
- schema:

Check notice on line 739 in open-catalog-api.oas.yaml

View workflow job for this annotation

GitHub Actions / Lint (pull_request)

sec-string-pattern-or-format-or-enum

Strings (non enum) must specify a pattern or a format. #/paths/~1logs/get/parameters/5/schema
type: string
maxLength: 255
example: 'BAD publiccode'
Expand Down Expand Up @@ -2012,7 +2012,7 @@
schema:
$ref: '#/components/schemas/Error'
schemas:
AnalysisData:

Check warning on line 2015 in open-catalog-api.oas.yaml

View workflow job for this annotation

GitHub Actions / Lint (pull_request)

sec-constrained-additionalProperties

Objects should not allow unconstrained additionalProperties. Disable them with `additionalProperties: false` or add `maxProperties`.
title: AnalysisData
type: object
nullable: true
Expand All @@ -2039,7 +2039,7 @@
readOnly: true
description: Timestamp of the last write (RFC 3339 datetime).
example: '2024-01-15T10:30:00Z'
additionalProperties: true

Check warning on line 2042 in open-catalog-api.oas.yaml

View workflow job for this annotation

GitHub Actions / Lint (pull_request)

sec-no-additionalProperties

Objects should not allow unconstrained additionalProperties. Disable them with `additionalProperties: false` or add `maxProperties`.
example:
acme-security-scanner:
v: 1
Expand Down Expand Up @@ -2083,7 +2083,7 @@
- remove
- replace
- test
path:

Check notice on line 2086 in open-catalog-api.oas.yaml

View workflow job for this annotation

GitHub Actions / Lint (pull_request)

sec-string-pattern-or-format-or-enum

Strings (non enum) must specify a pattern or a format. #/components/schemas/JsonPatchRequest/items/properties/path
type: string
maxLength: 255
description: >
Expand All @@ -2094,7 +2094,7 @@
value:
description: The value to set. Required for add, replace, and test operations.
example: 'name: My Software'
from:

Check notice on line 2097 in open-catalog-api.oas.yaml

View workflow job for this annotation

GitHub Actions / Lint (pull_request)

sec-string-pattern-or-format-or-enum

Strings (non enum) must specify a pattern or a format. #/components/schemas/JsonPatchRequest/items/properties/from
type: string
maxLength: 255
description: Source JSON Pointer, used by move and copy operations.
Expand Down Expand Up @@ -2202,13 +2202,13 @@
description: Unique identifier of the Catalog
example: 'a1b2c3d4-e5f6-4789-abcd-ef0123456789'
readOnly: true
name:

Check notice on line 2205 in open-catalog-api.oas.yaml

View workflow job for this annotation

GitHub Actions / Lint (pull_request)

sec-string-pattern-or-format-or-enum

Strings (non enum) must specify a pattern or a format. #/components/schemas/Catalog/properties/name
type: string

Check notice on line 2206 in open-catalog-api.oas.yaml

View workflow job for this annotation

GitHub Actions / Lint (pull_request)

use-recommended-names-in-schemas

Use recommended variable names in string.
minLength: 1

Check notice on line 2207 in open-catalog-api.oas.yaml

View workflow job for this annotation

GitHub Actions / Lint (pull_request)

use-recommended-names-in-schemas

Use recommended variable names in 1.
maxLength: 255

Check notice on line 2208 in open-catalog-api.oas.yaml

View workflow job for this annotation

GitHub Actions / Lint (pull_request)

use-recommended-names-in-schemas

Use recommended variable names in 255.
description: Human-readable name of the catalog

Check notice on line 2209 in open-catalog-api.oas.yaml

View workflow job for this annotation

GitHub Actions / Lint (pull_request)

use-recommended-names-in-schemas

Use recommended variable names in Human-readable name of the catalog.
example: 'Public Software Catalog'

Check notice on line 2210 in open-catalog-api.oas.yaml

View workflow job for this annotation

GitHub Actions / Lint (pull_request)

use-recommended-names-in-schemas

Use recommended variable names in Public Software Catalog.
alternativeId:

Check notice on line 2211 in open-catalog-api.oas.yaml

View workflow job for this annotation

GitHub Actions / Lint (pull_request)

sec-string-pattern-or-format-or-enum

Strings (non enum) must specify a pattern or a format. #/components/schemas/Catalog/properties/alternativeId
type: string
description: >
Optional alternative user-provided identifier for this Catalog.
Expand All @@ -2225,7 +2225,7 @@
description: Whether this Catalog is active or not
default: true
example: true
publishersNamespace:

Check notice on line 2228 in open-catalog-api.oas.yaml

View workflow job for this annotation

GitHub Actions / Lint (pull_request)

sec-string-pattern-or-format-or-enum

Strings (non enum) must specify a pattern or a format. #/components/schemas/Catalog/properties/publishersNamespace
type: string
maxLength: 255
description: >
Expand All @@ -2234,7 +2234,7 @@
each publiccode.yml organisation field equals
this prefix + the publisher alternativeId.
example: 'urn:x-italian-pa:'
scopes:

Check warning on line 2237 in open-catalog-api.oas.yaml

View workflow job for this annotation

GitHub Actions / Lint (pull_request)

sec-array-boundaries

Schema of type array must specify maxItems and minItems. #/components/schemas/Catalog/properties/scopes "scopes.minItems" property must be defined
type: array
maxItems: 20
description: >
Expand All @@ -2247,7 +2247,7 @@
string up to 64 characters is accepted. An empty or
absent list means the catalog is thematic and not tied
to a specific place.
items:

Check notice on line 2250 in open-catalog-api.oas.yaml

View workflow job for this annotation

GitHub Actions / Lint (pull_request)

sec-string-pattern-or-format-or-enum

Strings (non enum) must specify a pattern or a format. #/components/schemas/Catalog/properties/scopes/items
type: string
minLength: 1
maxLength: 64
Expand All @@ -2255,7 +2255,7 @@
example:
- 'iso3166:IT'
- 'm49:150'
sources:

Check warning on line 2258 in open-catalog-api.oas.yaml

View workflow job for this annotation

GitHub Actions / Lint (pull_request)

sec-array-boundaries

Schema of type array must specify maxItems and minItems. #/components/schemas/Catalog/properties/sources "sources.minItems" property must be defined
type: array
maxItems: 100
description: >
Expand Down Expand Up @@ -2290,7 +2290,7 @@
type: object
additionalProperties: false
properties:
driver:

Check notice on line 2293 in open-catalog-api.oas.yaml

View workflow job for this annotation

GitHub Actions / Lint (pull_request)

sec-string-pattern-or-format-or-enum

Strings (non enum) must specify a pattern or a format. #/components/schemas/CatalogSource/properties/driver
type: string
maxLength: 64
description: >
Expand All @@ -2310,7 +2310,7 @@
Optional arguments for the driver (e.g. a JSON
configuration file URL).
example: ['https://example.org/config.json']
items:

Check notice on line 2313 in open-catalog-api.oas.yaml

View workflow job for this annotation

GitHub Actions / Lint (pull_request)

sec-string-pattern-or-format-or-enum

Strings (non enum) must specify a pattern or a format. #/components/schemas/CatalogSource/properties/args/items
type: string
minLength: 1
maxLength: 2048
Expand Down Expand Up @@ -2627,7 +2627,7 @@
maxLength: 255
example: 'https://example.org/my-webhook-endpoint'
description: URL where the webhook payload will be delivered to
secret:

Check notice on line 2630 in open-catalog-api.oas.yaml

View workflow job for this annotation

GitHub Actions / Lint (pull_request)

sec-string-pattern-or-format-or-enum

Strings (non enum) must specify a pattern or a format. #/components/schemas/Webhook/properties/secret
type: string
minLength: 16
maxLength: 256
Expand Down
6 changes: 3 additions & 3 deletions publiccode.yml
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ description:
- Containerization support
- Helm chart available
longDescription: |
**software-catalog-api** is a RESTful API for public software catalogs.
**open-catalog-api** is a RESTful API for public software catalogs.
It powers developers.italia.it and can be deployed as a standalone
instance for any public software catalog.
shortDescription: |-
Expand Down Expand Up @@ -46,7 +46,7 @@ maintenance:
contacts:
- name: Fabio Bonelli
type: community
name: software-catalog-api
name: open-catalog-api
platforms:
- web
dependsOn:
Expand All @@ -55,4 +55,4 @@ dependsOn:
optional: true
softwareType: standalone/backend
softwareVersion: v1.0.0
url: "https://github.com/italia/developers-italia-api"
url: "https://github.com/italia/open-catalog-api"

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🚫 reported by reviewdog 🐶
url: 'https://github.com/italia/open-catalog-api' not reachable: HTTP GET failed for https://github.com/italia/open-catalog-api: not found

Loading