Code Monkey home page Code Monkey logo

libraries's Introduction

Overview

This repository contains a list of supported libraries, imports and technologies they belong to.

Structure

The entire list as stored as a JSON object, where the library name is the key, and the value of such property is a number of attributes such as import pattern, language, description, etc.

One library can be mapped to one single language only, but have multiple import patterns or technologies.

An example entry looks like:

	"Express": {
        "language": "JavaScript"
		"imports": ["express"],
		"technologies": ["MVC", "Web Development"],
		"description": "Express is a minimal Node.js framework for web and mobile applications.",
		"image": "https://raw.githubusercontent.com/github/explore/80688e429a7d4ef2fca1e82350fe8e3517d3494d/topics/express/express.png",
	}

Deep dive into structure

As mentioned before, the key of the object is the library name.

Language defines what language this library belongs to. One library can be mapped to one language only, so in case of ambiguous libraries like Bootstrap, the choice has to be made which language it is mainly. Bootstrap is mainly CSS, even though it involves some JavaScript.

Imports is an array of strings, that all map to this library. During the analysis of the repository, CodersRank extracts imports that were used in the commits authored by the user. This may have a form of

  • Symfony\Component\HttpFoundation\Request
  • github.com/micro/go-micro/client
  • express

The import name is not the exact string that should be matched, but rather the string the import starts with. Given this rule, the above imports would match the following:

  • Symfony\
  • github.com/micro/go-micro
  • express

Therefore if we import any package from go-micro, e.g. github.com/micro/go-micro/client, it would still match Go-micro library. Same applies for Symfony in PHP. Express is the exact match, but does not look any different from examples above, since the string express starts with the substring express.

Technologies are pretty self-explanatory. This mapping is used to calculate the score for a particular technology, and one library can be mapped to one of more technologies, as in the original example.

Description is a field thast allows the Library description to be provided.

Image allows to attach a logo to the library. This takes a form of the URL pointing to any image renderable by major browsers.

Contributing

All contributions are welcome, and CodersRank relies on such support. The rules are few, but essential:

  • All fields apart of description and image are required.
  • Please group Libraries by languages and maintain alphabetical order for both libraries and languages. Think SQL ORDER BY language, library.
  • If providing description, make sure to include the dot . at the end of the line. Also make sure the spelling is correct and the description is accurate.

TODO

  • Enforce the rules above in the continious integration. Again, any contribution with a handy bash script for this would be greatly appreciated.
  • Ensure correct JSON during the Continious Intergration pipeline.
  • Currently the image is not used anywhere, but once it is displayed, particular restrictions on format and dimenstions need to be introduced.
  • More languages and more libraries ๐Ÿ˜€

libraries's People

Contributors

peti2001 avatar crhraban avatar fredikats avatar qf-jonathan avatar torniker avatar gapercoco avatar kingsley-einstein avatar twodcube avatar thatkookooguy avatar alexfdezsauco avatar matricali avatar julianrubisch avatar leynier avatar mg901 avatar rolurq avatar codersrankorg avatar

Watchers

James Cloos avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.