自定义 Go 包的 import path 的命令行应用

栏目: IT技术 · 发布时间: 5年前

内容简介：The major advantages of using custom import path is that you don't need to change the import path when you are going to host your code elsewhere.

GOPKGs

gopkgs is a CLI application and HTTP service that manage custom import path of your Go packages.

The major advantages of using custom import path is that you don't need to change the import path when you are going to host your code elsewhere.

Online preview

$ curl "https://clevergo.tech/clevergo?go-get=1"
$ curl "https://clevergo.tech/captchas?go-get=1"
$ curl "https://clevergo.tech/form?go-get=1"

Installation

Source

$ git clone https://github.com/razonyang/gopkgs.git
$ cd gopkgs
$ packr2 build --tag [database]

database : mysql , sqlite3 or postgres .

go get -u github.com/gobuffalo/packr/v2/packr2 for installing packr2 .

Binary

Checkout releases page and download.

Configuration

Configuration is a JSON file.

{
    "addr": ":8080",
    "db": {
        "driver": "sqlite3",
        "dsn": "gopkgs.db",
        "tableName": "packages"
    }
}

addr : HTTP server address.
db :
- dsn : data source name, depends on what driver you use.
  - sqlite3 : /path/to/gopkgs.db
  - mysql : user:password@tcp(localhost:3306)/gopkgs?charset=utf8mb4&parseTime=True&loc=Local
  - postgres : postgres://user:password@localhost/gopkgs?sslmode=verify-full
- tableName : the name of packages table.

The config.json of the current directory will be used by default, you can specify the configuration file via -c or --config flag:

$ gopkgs -c /etc/gopkgs/config.json

Usage

Start HTTP server

$ gopkgs serve

You can use supervisord to manage gopkgs HTTP service.

You may also need to set up a reverse proxy, let's take Nginx as example:

location / {
    try_files $uri $uri/ @gopkgsproxy;
}

location @gopkgsproxy {
    proxy_set_header Host $host;
    proxy_pass http://127.0.0.1:8080;
}

Add package

$ gopkgs add <prefix> <vcs> <repo-root> [<docs-url>]

prefix
vcs
repo-root
docs-url

$ gopkgs add \
    example.com/foo \
    git \
    https://github.com/example/foo

And then checkout the output.

$ curl https://example.com/foo
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
<meta name="go-import" content="example.com/foo git https://github.com/example/foo">
<meta http-equiv="refresh" content="0; url=https://pkg.go.dev/example.com/foo?tab=doc">
<title>Package example.com/foo</title>
</head>
<body>
Nothing to see here; <a href="https://pkg.go.dev/example.com/foo?tab=doc">move along</a>.
</body>
</html>

Show package

$ gopkgs show example.com/foo
example.com/foo
vcs : git
root: https://github.com/example/foo
docs: https://pkg.go.dev/example.com/foo?tab=doc

Edit package

Modify VCS

$ gopkgs set-vcs example.com/foo svn

Repository Root

$ gopkgs set-root example.com/foo https://gitlab.com/example/foo

Documentations

$ gopkgs set-docs example.com/foo https://docs.example.com/foo

Verify that everything is OK

$ gopkgs show example.com/foo
example.com/foo
vcs : svn
root: https://gitlab.com/example/foo
docs: https://docs.example.com/foo

Remove pacakge

$ gopkgs remove example.com/foo

Help

$ gopkgs help

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持码农网

查看所有标签

猜你喜欢:

本站部分资源来源于网络，本站转载出于传递更多信息之目的，版权归原作者或者来源机构所有，如转载稿涉及版权问题，请联系我们。

码农书籍

应用Rails进行敏捷Web开发

Dave Thomas, David Hansson等 / 林芷薰 / 电子工业出版社 / 2006-7 / 65.00元

这是第一本关于Ruby on Rails的著作。全书主要内容分为两大部分。在“构建应用程序”部分中，读者将看到一个完整的“在线购书网站” 示例。在演示的过程中，作者真实地再现了一个完整的迭代式开发过程，让读者亲身体验实际应用开发中遇到的各种问题、以及Rails如何有效解决这些问题。在随后的“Rails框架”部分中，作者深入介绍了Rails框架的各个组成部分。尤为值得一提的是本部分的后几章......一起来看看《应用Rails进行敏捷Web开发》这本书的介绍吧!

码农工具