gdoc 0.0.1

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml ADDED
@@ -0,0 +1,7 @@
1
+ ---
2
+ SHA1:
3
+ metadata.gz: 72eefce3e6e62bbabaaa0b6a82df1bcb74ea8f71
4
+ data.tar.gz: fd02ed90e4a65fa1436e62301afc4952c78e0200
5
+ SHA512:
6
+ metadata.gz: 59de9b0b1e5f663b484fb0087d83446deb76680443fe66745f5265aa63498621b5489d93336d84f8d27df51e8f1c0e9c59c9fc8ebd0237f646be30559c82990e
7
+ data.tar.gz: 751fee0532c4f3df2bda3b160755d047e87edb6c7d810d47b07d8638f640894ada64b4aa8e429c9fdbe1fd542387c8fb99106399bf04753b5ce070da7b31f8c2
data/.gitignore ADDED
@@ -0,0 +1,17 @@
1
+ *.gem
2
+ *.rbc
3
+ .bundle
4
+ .config
5
+ .yardoc
6
+ Gemfile.lock
7
+ InstalledFiles
8
+ _yardoc
9
+ coverage
10
+ doc/
11
+ lib/bundler/man
12
+ pkg
13
+ rdoc
14
+ spec/reports
15
+ test/tmp
16
+ test/version_tmp
17
+ tmp
data/Gemfile ADDED
@@ -0,0 +1,4 @@
1
+ source 'https://rubygems.org'
2
+
3
+ # Specify your gem's dependencies in gdoc.gemspec
4
+ gemspec
data/LICENSE.txt ADDED
@@ -0,0 +1,22 @@
1
+ Copyright (c) 2014 mj
2
+
3
+ MIT License
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining
6
+ a copy of this software and associated documentation files (the
7
+ "Software"), to deal in the Software without restriction, including
8
+ without limitation the rights to use, copy, modify, merge, publish,
9
+ distribute, sublicense, and/or sell copies of the Software, and to
10
+ permit persons to whom the Software is furnished to do so, subject to
11
+ the following conditions:
12
+
13
+ The above copyright notice and this permission notice shall be
14
+ included in all copies or substantial portions of the Software.
15
+
16
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
17
+ EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
18
+ MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
19
+ NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
20
+ LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
21
+ OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
22
+ WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
data/README.md ADDED
@@ -0,0 +1,29 @@
1
+ # Gdoc
2
+
3
+ TODO: Write a gem description
4
+
5
+ ## Installation
6
+
7
+ Add this line to your application's Gemfile:
8
+
9
+ gem 'gdoc'
10
+
11
+ And then execute:
12
+
13
+ $ bundle
14
+
15
+ Or install it yourself as:
16
+
17
+ $ gem install gdoc
18
+
19
+ ## Usage
20
+
21
+ TODO: Write usage instructions here
22
+
23
+ ## Contributing
24
+
25
+ 1. Fork it ( http://github.com/<my-github-username>/gdoc/fork )
26
+ 2. Create your feature branch (`git checkout -b my-new-feature`)
27
+ 3. Commit your changes (`git commit -am 'Add some feature'`)
28
+ 4. Push to the branch (`git push origin my-new-feature`)
29
+ 5. Create new Pull Request
data/Rakefile ADDED
@@ -0,0 +1 @@
1
+ require "bundler/gem_tasks"
data/bin/gdoc ADDED
@@ -0,0 +1,6 @@
1
+ #!/usr/bin/env ruby
2
+
3
+ require_relative '../lib/gdoc'
4
+
5
+ gen = Gdoc::Generate.new ARGV[1]
6
+ gen.to_md ARGV[0]
data/gdoc.gemspec ADDED
@@ -0,0 +1,23 @@
1
+ # coding: utf-8
2
+ lib = File.expand_path('../lib', __FILE__)
3
+ $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
4
+ require 'gdoc/version'
5
+
6
+ Gem::Specification.new do |spec|
7
+ spec.name = "gdoc"
8
+ spec.version = Gdoc::VERSION
9
+ spec.authors = ["mjason"]
10
+ spec.email = ["tywf91@gmail.com"]
11
+ spec.summary = %q{一个文档dsl}
12
+ spec.description = %q{简单的方式生成好看的md文档}
13
+ spec.homepage = "https://github.com/mjason/gdoc"
14
+ spec.license = "MIT"
15
+
16
+ spec.files = `git ls-files -z`.split("\x0")
17
+ spec.executables = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
18
+ spec.test_files = spec.files.grep(%r{^(test|spec|features)/})
19
+ spec.require_paths = ["lib"]
20
+
21
+ spec.add_development_dependency "bundler", "~> 1.5"
22
+ spec.add_development_dependency "rake"
23
+ end
data/lib/gdoc.rb ADDED
@@ -0,0 +1,5 @@
1
+ require "gdoc/version"
2
+
3
+ module Gdoc
4
+ autoload :Generate, 'gdoc/generate'
5
+ end
data/lib/gdoc/doc.rb ADDED
@@ -0,0 +1,7 @@
1
+ module Gdoc
2
+
3
+ class Doc
4
+ attr_accessor :name, :method, :ok, :params, :desc
5
+ end
6
+
7
+ end
@@ -0,0 +1,138 @@
1
+ # coding: utf-8
2
+ require 'json'
3
+
4
+ module Gdoc
5
+
6
+ class Generate
7
+
8
+ def initialize(out_dir)
9
+ @out_dir = out_dir
10
+ @doc_md = []
11
+ @api_list = []
12
+ @docs = ''
13
+ end
14
+
15
+ # dsl api
16
+ def root value
17
+ @root = value
18
+ end
19
+
20
+ def model value
21
+ @model = value
22
+ end
23
+
24
+ def url value
25
+ @url = value
26
+ end
27
+
28
+ def get url, &blk
29
+ gen_api_md 'get', url, &blk
30
+ end
31
+
32
+ def post url, &blk
33
+ gen_api_md 'post', url, &blk
34
+ end
35
+
36
+ def put url, &blk
37
+ gen_api_md 'put', url, &blk
38
+ end
39
+
40
+ def del url, &blk
41
+ gen_api_md 'delete', url, &blk
42
+ end
43
+
44
+ def patch url, &blk
45
+ gen_api_md 'patch', url, &blk
46
+ end
47
+
48
+ def import source
49
+ eval(File.read "./#{source}.gdoc")
50
+ create_file
51
+ end
52
+
53
+ def desc value
54
+ @desc = value
55
+ end
56
+
57
+ def params typ, json_
58
+ typ
59
+ @params = json_
60
+ end
61
+
62
+ def ok code, json_
63
+ @ok = json_
64
+ end
65
+
66
+ def headers(header_={})
67
+ @header = header_
68
+ end
69
+
70
+ def auth ison=false
71
+ @ison = ison
72
+ end
73
+
74
+ def json
75
+ @typ = 'application/json'
76
+ end
77
+
78
+ # output
79
+ def to_md source
80
+ eval(File.read "./#{source}.gdoc")
81
+ gen_api_list_md
82
+ end
83
+
84
+ def gen_api_list_md
85
+ file = File.open "#{@out_dir}/Home.md", 'w'
86
+ file.puts <<-md
87
+ # index
88
+ > api 列表
89
+
90
+ api 地址: #{@root}
91
+
92
+ #{@api_list.join "\n"}
93
+ md
94
+ file.close
95
+ end
96
+
97
+ def gen_api_md method, url, &blk
98
+ blk.call
99
+ @doc_md << <<-md
100
+ ### #{@root}#{@url}#{url}
101
+ > #{@desc}
102
+
103
+ auth: #{@ison}
104
+
105
+ headers:
106
+ ```javascript
107
+ #{JSON.pretty_generate (@header || {})}
108
+ ```
109
+
110
+ content-type: #{@typ}
111
+
112
+ method: #{method}
113
+
114
+ params:
115
+
116
+ ```javascript
117
+ #{JSON.pretty_generate @params}
118
+ ```
119
+
120
+ return:
121
+
122
+ ```
123
+ #{JSON.pretty_generate @ok}
124
+ ```
125
+ md
126
+ end
127
+
128
+ def create_file
129
+ file = File.open "#{@out_dir}/#{@model}.md", 'w'
130
+ file.puts @doc_md.join("\n* * *\n\n")
131
+ file.close
132
+ @doc_md = []
133
+ @api_list << "[#{@model}](./wiki/#{@model})"
134
+ end
135
+
136
+ end
137
+
138
+ end
@@ -0,0 +1,3 @@
1
+ module Gdoc
2
+ VERSION = "0.0.1"
3
+ end
metadata ADDED
@@ -0,0 +1,84 @@
1
+ --- !ruby/object:Gem::Specification
2
+ name: gdoc
3
+ version: !ruby/object:Gem::Version
4
+ version: 0.0.1
5
+ platform: ruby
6
+ authors:
7
+ - mjason
8
+ autorequire:
9
+ bindir: bin
10
+ cert_chain: []
11
+ date: 2014-04-17 00:00:00.000000000 Z
12
+ dependencies:
13
+ - !ruby/object:Gem::Dependency
14
+ name: bundler
15
+ requirement: !ruby/object:Gem::Requirement
16
+ requirements:
17
+ - - "~>"
18
+ - !ruby/object:Gem::Version
19
+ version: '1.5'
20
+ type: :development
21
+ prerelease: false
22
+ version_requirements: !ruby/object:Gem::Requirement
23
+ requirements:
24
+ - - "~>"
25
+ - !ruby/object:Gem::Version
26
+ version: '1.5'
27
+ - !ruby/object:Gem::Dependency
28
+ name: rake
29
+ requirement: !ruby/object:Gem::Requirement
30
+ requirements:
31
+ - - ">="
32
+ - !ruby/object:Gem::Version
33
+ version: '0'
34
+ type: :development
35
+ prerelease: false
36
+ version_requirements: !ruby/object:Gem::Requirement
37
+ requirements:
38
+ - - ">="
39
+ - !ruby/object:Gem::Version
40
+ version: '0'
41
+ description: "简单的方式生成好看的md文档"
42
+ email:
43
+ - tywf91@gmail.com
44
+ executables:
45
+ - gdoc
46
+ extensions: []
47
+ extra_rdoc_files: []
48
+ files:
49
+ - ".gitignore"
50
+ - Gemfile
51
+ - LICENSE.txt
52
+ - README.md
53
+ - Rakefile
54
+ - bin/gdoc
55
+ - gdoc.gemspec
56
+ - lib/gdoc.rb
57
+ - lib/gdoc/doc.rb
58
+ - lib/gdoc/generate.rb
59
+ - lib/gdoc/version.rb
60
+ homepage: https://github.com/mjason/gdoc
61
+ licenses:
62
+ - MIT
63
+ metadata: {}
64
+ post_install_message:
65
+ rdoc_options: []
66
+ require_paths:
67
+ - lib
68
+ required_ruby_version: !ruby/object:Gem::Requirement
69
+ requirements:
70
+ - - ">="
71
+ - !ruby/object:Gem::Version
72
+ version: '0'
73
+ required_rubygems_version: !ruby/object:Gem::Requirement
74
+ requirements:
75
+ - - ">="
76
+ - !ruby/object:Gem::Version
77
+ version: '0'
78
+ requirements: []
79
+ rubyforge_project:
80
+ rubygems_version: 2.2.2
81
+ signing_key:
82
+ specification_version: 4
83
+ summary: "一个文档dsl"
84
+ test_files: []