##// END OF EJS Templates
jro_apps » redmine
RSS
Trac importer initial commit. The script migrates:...
Jean-Philippe Lang -
r678:296b6aee5aac
parent child
Show More
Show file before | Show file after | Hide comments
@@ -0,0 +1,416
1 # redMine - project management software
2 # Copyright (C) 2006-2007 Jean-Philippe Lang
3 #
4 # This program is free software; you can redistribute it and/or
5 # modify it under the terms of the GNU General Public License
6 # as published by the Free Software Foundation; either version 2
7 # of the License, or (at your option) any later version.
8 #
9 # This program is distributed in the hope that it will be useful,
10 # but WITHOUT ANY WARRANTY; without even the implied warranty of
11 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 # GNU General Public License for more details.
13 #
14 # You should have received a copy of the GNU General Public License
15 # along with this program; if not, write to the Free Software
16 # Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
17
18 require 'active_record'
19 require 'iconv'
20 require 'pp'
21
22 namespace :redmine do
23 desc 'Trac migration script'
24 task :migrate_from_trac => :environment do
25
26 module TracMigrate
27
28 DEFAULT_STATUS = IssueStatus.default
29 assigned_status = IssueStatus.find_by_position(2)
30 resolved_status = IssueStatus.find_by_position(3)
31 feedback_status = IssueStatus.find_by_position(4)
32 closed_status = IssueStatus.find :first, :conditions => { :is_closed => true }
33 STATUS_MAPPING = {'new' => DEFAULT_STATUS,
34 'reopened' => feedback_status,
35 'assigned' => assigned_status,
36 'closed' => closed_status
37 }
38
39 priorities = Enumeration.get_values('IPRI')
40 DEFAULT_PRIORITY = priorities[0]
41 PRIORITY_MAPPING = {'lowest' => priorities[0],
42 'low' => priorities[0],
43 'normal' => priorities[1],
44 'high' => priorities[2],
45 'highest' => priorities[3]
46 }
47
48 TRACKER_BUG = Tracker.find_by_position(1)
49 TRACKER_FEATURE = Tracker.find_by_position(2)
50 DEFAULT_TRACKER = TRACKER_BUG
51 TRACKER_MAPPING = {'defect' => TRACKER_BUG,
52 'enhancement' => TRACKER_FEATURE,
53 'task' => TRACKER_FEATURE,
54 'patch' =>TRACKER_FEATURE
55 }
56
57 DEFAULT_ROLE = Role.find_by_position(3)
58 manager_role = Role.find_by_position(1)
59 developer_role = Role.find_by_position(2)
60 ROLE_MAPPING = {'admin' => manager_role,
61 'developer' => developer_role
62 }
63
64 class TracComponent < ActiveRecord::Base
65 set_table_name :component
66 end
67
68 class TracMilestone < ActiveRecord::Base
69 set_table_name :milestone
70
71 def due
72 if read_attribute(:due) > 0
73 Time.at(read_attribute(:due)).to_date
74 else
75 nil
76 end
77 end
78 end
79
80 class TracTicketCustom < ActiveRecord::Base
81 set_table_name :ticket_custom
82 end
83
84 class TracTicket < ActiveRecord::Base
85 set_table_name :ticket
86 set_inheritance_column :none
87
88 has_many :comments, :class_name => "TracTicketChange", :foreign_key => :ticket, :conditions => "field = 'comment'"
89 has_many :attachments, :class_name => "TracAttachment", :foreign_key => :id, :conditions => "type = 'ticket'"
90 has_many :customs, :class_name => "TracTicketCustom", :foreign_key => :ticket
91
92 def ticket_type
93 read_attribute(:type)
94 end
95
96 def summary
97 read_attribute(:summary).blank? ? "(no subject)" : read_attribute(:summary)
98 end
99
100 def description
101 read_attribute(:description).blank? ? summary : read_attribute(:description)
102 end
103
104 def time; Time.at(read_attribute(:time)) end
105 end
106
107 class TracTicketChange < ActiveRecord::Base
108 set_table_name :ticket_change
109
110 def time; Time.at(read_attribute(:time)) end
111 end
112
113 class TracAttachment < ActiveRecord::Base
114 set_table_name :attachment
115 set_inheritance_column :none
116
117 def time; Time.at(read_attribute(:time)) end
118
119 def original_filename
120 filename
121 end
122
123 def content_type
124 Redmine::MimeType.of(filename) || ''
125 end
126
127 def exist?
128 File.file? trac_fullpath
129 end
130
131 def read
132 File.open("#{trac_fullpath}", 'rb').read
133 end
134
135 private
136 def trac_fullpath
137 attachment_type = read_attribute(:type)
138 trac_file = filename.gsub( /[^a-zA-Z0-9\-_\.!~*']/n ) {|x| sprintf('%%%02x', x[0]) }
139 "#{TracMigrate.trac_directory}/attachments/#{attachment_type}/#{id}/#{trac_file}"
140 end
141 end
142
143 class TracWikiPage < ActiveRecord::Base
144 set_table_name :wiki
145 end
146
147 class TracPermission < ActiveRecord::Base
148 set_table_name :permission
149 end
150
151 def self.find_or_create_user(username, project_member = false)
152 u = User.find_by_login(username)
153 if !u
154 # Create a new user if not found
155 mail = username[0,limit_for(User, 'mail')]
156 mail = "#{mail}@foo.bar" unless mail.include?("@")
157 u = User.new :firstname => username[0,limit_for(User, 'firstname')].gsub(/[^\w\s\'\-]/i, '-'),
158 :lastname => '-',
159 :mail => mail.gsub(/[^-@a-z0-9\.]/i, '-')
160 u.login = username[0,limit_for(User, 'login')].gsub(/[^a-z0-9_\-@\.]/i, '-')
161 u.password = 'trac'
162 u.admin = true if TracPermission.find_by_username_and_action(username, 'admin')
163 # finally, a default user is used if the new user is not valid
164 u = User.find(:first) unless u.save
165 end
166 # Make sure he is a member of the project
167 if project_member && !u.member_of?(@target_project)
168 role = DEFAULT_ROLE
169 if u.admin
170 role = ROLE_MAPPING['admin']
171 elsif TracPermission.find_by_username_and_action(username, 'developer')
172 role = ROLE_MAPPING['developer']
173 end
174 Member.create(:user => u, :project => @target_project, :role => DEFAULT_ROLE)
175 u.reload
176 end
177 u
178 end
179
180 # Basic wiki syntax conversion
181 def self.convert_wiki_text(text)
182 # Titles
183 text = text.gsub(/^(\=+)\s(.+)\s(\=+)/) {|s| "h#{$1.length}. #{$2}\n"}
184 # Links
185 text = text.gsub(/\[(http[^\s]+)\s+([^\]]+)\]/) {|s| "\"#{$2}\":#{$1}"}
186 # Revisions links
187 text = text.gsub(/\[(\d+)\]/, 'r\1')
188 text
189 end
190
191 def self.migrate
192 # Quick database test before clearing Redmine data
193 TracComponent.count
194
195 puts "Deleting data"
196 CustomField.destroy_all
197 Issue.destroy_all
198 IssueCategory.destroy_all
199 Version.destroy_all
200 User.destroy_all "login <> 'admin'"
201
202 migrated_components = 0
203 migrated_milestones = 0
204 migrated_tickets = 0
205 migrated_ticket_comments = 0
206 migrated_custom_values = 0
207 trac_ticket_comments = 0
208 migrated_ticket_attachments = 0
209 migrated_wiki_edits = 0
210
211 # Components
212 print "Migrating components"
213 issues_category_map = {}
214 TracComponent.find(:all).each do |component|
215 print '.'
216 c = IssueCategory.new :project => @target_project,
217 :name => encode(component.name[0, limit_for(IssueCategory, 'name')])
218 next unless c.save
219 issues_category_map[component.name] = c
220 migrated_components += 1
221 end
222 puts
223
224 # Milestones
225 print "Migrating milestones"
226 version_map = {}
227 TracMilestone.find(:all).each do |milestone|
228 print '.'
229 v = Version.new :project => @target_project,
230 :name => encode(milestone.name[0, limit_for(Version, 'name')]),
231 :description => encode(milestone.description[0, limit_for(Version, 'description')]),
232 :effective_date => milestone.due
233 next unless v.save
234 version_map[milestone.name] = v
235 migrated_milestones += 1
236 end
237 puts
238
239 # Custom fields
240 # TODO: read trac.ini instead
241 print "Custom fields"
242 custom_field_map = {}
243 TracTicketCustom.find_by_sql("SELECT DISTINCT name FROM #{TracTicketCustom.table_name}").each do |field|
244 print '.'
245 f = IssueCustomField.new :name => encode(field.name[0, limit_for(IssueCustomField, 'name')]),
246 :field_format => 'string',
247 :is_for_all => true
248 next unless f.save
249 f.trackers = Tracker.find(:all)
250 custom_field_map[field.name] = f
251 end
252 puts
253
254 # Tickets
255 print "Migrating tickets"
256 TracTicket.find(:all).each do |ticket|
257 print '.'
258 i = Issue.new :project => @target_project,
259 :subject => encode(ticket.summary[0, limit_for(Issue, 'subject')]),
260 :description => convert_wiki_text(encode(ticket.description)),
261 :priority => PRIORITY_MAPPING[ticket.priority] || DEFAULT_PRIORITY,
262 :created_on => ticket.time
263 i.author = find_or_create_user(ticket.reporter)
264 i.category = issues_category_map[ticket.component] unless ticket.component.blank?
265 i.fixed_version = version_map[ticket.milestone] unless ticket.milestone.blank?
266 i.status = STATUS_MAPPING[ticket.status] || DEFAULT_STATUS
267 i.tracker = TRACKER_MAPPING[ticket.ticket_type] || DEFAULT_TRACKER
268 i.id = ticket.id
269 next unless i.save
270 migrated_tickets += 1
271
272 # Owner
273 unless ticket.owner.blank?
274 i.assigned_to = find_or_create_user(ticket.owner, true)
275 i.save
276 end
277
278 # Comments
279 # TODO: migrate status changes history
280 ticket.comments.each do |comment|
281 next if comment.newvalue.blank?
282 trac_ticket_comments += 1
283 n = Journal.new :notes => convert_wiki_text(encode(comment.newvalue)),
284 :created_on => comment.time
285 n.user = find_or_create_user(comment.author)
286 n.journalized = i
287 migrated_ticket_comments += 1 if n.save
288 end
289
290 # Attachments
291 ticket.attachments.each do |attachment|
292 next unless attachment.exist?
293 a = Attachment.new :created_on => attachment.time
294 a.file = attachment
295 a.author = find_or_create_user(attachment.author)
296 a.container = i
297 migrated_ticket_attachments += 1 if a.save
298 end
299
300 # Custom fields
301 ticket.customs.each do |custom|
302 v = CustomValue.new :custom_field => custom_field_map[custom.name],
303 :value => custom.value
304 v.customized = i
305 next unless v.save
306 migrated_custom_values += 1
307 end
308 end
309 puts
310
311 # Wiki
312 print "Migrating wiki"
313 @target_project.wiki.destroy if @target_project.wiki
314 @target_project.reload
315 wiki = Wiki.new(:project => @target_project, :start_page => 'WikiStart')
316 if wiki.save
317 TracWikiPage.find(:all, :order => 'name, version').each do |page|
318 print '.'
319 p = wiki.find_or_new_page(page.name)
320 p.content = WikiContent.new(:page => p) if p.new_record?
321 p.content.text = page.text
322 p.content.author = find_or_create_user(page.author) unless page.author.blank? || page.author == 'trac'
323 p.content.comments = page.comment
324 p.new_record? ? p.save : p.content.save
325 migrated_wiki_edits += 1 unless p.content.new_record?
326 end
327
328 wiki.reload
329 wiki.pages.each do |page|
330 page.content.text = convert_wiki_text(page.content.text)
331 page.content.save
332 end
333 end
334 puts
335
336 puts
337 puts "Components: #{migrated_components}/#{TracComponent.count}"
338 puts "Milestones: #{migrated_milestones}/#{TracMilestone.count}"
339 puts "Tickets: #{migrated_tickets}/#{TracTicket.count}"
340 puts "Ticket comments: #{migrated_ticket_comments}/#{trac_ticket_comments}"
341 puts "Ticket files: #{migrated_ticket_attachments}/" + TracAttachment.count("type = 'ticket'").to_s
342 puts "Custom values: #{migrated_custom_values}/#{TracTicketCustom.count}"
343 puts "Wiki edits: #{migrated_wiki_edits}/#{TracWikiPage.count}"
344 end
345
346 def self.limit_for(klass, attribute)
347 klass.columns_hash[attribute.to_s].limit
348 end
349
350 def self.encoding(charset)
351 @ic = Iconv.new('UTF-8', charset)
352 rescue Iconv::InvalidEncoding
353 return false
354 end
355
356 def self.trac_directory=(path)
357 @trac_directory = path if File.directory?(path)
358 end
359
360 def self.trac_directory
361 @trac_directory
362 end
363
364 def self.target_project_identifier(identifier)
365 @target_project = Project.find_by_identifier(identifier)
366 end
367
368 def self.establish_connection(params)
369 constants.each do |const|
370 klass = const_get(const)
371 next unless klass.respond_to? 'establish_connection'
372 klass.establish_connection params
373 end
374 end
375
376 private
377 def self.encode(text)
378 @ic.iconv text
379 rescue
380 text
381 end
382 end
383
384 puts
385 puts "WARNING: Your Redmine data will be deleted during this process."
386 print "Are you sure you want to continue ? [y/N] "
387 break unless STDIN.gets.match(/^y$/i)
388 puts
389
390 while true
391 print "Trac directory: "
392 directory = STDIN.gets.chomp!
393 TracMigrate.trac_directory = directory
394 break if TracMigrate.trac_directory
395 puts " This directory doesn't exist!"
396 end
397 while true
398 print "Database encoding [UTF-8]: "
399 encoding = STDIN.gets.chomp!
400 encoding = 'UTF-8' if encoding.blank?
401 break if TracMigrate.encoding encoding
402 puts " Invalid encoding!"
403 end
404 while true
405 print "Target project identifier: "
406 identifier = STDIN.gets.chomp!
407 break if TracMigrate.target_project_identifier identifier
408 puts " Project not found in Redmine database!"
409 end
410 puts
411
412 TracMigrate.establish_connection({:adapter => 'sqlite',
413 :database => "#{TracMigrate.trac_directory}/db/trac.db"})
414 TracMigrate.migrate
415 end
416 end
General Comments 0
You need to be logged in to leave comments. Login now