foreman_kernel_care 0.0.1

data/Rakefile

@@ -0,0 +1,47 @@
+#!/usr/bin/env rake
+begin
+  require 'bundler/setup'
+rescue LoadError
+  puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
+end
+begin
+  require 'rdoc/task'
+rescue LoadError
+  require 'rdoc/rdoc'
+  require 'rake/rdoctask'
+  RDoc::Task = Rake::RDocTask
+end
+
+RDoc::Task.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'ForemanKernelCare'
+  rdoc.options << '--line-numbers'
+  rdoc.rdoc_files.include('README.rdoc')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+APP_RAKEFILE = File.expand_path('../test/dummy/Rakefile', __FILE__)
+
+Bundler::GemHelper.install_tasks
+
+require 'rake/testtask'
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.libs << 'test'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = false
+end
+
+task default: :test
+
+begin
+  require 'rubocop/rake_task'
+  RuboCop::RakeTask.new
+rescue => _
+  puts 'Rubocop not loaded.'
+end
+
+task :default do
+  Rake::Task['rubocop'].execute
+end

data/app/helpers/concerns/foreman_kernel_care/hosts_helper_extensions.rb

@@ -0,0 +1,13 @@
+module ForemanKernelCare
+  module HostsHelperExtensions
+    extend ActiveSupport::Concern
+
+    included do
+      # execute callbacks
+    end
+
+    # create or overwrite instance methods...
+    def instance_method_name
+    end
+  end
+end

data/app/models/concerns/foreman_kernel_care/host_extensions.rb

@@ -0,0 +1,19 @@
+module ForemanKernelCare
+  module HostExtensions
+    extend ActiveSupport::Concern
+
+    included do
+      # execute callbacks
+    end
+
+    # create or overwrite instance methods...
+    def instance_method_name
+    end
+
+    module ClassMethods
+      # create or overwrite class methods...
+      def class_method_name
+      end
+    end
+  end
+end

data/app/models/concerns/foreman_kernel_care/host_managed_extensions.rb

@@ -0,0 +1,23 @@
+module ForemanKernelCare
+  module HostManagedExtensions
+    def import_tracer_profile(tracer_profile)
+      traces = []
+      tracer_profile.each do |trace, attributes|
+        next if attributes[:helper].blank?
+
+        next if trace == 'kernel' && kernelcare?
+
+        traces << { host_id: self.id, application: trace, helper: attributes[:helper], app_type: attributes[:type] }
+      end
+      host_traces.delete_all
+      Katello::HostTracer.import(traces, validate: false)
+      update_trace_status
+    end
+
+    protected
+
+    def kernelcare?
+      !installed_packages.select { |package| package.name == 'kernelcare' }.empty?
+    end
+  end
+end

data/app/views/dashboard/_foreman_kernel_care_widget.html.erb

@@ -0,0 +1,2 @@
+<h4 class="header ca"><%= _('ForemanKernelCare') %></h4>
+<%= _('Widget content') %>

data/config/routes.rb

@@ -0,0 +1,9 @@
+ForemanKernelCare::Engine.routes.draw do
+  get 'new_action', to: 'example#new_action', as: 'new_action'
+  get 'plugin_template_description', to: 'example#react_template_page_description'
+  get 'welcome', to: '/react#index', as: 'welcome'
+end
+
+Foreman::Application.routes.draw do
+  mount ForemanKernelCare::Engine, at: '/foreman_kernel_care'
+end

data/lib/foreman_kernel_care/engine.rb

@@ -0,0 +1,57 @@
+module ForemanKernelCare
+  class Engine < ::Rails::Engine
+    isolate_namespace ForemanKernelCare
+    engine_name 'foreman_kernel_care'
+
+    config.autoload_paths += Dir["#{config.root}/app/controllers/concerns"]
+    config.autoload_paths += Dir["#{config.root}/app/helpers/concerns"]
+    config.autoload_paths += Dir["#{config.root}/app/models/concerns"]
+    config.autoload_paths += Dir["#{config.root}/app/overrides"]
+
+    # Add any db migrations
+    initializer 'foreman_kernel_care.load_app_instance_data' do |app|
+      ForemanKernelCare::Engine.paths['db/migrate'].existent.each do |path|
+        app.config.paths['db/migrate'] << path
+      end
+    end
+
+    initializer 'foreman_kernel_care.register_plugin', :before => :finisher_hook do |_app|
+      Foreman::Plugin.register :foreman_kernel_care do
+        requires_foreman '>= 2.4.0'
+
+        # Add Global files for extending foreman-core components and routes
+        register_global_js_file 'global'
+
+        # Add a new role called 'Discovery' if it doesn't exist
+        role 'ForemanKernelCare', [:view_foreman_kernel_care]
+
+        # add dashboard widget
+        widget 'foreman_kernel_care_widget', name: N_('KernelCare widget'), sizex: 4, sizey: 1
+      end
+    end
+
+    # Include concerns in this config.to_prepare block
+    config.to_prepare do
+
+      begin
+        Host::Managed.send(:include, ForemanKernelCare::HostExtensions)
+        HostsHelper.send(:include, ForemanKernelCare::HostsHelperExtensions)
+        Katello::Concerns::HostManagedExtensions.send(:prepend, ForemanKernelCare::HostManagedExtensions)
+      rescue => e
+        Rails.logger.warn "ForemanKernelCare: skipping engine hook (#{e})"
+      end
+    end
+
+    rake_tasks do
+      Rake::Task['db:seed'].enhance do
+        ForemanKernelCare::Engine.load_seed
+      end
+    end
+
+    initializer 'foreman_kernel_care.register_gettext', after: :load_config_initializers do |_app|
+      locale_dir = File.join(File.expand_path('../../..', __FILE__), 'locale')
+      locale_domain = 'foreman_kernel_care'
+      Foreman::Gettext::Support.add_text_domain locale_domain, locale_dir
+    end
+  end
+end

data/lib/foreman_kernel_care/version.rb

@@ -0,0 +1,3 @@
+module ForemanKernelCare
+  VERSION = '0.0.1'.freeze
+end

data/lib/foreman_kernel_care.rb

@@ -0,0 +1,4 @@
+require 'foreman_kernel_care/engine'
+
+module ForemanKernelCare
+end

data/lib/tasks/foreman_kernel_care_tasks.rake

@@ -0,0 +1,48 @@
+require 'rake/testtask'
+
+# Tasks
+namespace :foreman_kernel_care do
+  namespace :example do
+    desc 'Example Task'
+    task task: :environment do
+      # Task goes here
+    end
+  end
+end
+
+# Tests
+namespace :test do
+  desc 'Test ForemanKernelCare'
+  Rake::TestTask.new(:foreman_kernel_care) do |t|
+    test_dir = File.expand_path('../../test', __dir__)
+    t.libs << 'test'
+    t.libs << test_dir
+    t.pattern = "#{test_dir}/**/*_test.rb"
+    t.verbose = true
+    t.warning = false
+  end
+end
+
+namespace :foreman_kernel_care do
+  task :rubocop do
+    begin
+      require 'rubocop/rake_task'
+      RuboCop::RakeTask.new(:rubocop_foreman_kernel_care) do |task|
+        task.patterns = ["#{ForemanKernelCare::Engine.root}/app/**/*.rb",
+                         "#{ForemanKernelCare::Engine.root}/lib/**/*.rb",
+                         "#{ForemanKernelCare::Engine.root}/test/**/*.rb"]
+      end
+    rescue
+      puts 'Rubocop not loaded.'
+    end
+
+    Rake::Task['rubocop_foreman_kernel_care'].invoke
+  end
+end
+
+Rake::Task[:test].enhance ['test:foreman_kernel_care']
+
+load 'tasks/jenkins.rake'
+if Rake::Task.task_defined?(:'jenkins:unit')
+  Rake::Task['jenkins:unit'].enhance ['test:foreman_kernel_care', 'foreman_kernel_care:rubocop']
+end

data/locale/Makefile

@@ -0,0 +1,60 @@
+#
+# Makefile for PO merging and MO generation. More info in the README.
+#
+# make all-mo (default) - generate MO files
+# make check - check translations using translate-tool
+# make tx-update - download and merge translations from Transifex
+# make clean - clean everything
+#
+DOMAIN = foreman_kernel_care
+VERSION = $(shell ruby -e 'require "rubygems";spec = Gem::Specification::load(Dir.glob("../*.gemspec")[0]);puts spec.version')
+POTFILE = $(DOMAIN).pot
+MOFILE = $(DOMAIN).mo
+POFILES = $(shell find . -name '$(DOMAIN).po')
+MOFILES = $(patsubst %.po,%.mo,$(POFILES))
+POXFILES = $(patsubst %.po,%.pox,$(POFILES))
+EDITFILES = $(patsubst %.po,%.edit.po,$(POFILES))
+
+%.mo: %.po
+	mkdir -p $(shell dirname $@)/LC_MESSAGES
+	msgfmt -o $(shell dirname $@)/LC_MESSAGES/$(MOFILE) $<
+
+# Generate MO files from PO files
+all-mo: $(MOFILES)
+
+# Check for malformed strings
+%.pox: %.po
+	msgfmt -c $<
+	pofilter --nofuzzy -t variables -t blank -t urls -t emails -t long -t newlines \
+		-t endwhitespace -t endpunc -t puncspacing -t options -t printf -t validchars --gnome $< > $@
+	cat $@
+	! grep -q msgid $@
+
+%.edit.po:
+	touch $@
+
+check: $(POXFILES)
+
+# Unify duplicate translations
+uniq-po:
+	for f in $(shell find ./ -name "*.po") ; do \
+		msguniq $$f -o $$f ; \
+	done
+
+tx-pull: $(EDITFILES)
+	tx pull -f
+	for f in $(EDITFILES) ; do \
+		sed -i 's/^\("Project-Id-Version: \).*$$/\1$(DOMAIN) $(VERSION)\\n"/' $$f; \
+	done
+
+tx-update: tx-pull
+	@echo
+	@echo Run rake plugin:gettext[$(DOMAIN)] from the Foreman installation, then make -C locale mo-files to finish
+	@echo
+
+mo-files: $(MOFILES)
+	git add $(POFILES) $(POTFILE) ../locale/*/LC_MESSAGES
+	git commit -m "i18n - pulling from tx"
+	@echo
+	@echo Changes commited!
+	@echo

data/locale/en/foreman_kernel_care.po

@@ -0,0 +1,19 @@
+# foreman_kernel_care
+#
+# This file is distributed under the same license as foreman_kernel_care.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: version 0.0.1\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2014-08-20 08:46+0100\n"
+"PO-Revision-Date: 2014-08-20 08:54+0100\n"
+"Last-Translator: Foreman Team <foreman-dev@googlegroups.com>\n"
+"Language-Team: Foreman Team <foreman-dev@googlegroups.com>\n"
+"Language: \n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=2; plural=(n != 1);\n"
+

data/locale/foreman_kernel_care.pot

@@ -0,0 +1,19 @@
+# foreman_kernel_care
+#
+# This file is distributed under the same license as foreman_kernel_care.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: version 0.0.1\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2014-08-20 08:46+0100\n"
+"PO-Revision-Date: 2014-08-20 08:46+0100\n"
+"Last-Translator: Foreman Team <foreman-dev@googlegroups.com>\n"
+"Language-Team: Foreman Team <foreman-dev@googlegroups.com>\n"
+"Language: \n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=INTEGER; plural=EXPRESSION;\n"
+

data/locale/gemspec.rb

@@ -0,0 +1,2 @@
+# Matches foreman_kernel_care.gemspec
+_('TODO: Description of ForemanKernelCare.')

data/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "foreman_kernel_care",
+  "version": "1.0.0",
+  "description": "DESCRIPTION",
+  "main": "index.js",
+  "scripts": {
+    "lint": "tfm-lint --plugin -d /webpack",
+    "test": "tfm-test --config jest.config.js",
+    "test:watch": "tfm-test --plugin --watchAll",
+    "test:current": "tfm-test --plugin --watch",
+    "publish-coverage": "tfm-publish-coverage",
+    "stories": "tfm-stories --plugin",
+    "stories:build": "tfm-build-stories --plugin",
+    "create-react-component": "yo react-domain"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/theforeman/foreman_kernel_care.git"
+  },
+  "bugs": {
+    "url": "http://projects.theforeman.org/projects/foreman_kernel_care/issues"
+  },
+  "peerDependencies": {
+    "@theforeman/vendor": ">= 6.0.0"
+  },
+  "dependencies": {
+    "react-intl": "^2.8.0"
+  },
+  "devDependencies": {
+    "@babel/core": "^7.7.0",
+    "@sheerun/mutationobserver-shim": "^0.3.3",
+    "@theforeman/builder": "^6.0.0",
+    "@theforeman/eslint-plugin-foreman": "6.0.0",
+    "@theforeman/find-foreman": "^4.8.0",
+    "@theforeman/stories": "^7.0.0",
+    "@theforeman/test": "^8.0.0",
+    "@theforeman/vendor-dev": "^6.0.0",
+    "babel-eslint": "^10.0.3",
+    "eslint": "^6.7.2",
+    "prettier": "^1.19.1",
+    "stylelint-config-standard": "^18.0.0",
+    "stylelint": "^9.3.0"
+  }
+}

data/test/factories/foreman_kernel_care_factories.rb

@@ -0,0 +1,5 @@
+FactoryBot.define do
+  factory :host do
+    name 'foreman_kernel_care'
+  end
+end

data/test/test_plugin_helper.rb

@@ -0,0 +1,6 @@
+# This calls the main test_helper in Foreman-core
+require 'test_helper'
+
+# Add plugin to FactoryBot's paths
+FactoryBot.definition_file_paths << File.join(File.dirname(__FILE__), 'factories')
+FactoryBot.reload

data/test/unit/foreman_kernel_care_test.rb

@@ -0,0 +1,11 @@
+require 'test_plugin_helper'
+
+class ForemanPluginTemplateTest < ActiveSupport::TestCase
+  setup do
+    User.current = User.find_by_login 'admin'
+  end
+
+  test 'the truth' do
+    assert true
+  end
+end

data/webpack/global_index.js

@@ -0,0 +1,17 @@
+import { registerReducer } from 'foremanReact/common/MountingService';
+import { addGlobalFill } from 'foremanReact/components/common/Fill/GlobalFill';
+import { registerRoutes } from 'foremanReact/routes/RoutingService';
+import Routes from './src/Router/routes'
+import reducers from './src/reducers';
+
+// register reducers
+Object.entries(reducers).forEach(([key, reducer]) =>
+    registerReducer(key, reducer)
+);
+
+// register client routes
+registerRoutes('PluginTemplate', Routes);
+
+// register fills for extending foreman core
+// http://foreman.surge.sh/?path=/docs/introduction-slot-and-fill--page
+addGlobalFill('<slotId>', '<fillId>', <div key='plugin-template-example' />, 300);

data/webpack/global_test_setup.js

@@ -0,0 +1,11 @@
+// runs before each test to make sure console.error output will
+// fail a test (i.e. default PropType missing). Check the error
+// output and traceback for actual error.
+global.console.error = (error, stack) => {
+    /* eslint-disable-next-line no-console */
+    if (stack) console.log(stack); // Prints out original stack trace
+    throw new Error(error);
+};
+
+// Increase jest timeout as some tests using multiple http mocks can time out on CI systems.
+jest.setTimeout(10000);

data/webpack/index.js

@@ -0,0 +1,8 @@
+import componentRegistry from 'foremanReact/components/componentRegistry';
+import ExtendedEmptyState from './src/Components/EmptyState/ExtendedEmptyState';
+
+// register components for erb mounting
+componentRegistry.register({
+    name: 'ExtendedEmptyState',
+    type: ExtendedEmptyState,
+});

data/webpack/src/Components/EmptyState/Constants.js

@@ -0,0 +1,2 @@
+export const GENERAL_ACTION_TYPE = '[PLUGIN_TEMPLATE] GENERAL ACTION';
+export const FOREMAN_STORYBOOK = 'https://foreman.surge.sh';

data/webpack/src/Components/EmptyState/EmptyStateReducer.js

@@ -0,0 +1,19 @@
+// This is an example for a generic redux's reducer
+// Reducers should be registered to foreman-core
+// For a further registration demonstration, have a look in `webpack/global_index.js` 
+
+import Immutable from 'seamless-immutable';
+import { GENERAL_ACTION_TYPE } from './Constants';
+
+const initialState = Immutable({});
+
+export default (state = initialState, action) => {
+  const { payload } = action;
+
+  switch (action.type) {
+    case GENERAL_ACTION_TYPE:
+      return state.set('generalProprty', payload);
+    default:
+      return state;
+  }
+};

data/webpack/src/Components/EmptyState/ExtendedEmptyState.js

@@ -0,0 +1,43 @@
+import React from 'react';
+import { Button, Alert } from '@patternfly/react-core';
+import EmptyState from 'foremanReact/components/common/EmptyState/EmptyStatePattern';
+import SkeletonLoader from 'foremanReact/components/common/SkeletonLoader';
+import PropTypes from 'prop-types';
+
+import { STATUS } from 'foremanReact/constants'
+import { useAPI } from 'foremanReact/common/hooks/API/APIHooks'
+import { translate as __ } from 'foremanReact/common/I18n';
+import { FOREMAN_STORYBOOK } from './Constants';
+
+const ExtendedEmptyState = ({ header }) => {
+  // AJAX request using useAPI hook
+  const { response: { description }, status } = useAPI('get', '/foreman_kernel_care/plugin_template_description')
+  
+
+  const storybookBtn = (
+    <Button onClick={() => window.open(FOREMAN_STORYBOOK, '_blank')}>
+      Storybook
+    </Button>
+  );
+
+  switch (status) {
+    case STATUS.ERROR:
+      return (<Alert variant="danger" title={__("Loading description has failed")} />);
+    case STATUS.RESOLVED: return (
+      <EmptyState
+        icon="add-circle-o"
+        action={storybookBtn}
+        header={header}
+        description={description}
+        documentation={false}
+      />
+    )
+    default:
+      return (<SkeletonLoader isLoading={status === STATUS.PENDING} count={5} />);
+  }
+};
+ExtendedEmptyState.PropTypes = {
+  header: PropTypes.string.isRequired
+};
+
+export default ExtendedEmptyState;

