6 |
7 | ### Disclaimer
8 |
9 | This project is a side project, and a product of a half weekend, if people will find joy in it, we will put more effort into it. Both of us creating it, used a personally new framework. It was pure fun.
10 |
11 | ### Rules
12 |
13 | Every day you get the short description of 5 npm projects and you have to guess what the projects are! You have three attempts per project.
14 |
15 | Depending how many hints you use:
16 |
17 | - 🟢 You got the project right without any hints.
18 | - 🟡 You got the project right, but not on the first try.
19 | - 🔴 You didn't get the project right.
20 | - ⚪ Unanswered questions.
21 |
22 | ### Info
23 |
24 | Your data is stored client-side (browser local storage). More details [here](https://developer.mozilla.org/en-US/docs/Web/API/Window/localStorage).
25 | The quiz is reset every noon (UTC) quiz starts on February 5 and runs for 15 days, ending on February 20. Have Fun and Good Luck! 🍾
26 |
27 | ⭐ **Drop a star if you want to see more like this!**
28 |
29 | ### License
30 |
31 | You can create your own quiz game using this one, as it is fully open-source with an Apache 2.0 license.
32 |
--------------------------------------------------------------------------------
/api/Dockerfile:
--------------------------------------------------------------------------------
1 | FROM gcr.io/distroless/static
2 | LABEL maintainer="nandor-magyar"
3 | COPY --chown=nonroot:nonroot ./cmd/server/api.bin /api.bin
4 | ENTRYPOINT ["/api.bin"]
--------------------------------------------------------------------------------
/api/cmd/cli/cli.go:
--------------------------------------------------------------------------------
1 | package main
2 |
3 | import (
4 | "fmt"
5 | "strings"
6 |
7 | "github.com/dyrector-io/xor/api/pkg/game"
8 | "github.com/dyrector-io/xor/api/pkg/processor"
9 | )
10 |
11 | const gradingSplit = 3
12 |
13 | func printAnswer(right bool) string {
14 | if right {
15 | return "++"
16 | }
17 | return "--"
18 | }
19 |
20 | func quiz() {
21 | records := processor.ReadJSONData()
22 |
23 | qNum := 5
24 | attempts := 3
25 |
26 | indices := game.PickRandom(qNum, len(records)-1)
27 | answers := map[int]bool{}
28 |
29 | fmt.Printf("How well do you know the landscape? Find out who has this as a value proposition / GitHub description.")
30 | for i := 0; i < qNum; i++ {
31 | fmt.Printf("\n%d. Question\n%s\nStars:%d\n",
32 | i+1, records[indices[i]].Description, records[indices[i]].GithubStars)
33 | fmt.Printf("Code sample:\n%s\n", records[indices[i]].CodeExample)
34 | if records[indices[i]].RandomFact != "" {
35 | fmt.Printf("Random fact:\n%s\n", records[indices[i]].RandomFact)
36 | }
37 | for j := attempts; j > 0; j-- {
38 | input := ""
39 | fmt.Scanln(&input)
40 | if strings.EqualFold(records[indices[i]].Name, input) ||
41 | (len(input) > 4 && strings.Contains(records[indices[i]].Name, input)) {
42 | answers[i] = true
43 | fmt.Printf("Nailed it! Onto the next one...\n")
44 | break
45 | }
46 | if j == attempts {
47 | fmt.Printf("Hint: %s\n", records[indices[i]].CodeExample)
48 | }
49 | if input == "" {
50 | fmt.Printf("You have to write something...\n")
51 | j++
52 | }
53 | fmt.Printf("Not: %v. Try again! %d attempts left\n", input, j-1)
54 | }
55 | fmt.Printf("It was: %s\n\n", records[indices[i]].Name)
56 | }
57 |
58 | good := 0
59 | for _, v := range answers {
60 | if v {
61 | good++
62 | }
63 | }
64 | fmt.Printf("Your result is: %d/%d\n", good, qNum)
65 | if good < gradingSplit {
66 | fmt.Printf("Better luck next time.\n")
67 | } else if good > gradingSplit {
68 | fmt.Printf("You've got it! GG!")
69 | }
70 | for i := 0; i < qNum; i++ {
71 | fmt.Printf("%d %s | %s\n", i+1, records[indices[i]].Name, printAnswer(answers[i]))
72 | }
73 | }
74 |
75 | func main() {
76 | quiz()
77 | }
78 |
--------------------------------------------------------------------------------
/api/cmd/server/.env.example:
--------------------------------------------------------------------------------
1 | DEBUG=true
2 | PORT=3333
3 | # for testing leave it empty for persistence
4 | METHOD=RANDOM
5 | DSN="host=localhost user=postgres password=password dbname=postgres port=5432 sslmode=disable"
6 | END_DATE=2023-01-28
--------------------------------------------------------------------------------
/api/cmd/server/server.go:
--------------------------------------------------------------------------------
1 | package main
2 |
3 | import (
4 | "os"
5 |
6 | "github.com/dyrector-io/xor/api/internal/config"
7 | "github.com/dyrector-io/xor/api/pkg/server"
8 | "github.com/rs/zerolog/log"
9 |
10 | "github.com/ilyakaznacheev/cleanenv"
11 | )
12 |
13 | func ReadConfig(cfg *config.AppConfig) error {
14 | err := cleanenv.ReadConfig(".env", cfg)
15 |
16 | if err != nil && !os.IsNotExist(err) {
17 | return err
18 | }
19 | err = cleanenv.ReadEnv(cfg)
20 | if err != nil {
21 | return err
22 | }
23 |
24 | return nil
25 | }
26 |
27 | func main() {
28 | appConfig := &config.AppConfig{}
29 |
30 | err := ReadConfig(appConfig)
31 | if err != nil {
32 | log.Fatal().Err(err).Send()
33 | }
34 |
35 | log.Info().Object("appConfig", appConfig).Send()
36 |
37 | serv := server.GetChi(appConfig)
38 |
39 | log.Info().Msgf("starting server at: %d", appConfig.Port)
40 | err = serv.ListenAndServe()
41 | if err != nil {
42 | log.Fatal().Err(err).Send()
43 | }
44 | }
45 |
--------------------------------------------------------------------------------
/api/internal/config/config.go:
--------------------------------------------------------------------------------
1 | package config
2 |
3 | import (
4 | "github.com/dyrector-io/xor/api/pkg/processor"
5 | "github.com/rs/zerolog"
6 | "gorm.io/gorm"
7 | )
8 |
9 | type AppConfig struct {
10 | AllowedOrigins string `env:"ALLOWED_ORIGINS"`
11 | Port uint16 `env:"PORT" env-default:"3333"`
12 | Debug bool `env:"DEBUG"`
13 | DSN string `env:"DSN"`
14 | Method string `env:"METHOD"`
15 | Freq string `env:"FREQ" env-default:"DAILY"`
16 | EndDate string `env:"END_DATE"`
17 | }
18 | type AppState struct {
19 | AppConfig *AppConfig
20 | DBConn *gorm.DB
21 | Ended bool
22 | QuizList processor.QuizSequence
23 | QuizCounter int
24 | }
25 |
26 | func (c *AppConfig) MarshalZerologObject(e *zerolog.Event) {
27 | e.Str("origins", c.AllowedOrigins).
28 | Uint16("port", c.Port).
29 | Bool("debug", c.Debug).
30 | Str("method", c.Method).
31 | Str("freq", c.Freq).
32 | Str("end", c.EndDate)
33 | }
34 |
--------------------------------------------------------------------------------
/api/internal/ctx/ctx.go:
--------------------------------------------------------------------------------
1 | package ctx
2 |
3 | import "context"
4 |
5 | type CtxKey int
6 |
7 | const (
8 | StateKey = iota
9 | )
10 |
11 | func SetContextVar[T any](c context.Context, key CtxKey, value T) context.Context {
12 | return context.WithValue(c, key, value)
13 | }
14 |
15 | func GetContextVar[T any](c context.Context, key CtxKey) T {
16 | return c.Value(key).(T)
17 | }
18 |
--------------------------------------------------------------------------------
/api/pkg/database/database.go:
--------------------------------------------------------------------------------
1 | package database
2 |
3 | import (
4 | "database/sql"
5 | "fmt"
6 | "net/http"
7 | "strconv"
8 | "strings"
9 | "time"
10 |
11 | "github.com/dyrector-io/xor/api/internal/config"
12 | "github.com/dyrector-io/xor/api/pkg/processor"
13 | "github.com/rs/zerolog/log"
14 | "gorm.io/driver/postgres"
15 | "gorm.io/gorm"
16 |
17 | _ "github.com/proullon/ramsql/driver" // ramsql
18 | )
19 |
20 | const (
21 | SimpleDateFormat = "2006-01-02"
22 | DBconnectAttempt = 3
23 | DBconnectBackoffSeconds = 10
24 | )
25 |
26 | type Pick struct {
27 | gorm.Model
28 | // 1,2,3,4,5 format
29 | Picks string
30 | // day of pick
31 | Date time.Time `gorm:"unique"`
32 | }
33 |
34 | type History struct {
35 | Date string
36 | Projects string
37 | }
38 |
39 | func (c *History) Render(w http.ResponseWriter, r *http.Request) error {
40 | return nil
41 | }
42 |
43 | type HistoryList []*History
44 |
45 | func SimpleDay(t time.Time) time.Time {
46 | str := t.Format(SimpleDateFormat)
47 | val, _ := time.Parse(SimpleDateFormat, str)
48 | return val
49 | }
50 |
51 | func PersistPicks(db *gorm.DB, today time.Time, picks []int) error {
52 | strArr := []string{}
53 | for _, p := range picks {
54 | strArr = append(strArr, fmt.Sprintf("%d", p))
55 | }
56 |
57 | str := strings.Join(strArr, ",")
58 | tx := db.Create(&Pick{Picks: str, Date: SimpleDay(today)})
59 | if tx.Error != nil {
60 | return tx.Error
61 | }
62 | return nil
63 | }
64 |
65 | func GetPicksForDay(db *gorm.DB, day time.Time) []int {
66 | p := Pick{}
67 |
68 | prunedDay := SimpleDay(day)
69 | err := db.Where(&Pick{Date: prunedDay}).First(&p)
70 | if err.Error != nil {
71 | return []int{}
72 | }
73 |
74 | return ParsePicksToIntArr(p.Picks)
75 | }
76 |
77 | func ParsePicksToIntArr(pickStr string) []int {
78 | str := strings.Split(pickStr, ",")
79 | picks := []int{}
80 | for _, v := range str {
81 | i, err := strconv.ParseInt(v, 10, 32)
82 | if err != nil {
83 | log.Error().Err(err).Msg("very unlikely str to int parse error")
84 | }
85 | picks = append(picks, int(i))
86 | }
87 | return picks
88 | }
89 |
90 | func GetHistoryDB(db *gorm.DB) HistoryList {
91 | picks := []Pick{}
92 | result := db.Where("Date < ?", SimpleDay(time.Now())).Find(&picks)
93 | if result.Error != nil {
94 | log.Error().Err(result.Error).Msg("could not load history returning empty set")
95 | return HistoryList{}
96 | }
97 | all := processor.ReadJSONData()
98 | hist := HistoryList{}
99 | for i := range picks {
100 | pickList := ParsePicksToIntArr(picks[i].Picks)
101 | projectNames := []string{}
102 | for _, index := range pickList {
103 | projectNames = append(projectNames, all[index].Name)
104 | }
105 | hist = append(hist, &History{
106 | Date: picks[i].Date.Format(SimpleDateFormat),
107 | Projects: strings.Join(projectNames, ","),
108 | })
109 | }
110 | return hist
111 | }
112 |
113 | func GetExclusionList(db *gorm.DB) []int {
114 | picks := []Pick{}
115 | result := db.Find(&picks)
116 | if result.Error != nil {
117 | log.Error().Err(result.Error).Msg("could not load history returning empty set")
118 | return []int{}
119 | }
120 | xList := []int{}
121 | for i := range picks {
122 | pickList := ParsePicksToIntArr(picks[i].Picks)
123 | xList = append(xList, pickList...)
124 | }
125 | return xList
126 | }
127 |
128 | func InitPostgres(cfg *config.AppConfig) *gorm.DB {
129 | db := connect(cfg)
130 | err := db.AutoMigrate(&Pick{})
131 | if err != nil {
132 | log.Fatal().Msgf("sql migrate: %s\n", err)
133 | }
134 | return db
135 | }
136 |
137 | func connect(cfg *config.AppConfig) *gorm.DB {
138 | if cfg.DSN == "" {
139 | sqlDB, err := sql.Open("ramsql", "test")
140 | if err != nil {
141 | log.Fatal().Msgf("ramsql.Open: %s\n", err)
142 | }
143 |
144 | db, err := gorm.Open(postgres.New(postgres.Config{
145 | Conn: sqlDB,
146 | }), &gorm.Config{})
147 | if err != nil {
148 | log.Fatal().Msgf("sql.Open: %s\n", err)
149 | }
150 |
151 | return db
152 | }
153 | for i := 0; i < DBconnectAttempt; i++ {
154 | db, err := gorm.Open(postgres.Open(cfg.DSN), &gorm.Config{})
155 | if err != nil {
156 | log.Error().Err(err).Msgf("sql error, backoff %d %d/%d\n", DBconnectBackoffSeconds, i+1, DBconnectAttempt)
157 | time.Sleep(DBconnectBackoffSeconds * time.Second)
158 | } else {
159 | return db
160 | }
161 | if i == DBconnectAttempt {
162 | log.Fatal().Msg("could not open sql connection")
163 | }
164 | }
165 | log.Fatal().Msg("db connect unreachable code")
166 | return nil
167 | }
168 |
--------------------------------------------------------------------------------
/api/pkg/game/game.go:
--------------------------------------------------------------------------------
1 | package game
2 |
3 | import (
4 | "crypto/rand"
5 | "math/big"
6 | "time"
7 |
8 | "github.com/dyrector-io/xor/api/internal/config"
9 | "github.com/dyrector-io/xor/api/pkg/database"
10 | "github.com/dyrector-io/xor/api/pkg/processor"
11 | "github.com/rs/zerolog/log"
12 | "golang.org/x/exp/slices"
13 | "gorm.io/gorm"
14 | )
15 |
16 | const (
17 | FilterIfStartLessThan = 1000
18 | QuestionCount = 5
19 | )
20 |
21 | const (
22 | RandomGenMethod = "RANDOM"
23 | LinearGenMethod = "LINEAR"
24 | )
25 |
26 | func PickRandom(amount, upperLimit int) []int {
27 | picked := []int{}
28 | min := 0
29 | bg := big.NewInt(int64(upperLimit) - int64(min))
30 | for i := 0; i < amount; i++ {
31 | gen, err := rand.Int(rand.Reader, bg)
32 | if err != nil {
33 | log.Error().Err(err).Send()
34 | }
35 | if i > 0 {
36 | if slices.Contains(picked, int(gen.Int64())) {
37 | i--
38 | continue
39 | }
40 | }
41 | picked = append(picked, int(gen.Int64()))
42 | }
43 |
44 | return picked
45 | }
46 |
47 | func sdbmHash(data []byte) uint64 {
48 | var hash uint64
49 |
50 | for _, b := range data {
51 | hash = uint64(b) + (hash << 6) + (hash << 16) - hash
52 | }
53 |
54 | return hash
55 | }
56 |
57 | func PickByDate(today time.Time, amount, upperLimit int, excluded []int) []int {
58 | if len(excluded)+amount-1 >= upperLimit {
59 | log.Info().Msgf("ran out of item indices %v/%v", len(excluded), upperLimit)
60 | return []int{}
61 | }
62 |
63 | hash := sdbmHash([]byte(today.Format("2006-01-02")))
64 | slice := hash / uint64(amount)
65 | log.Info().Msgf("%d", hash)
66 |
67 | picked := []int{}
68 | for i := 0; i < amount; i++ {
69 | gen := hash % uint64(upperLimit)
70 | hash -= slice
71 |
72 | for j := 1; slices.Contains(picked, int(gen)) || slices.Contains(excluded, int(gen)); j++ {
73 | gen = (hash + uint64(j)) % uint64(upperLimit)
74 | }
75 |
76 | picked = append(picked, int(gen))
77 | }
78 |
79 | log.Info().Msgf("%v", picked)
80 | return picked
81 | }
82 |
83 | func GetPicksIfPresent(db *gorm.DB, today time.Time) []int {
84 | return database.GetPicksForDay(db, today)
85 | }
86 |
87 | func SelectAQuiz(state *config.AppState) {
88 | today := time.Now()
89 | log.Info().Msgf("SelectAQuiz running %v", today)
90 | listAll := processor.ReadJSONData()
91 | var indices []int
92 | if state.AppConfig.EndDate != "" {
93 | end, err := time.Parse("2006-01-02", state.AppConfig.EndDate)
94 | if err != nil {
95 | log.Err(err).Msg("invalid ending date format, expected: 2006-01-02")
96 | }
97 | if today.After(end) {
98 | log.Info().Msgf("End date passed %v>%v", today, state.AppConfig.EndDate)
99 | state.QuizList = processor.QuizSequence{}
100 | state.Ended = true
101 | return
102 | }
103 | }
104 | if state.QuizCounter*QuestionCount >= len(listAll) {
105 | state.QuizList = processor.QuizSequence{}
106 | state.Ended = true
107 | return
108 | } else if state.AppConfig.Method == RandomGenMethod {
109 | indices = PickRandom(QuestionCount, len(listAll)-1)
110 | log.Info().Msg("generating new random quiz")
111 | } else if state.AppConfig.Method == LinearGenMethod {
112 | start := state.QuizCounter * QuestionCount
113 | for i := start; i < start+QuestionCount; i++ {
114 | indices = append(indices, i)
115 | }
116 | state.QuizCounter++
117 | } else {
118 | indices = GetPicksIfPresent(state.DBConn, today)
119 | if len(indices) == 0 {
120 | log.Info().Msg("generating new quiz")
121 |
122 | indices = PickByDate(today, QuestionCount, len(listAll)-1, database.GetExclusionList(state.DBConn))
123 |
124 | err := database.PersistPicks(state.DBConn, today, indices)
125 | if err != nil {
126 | log.Error().Err(err).Msg("persisting quiz picks for the day")
127 | }
128 | } else {
129 | log.Info().Msg("found already generated quiz for today")
130 | }
131 | }
132 |
133 | if len(indices) == 0 {
134 | state.Ended = true
135 | log.Info().Msg("no quiz indices were picked, assuming the end")
136 | return
137 | }
138 |
139 | selected := processor.QuizSequence{}
140 |
141 | for _, i := range indices {
142 | selected = append(selected, listAll[i])
143 | }
144 |
145 | state.QuizList = selected
146 | }
147 |
--------------------------------------------------------------------------------
/api/pkg/game/game_test.go:
--------------------------------------------------------------------------------
1 | package game_test
2 |
3 | import (
4 | "testing"
5 | "time"
6 |
7 | "github.com/dyrector-io/xor/api/pkg/game"
8 | "github.com/stretchr/testify/assert"
9 | )
10 |
11 | func TestDatePicking(t *testing.T) {
12 | const pickPerDay = 5
13 | dat, _ := time.Parse("2006-01-02", "2022-12-12")
14 | picks := game.PickByDate(dat, pickPerDay, 15, []int{})
15 | assert.Equalf(t, []int{12, 7, 2, 8, 3}, picks, "These numbers should've been picked on the first day")
16 | excl := picks
17 | picks = game.PickByDate(dat.AddDate(0, 0, 1), pickPerDay, 15, excl)
18 | assert.Equalf(t, []int{13, 4, 14, 9, 5}, picks, "These numbers should've been picked on the second day")
19 | excl = append(excl, picks...)
20 | picks = game.PickByDate(dat.AddDate(0, 0, 1), pickPerDay, 15, excl)
21 | assert.Equalf(t, []int{10, 6, 0, 11, 1}, picks, "These numbers should've been picked on the third day")
22 | }
23 |
--------------------------------------------------------------------------------
/api/pkg/main.go:
--------------------------------------------------------------------------------
1 | package main
2 |
3 | import (
4 | "encoding/json"
5 | "fmt"
6 | "os"
7 |
8 | "github.com/dyrector-io/xor/api/pkg/processor"
9 | )
10 |
11 | func main() {
12 | seq := processor.ReadJSONData()
13 |
14 | toWrite := processor.QuizSequence{}
15 | for _, i := range seq {
16 | if i.GithubStars > 1000 {
17 | toWrite = append(toWrite, i)
18 | }
19 | }
20 |
21 | bytes, err := json.MarshalIndent(toWrite, "", " ")
22 | if err != nil {
23 | panic(err)
24 | }
25 | fmt.Printf("%v", bytes)
26 |
27 | os.WriteFile("landscape.json", bytes, os.ModePerm)
28 | }
29 |
--------------------------------------------------------------------------------
/api/pkg/processor/javascript.json:
--------------------------------------------------------------------------------
1 | [
2 | {
3 | "Name": "Lodash",
4 | "Description": "... makes JavaScript easier by taking the hassle out of working with arrays, numbers, objects, strings, etc.",
5 | "CodeExample": "```*redacted*.defaults({ 'a': 1 }, { 'a': 3, 'b': 2 });```",
6 | "RandomFact": "2015 was big year! ... became the most depended on npm package, passed 1 billion downloads, & its v3 release saw massive adoption!",
7 | "GithubStars": 55500,
8 | "GitHubLink": "https://github.com/lodash/lodash",
9 | "WeeklyDownloads": 46000000
10 | },
11 | {
12 | "Name": "Cloudinary",
13 | "Description": "Effortlessly optimize, transform, upload and manage your cloud's assets.",
14 | "CodeExample": "```*redacted*.url('sample.jpg', {width: 100, height: 150, crop: 'fill', fetch_format: 'auto'})```",
15 | "RandomFact": "Image and Video API for Powerful Visual Experiences - Store, transform, optimize, and deliver all your media assets with easy-to-use APIs, widgets, or user interface.",
16 | "GithubStars": 567,
17 | "GitHubLink": "https://github.com/cloudinary/cloudinary_npm",
18 | "WeeklyDownloads": 183000
19 | },
20 | {
21 | "Name": "Axios",
22 | "Description": "Promise based HTTP client for the browser and node.js",
23 | "CodeExample": "```*redacted*.({ method: 'post', url: '/user/12345', data: { firstName: 'Fred', lastName: 'Flintstone'} });```",
24 | "RandomFact": "Matt Zabriskie is the founder of the npm package, started in the summer of 2014.",
25 | "GithubStars": 98500,
26 | "GitHubLink": "https://github.com/axios/axios",
27 | "WeeklyDownloads": 39000000
28 | },
29 | {
30 | "Name": "chalk",
31 | "Description": "Terminal string styling done right",
32 | "CodeExample": "```log(*redacted*.blue.bgRed.bold('Hello world!'));```",
33 | "RandomFact": "... supports 256 colors and Truecolor (16 million colors) on supported terminal apps. Colors are downsampled from 16 million RGB values to an ANSI color format that is supported by the terminal emulator (or by specifying {level: n} as a ... option). For example, ... configured to run at level 1 (basic color support) will downsample an RGB value of #FF0000 (red) to 31 (ANSI escape for red).",
34 | "GithubStars": 19700,
35 | "GitHubLink": "https://github.com/chalk/chalk",
36 | "WeeklyDownloads": 233114855
37 | },
38 | {
39 | "Name": "mustache.js",
40 | "Description": "Logic-less {{...}} templates with JavaScript. ... is a zero-dependency implementation of the ... template system in JavaScript.",
41 | "CodeExample": "```const view = {\n title: \"Joe\",\n calc: () => ( 2 + 4 )\n};\nconst output = *redacted*.render(\"{{title}} spends {{calc}}\", view);```",
42 | "RandomFact": "You can use ... to render mustache templates anywhere you can use JavaScript. This includes web browsers, server-side environments such as Node.js, and CouchDB views.",
43 | "GithubStars": 15700,
44 | "GitHubLink": "https://github.com/janl/mustache.js",
45 | "WeeklyDownloads": 3139159
46 | },
47 | {
48 | "Name": "minimist",
49 | "Description": "This module is the guts of optimist's argument parser without all the fanciful decoration.",
50 | "CodeExample": "```$ node example/parse.js -a beep -b boop { _: [], a: 'beep', b: 'boop' }```",
51 | "RandomFact": "Parse argument options",
52 | "GithubStars": 120,
53 | "GitHubLink": "https://github.com/minimistjs/minimist",
54 | "WeeklyDownloads": 53595074
55 | },
56 | {
57 | "Name": "Commander.js",
58 | "Description": "The complete solution for node.js command-line interfaces.",
59 | "CodeExample": "```program\n .option('--first')\n .option('-s, --separator Hello, XOR!
\"),\n initialize: function () {\n this.render();\n },\n render: function () {\n this.$el.html(this.template());\n },\n });\n new View();\n })();\n});\n```", 429 | "RandomFact": "", 430 | "GithubStars": 27984, 431 | "GitHubLink": "https://github.com/jashkenas/backbone", 432 | "WeeklyDownloads": 607180 433 | }, 434 | { 435 | "Name": "kibana", 436 | "Description": "It's an open source (Apache Licensed), browser-based analytics and search dashboard for Elasticsearch.", 437 | "CodeExample": "```//a query\nhttp.request.method: *```", 438 | "RandomFact": "Built in linter, code formatter, ability to build a self-contained executable, test runner, IDE integration, and more.", 439 | "GithubStars": 18195, 440 | "GitHubLink": "github.com/elastic/kibana", 441 | "WeeklyDownloads": 8 442 | }, 443 | { 444 | "Name": "knockout", 445 | "Description": "... is a JavaScript MVVM (a modern variant of MVC) library that makes it easier to create rich, desktop-like user interfaces with JavaScript and HTML.", 446 | "CodeExample": "```// Here's my data model \n var ViewModel = function(first, last) { \n this.firstName = *redacted*.observable(first); \n this.lastNme = *redacted*.observable(last); \n this.fullName = *redacted*.pureComputed(function() { \n // ... tracks dependencies automatically. It knows that fullName depends on firstName and lastName, because these get called when evaluating fullName. \n return this.firstName() + \" \" + this.lastName(); \n }, this); \n }; \n *redacted*.applyBindings(new ViewModel(\"Planet\", \"Earth\")); // This makes ... get to work```", 447 | "RandomFact": "When your data model's state changes, your UI updates automatically", 448 | "GithubStars": 10279, 449 | "GitHubLink": "https://github.com/knockout/knockout", 450 | "WeeklyDownloads": 70616 451 | }, 452 | { 453 | "Name": "mocha", 454 | "Description": "Simple, flexible, fun JavaScript test framework for Node.js & The Browser", 455 | "CodeExample": "```var assert = require('assert');\ndescribe('Array', function () {\n describe('#indexOf()', function () {\n it('should return -1 when the value is not present', function () {\n assert.equal([1, 2, 3].indexOf(4), -1);\n });\n });\n});```", 456 | "RandomFact": "... is one of the most-depended-upon modules on npm (source: libraries.io)", 457 | "GithubStars": 21871, 458 | "GitHubLink": "https://github.com/mochajs/mocha", 459 | "WeeklyDownloads": 7662359 460 | }, 461 | { 462 | "Name": "Three.js", 463 | "Description": "The aim of the project is to create an easy to use, lightweight, cross-browser, general purpose 3D library.", 464 | "CodeExample": "```const scene = new *redacted*.Scene();\nconst camera = new *redacted*.PerspectiveCamera( 75, window.innerWidth / window.innerHeight, 0.1, 1000 );\nconst renderer = new *redacted*.WebGLRenderer();\nrenderer.setSize( window.innerWidth, window.innerHeight );\ndocument.body.appendChild( renderer.domElement );```", 465 | "RandomFact": "The current builds only include a WebGL renderer but WebGPU (experimental), SVG and CSS3D renderers are also available as addons.", 466 | "GithubStars": 88640, 467 | "GitHubLink": "https://github.com/mrdoob/three.js", 468 | "WeeklyDownloads": 922629 469 | }, 470 | { 471 | "Name": "ws", 472 | "Description": "... is a simple to use, blazing fast, and thoroughly tested WebSocket client and server implementation.", 473 | "CodeExample": "```// server-side\nconst server = new WebSocketServer({\n port: 8080,\n perMessageDeflate: {\n zlibDeflateOptions: {\n // See zlib defaults.\n chunkSize: 1024,\n memLevel: 7,\n level: 3\n },\n zlibInflateOptions: {\n chunkSize: 10 * 1024\n },\n // Other options settable:\n clientNoContextTakeover: true, // Defaults to negotiated value.\n serverNoContextTakeover: true, // Defaults to negotiated value.\n serverMaxWindowBits: 10, // Defaults to negotiated value.\n // Below options specified as default values.\n concurrencyLimit: 10, // Limits zlib concurrency for perf.\n threshold: 1024 // Size (in bytes) below which messages\n // should not be compressed if context takeover is disabled.\n }\n});\n// client side\nconst client = new WebSocket('ws://www.host.com/path', {\n perMessageDeflate: false\n});```", 474 | "RandomFact": "", 475 | "GithubStars": 19390, 476 | "GitHubLink": "https://github.com/websockets/ws", 477 | "WeeklyDownloads": 70632670 478 | }, 479 | { 480 | "Name": "Anime.js", 481 | "Description": "One of the best animation libraries that makes staggering follow-through animations so simple, ... is light-weight and comes with a clean yet powerful API.", 482 | "CodeExample": "```*redacted*({\n targets: 'div',\n translateX: 250,\n rotate: '1turn',\n backgroundColor: '#FFF',\n duration: 800\n});```", 483 | "RandomFact": "... works with anything web. CSS, SVG, DOM attributes and JavaScript Objects: animate everything with a single unified API.", 484 | "GithubStars": 44292, 485 | "GitHubLink": "https://github.com/juliangarnier/anime", 486 | "WeeklyDownloads": 139834 487 | }, 488 | { 489 | "Name": "handlebars", 490 | "Description": "... provides the power necessary to let you build semantic templates effectively with no frustration.", 491 | "CodeExample": "```var source = \"Hello, my name is {{name}}. I am from {{hometown}}. I have \" +\n\"{{kids.length}} kids:
\" +\n\"Resize the browser window to see the effect.
\nThe columns will automatically stack on top of each other when the screen is less than 768px wide.
\n![\"\"](\"/sarah-dayan.jpg\")
\n \n\n\n \u201C... is the only framework that I've seen scale \n on large teams. It\u2019s easy to customize, adapts to any design, \n and the build size is tiny.\u201D\n
\n
${welcome}, ${name}!
\nNow set forth ${quest.toLowerCase()}!
```", 600 | "RandomFact": "Version 2, ... applications are built by composing a series of simple components.", 601 | "GithubStars": 1255, 602 | "GitHubLink": "https://github.com/aurelia/aurelia", 603 | "WeeklyDownloads": 932 604 | }, 605 | { 606 | "Name": "leaflet", 607 | "Description": "JavaScript library for mobile-friendly interactive maps", 608 | "CodeExample": "```var map = L.map('map').setView([51.505, -0.09], 13);\nL.tileLayer('https://tile.openstreetmap.org/{z}/{x}/{y}.png', {\n attribution: '© OpenStreetMap contributors'\n}).addTo(map);\nL.marker([51.5, -0.09]).addTo(map)\n .bindPopup('A pretty CSS3 popup.{codeContent}Description: {question.Description}
79 |Random fact: {question.RandomFact}
80 |
81 | Code example:
82 |
93 | GitHub Stars: 94 | {question.GithubStars.toLocaleString('en-US')} / Weekly npm downloads: 95 | {question.WeeklyDownloads.toLocaleString('en-US')} 96 |
97 |46 | contact: hello@dyrector.io 49 | / repository: 50 | dyrector-io/xor 53 |
54 |Take a look at previously included projects.
18 |