JavaScript Go Makefile
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.github
cmd
dao
docs
domain
env
errors
makes
public/js
server
service
static
transfer/api/v1/tracker
vendor
.gitattributes
.gitignore
.goreleaser.yml
.scrutinizer.yml
.travis.yml
Gopkg.lock
Gopkg.toml
LICENSE
Makefile
README.md
build.go
main.go
main_test.go
pkg_test.go

README.md

Passport Tweet

Analytics Person Identifier as a Service — your personal user tracker and auth service.

Patreon Build Status Code Coverage Code Quality License

Quick start

Requirements:

  • Docker 17.09.0-ce or above
  • Docker Compose 1.16.1 or above
  • Go 1.9.2 or above
  • GNU Make 3.81 or above
$ make up status

       Name                     Command               State                                  Ports
----------------------------------------------------------------------------------------------------------------------------------
passport_db_1        docker-entrypoint.sh postgres    Up      0.0.0.0:5432->5432/tcp
passport_server_1    /bin/sh -c envsubst '$SERV ...   Up      80/tcp, 0.0.0.0:80->8080/tcp
passport_service_1   passport run --with-profil ...   Up      0.0.0.0:8080->80/tcp, 0.0.0.0:8090->8090/tcp, 0.0.0.0:8091->8091/tcp

Specification

API

You can find API specification here. Also, we recommend using Insomnia HTTP client to work with the API - you can import data for it from the file.

CLI

$ passport --help
Passport

Usage:
  passport [command]

Available Commands:
  completion  Print Bash or Zsh completion
  help        Help about any command
  migrate     Apply database migration
  run         Start HTTP server
  version     Show application version

Flags:
  -h, --help   help for passport

Use "passport [command] --help" for more information about a command.

Installation

Brew

$ brew install kamilsk/tap/passport

Binary

$ export VER=1.0.0      # all available versions are on https://github.com/kamilsk/passport/releases
$ export REQ_OS=Linux   # macOS and Windows are also available
$ export REQ_ARCH=64bit # 32bit is also available
$ wget -q -O passport.tar.gz \
       https://github.com/kamilsk/passport/releases/download/"${VER}/passport_${VER}_${REQ_OS}-${REQ_ARCH}".tar.gz
$ tar xf passport.tar.gz -C "${GOPATH}"/bin/ && rm passport.tar.gz

Docker Hub

$ docker pull kamilsk/passport:1.x

From source code

$ egg github.com/kamilsk/passport@^1.0.0 -- make test install

Mirror

$ egg bitbucket.org/kamilsk/passport@^1.0.0 -- make test install

egg is an extended go get.

Bash and Zsh completions

You can find completion files here or build your own using these commands

$ passport completion bash > /path/to/bash_completion.d/passport.sh
$ passport completion zsh  > /path/to/zsh-completions/_passport.zsh

Notes

  • brief roadmap
    • v1: MVP
    • v2: Simple Auth
    • v3: OAuth
    • v4: CRUD
    • v5: GUI
    • Passport, SaaS
  • research
  • tested on Go 1.9 and 1.10

Update

This application is in a state of MVP and under active development. SemVer is used for releases, and you can easily be updated within minor versions, but major versions can be not BC-safe.


Gitter @kamilsk @octolab

made with ❤️ by OctoLab