summaryrefslogtreecommitdiff
path: root/xmake/plugins/doxygen/main.lua
blob: 0b39eaca7efc895f5338c942587ace507f9bad71 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
--!The Automatic Cross-platform Build Tool
-- 
-- XMake is free software; you can redistribute it and/or modify
-- it under the terms of the GNU Lesser General Public License as published by
-- the Free Software Foundation; either version 2.1 of the License, or
-- (at your option) any later version.
-- 
-- XMake is distributed in the hope that it will be useful,
-- but WITHOUT ANY WARRANTY; without even the implied warranty of
-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-- GNU Lesser General Public License for more details.
-- 
-- You should have received a copy of the GNU Lesser General Public License
-- along with XMake; 
-- If not, see <a href="http://www.gnu.org/licenses/"> http://www.gnu.org/licenses/</a>
-- 
-- Copyright (C) 2015 - 2016, ruki All rights reserved.
--
-- @author      ruki
-- @file        main.lua
--

-- imports
import("core.base.option")
import("core.tool.tool")
import("core.project.config")
import("core.project.project")

-- main
function main()

    -- check the doxygen
    local doxygen = tool.check("doxygen", nil, function (shellname)
                        os.run("%s -v", shellname)
                    end)
    assert(doxygen, "doxygen not found!")

    -- generate doxyfile first
    local doxyfile = path.join(os.tmpdir(), "doxyfile")

    -- generate the default doxyfile
    os.run("%s -g %s", doxygen, doxyfile)

    -- load configure
    config.load()

    -- load project
    project.load()

    -- enable recursive
    --
    -- RECURSIVE = YES
    --
    io.gsub(doxyfile, "RECURSIVE%s-=%s-NO", "RECURSIVE = YES")

    -- set the source directory
    --
    -- INPUT = xxx
    --
    local srcdir = option.get("srcdir")
    if srcdir and os.isdir(srcdir) then
        io.gsub(doxyfile, "INPUT%s-=.-\n", format("INPUT = %s\n", srcdir))
    end

    -- set the output directory
    --
    -- OUTPUT_DIRECTORY = 
    --
    local outputdir = option.get("outputdir") or config.get("buildir") or "build"
    if outputdir then

        -- update the doxyfile
        io.gsub(doxyfile, "OUTPUT_DIRECTORY%s-=.-\n", format("OUTPUT_DIRECTORY = %s\n", outputdir))

        -- ensure the output directory
        os.mkdir(outputdir)
    end

    -- set the project version
    --
    -- PROJECT_NUMBER = 
    --
    local version = project.version()
    if version then
        io.gsub(doxyfile, "PROJECT_NUMBER%s-=.-\n", format("PROJECT_NUMBER = %s\n", version))
    end

    -- set the project name
    --
    -- PROJECT_NAME = 
    --
    local name = project.name()
    if name then
        io.gsub(doxyfile, "PROJECT_NAME%s-=.-\n", format("PROJECT_NAME = %s\n", name))
    end

    -- check
    assert(os.isfile(doxyfile), "%s not found!", doxyfile)

    -- enter the project directory
    os.cd(project.directory())

    -- generate document
    if option.get("verbose") then
        os.exec("%s %s", doxygen, doxyfile)
    else
        os.run("%s %s", doxygen, doxyfile)
    end

    -- leave the project directory
    os.cd("-")

    -- trace
    print("result: %s/html/index.html", outputdir)
    print("doxygen ok!")
end