https://github.com/orsinium-labs/awesome-generator

Generate awesome list over Github API
https://github.com/orsinium-labs/awesome-generator

List: awesome-generator

awesome awesome-list awesomeness cli generator github github-api go golang languages topics

Last synced: 8 days ago
JSON representation

Generate awesome list over Github API

• Host: GitHub
• URL: https://github.com/orsinium-labs/awesome-generator
• Owner: orsinium-labs
• License: lgpl-3.0
• Created: 2018-04-06T09:18:32.000Z (almost 7 years ago)
• Default Branch: master
• Last Pushed: 2020-04-23T12:33:12.000Z (almost 5 years ago)
• Last Synced: 2024-05-23T10:07:52.772Z (8 months ago)
• Topics: awesome, awesome-list, awesomeness, cli, generator, github, github-api, go, golang, languages, topics
• Language: Go
• Homepage:
• Size: 59.6 KB
• Stars: 59
• Watchers: 4
• Forks: 6
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• project-awesome - orsinium-labs/awesome-generator - Generate awesome list over Github API (Go)

README

        
# Awesome generator

![Awesome Generator logo](logo.png)

[![Build Status](https://travis-ci.org/orsinium/awesome-generator.svg?branch=master)](https://travis-ci.org/orsinium/awesome-generator)[![Build status](https://ci.appveyor.com/api/projects/status/5rlai32aaj62v86c/branch/master?svg=true)](https://ci.appveyor.com/project/orsinium/awesome-generator/branch/master)[![Go report](https://goreportcard.com/badge/github.com/orsinium/awesome-generator)](https://goreportcard.com/report/github.com/orsinium/awesome-generator) [![Code size](https://img.shields.io/github/languages/code-size/orsinium/awesome-generator.svg)](https://github.com/orsinium/awesome-generator) [![License](https://img.shields.io/github/license/orsinium/awesome-generator.svg)](LICENSE)

Generate awesome list for any language over [Github search API](https://developer.github.com/v3/search/#search-repositories).

Generated awesome lists: [generated-awesomeness](https://github.com/orsinium/generated-awesomeness).

## Installation

[Download](https://github.com/orsinium/awesome-generator/releases) binary for latest release or install from source:

```bash

go get github.com/orsinium/awesome-generator

cd $GOPATH/src/orsinium/awesome-generator

```

## Usage

Generate awesome list for language:

```bash

go run awesome.go -l python > python.md

```

Generate awesome list for topic:

```bash

go run awesome.go -t docker > docker.md

```

If you're download binary release then use it instead of `go run awesome.go`:

```bash

./linux-amd64.bin -t docker > docker.md

```

## Advanced usage

Save projects to JSON:

```bash

go run awesome.go -l python --json > python.json

```

Generate awesome list from JSON:

```bash

cat python.json | go run awesome.go > python.md

```

## Command line arguments

* `-l` -- language. `go run awesome.go -l python`

* `-t` -- topic. `go run awesome.go -t docker`

* `--json` -- dump projects to json. `go run awesome.go -l python --json`

* `--pages` -- count of pages (default 10). `go run awesome.go -l python --pages 5`

* `--min` -- minimum projects into one section (default 2). `go run awesome.go -l python --min 3`