Téléchargement github metadata - Téléchargement du code source github metadata

github-metadata

Rassemblez les métadonnées GitHub sur un référentiel.

Installer

Installer avec NPM:

$ npm install --save github-metadata

Installer avec du fil:

$ yarn add github-metadata

Usage

 var metadata = require ( 'github-metadata' ) ;

API

métadonnées

Rassemblez les métadonnées GitHub pour le référentiel spécifié. Cela tente d'obtenir les mêmes métadonnées qui sont utilisées par Jekyll et spécifiées dans les documents GitHub. Certaines métadonnées nécessitent une authentification, ce qui nécessite de passer un username et password ou token sur l'objet options . Il est préférable d'utiliser un jeton d'accès personnel depuis GitHub. Voir la section des résultats pour voir à quoi ressemble l'objet de métadonnées retourné

Paramètres

options {Object} : Options Object Contenant les détails de l'authentification et du référentiel.
options.owner {String} : l'utilisateur ou l'organisation propriétaire du référentiel. Il s'agit du premier segment de chemin après "https://github.com/".
options.repo {String} : le nom du référentiel pour obtenir des métadonnées pour. Il s'agit du deuxième segment de chemin après "https://github.com/".
options.exclude {array} : éventuellement passer une liste des propriétés de niveau supérieur à exclure des métadonnées en ne le téléchargeant pas à partir de github.
options.username {String} : Fournit éventuellement un nom d'utilisateur GitHub pour l'authentification. Ceci n'est nécessaire que lorsque vous utilisez username/password pour l'authentification.
options.password {String} : Fournit éventuellement un mot de passe GitHub pour l'authentification. Ceci n'est nécessaire que lorsque vous utilisez username/password pour l'authentification.
options.token {String} : Fournit éventuellement un jeton d'accès personnel GitHub pour l'authentification. Ceci est nécessaire avec l'utilisation d'OAuth (au lieu username/password ) pour l'authentification.
returns {Promise} : Renvoie une promesse qui aura les métadonnées des référentiels lorsqu'elle est résolue.

Exemple

 var options = {
  token : 'XXXXXXXXXX' // get this from GitHub,
  owner : 'doowb' ,
  repo : 'github-metadata'
} ;

metadata ( options )
  . then ( function ( data ) {
    console . log ( data ) ;
    //=> {
    //=>   // this object contains all of the metadata that was gather from GitHub
    //=> }
  } )
  . catch ( console . error ) ;

Résultats

