File: KNOWN_ISSUES.rdoc

package info (click to toggle)
bioruby 1.4.0-2
  • links: PTS, VCS
  • area: main
  • in suites: squeeze
  • size: 6,328 kB
  • ctags: 7,787
  • sloc: ruby: 61,539; xml: 3,383; makefile: 58; sh: 4
file content (120 lines) | stat: -rw-r--r-- 4,165 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
= KNOWN_ISSUES.rdoc - Known issues and bugs in BioRuby
Copyright:: Copyright (C) 2009 Naohisa Goto <ng@bioruby.org>
License::   The Ruby License

= Known issues and bugs in BioRuby

Below are known issues and bugs in BioRuby. Pathes to fix them are welcomed.
We hope they will be fixed in the future.

Items marked with (WONT_FIX) tags would not be fixed within BioRuby because
they are not BioRuby's issues and/or it is very difficult to fix them.

== 1. Ruby version specific issues

=== Ruby 1.9.1 or later

Some classes/modules/methods still may not work or may return incorrect
results in Ruby 1.9.1, especially those not covered by the unit tests.

==== String encodings

Currently, BioRuby do not care string encodings. In some cases,
Encoding::CompatibilityError or "ArgumentError: invalid byte sequence in
(encoding name)" may be raised.

=== Ruby 1.9.0

(WONT_FIX) Ruby 1.9.0 is NOT supported because it isn't a stable release.
Use Ruby 1.9.1 or later.

=== Ruby 1.8.2 or earlier

(WONT_FIX) In some cases, temporary files and directories may not be
removed because of the lack of FileUtils.remove_entry_secure.

(WONT_FIX) We will soon end support for Ruby 1.8.2. Note that Ruby
1.8.1 or earlier is no longer supported, as described in README.rdoc.

=== Issues about SOAP/WSDL

SOAP4R (SOAP and WSDL implementation) is no longer bundled with Ruby 1.9.
In addition, because of the API changes in recent SOAP4R, some
classes/modules using SOAP4R may not work.

=== Problem with REXML DoS vulnerability patch before 09-Nov-2008

(WONT_FIX) If you have applied a patch taken from
http://www.ruby-lang.org/en/news/2008/08/23/dos-vulnerability-in-rexml/
before 09 Nov 2008 12:40 +0900, because of the bug in the patch,
parsing of Blast XML results with REXML parser may fail. The bug is already
fixed and new patch is available on the above URL. Note that some Linux
distributions would have incorporated the patch in their manners, and may
have the same problem.

== 2. OS and/or architecture-dependent issues

=== Microsoft Windows

==== Text mode issues

Following 4 tests failed on mswin32 (and maybe on mingw32 and bccwin32)
because of the conversion of line feed codes in the text mode.

* test_ended_pos and test_start_pos in test/unit/bio/io/test_flatfile.rb
* test_pos in test/unit/bio/io/flatfile/test_buffer.rb
* test_entry_pos in test/unit/bio/appl/blast/test_rpsblast.rb

This indicates that br_bioflat.rb and Bio::FlatFileIndex may create
incorrect indexes on mswin32, mingw32, and bccwin32. In addition,
Bio::FlatFile may return incorrect data.

==== Windows 95/98/98SE/ME

(WONT_FIX) Some methods that call external programs may not work in
Windows 95/98/98SE/ME because of the limitation of COMMAND.COM.

=== OpenVMS, BeOS, OS/2, djgpp, Windows CE

(WONT_FIX) BioRuby may not work on these platforms.

== 3. Known issues and bugs in BioRuby

=== Bio::Ensembl

Due to the renewal of Ensembl web site, Bio::Ensembl does not work for
the latest Ensembl. For a workaround, use an archive server. For example,
"jul2008.archive.ensembl.org" seems to be the last server before the renewal.
  human = Bio::Ensembl.new("Homo_sapiens", "jul2008.archive.ensembl.org")

Alternatively, consider using Ruby Ensembl API.
* http://github.com/jandot/ruby-ensembl-api

=== Bio::DBGET and sample/dbget

(WONT_FIX) Because the DBGET service have not been publically available for
a long time, we give up support for Bio::DBGET and sample/dbget. Instead,
using Bio::TogoWS or Bio::KEGG::API is recommended.

=== Bio::NCBI::SOAP

It seems that Bio::NCBI::SOAP (in lib/bio/io/ncbisoap.rb) does not work
correctly, even running on Ruby 1.8.x. Instead, use Bio::NCBI::REST.

=== Bio::KEGG::Taxonomy and sample/demo_kegg_taxonomy.rb

Bio::KEGG::Taxonomy fails to parse current KEGG taxonomy data file probably
because of the growth of the data size.

== 4. Compatibility issues with other libraries/extensions

=== ActiveRecord

BioSQL support uses ActiveRecord, but the author of the document does not
know which version is suitable.

=== Ruby on Rails

BioRuby Shell on Web uses Ruby on Rails, but the author of the document does
not know which version is suitable.