help.c.nf / Paquets

Registre de paquets

p.c.nf est le registre de paquets de CNF — un espace de noms inspiré de GitHub pour publier des paquets versionnés. Chaque artefact possède une URL stable, un compteur de téléchargements et des contrôles d’accès.

Sommaire

Vue d’ensemble

p.c.nf héberge les paquets dans un espace de noms <username>/<project>. Chaque projet comporte une ou plusieurs versions, et chaque version peut proposer un ou plusieurs artefacts téléchargeables.

Le principe ressemble à @scope/package de npm ou à user/repo de GitHub, mais pour des artefacts binaires plutôt que du code source.

Structure de l’URL

p.c.nf/ Catalogue — parcourir tous les paquets publics
p.c.nf/<user> Profil utilisateur — répertorier ses paquets
p.c.nf/<user>/<pkg> Page du projet — dernière version et historique
p.c.nf/<user>/<pkg>/<version> Page d’une version — artefacts et journal des modifications
p.c.nf/<user>/<pkg>/download Télécharger le dernier artefact
p.c.nf/<user>/<pkg>/<version>/download Télécharger une version spécifique (permanente)
p.c.nf/<user>/<pkg>/<version>/<label> Télécharger un artefact étiqueté (par exemple, une variante de plateforme)

Téléchargement

Télécharger un paquet avec curl ou wget:

# Dernière version curl -LO https://p.c.nf/c/cred-extension/download # Version épinglée curl -LO https://p.c.nf/c/cred-extension/2.0.1/download

Les téléchargements prennent en charge les requêtes HTTP Range pour la reprise, ainsi que les requêtes GET conditionnelles qui renvoient 304 Not Modified.

Limite de fréquence : 30 téléchargements par adresse IP et par minute. Un en-tête 429 Retry-After est renvoyé lorsque cette limite est dépassée.

Publication

Publiez une nouvelle version depuis la console ou l’API HTTP. Les deux méthodes créent le projet lors de sa première publication.

Avec l’API

curl -X POST https://p.c.nf/api/publish \ -H "Authorization: Bearer cnf_..." \ -F "slug=my-tool" \ -F "version=1.0.0" \ -F "file=@dist/my-tool.zip" \ -F "description=Short one-line summary" \ -F "category=Client tools" ✓ Publié you/my-tool@1.0.0

Champs obligatoires :

  • slug — lettres minuscules et traits d’union uniquement (128 caractères au maximum)
  • version — chaîne libre ; la gestion sémantique des versions est recommandée
  • file — artefact à téléverser

Champs facultatifs : description, category, icon, visibility, changelog et label pour les versions comportant plusieurs artefacts.

Depuis la console

Connectez-vous à console.c.nf, puis ouvrez l’administration des téléchargements. La console gère le téléversement des fichiers, les métadonnées et les mises à jour de version.

Remarque : la publication nécessite un utilisateur CNF authentifié. Chaque utilisateur publie dans son propre espace de noms /<username>/. Vous ne pouvez pas publier sous le nom d’un autre utilisateur.

Authentification

Deux méthodes d’authentification sont prises en charge :

Clé d’API (recommandée pour l’automatisation)

Générez une clé sur console.c.nf/account/api, puis envoyez-la comme jeton Bearer :

Authorization: Bearer cnf_a1b2c3d4e5f6...

Les clés ne sont affichées qu’une fois lors de leur création. Vous pouvez conserver jusqu’à 10 clés actives et les révoquer à tout moment.

Cookie de session

Lorsque vous naviguez depuis console.c.nf ou id.c.nf, votre cookie de session vous authentifie automatiquement. Ce mécanisme est utile pour l’extension de navigateur et la console.

Visibilité

public Répertorié dans le catalogue ; tout le monde peut le télécharger.
unlisted Masqué du catalogue ; toute personne disposant de l’URL peut le télécharger.
private Seuls le propriétaire et les administrateurs peuvent le voir ou le télécharger.

Versions

Chaque version publiée est conservée à une URL stable. Les anciennes versions restent disponibles après les nouvelles publications : les consommateurs épinglés sur /1.0.0/download continuent donc de recevoir exactement cette compilation.

Le point de terminaison non versionné /download sert toujours la dernière version.

Les chaînes de version sont du texte libre. La gestion sémantique des versions (MAJOR.MINOR.PATCH) est recommandée pour plus de clarté, mais n’est pas imposée.

FAQ

Quelle est la différence entre p.c.nf et d.c.nf?

p.c.nf est un registre de paquets versionnés doté d’un espace de noms par utilisateur (user/project). d.c.nf est un catalogue simple de téléchargements sélectionnés et gérés par les administrateurs de CNF.

Puis-je supprimer une version ?

Oui, depuis la console. La suppression d’une version rend inopérantes les URL épinglées que des consommateurs peuvent avoir enregistrées ; il est donc généralement préférable de publier une nouvelle version.

Existe-t-il une limite de taille ?

Les limites d’artefact dépendent du niveau d’autorisation de l’utilisateur : 50 Mo par niveau d’UPL, jusqu’à environ 500 Mo. Les fichiers plus volumineux peuvent être téléversés par segments depuis la console.

Comment authentifier l’extension?

L’extension CNF Cred prend en charge les cookies de session lorsque vous êtes connecté à console.c.nf, ainsi que les clés d’API. Configurez la méthode dans les paramètres de l’extension.