L'objet suivant représente les métadonnées GitHub qui sont renvoyées pour le référentiel Assemble / assemble. Les éléments des propriétés contenant de longs matrices ont été supprimés et remplacés par ... Voir l'objet JSON complet et la documentation de l'API GitHub pour plus d'informations sur les éléments de ces tableaux.

 {
  "public_repositories" : [
    ...
  ] ,
  "organization_members" : [
    ...
  ] ,
  "contributors" : [
    ...
  ] ,
  "collaborators" : [
    ...
  ] ,
  "branches" : [
    ...
  ] ,
  "languages" : {
    "CSS" : 483616 ,
    "JavaScript" : 102873 ,
    "HTML" : 44790
  } ,
  "teams" : [
    ...
  ] ,
  "releases" : [
    ...
  ] ,
  "tags" : [
    ...
  ] ,
  "repository" : {
    "id" : 5916767 ,
    "name" : "assemble" ,
    "full_name" : "assemble/assemble" ,
    "owner" : {
      "login" : "assemble" ,
      "id" : 2645080 ,
      "avatar_url" : "https://avatars3.githubusercontent.com/u/2645080?v=3" ,
      "gravatar_id" : "" ,
      "url" : "https://api.github.com/users/assemble" ,
      "html_url" : "https://github.com/assemble" ,
      "followers_url" : "https://api.github.com/users/assemble/followers" ,
      "following_url" : "https://api.github.com/users/assemble/following{/other_user}" ,
      "gists_url" : "https://api.github.com/users/assemble/gists{/gist_id}" ,
      "starred_url" : "https://api.github.com/users/assemble/starred{/owner}{/repo}" ,
      "subscriptions_url" : "https://api.github.com/users/assemble/subscriptions" ,
      "organizations_url" : "https://api.github.com/users/assemble/orgs" ,
      "repos_url" : "https://api.github.com/users/assemble/repos" ,
      "events_url" : "https://api.github.com/users/assemble/events{/privacy}" ,
      "received_events_url" : "https://api.github.com/users/assemble/received_events" ,
      "type" : "Organization" ,
      "site_admin" : false
    } ,
    "private" : false ,
    "html_url" : "https://github.com/assemble/assemble" ,
    "description" : "Static site generator and rapid prototyping framework for Node.js, Grunt.js, and Yeoman and Gulp. Render templates with Handlebars, Lo-Dash or any template engine. Used by Less.js / lesscss.org, Topcoat, Web Experience Toolkit, and hundreds of other projects to build sites, themes, components, documentation, blogs and gh-pages." ,
    "fork" : false ,
    "url" : "https://api.github.com/repos/assemble/assemble" ,
    "forks_url" : "https://api.github.com/repos/assemble/assemble/forks" ,
    "keys_url" : "https://api.github.com/repos/assemble/assemble/keys{/key_id}" ,
    "collaborators_url" : "https://api.github.com/repos/assemble/assemble/collaborators{/collaborator}" ,
    "teams_url" : "https://api.github.com/repos/assemble/assemble/teams" ,
    "hooks_url" : "https://api.github.com/repos/assemble/assemble/hooks" ,
    "issue_events_url" : "https://api.github.com/repos/assemble/assemble/issues/events{/number}" ,
    "events_url" : "https://api.github.com/repos/assemble/assemble/events" ,
    "assignees_url" : "https://api.github.com/repos/assemble/assemble/assignees{/user}" ,
    "branches_url" : "https://api.github.com/repos/assemble/assemble/branches{/branch}" ,
    "tags_url" : "https://api.github.com/repos/assemble/assemble/tags" ,
    "blobs_url" : "https://api.github.com/repos/assemble/assemble/git/blobs{/sha}" ,
    "git_tags_url" : "https://api.github.com/repos/assemble/assemble/git/tags{/sha}" ,
    "git_refs_url" : "https://api.github.com/repos/assemble/assemble/git/refs{/sha}" ,
    "trees_url" : "https://api.github.com/repos/assemble/assemble/git/trees{/sha}" ,
    "statuses_url" : "https://api.github.com/repos/assemble/assemble/statuses/{sha}" ,
    "languages_url" : "https://api.github.com/repos/assemble/assemble/languages" ,
    "stargazers_url" : "https://api.github.com/repos/assemble/assemble/stargazers" ,
    "contributors_url" : "https://api.github.com/repos/assemble/assemble/contributors" ,
    "subscribers_url" : "https://api.github.com/repos/assemble/assemble/subscribers" ,
    "subscription_url" : "https://api.github.com/repos/assemble/assemble/subscription" ,
    "commits_url" : "https://api.github.com/repos/assemble/assemble/commits{/sha}" ,
    "git_commits_url" : "https://api.github.com/repos/assemble/assemble/git/commits{/sha}" ,
    "comments_url" : "https://api.github.com/repos/assemble/assemble/comments{/number}" ,
    "issue_comment_url" : "https://api.github.com/repos/assemble/assemble/issues/comments{/number}" ,
    "contents_url" : "https://api.github.com/repos/assemble/assemble/contents/{+path}" ,
    "compare_url" : "https://api.github.com/repos/assemble/assemble/compare/{base}...{head}" ,
    "merges_url" : "https://api.github.com/repos/assemble/assemble/merges" ,
    "archive_url" : "https://api.github.com/repos/assemble/assemble/{archive_format}{/ref}" ,
    "downloads_url" : "https://api.github.com/repos/assemble/assemble/downloads" ,
    "issues_url" : "https://api.github.com/repos/assemble/assemble/issues{/number}" ,
    "pulls_url" : "https://api.github.com/repos/assemble/assemble/pulls{/number}" ,
    "milestones_url" : "https://api.github.com/repos/assemble/assemble/milestones{/number}" ,
    "notifications_url" : "https://api.github.com/repos/assemble/assemble/notifications{?since,all,participating}" ,
    "labels_url" : "https://api.github.com/repos/assemble/assemble/labels{/name}" ,
    "releases_url" : "https://api.github.com/repos/assemble/assemble/releases{/id}" ,
    "deployments_url" : "https://api.github.com/repos/assemble/assemble/deployments" ,
    "created_at" : "2012-09-22T20:50:23Z" ,
    "updated_at" : "2017-06-15T01:09:31Z" ,
    "pushed_at" : "2017-05-20T00:33:33Z" ,
    "git_url" : "git://github.com/assemble/assemble.git" ,
    "ssh_url" : "[email protected]:assemble/assemble.git" ,
    "clone_url" : "https://github.com/assemble/assemble.git" ,
    "svn_url" : "https://github.com/assemble/assemble" ,
    "homepage" : "http://assemble.io/" ,
    "size" : 13050 ,
    "stargazers_count" : 3350 ,
    "watchers_count" : 3350 ,
    "language" : "CSS" ,
    "has_issues" : true ,
    "has_projects" : true ,
    "has_downloads" : true ,
    "has_wiki" : true ,
    "has_pages" : false ,
    "forks_count" : 225 ,
    "mirror_url" : null ,
    "open_issues_count" : 26 ,
    "forks" : 225 ,
    "open_issues" : 26 ,
    "watchers" : 3350 ,
    "default_branch" : "master" ,
    "permissions" : {
      "admin" : true ,
      "push" : true ,
      "pull" : true
    } ,
    "allow_squash_merge" : true ,
    "allow_merge_commit" : true ,
    "allow_rebase_merge" : true ,
    "organization" : {
      "login" : "assemble" ,
      "id" : 2645080 ,
      "avatar_url" : "https://avatars3.githubusercontent.com/u/2645080?v=3" ,
      "gravatar_id" : "" ,
      "url" : "https://api.github.com/users/assemble" ,
      "html_url" : "https://github.com/assemble" ,
      "followers_url" : "https://api.github.com/users/assemble/followers" ,
      "following_url" : "https://api.github.com/users/assemble/following{/other_user}" ,
      "gists_url" : "https://api.github.com/users/assemble/gists{/gist_id}" ,
      "starred_url" : "https://api.github.com/users/assemble/starred{/owner}{/repo}" ,
      "subscriptions_url" : "https://api.github.com/users/assemble/subscriptions" ,
      "organizations_url" : "https://api.github.com/users/assemble/orgs" ,
      "repos_url" : "https://api.github.com/users/assemble/repos" ,
      "events_url" : "https://api.github.com/users/assemble/events{/privacy}" ,
      "received_events_url" : "https://api.github.com/users/assemble/received_events" ,
      "type" : "Organization" ,
      "site_admin" : false
    } ,
    "network_count" : 225 ,
    "subscribers_count" : 121
  } ,
  "pages_info" : {
    "message" : "Not Found" ,
    "documentation_url" : "https://developer.github.com/v3"
  } ,
  "pages" : {
    "env" : "development" ,
    "test" : false ,
    "dotcom" : false ,
    "enterprise" : false ,
    "development" : true ,
    "ssl" : false ,
    "schema" : "http" ,
    "custom_domains_enabled" : false ,
    "github_hostname" : "github.com" ,
    "pages_hostname" : "localhost:4000" ,
    "github_url" : "http://github.com" ,
    "api_url" : "https://api.github.com" ,
    "help_url" : "https://help.github.com"
  } ,
  "hostname" : "github.com" ,
  "pages_hostname" : "localhost:4000" ,
  "api_url" : "https://api.github.com" ,
  "help_url" : "https://help.github.com" ,
  "environment" : "development" ,
  "pages_env" : "development" ,
  "url" : "https://github.com/assemble/assemble" ,
  "project_title" : "assemble" ,
  "repository_name" : "assemble" ,
  "repository_nwo" : "assemble/assemble" ,
  "project_tagline" : "Static site generator and rapid prototyping framework for Node.js, Grunt.js, and Yeoman and Gulp. Render templates with Handlebars, Lo-Dash or any template engine. Used by Less.js / lesscss.org, Topcoat, Web Experience Toolkit, and hundreds of other projects to build sites, themes, components, documentation, blogs and gh-pages." ,
  "owner_name" : "assemble" ,
  "owner_gravatar_url" : "http://github.com/assemble.png}" ,
  "repository_url" : "https://github.com/assemble/assemble" ,
  "language" : "CSS" ,
  "show_downloads" : true ,
  "owner_url" : "http://github.com/assemble" ,
  "zip_url" : "http://github.com/assemble/assemble/zipball/gh_pages" ,
  "tar_url" : "http://github.com/assemble/assemble/tarball/gh_pages" ,
  "clone_url" : "http://github.com/assemble/assemble.git" ,
  "releases_url" : "http://github.com/assemble/assemble/releases" ,
  "issues_url" : "http://github.com/assemble/assemble/issues" ,
  "wiki_url" : "http://github.com/assemble/assemble/wiki" ,
  "is_user_page" : false ,
  "is_project_page" : true
}

À propos

Projets connexes

Assemblez: Sortez les rochers de vos chaussettes! Assembler vous fait vite pour créer des projets Web… plus | page d'accueil
GitHub-base: wrapper javascript qui simplifie considérablement le travail avec l'API de GitHub. | page d'accueil

Contributif

Les demandes de tirage et les étoiles sont toujours les bienvenues. Pour les bogues et les demandes de fonctionnalités, veuillez créer un problème.

Veuillez lire le guide de contribution pour obtenir des conseils sur les problèmes d'ouverture, les demandes de traction et les normes de codage.

Doct

(Readme.md de ce projet est généré par Verbe, veuillez ne pas modifier directement le ReadMe. Toute modification de la lecture doit être apportée dans le modèle .verb.md Readme.)

Pour générer le ReadMe, exécutez la commande suivante:

$ npm install -g verbose/verb#dev verb-generate-readme && verb

Tests en cours d'exécution

L'exécution et l'examen des tests unitaires sont un excellent moyen de se familiariser avec une bibliothèque et son API. Vous pouvez installer des dépendances et exécuter des tests avec la commande suivante: