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

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

内容简介：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

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

查看所有标签

猜你喜欢:

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

码农书籍

Python 3面向对象编程

[加]Dusty Phillips（达斯帝•菲利普斯） / 肖鹏、常贺、石琳 / 电子工业出版社 / 2015-6 / 79.00元

Python 是一种面向对象的解释型语言，面向对象是其非常重要的特性。《Python 3面向对象编程》通过Python 的数据结构、语法、设计模式，从简单到复杂，从初级到高级，一步步通过例子来展示了Python 中面向对象的概念和原则。《Python 3面向对象编程》不是Python 的入门书籍，适合具有Python 基础经验的开发人员阅读。如果你拥有其他面向对象语言的经验，你会更容易理解......一起来看看《Python 3面向对象编程》这本书的介绍吧!

码农工具