qexport

README

The Q Language Export Tool

Export go package to qlang module

The Q Language : https://github.com/qiniu/qlang

Usages:

Export go packages to qlang modules.

Usage:
  qexport [option] packages

The packages for go package list or std for golang all standard packages.
  
  -casestyle int
    	optional export case style. 0: upper case, 1: lower case, 2: both case export. (default 0)
  -contexts string
    	optional comma-separated list of <goos>-<goarch>[-cgo] to override default contexts.
  -convnew
    	optional convert NewType func to type func (default true)
  -defctx
    	optional use default context for build, default use all contexts.
  -outpath string
    	optional set export root path (default "./qlang")
  -skiperrimpl
    	optional skip error interface implement struct. (default true)
  -updatepath string
    	option set update qlang package root

Examples

export sync
> qexport sync

export html and html/template package
> qexport html html/template

export all package
> qexport std

export io and update from qlang.io/lib/io
> qexport -casestyle 2 -updatepath qlang.io/qlang io

export all package and update from qlang.io
> qexport -updatepath qlang.io/qlang std

导出包

导出一个包
> qexport bufio

导出多个包
> qexport bufio io io/ioutil

导出标准包
> qexport std 

更新包

导出bufio包，复制qlang.io/qlang中bufio包到输出目录并更新。
> qexport -updatepath qlang.io/qlang bufio

导出多个包，复制qlang.io/qlang中对应包到输出目录并作更新。
> qexport -updatepath qlang.io/qlang bufio io io/ioutil

导出标准包，复制qlang.io/qlang中对应包到输出目录并作更新。
> qexport -updatepath qlang.io/qlang std

导出和更新包原理和实现

1. 导出pkg包，首先分析pkg包的所有函数和类型作导出准备

2. 如果需要更新，则先复制qlang.io/lib/pkg包到输出目录中
   同时分析qlang.io/lib/pkg包中对原始pkg包的引用
   所有引用的名称在做更新导出时不再输出。

3. 输出需要导出的函数到输出文件中，如果为更新包，则作合并处理
   标准输出位置为 Exports 变量的定义处
   特定Go版本输出 以go1.6版本为例
        文件名为 pkg-go1.6.go 
        编译注释 // +build go1.6 
	    在init函数中作输出