origen_app_generators 0.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (69) hide show
  1. checksums.yaml +7 -0
  2. data/config/application.rb +146 -0
  3. data/config/commands.rb +75 -0
  4. data/config/environment.rb +1 -0
  5. data/config/users.rb +19 -0
  6. data/config/version.rb +8 -0
  7. data/lib/origen_app_generators/application.rb +62 -0
  8. data/lib/origen_app_generators/base.rb +201 -0
  9. data/lib/origen_app_generators/generic_application.rb +15 -0
  10. data/lib/origen_app_generators/generic_plugin.rb +15 -0
  11. data/lib/origen_app_generators/new.rb +137 -0
  12. data/lib/origen_app_generators/plugin.rb +39 -0
  13. data/lib/origen_app_generators/test_engineering/generic_test_block.rb +68 -0
  14. data/lib/origen_app_generators.rb +67 -0
  15. data/lib/tasks/app_generators.rake +50 -0
  16. data/lib/tasks/boot.rb +42 -0
  17. data/templates/app_generators/application/Gemfile +12 -0
  18. data/templates/app_generators/application/Rakefile +10 -0
  19. data/templates/app_generators/application/config/application.rb +110 -0
  20. data/templates/app_generators/application/config/commands.rb +76 -0
  21. data/templates/app_generators/application/config/environment.rb +4 -0
  22. data/templates/app_generators/application/config/users.rb +29 -0
  23. data/templates/app_generators/application/config/version.rb +8 -0
  24. data/templates/app_generators/application/doc/history +0 -0
  25. data/templates/app_generators/application/lib/app.rake +6 -0
  26. data/templates/app_generators/application/lib/module.rb +17 -0
  27. data/templates/app_generators/application/lib/top_level.rb +12 -0
  28. data/templates/app_generators/application/spec/spec_helper.rb +98 -0
  29. data/templates/app_generators/application/target/debug.rb +8 -0
  30. data/templates/app_generators/application/target/production.rb +9 -0
  31. data/templates/app_generators/application/templates/web/archive.md.erb +11 -0
  32. data/templates/app_generators/application/templates/web/contact.md.erb +36 -0
  33. data/templates/app_generators/application/templates/web/docs/environment/definitions.md.erb +17 -0
  34. data/templates/app_generators/application/templates/web/docs/environment/installation.md.erb +22 -0
  35. data/templates/app_generators/application/templates/web/docs/environment/introduction.md.erb +5 -0
  36. data/templates/app_generators/application/templates/web/index.md.erb +12 -0
  37. data/templates/app_generators/application/templates/web/layouts/_basic.html.erb +14 -0
  38. data/templates/app_generators/application/templates/web/layouts/_doc.html.erb +35 -0
  39. data/templates/app_generators/application/templates/web/partials/_navbar.html.erb +23 -0
  40. data/templates/app_generators/application/templates/web/references.md.erb +39 -0
  41. data/templates/app_generators/application/templates/web/release_notes.md.erb +5 -0
  42. data/templates/app_generators/new/generator.rb +78 -0
  43. data/templates/app_generators/new/info.md.erb +9 -0
  44. data/templates/app_generators/plugin/Gemfile +12 -0
  45. data/templates/app_generators/plugin/config/development.rb +12 -0
  46. data/templates/app_generators/plugin/gemspec.rb +36 -0
  47. data/templates/app_generators/plugin/templates/web/index.md.erb +60 -0
  48. data/templates/app_generators/plugin/templates/web/partials/_navbar.html.erb +22 -0
  49. data/templates/app_generators/test_engineering/generic_test_block/lib/interface.rb +6 -0
  50. data/templates/app_generators/test_engineering/generic_test_block/program/prb1.rb +9 -0
  51. data/templates/app_generators/test_engineering/generic_test_block/target/j750.rb +10 -0
  52. data/templates/app_generators/test_engineering/generic_test_block/target/ultraflex.rb +10 -0
  53. data/templates/app_generators/test_engineering/generic_test_block/target/v93k.rb +10 -0
  54. data/templates/web/_history.md +166 -0
  55. data/templates/web/archive.md.erb +11 -0
  56. data/templates/web/contact.md.erb +36 -0
  57. data/templates/web/docs/developers/creating.md.erb +290 -0
  58. data/templates/web/docs/environment/installation.md.erb +12 -0
  59. data/templates/web/docs/environment/introduction.md.erb +10 -0
  60. data/templates/web/example.md.erb +73 -0
  61. data/templates/web/index.md.erb +48 -0
  62. data/templates/web/layouts/_basic.html.erb +18 -0
  63. data/templates/web/layouts/_doc.html.erb +37 -0
  64. data/templates/web/origen_app_generators/application.md.erb +116 -0
  65. data/templates/web/origen_app_generators/plugin.md.erb +29 -0
  66. data/templates/web/origen_app_generators/test_engineering/generic_test_block.md.erb +16 -0
  67. data/templates/web/partials/_navbar.html.erb +22 -0
  68. data/templates/web/release_notes.md.erb +5 -0
  69. metadata +126 -0
@@ -0,0 +1,18 @@
1
+ ---
2
+ layout: bootstrap
3
+ title: <%= options[:title] || Origen.app.namespace %>
4
+ ---
5
+ <%= render "templates/web/partials/navbar.html", tab: options[:tab] %>
6
+
7
+ <div class="row">
8
+ %# The markdown attribute is important if you are going to include content written
9
+ %# in markdown, without this is will be included verbatim
10
+ <div class="span12" markdown="1">
11
+ <%= yield %>
12
+
13
+ % if !options.has_key?(:yammer_comments) || options[:yammer_comments]
14
+ <%= yammer_comments %>
15
+ % end
16
+
17
+ </div>
18
+ </div>
@@ -0,0 +1,37 @@
1
+ ---
2
+ layout: bootstrap
3
+ title: <%= options[:title] || "#{Origen.app.namespace} - Docs" %>
4
+ ---
5
+ <%= render "templates/web/partials/navbar.html", tab: :docs %>
6
+ % s = {}
7
+
8
+ %# This creates the index on the left of your doc pages
9
+ %#
10
+ %# Naming of the keys is very important and must be of the form:
11
+ %# <section>_<page> with no other underscores
12
+ %# Origen will then look for the corresponding page in:
13
+ %# templates/web/docs/<section>/<page>.md.erb
14
+ %#
15
+ %# See here for more info: http://origen.freescale.net/doc_helpers/latest/examples/searchable/intro/
16
+
17
+ % s["Environment"] = {
18
+ % environment_introduction: "Introduction",
19
+ % environment_installation: "Installation",
20
+ % }
21
+ % s["Developers"] = {
22
+ % developers_creating: "Creating a Generator",
23
+ % }
24
+ %
25
+ %# Define additional sections as required, e.g.
26
+ %# s["Registers"] = {
27
+ %# registers_map: "Register Map",
28
+ %# }
29
+
30
+
31
+ % render "doc_helpers/searchable.html", options.merge(:index => s) do
32
+
33
+ <%= yield %>
34
+
35
+ <%= yammer_comments %>
36
+
37
+ % end
@@ -0,0 +1,116 @@
1
+ % render "layouts/basic.html" do
2
+
3
+ ### OrigenAppGenerators
4
+
5
+ ## Generic Application
6
+
7
+ Builds a generic Origen application shell that has no specific use case in mind.
8
+
9
+ It will build the following application structure:
10
+
11
+ ~~~text
12
+ |-- config
13
+ | |-- application.rb
14
+ | |-- commands.rb
15
+ | |-- environment.rb
16
+ | |-- users.rb
17
+ | |-- version.rb
18
+ |-- doc
19
+ | |--history
20
+ |-- lib
21
+ | |-- app_name
22
+ | | |-- top_level.rb
23
+ | |-- app_name.rb
24
+ | |-- tasks
25
+ | |-- app_name.rake
26
+ |-- spec
27
+ | |-- spec_helper.rb
28
+ |-- log
29
+ |-- output
30
+ |-- targets
31
+ | |-- debug.rb
32
+ | |-- default.rb
33
+ | |-- production.rb
34
+ |-- templates
35
+ | |-- web
36
+ |-- Gemfile
37
+ |-- Rakefile
38
+ ~~~
39
+
40
+ **config**
41
+
42
+ Holds all configuration information for your application
43
+
44
+ **config/application.rb**
45
+
46
+ This is the main configuration file where the behavior of Origen can be tailored
47
+ to the needs of your application. The default settings are usually sufficient
48
+ until your application becomes more advanced.
49
+
50
+ **config/commands.rb**
51
+
52
+ Custom origen commands can be added to your application, this is the preferred
53
+ way of distributing any scripts required to support your application to your
54
+ users. See the [command guide](http://origen.freescale.net/origen/latest/guides/custom/commands/)
55
+ for details.
56
+
57
+ **config/environment.rb**
58
+
59
+ This file will be called by Origen to load your application environment, any files
60
+ that you add to the lib directory should be loaded from here.
61
+
62
+ **config/users.rb**
63
+
64
+ Define your application users here, this is basically your mailing list for
65
+ release notices.
66
+
67
+ **config/version.rb**
68
+
69
+ Defines the current application version. This file is managed by Origen via the
70
+ 'origen rc tag' command and should generally never be edited by hand.
71
+
72
+ **doc**
73
+
74
+ Any documentation related to your application can be stored here.
75
+
76
+ **doc/history**
77
+
78
+ A rolling log of your application tags and release notes is maintained here. A
79
+ new entry is generated every time the 'origen rc tag' command is run. This file is
80
+ pre-formatted to look good when rendered as a web page.
81
+
82
+ **lib**
83
+
84
+ All of your application models and logic should go in here. This folder is
85
+ already added to Ruby's load path by Origen. Sub-folders can be used as desired
86
+ to keep things organized. The contents of this folder will be accessible by
87
+ any other applications which import this application.
88
+
89
+ **log**
90
+
91
+ All log output generated by Origen will be placed in here. There is a log containing
92
+ the output from the last origen invocation and a rolling log from all previous
93
+ runs.
94
+
95
+ **output**
96
+
97
+ By default all generated or compiled output will be placed in here.
98
+
99
+ **target**
100
+
101
+ A target defines which silicon design and/or test platform is being targeting
102
+ by the generated content. All target definitions live in here.
103
+
104
+ **templates**
105
+
106
+ All templates used by the application should reside here, normally in sub-directories to separate
107
+ them by type - e.g. templates/j750, templates/bench_code, templates/rtl, etc.
108
+
109
+ **templates/web**
110
+
111
+ Web based documentation of your project should reside here. Origen makes it easy
112
+ to produce dynamic documentation based on your application target
113
+ configurations. See http://origen.freescale.net for an example of the kind of
114
+ documentation that can be produced.
115
+
116
+ % end
@@ -0,0 +1,29 @@
1
+ % render "layouts/basic.html" do
2
+
3
+ ### OrigenAppGenerators
4
+
5
+ ## Generic Plugin
6
+
7
+ Builds a generic Origen plugin shell that has no specific use case in mind.
8
+
9
+ The generated application is very similar to the [Generic Application](<%= path "origen_app_generators/application" %>),
10
+ but with the following additional files:
11
+
12
+ ~~~text
13
+ |-- config
14
+ | |-- development.rb
15
+ |-- app_name.gemspec
16
+ ~~~
17
+
18
+ Some file content may be slightly different to that for an application
19
+ and it also has a different web doc structure to reflect the goal
20
+ for all plugins to have consistent and snappy documentation.
21
+
22
+ **config/development.rb**
23
+
24
+ Similar to environment.rb this file can be used by plugins to require private
25
+ files for the purposes of testing or for use in the development environment.
26
+ Only files loaded by environment.rb will be available to applications importing
27
+ the plugin.
28
+
29
+ % end
@@ -0,0 +1,16 @@
1
+ % render "layouts/basic.html" do
2
+
3
+ ### OrigenAppGenerators
4
+
5
+ ## Generic Test Block
6
+
7
+ This generates a customized version of the [Generic Plugin](<%= path "origen_app_generators/plugin" %>).
8
+
9
+ At present this builds essentially the same as a generic plugin, but in future it will be
10
+ enhanced with some domain specific configuration and added logic.
11
+
12
+ Generally this is intended to be a shell for a test block that is an Origen plugin designed to
13
+ work with a top-level BOM/product-specific application.
14
+
15
+ % end
16
+
@@ -0,0 +1,22 @@
1
+ <div class="navbar navbar-inverse navbar-fixed-top">
2
+ <div class="navbar-inner">
3
+ <div class="container">
4
+ <a class="btn btn-navbar" data-toggle="collapse" data-target=".nav-collapse">
5
+ <span class="icon-bar"></span>
6
+ <span class="icon-bar"></span>
7
+ <span class="icon-bar"></span>
8
+ </a>
9
+ <a class="brand" href="<%= path "/" %>">Home</a>
10
+ <div class="nav-collapse collapse">
11
+ <ul class="nav">
12
+ <li class="<%= options[:tab] == :docs ? 'active' : '' %>"><a href="<%= path("/docs/environment/introduction") %>">Docs</a></li>
13
+ <li class="<%= options[:tab] == :api ? 'active' : '' %>"><a href="<%= path "/api/" %>">API</a></li>
14
+ <li class="<%= options[:tab] == :archive ? 'active' : '' %>"><a href="<%= path "/archive" %>">Archive</a></li>
15
+ <li class="<%= options[:tab] == :release ? 'active' : '' %>"><a href="<%= path "/release_notes" %>">Release Notes</a></li>
16
+ <li class="<%= options[:tab] == :contact ? 'active' : '' %>"><a href="<%= path "/contact" %>">Contact</a></li>
17
+ </ul>
18
+ <%= import "origen/web/logo.html" %>
19
+ </div><!--/.nav-collapse -->
20
+ </div>
21
+ </div>
22
+ </div>
@@ -0,0 +1,5 @@
1
+ % render "layouts/basic.html", tab: :release, yammer_comments: false do
2
+
3
+ <%= render "#{Origen.root}/doc/history" %>
4
+
5
+ % end
metadata ADDED
@@ -0,0 +1,126 @@
1
+ --- !ruby/object:Gem::Specification
2
+ name: origen_app_generators
3
+ version: !ruby/object:Gem::Version
4
+ version: 0.0.2
5
+ platform: ruby
6
+ authors:
7
+ - Stephen McGinty
8
+ autorequire:
9
+ bindir: bin
10
+ cert_chain: []
11
+ date: 2015-06-24 00:00:00.000000000 Z
12
+ dependencies:
13
+ - !ruby/object:Gem::Dependency
14
+ name: origen
15
+ requirement: !ruby/object:Gem::Requirement
16
+ requirements:
17
+ - - ">="
18
+ - !ruby/object:Gem::Version
19
+ version: 0.0.3
20
+ type: :runtime
21
+ prerelease: false
22
+ version_requirements: !ruby/object:Gem::Requirement
23
+ requirements:
24
+ - - ">="
25
+ - !ruby/object:Gem::Version
26
+ version: 0.0.3
27
+ description:
28
+ email:
29
+ - stephen.f.mcginty@gmail.com
30
+ executables: []
31
+ extensions: []
32
+ extra_rdoc_files: []
33
+ files:
34
+ - config/application.rb
35
+ - config/commands.rb
36
+ - config/environment.rb
37
+ - config/users.rb
38
+ - config/version.rb
39
+ - lib/origen_app_generators.rb
40
+ - lib/origen_app_generators/application.rb
41
+ - lib/origen_app_generators/base.rb
42
+ - lib/origen_app_generators/generic_application.rb
43
+ - lib/origen_app_generators/generic_plugin.rb
44
+ - lib/origen_app_generators/new.rb
45
+ - lib/origen_app_generators/plugin.rb
46
+ - lib/origen_app_generators/test_engineering/generic_test_block.rb
47
+ - lib/tasks/app_generators.rake
48
+ - lib/tasks/boot.rb
49
+ - templates/app_generators/application/Gemfile
50
+ - templates/app_generators/application/Rakefile
51
+ - templates/app_generators/application/config/application.rb
52
+ - templates/app_generators/application/config/commands.rb
53
+ - templates/app_generators/application/config/environment.rb
54
+ - templates/app_generators/application/config/users.rb
55
+ - templates/app_generators/application/config/version.rb
56
+ - templates/app_generators/application/doc/history
57
+ - templates/app_generators/application/lib/app.rake
58
+ - templates/app_generators/application/lib/module.rb
59
+ - templates/app_generators/application/lib/top_level.rb
60
+ - templates/app_generators/application/spec/spec_helper.rb
61
+ - templates/app_generators/application/target/debug.rb
62
+ - templates/app_generators/application/target/production.rb
63
+ - templates/app_generators/application/templates/web/archive.md.erb
64
+ - templates/app_generators/application/templates/web/contact.md.erb
65
+ - templates/app_generators/application/templates/web/docs/environment/definitions.md.erb
66
+ - templates/app_generators/application/templates/web/docs/environment/installation.md.erb
67
+ - templates/app_generators/application/templates/web/docs/environment/introduction.md.erb
68
+ - templates/app_generators/application/templates/web/index.md.erb
69
+ - templates/app_generators/application/templates/web/layouts/_basic.html.erb
70
+ - templates/app_generators/application/templates/web/layouts/_doc.html.erb
71
+ - templates/app_generators/application/templates/web/partials/_navbar.html.erb
72
+ - templates/app_generators/application/templates/web/references.md.erb
73
+ - templates/app_generators/application/templates/web/release_notes.md.erb
74
+ - templates/app_generators/new/generator.rb
75
+ - templates/app_generators/new/info.md.erb
76
+ - templates/app_generators/plugin/Gemfile
77
+ - templates/app_generators/plugin/config/development.rb
78
+ - templates/app_generators/plugin/gemspec.rb
79
+ - templates/app_generators/plugin/templates/web/index.md.erb
80
+ - templates/app_generators/plugin/templates/web/partials/_navbar.html.erb
81
+ - templates/app_generators/test_engineering/generic_test_block/lib/interface.rb
82
+ - templates/app_generators/test_engineering/generic_test_block/program/prb1.rb
83
+ - templates/app_generators/test_engineering/generic_test_block/target/j750.rb
84
+ - templates/app_generators/test_engineering/generic_test_block/target/ultraflex.rb
85
+ - templates/app_generators/test_engineering/generic_test_block/target/v93k.rb
86
+ - templates/web/_history.md
87
+ - templates/web/archive.md.erb
88
+ - templates/web/contact.md.erb
89
+ - templates/web/docs/developers/creating.md.erb
90
+ - templates/web/docs/environment/installation.md.erb
91
+ - templates/web/docs/environment/introduction.md.erb
92
+ - templates/web/example.md.erb
93
+ - templates/web/index.md.erb
94
+ - templates/web/layouts/_basic.html.erb
95
+ - templates/web/layouts/_doc.html.erb
96
+ - templates/web/origen_app_generators/application.md.erb
97
+ - templates/web/origen_app_generators/plugin.md.erb
98
+ - templates/web/origen_app_generators/test_engineering/generic_test_block.md.erb
99
+ - templates/web/partials/_navbar.html.erb
100
+ - templates/web/release_notes.md.erb
101
+ homepage: http://origen-sdk.org/origen_app_generators
102
+ licenses:
103
+ - LGPL-3
104
+ metadata: {}
105
+ post_install_message:
106
+ rdoc_options: []
107
+ require_paths:
108
+ - lib
109
+ required_ruby_version: !ruby/object:Gem::Requirement
110
+ requirements:
111
+ - - ">="
112
+ - !ruby/object:Gem::Version
113
+ version: 1.9.3
114
+ required_rubygems_version: !ruby/object:Gem::Requirement
115
+ requirements:
116
+ - - ">="
117
+ - !ruby/object:Gem::Version
118
+ version: 1.8.11
119
+ requirements: []
120
+ rubyforge_project:
121
+ rubygems_version: 2.2.2
122
+ signing_key:
123
+ specification_version: 4
124
+ summary: Origen application generators
125
+ test_files: []
126
+ has_rdoc: