| # |
| # Post or edit a report or resolution |
| # |
| # For new resolutions, allow entry of title, but not commit message |
| # For everything else, allow modification of commit message, but not title |
| |
| class Post < Vue |
| def initialize |
| @button = @@button.text |
| @disabled = false |
| @alerted = false |
| @edited = false |
| @pmcs = [] |
| @roster = [] |
| @parent = nil |
| end |
| |
| # default attributes for the button associated with this form |
| def self.button |
| { |
| text: 'post report', |
| class: 'btn_primary', |
| disabled: Server.offline, |
| data_toggle: 'modal', |
| data_target: '#post-report-form' |
| } |
| end |
| |
| def render |
| _ModalDialog.wide_form.post_report_form! color: 'commented' do |
| if @button == 'add item' |
| _h4 'Select Item Type' |
| |
| _ul.new_item_type do |
| _li do |
| _button.btn.btn_primary 'Change Chair', onClick: selectItem |
| _ '- change chair for an existing PMC' |
| end |
| |
| _li do |
| _button.btn.btn_primary 'Establish Project', onClick: selectItem |
| _ '- direct to TLP project and subproject to TLP' |
| end |
| |
| _li do |
| _button.btn.btn_primary 'Terminate Project', onClick: selectItem |
| _ '- move a project to the attic' |
| end |
| |
| _li do |
| _button.btn.btn_primary 'New Resolution', onClick: selectItem |
| _ '- free form entry of a new resolution' |
| end |
| |
| _li do |
| _button.btn.btn_info 'Out of Cycle Report', onClick: selectItem |
| _ '- report from a PMC not currently on the agenda for this month' |
| end |
| |
| _li do |
| _button.btn.btn_success 'Discussion Item', onClick: selectItem |
| _ '- add a discussion item to the agenda' |
| end |
| end |
| |
| _button.btn_default 'Cancel', data_dismiss: 'modal' |
| |
| elsif @button == 'Change Chair' |
| _h4 'Change Chair Resolution' |
| |
| _div.form_group do |
| _label 'PMC', for: 'change-chair-pmc' |
| _select.form_control.change_chair_pmc!( |
| onChange: ->(event) {chair_pmc_change(event.target.value)} |
| ) do |
| @pmcs.each {|pmc| _option pmc} |
| end |
| end |
| |
| _div.form_group do |
| _label 'Outgoing Chair', for: 'outgoing-chair' |
| _input.form_control.outgoing_chair! value: @outgoing_chair, |
| disabled: true |
| end |
| |
| _div.form_group do |
| _label 'Incoming Chair', for: 'incoming-chair' |
| _select.form_control.incoming_chair! do |
| @pmc_members.each do |person| |
| _option person.name, value: person.id, |
| selected: person.id == User.id |
| end |
| end |
| end |
| |
| _button.btn_default 'Cancel', data_dismiss: 'modal' |
| _button.btn_primary 'Draft', disabled: @disabled, |
| onClick: draft_chair_change_resolution |
| |
| elsif @button == 'Establish Project' |
| _h4 'Establish Project Resolution' |
| |
| _div.form_group do |
| _label 'PMC name', for: 'establish-pmc' |
| _input.form_control.establish_pmc! value: @pmcname |
| end |
| |
| _div.form_group do |
| # capitalize pmcname |
| pmcname = @pmcname |
| if @pmcname and @pmcname !~ /[A-Z]/ |
| pmcname.gsub!(/\b\w/) {|c| c.upcase()} |
| end |
| |
| _label 'Complete this sentence:', for: 'establish-description' |
| _ " Apache #{pmcname} consists of software related to" if pmcname |
| |
| _textarea.form_control.establish_description! value: @pmcdesc, |
| disabled: !pmcname |
| end |
| |
| _div.form_group do |
| _label 'Parent PMC name (if applicable)', for: 'parent-pmc' |
| _select.form_control.parent_pmc!( |
| onChange: ->(event) {parent_pmc_change(event.target.value)} |
| ) do |
| _option '-- none --', value: '', selected: true |
| @pmcs.each {|pmc| _option pmc unless pmc == 'incubator'} |
| end |
| end |
| |
| if @chair |
| _div.form_group do |
| _label "Chair: #{@chair.name}" |
| end |
| end |
| |
| _label 'Initial set of PMC members' |
| |
| _p do |
| if !@chair |
| _ 'Search for the chair ' |
| else |
| _ 'Search for additional PMC members ' |
| end |
| _ 'using the search box below, and select ' |
| _ 'the desired name using the associated checkbox' |
| end |
| |
| @pmc.each do |person| |
| _div.form_check do |
| _input.form_check_input type: 'checkbox', checked: true, |
| value: person.id, id: "person_#{person.id}" |
| _label.form_check_label person.name, for: "person_#{person.id}" |
| end |
| end |
| |
| _input.form_control value: @search, placeholder: 'search' |
| |
| if @search.length >= 3 and Server.committers |
| search = @search.downcase().split(' ') |
| Server.committers.each do |person| |
| if |
| search.all? {|part| |
| person.id.include? part or |
| person.name.downcase().include? part |
| } \ |
| and |
| not @pmc.include? person |
| then |
| _div.form_check key: person.id do |
| _input.form_check_input type: 'checkbox', |
| id: "person_#{person.id}", |
| onClick: -> {establish_pmc(person)} |
| _label.form_check_label person.name, |
| for: "person_#{person.id}" |
| end |
| end |
| end |
| elsif @search.length == 0 and @roster and not @roster.empty? |
| @roster.each do |person| |
| unless @pmc.include? person |
| _div.form_check key: person.id do |
| _input.form_check_input type: 'checkbox', |
| id: "person_#{person.id}", |
| onClick: -> {establish_pmc(person)} |
| _label.form_check_label person.name, |
| for: "person_#{person.id}" |
| end |
| end |
| end |
| end |
| |
| _button.btn_default 'Cancel', data_dismiss: 'modal' |
| _button.btn_primary 'Draft', onClick: draft_establish_project, |
| disabled: (!@pmcname or !@pmcdesc or @pmc.empty?) |
| |
| elsif @button == 'Terminate Project' |
| _h4 'Terminate Project Resolution' |
| |
| _div.form_group do |
| _label 'PMC', for: 'terminate-pmc' |
| _select.form_control.terminate_pmc! do |
| @pmcs.each {|pmc| _option pmc} |
| end |
| end |
| |
| _p 'Reason for termination:' |
| |
| _div.form_check do |
| _input.form_check_input.termvote! type: 'radio', name: 'termreason', |
| onClick: -> {@termreason = 'vote'} |
| _label.form_check_label 'by vote of the PMC', for: 'termvote' |
| end |
| |
| _div.form_check do |
| _input.form_check_input.termconsensus! type: 'radio', |
| name: 'termreason', onClick: -> {@termreason = 'consensus'} |
| _label.form_check_label 'by consensus of the PMC', |
| for: 'termconsensus' |
| end |
| |
| _div.form_check do |
| _input.form_check_input.termboard! type: 'radio', |
| name: 'termreason', onClick: -> {@termreason = 'board'} |
| _label.form_check_label 'by the board for inactivity', |
| for: 'termboard' |
| end |
| |
| _button.btn_default 'Cancel', data_dismiss: 'modal' |
| _button.btn_primary 'Draft', onClick: draft_terminate_project, |
| disabled: (@pmcs.empty? or not @termreason) |
| |
| elsif @button == 'Out of Cycle Report' |
| _h4 'Out of Cycle PMC Report' |
| |
| # determine which PMCs are reporting this month |
| reporting_this_month = [] |
| Agenda.index.each do |item| |
| if item.roster and item.attach =~ /^[A-Z]+$/ |
| reporting_this_month << item.roster.split('/').pop() |
| end |
| end |
| |
| # provide a selection box with the remainder |
| _div.form_group do |
| _label 'PMC', for: 'out-of-cycle-pmc' |
| _select.form_control.out_of_cycle_pmc! do |
| @pmcs.each do |pmc| |
| _option pmc unless reporting_this_month.include? pmc |
| end |
| end |
| end |
| |
| _button.btn_default 'Cancel', data_dismiss: 'modal' |
| _button.btn_primary 'Draft', disabled: @pmcs.empty?, |
| onClick: draft_out_of_cycle_report |
| |
| else |
| |
| _h4 @header |
| |
| #input field: title |
| if @header == 'Add Resolution' or @header == 'Add Discussion Item' |
| _input.post_report_title! label: 'title', disabled: @disabled, |
| placeholder: 'title', value: @title, onFocus: self.default_title |
| end |
| |
| #input field: report text |
| _textarea.post_report_text! label: @label, value: @report, |
| placeholder: @label, rows: 17, disabled: @disabled, |
| onInput: self.change_text |
| |
| # upload of spreadsheet from virtual |
| if @@item.title == 'Treasurer' |
| _form do |
| _div.form_group do |
| _label 'financial spreadsheet from virtual', for: 'upload' |
| _input.upload! type: 'file', value: @upload |
| _button.btn.btn_primary 'Upload', onClick: upload_spreadsheet, |
| disabled: @disabled || !@upload |
| end |
| end |
| end |
| |
| #input field: commit_message |
| if @header != 'Add Resolution' and @header != 'Add Discussion Item' |
| _input.post_report_message! label: 'commit message', |
| disabled: @disabled, value: @message |
| end |
| |
| # footer buttons |
| _button.btn_default 'Cancel', data_dismiss: 'modal' |
| _button 'Reflow', class: self.reflow_color(), onClick: self.reflow |
| _button.btn_primary 'Submit', onClick: self.submit, |
| disabled: (not self.ready()) |
| end |
| end |
| end |
| |
| # add item menu support |
| def selectItem(event) |
| @button = event.target.textContent |
| |
| if @button == 'Change Chair' |
| initialize_chair_change() |
| elsif @button == 'Establish Project' |
| initialize_establish_project() |
| elsif @button == 'Terminate Project' |
| initialize_terminate_project() |
| elsif @button == 'Out of Cycle Report' |
| initialize_out_of_cycle() |
| end |
| |
| retitle() |
| end |
| |
| # autofocus on report/resolution title/text |
| def mounted() |
| jQuery('#post-report-form').on 'show.bs.modal' do |
| # update contents when modal is about to be shown |
| @button = @@button.text |
| self.retitle() |
| end |
| |
| jQuery('#post-report-form').on 'shown.bs.modal' do |
| reposition() |
| end |
| end |
| |
| # reposition after update if header changed |
| def updated() |
| reposition() if Post.header != @header |
| end |
| |
| # set focus, scroll |
| def reposition() |
| # set focus once modal is shown |
| title = document.getElementById('post-report-title') |
| text = document.getElementById('post-report-text') |
| |
| if title || text |
| (title || text).focus() |
| |
| # scroll to the top |
| setTimeout 0 do |
| text.scrollTop = 0 if text |
| end |
| end |
| |
| Post.header = @header |
| end |
| |
| # initialize form title, etc. |
| def created() |
| self.retitle() |
| end |
| |
| # match form title, input label, and commit message with button text |
| def retitle() |
| @report = nil |
| parent_pmc_change(nil) |
| |
| case @button |
| when 'post report' |
| @header = 'Post Report' |
| @label = 'report' |
| @message = "Post #{@@item.title} Report" |
| |
| # if by chance the report was posted to board@, attempt to fetch |
| # the text/plain version of the body |
| posted = Posted.get(@@item.title) |
| unless posted.empty? |
| post 'posted-reports', path: posted.last.path do |response| |
| @report ||= response.text |
| end |
| end |
| |
| # if there is a draft being prepared at reporter.apache.org, use it |
| draft = Reporter.find(@@item) |
| @report = draft.text if draft |
| |
| when 'edit item' |
| @header = 'Edit Discussion Item' |
| @label = 'text' |
| @message = "Edit #{@@item.title} Discussion Item" |
| |
| when 'edit report' |
| @header = 'Edit Report' |
| @label = 'report' |
| @message = "Edit #{@@item.title} Report" |
| |
| when 'add resolution', 'New Resolution' |
| @header = 'Add Resolution' |
| @label = 'resolution' |
| @title = '' |
| |
| when 'edit resolution' |
| @header = 'Edit Resolution' |
| @label = 'resolution' |
| @title = '' |
| |
| when 'post item', 'Discussion Item' |
| @header = 'Add Discussion Item' |
| @label = 'text' |
| @message = 'Add Discussion Item' |
| |
| when 'post items' |
| @header = 'Post Discussion Items' |
| @label = 'text' |
| @message = 'Post Discussion Items' |
| |
| when 'edit items' |
| @header = 'Edit Discussion Items' |
| @label = 'text' |
| @message = 'Edit Discussion Items' |
| end |
| |
| if not @edited |
| text = @report || @@item.text || '' |
| if @@item.title == 'President' |
| text.sub! /\s*Additionally, please see Attachments \d through \d\d?\./, '' |
| end |
| |
| @report = text |
| @digest = @@item.digest |
| @alerted = false |
| @edited = false |
| @base = @report |
| elsif not @alerted and @edited and @digest != @@item.digest |
| alert 'edit conflict' |
| @alerted = true |
| else |
| @report = @base |
| end |
| |
| if @header == 'Add Resolution' or @@item.attach =~ /^[47]/ |
| @indent = ' ' |
| elsif @header == 'Add Discussion Item' |
| @indent = ' ' |
| elsif @@item.attach == '8.' |
| @indent = ' ' |
| else |
| @indent = '' |
| end |
| end |
| |
| # default title based on common resolution patterns |
| def default_title(event) |
| return if @title |
| match = nil |
| |
| if (match = @report.match(/to\s+be\s+known\s+as\s+the\s+"Apache\s+(.*?)\s+Project",\s+be\s+and\s+hereby\s+is\s+established/)) |
| @title = "Establish the Apache #{match[1]} Project" |
| elsif (match = @report.match(/appointed\s+to\s+the\s+office\s+of\s+Vice\s+President,\s+Apache\s+(.*?),/)) |
| @title = "Change the Apache #{match[1]} Project Chair" |
| elsif (match = @report.match(/the\s+Apache\s+(.*?)\s+project\s+is\s+hereby\s+terminated/)) |
| @title = "Terminate the Apache #{match[1]} Project" |
| end |
| end |
| |
| # track changes to text value |
| def change_text(event) |
| @report = event.target.value |
| self.change_message() |
| end |
| |
| # update default message to reflect whether only whitespace changes were |
| # made or if there is something more that was done |
| def change_message() |
| @edited = (@base != @report) |
| |
| if @message =~ /(Edit|Reflow) #{@@item.title} Report/ |
| if @edited and @base.gsub(/[ \t\n]+/, '') == @report.gsub(/[ \t\n]+/, '') |
| @message = "Reflow #{@@item.title} Report" |
| else |
| @message = "Edit #{@@item.title} Report" |
| end |
| end |
| end |
| |
| # determine if reflow button should be default or danger color |
| def reflow_color() |
| width = 80 - @indent.length |
| |
| if @report.split("\n").all? {|line| line.length <= width} |
| return 'btn-default' |
| else |
| return'btn-danger' |
| end |
| end |
| |
| # perform a reflow of report text |
| def reflow() |
| report = @report |
| textarea = document.getElementById('post-report-text') |
| indent = start = finish = 0 |
| |
| # extract selection (if any) |
| if textarea and textarea.selectionEnd > textarea.selectionStart |
| start = textarea.selectionStart |
| start -= 1 while start > 0 and report[start-1] != "\n" |
| finish = textarea.selectionEnd |
| finish += 1 while report[finish] != "\n" and finish < report.length-1 |
| end |
| |
| # enable special punctuation rules for the incubator |
| puncrules = (@@item.title == 'Incubator') |
| |
| # reflow selection or entire report |
| if finish > start |
| report = Flow.text(report[start..finish], @indent+indent, puncrules) |
| report.gsub(/^/, ' ' * indent) if indent > 0 |
| @report = @report[0...start] + report + @report[finish+1..-1] |
| else |
| # remove indentation |
| unless report =~ /^\S/ |
| regex = RegExp.new('^( +)', 'gm') |
| indents = [] |
| while (result = regex.exec(report)) |
| indents.push result[1].length |
| end |
| unless indents.empty? |
| indent = Math.min(*indents) |
| report.gsub!(RegExp.new('^' + ' ' * indent, 'gm'), '') |
| end |
| end |
| |
| @report = Flow.text(report, @indent, puncrules) |
| end |
| |
| self.change_message() |
| end |
| |
| # determine if the form is ready to be submitted |
| def ready() |
| return false if @disabled |
| |
| if @header == 'Add Resolution' or @header == 'Add Discussion Item' |
| return @report != '' && @title != '' |
| else |
| return @report != @@item.text && @message != '' |
| end |
| end |
| |
| # when save button is pushed, post comment and dismiss modal when complete |
| def submit(event) |
| @edited = false |
| |
| if @header == 'Add Resolution' or @header == 'Add Discussion Item' |
| data = { |
| agenda: Agenda.file, |
| attach: (@header == 'Add Resolution') ? '7?' : '8?', |
| title: @title, |
| report: @report |
| } |
| else |
| data = { |
| agenda: Agenda.file, |
| attach: @attach || @@item.attach, |
| digest: @digest, |
| message: @message, |
| report: @report |
| } |
| end |
| |
| @disabled = true |
| post 'post', data do |response| |
| jQuery('#post-report-form').modal(:hide) |
| document.body.classList.remove('modal-open') |
| @attach = nil |
| @disabled = false |
| Agenda.load response.agenda, response.digest |
| end |
| end |
| |
| ######################################################################### |
| # Treasurer # |
| ######################################################################### |
| |
| # upload contents of spreadsheet in base64; append extracted table to report |
| def upload_spreadsheet(event) |
| @disabled = true |
| event.preventDefault() |
| |
| reader = FileReader.new |
| def reader.onload(event) |
| # Convert the spreadsheet a byte at a time because |
| # Chrome JavaScript did not handle the following properly: |
| # String.fromCharCode(*Uint8Array.new(event.target.result)) |
| # See commit 46058b1e8baff80c75ea72f5b79f2f23af2e87a5 |
| bytes = Uint8Array.new(event.target.result) |
| binary = '' |
| for i in 0...bytes.byteLength |
| binary += String.fromCharCode(bytes[i]) |
| end |
| |
| post 'financials', spreadsheet: btoa(binary) do |response| |
| report = @report |
| report += "\n" if report and not report.end_with? "\n" |
| report += "\n" if report |
| report += response.table |
| |
| self.change_text target: {value: report} |
| |
| @upload = nil |
| @disabled = false |
| end |
| end |
| reader.readAsArrayBuffer(document.getElementById('upload').files[0]) |
| end |
| |
| ######################################################################### |
| # Establish Project # |
| ######################################################################### |
| |
| def initialize_establish_project() |
| @search = '' |
| |
| @pmcname = nil |
| @pmcdesc = nil |
| @chair = nil |
| @pmc = [] |
| |
| # get a list of committers |
| unless Server.committers |
| retrieve 'committers', :json do |committers| |
| Server.committers = committers || [] |
| end |
| end |
| |
| # get a list of PMCs |
| if @pmcs.empty? |
| post 'post-data', request: 'committee-list' do |response| |
| @pmcs = response |
| end |
| end |
| end |
| |
| def establish_pmc(person) |
| @chair = person unless @chair |
| @pmc << person |
| @search = '' |
| end |
| |
| def draft_establish_project() |
| @disabled = true |
| |
| people = [] |
| Array(document.querySelectorAll('input:checked')).each do |checkbox| |
| people << checkbox.value |
| end |
| |
| options = { |
| request: 'establish', |
| pmcname: @pmcname, |
| parent: @parent, |
| description: @pmcdesc, |
| chair: @chair.id, |
| people: people.join(',') |
| } |
| |
| post 'post-data', options do |response| |
| @button = @header = 'Add Resolution' |
| @title = response.title |
| @report = response.draft |
| @label = 'resolution' |
| @disabled = false |
| end |
| end |
| |
| ######################################################################### |
| # Terminate Project # |
| ######################################################################### |
| |
| def initialize_terminate_project() |
| # get a list of PMCs |
| if @pmcs.empty? |
| post 'post-data', request: 'committee-list' do |response| |
| @pmcs = response |
| end |
| end |
| |
| @termreason = nil |
| end |
| |
| def draft_terminate_project() |
| @disabled = true |
| options = { |
| request: 'terminate', |
| pmc: document.getElementById('terminate-pmc').value, |
| reason: @termreason |
| } |
| |
| post 'post-data', options do |response| |
| @button = @header = 'Add Resolution' |
| @title = response.title |
| @report = response.draft |
| @label = 'resolution' |
| @disabled = false |
| end |
| end |
| |
| ######################################################################### |
| # Out of Cycle report # |
| ######################################################################### |
| |
| def initialize_out_of_cycle() |
| @disabled = true |
| |
| # gather a list of reports already on the agenda |
| scheduled = {} |
| Agenda.index.each do |item| |
| if item.attach =~ /^[A-Z]/ |
| scheduled[item.title.downcase] = true |
| end |
| end |
| |
| # get a list of PMCs and select ones that aren't on the agenda |
| @pmcs = [] |
| post 'post-data', request: 'committee-list' do |response| |
| response.each do |pmc| |
| @pmcs << pmc unless scheduled[pmc] |
| end |
| end |
| end |
| |
| def draft_out_of_cycle_report() |
| pmc = document.getElementById('out-of-cycle-pmc').value. |
| gsub(/\b[a-z]/) {|s| s.upcase()} |
| @button = 'post report' |
| @disabled = true |
| @report = '' |
| @header = 'Post Report' |
| @label = 'report' |
| @message = "Post Out of Cycle #{pmc} Report" |
| @attach = '+' + pmc |
| @disabled = false |
| end |
| |
| ######################################################################### |
| # Change Project Chair # |
| ######################################################################### |
| |
| def initialize_chair_change() |
| @disabled = true |
| @pmcs = [] |
| chair_pmc_change(nil) |
| post 'post-data', request: 'committee-list' do |response| |
| @pmcs = response |
| chair_pmc_change(@pmcs.first) |
| end |
| end |
| |
| def chair_pmc_change(pmc) |
| @disabled = true |
| @outgoing_chair = nil |
| @pmc_members = [] |
| return unless pmc |
| post 'post-data', request: 'committee-members', pmc: pmc do |response| |
| @outgoing_chair = response.chair.name |
| @pmc_members = response.members |
| @disabled = false |
| end |
| end |
| |
| def parent_pmc_change(pmc) |
| @roster = [] |
| @parent = pmc |
| return unless pmc |
| post 'post-data', request: 'committer-list', pmc: pmc do |response| |
| @roster = response.members if response |
| end |
| end |
| |
| def draft_chair_change_resolution() |
| @disabled = true |
| options = { |
| request: 'change-chair', |
| pmc: document.getElementById('change-chair-pmc').value, |
| chair: document.getElementById('incoming-chair').value |
| } |
| |
| post 'post-data', options do |response| |
| @button = @header = 'Add Resolution' |
| @title = response.title |
| @report = response.draft |
| @label = 'resolution' |
| @disabled = false |
| end |
| end |
| |
| end |