data/webpack/src/Components/EmptyState/__tests__/ExtendedEmptyState.test.js

@@ -0,0 +1,37 @@
+// Tests work with react-testing-library or enzyme
+// This test uses react testing library
+// https://testing-library.com/docs/react-testing-library/api
+
+// For more information, test utils, and snapshots testing examples:
+// https://github.com/theforeman/foreman-js/tree/master/packages/test
+
+
+import React from 'react';
+import { createStore, applyMiddleware, combineReducers } from 'redux';
+import { render, waitFor, screen } from '@testing-library/react'
+import { Provider } from 'react-redux';
+
+import { reducers as APIReducer } from 'foremanReact/redux/API';
+import { middlewares } from 'foremanReact/redux/middlewares';
+import APIHelper from 'foremanReact/redux/API/API';
+import ExtendedEmptyState from '../ExtendedEmptyState';
+
+jest.mock('foremanReact/redux/API/API');
+
+const reducers = combineReducers(APIReducer);
+const store = createStore(reducers, applyMiddleware(...middlewares));
+const wrapper = ({ children }) => (
+  <Provider store={store}>{children}</Provider>
+);
+describe('foreman plugin template', () => {
+  it('should render an error alert', async () => {
+    APIHelper.get.mockRejectedValue({ error: new Error() });
+    render(<ExtendedEmptyState />, { wrapper });
+    await waitFor(() => expect(screen.getByText('Loading description has failed')).toBeInTheDocument());
+  });
+  it('should render an empty state with custom description', async () => {
+    APIHelper.get.mockResolvedValue({ data: { description: 'some description' } });
+    render(<ExtendedEmptyState />, { wrapper });
+    await waitFor(() => expect(screen.getByText('some description')).toBeInTheDocument());
+  });
+});

data/webpack/src/Extends/index.js

@@ -0,0 +1,15 @@
+// This is an example of extending foreman-core's component via slot&fill
+// http://foreman.surge.sh/?path=/docs/introduction-slot-and-fill--page
+/*
+import React from 'react';
+import { addGlobalFill } from 'foremanReact/components/common/Fill/GlobalFill';
+
+addGlobalFill('slotId', 'fillId', <SomeComponent key="some-key" />, 300);
+
+addGlobalFill(
+  'slotId',
+  'fillId',
+  { someProp: 'this is an override prop' },
+  300
+);
+*/

data/webpack/src/Router/WelcomePage/Welcome.js

@@ -0,0 +1,9 @@
+import React from 'react';
+import ExtendedEmptyState from '../../Components/EmptyState/ExtendedEmptyState';
+import { translate as __ } from 'foremanReact/common/I18n';
+
+const WelcomePage = () => (
+  <ExtendedEmptyState header={__("Welcome to the plugin template")} />
+);
+
+export default WelcomePage;

data/webpack/src/Router/WelcomePage/index.js

@@ -0,0 +1 @@
+export { default } from './Welcome';

data/webpack/src/Router/routes.js

@@ -0,0 +1,12 @@
+import React from 'react';
+import WelcomePage from './WelcomePage';
+
+const routes = [
+  {
+    path: '/foreman_kernel_care/welcome',
+    exact: true,
+    render: (props) => <WelcomePage {...props} />,
+  },
+];
+
+export default routes;

data/webpack/src/reducers.js

@@ -0,0 +1,10 @@
+import { combineReducers } from 'redux';
+import EmptyStateReducer from './Components/EmptyState/EmptyStateReducer';
+
+const reducers = {
+  foremanKernelCare: combineReducers({
+    emptyState: EmptyStateReducer,
+  }),
+};
+
+export default reducers;

data/webpack/test_setup.js

@@ -0,0 +1,17 @@
+import 'core-js/shim';
+import 'regenerator-runtime/runtime';
+import MutationObserver from '@sheerun/mutationobserver-shim';
+
+import { configure } from 'enzyme';
+import Adapter from 'enzyme-adapter-react-16';
+
+configure({ adapter: new Adapter() });
+
+// Mocking translation function
+global.__ = text => text; // eslint-disable-line
+
+// Mocking locales to prevent unnecessary fallback messages
+window.locales = { en: { domain: 'app', locale_data: { app: { '': {} } } } };
+
+// see https://github.com/testing-library/dom-testing-library/releases/tag/v7.0.0
+window.MutationObserver = MutationObserver;