minter-raccdoc 0.0.2 → 0.0.3

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 (6) hide show
  1. data/CHANGELOG +5 -0
  2. data/Manifest +1 -1
  3. data/README +90 -0
  4. data/lib/raccdoc.rb +1 -1
  5. data/raccdoc.gemspec +4 -4
  6. metadata +4 -2
data/CHANGELOG ADDED
@@ -0,0 +1,5 @@
1
+ v0.0.3 Documentation updates
2
+
3
+ v0.0.2 Adding tests, cleaning up gemspec.
4
+
5
+ v0.0.1 Initial release.
data/Manifest CHANGED
@@ -4,6 +4,6 @@ LICENSE
4
4
  Manifest
5
5
  raccdoc.gemspec
6
6
  Rakefile
7
- README.rdoc
7
+ README
8
8
  test/raccdoc_connection_test.rb
9
9
  test/test_helper.rb
data/README ADDED
@@ -0,0 +1,90 @@
1
+ = Raccdoc
2
+
3
+ == DESCRIPTION
4
+
5
+ Raccdoc is an API into the data of several classic telnet-based BBS systems, including:
6
+
7
+ * ISCABBS[http://iscabbs.com/]
8
+ * InaraBBS[http://www.inarabbs.com/]
9
+ * Gestalt
10
+
11
+ This is a Ruby version of that API.
12
+
13
+ == EXAMPLE
14
+
15
+ require 'raccdoc'
16
+
17
+ # Connect to the BBS as user Bugcrusher
18
+ bbs = Raccdoc::Connection.new(:host => 'bbs.iscabbs.com', :port => 6145, :user => 'Bugcrusher', :password => 'MyPass')
19
+
20
+ # Find out information on each forum
21
+ bbs.forums.each do |id, data|
22
+ print "On forum number #{id} named #{data[:name]}\n"
23
+ end
24
+
25
+ # Join the Babble forum
26
+ forum = bbs.jump("Babble")
27
+
28
+ # See if you have permission to post
29
+ print "Can you post in there? #{forum.post?}\n"
30
+
31
+ # Read post number 2280
32
+ post = forum.read(2280)
33
+
34
+ # Print out the post body for 2280
35
+ print "Body is #{post.body}\n"
36
+
37
+ # Make your own post
38
+ mypost = forum.post("Hello world!")
39
+
40
+ # Get information on it
41
+ print "My new post is id number #{mypost.id}\n"
42
+
43
+ # Now delete it
44
+ mypost.delete
45
+
46
+ # Log out
47
+ bbs.logout
48
+
49
+ == REQUIREMENTS
50
+
51
+ * Ruby 1.8
52
+ * An account on the BBS that you wish to access (unless doing Guest/read-only operations)
53
+ * Mocha (for tests)
54
+
55
+ == TODO & KNOWN ISSUES
56
+
57
+ * X-Message support
58
+ * Mail> support
59
+
60
+ == INSTALL
61
+
62
+ * gem sources -a http://gems.github.com
63
+ * sudo gem install minter-raccdoc
64
+
65
+ Then require 'raccdoc' in your Ruby program.
66
+
67
+ == LICENSE
68
+
69
+ (The MIT License)
70
+
71
+ Copyright (c) 2009 H. Wade Minter
72
+
73
+ Permission is hereby granted, free of charge, to any person obtaining
74
+ a copy of this software and associated documentation files (the
75
+ 'Software'), to deal in the Software without restriction, including
76
+ without limitation the rights to use, copy, modify, merge, publish,
77
+ distribute, sublicense, and/or sell copies of the Software, and to
78
+ permit persons to whom the Software is furnished to do so, subject to
79
+ the following conditions:
80
+
81
+ The above copyright notice and this permission notice shall be
82
+ included in all copies or substantial portions of the Software.
83
+
84
+ THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
85
+ EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
86
+ MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
87
+ IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
88
+ CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
89
+ TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
90
+ SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
data/lib/raccdoc.rb CHANGED
@@ -1,6 +1,6 @@
1
1
  module Raccdoc
2
2
 
3
- VERSION = '0.0.2'
3
+ VERSION = '0.0.3'
4
4
  require 'socket'
5
5
  require 'time'
6
6
 
data/raccdoc.gemspec CHANGED
@@ -2,18 +2,18 @@
2
2
 
3
3
  Gem::Specification.new do |s|
4
4
  s.name = %q{raccdoc}
5
- s.version = "0.0.2"
5
+ s.version = "0.0.3"
6
6
 
7
7
  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
8
8
  s.authors = ["H. Wade Minter"]
9
9
  s.date = %q{2009-01-12}
10
10
  s.description = %q{A Ruby interface into the Raccdoc protocol}
11
11
  s.email = %q{minter@lunenburg.org}
12
- s.extra_rdoc_files = ["lib/raccdoc.rb", "LICENSE", "README"]
13
- s.files = ["lib/raccdoc.rb", "LICENSE", "Manifest", "raccdoc.gemspec", "Rakefile", "README", "test/raccdoc_connection_test.rb", "test/test_helper.rb"]
12
+ s.extra_rdoc_files = ["CHANGELOG", "lib/raccdoc.rb", "LICENSE", "README"]
13
+ s.files = ["CHANGELOG", "lib/raccdoc.rb", "LICENSE", "Manifest", "raccdoc.gemspec", "Rakefile", "README", "test/raccdoc_connection_test.rb", "test/test_helper.rb"]
14
14
  s.has_rdoc = true
15
15
  s.homepage = %q{}
16
- s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Raccdoc", "--main", "README.rdoc"]
16
+ s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Raccdoc", "--main", "README"]
17
17
  s.require_paths = ["lib"]
18
18
  s.rubyforge_project = %q{raccdoc}
19
19
  s.rubygems_version = %q{1.3.1}
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: minter-raccdoc
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.0.2
4
+ version: 0.0.3
5
5
  platform: ruby
6
6
  authors:
7
7
  - H. Wade Minter
@@ -28,10 +28,12 @@ executables: []
28
28
  extensions: []
29
29
 
30
30
  extra_rdoc_files:
31
+ - CHANGELOG
31
32
  - lib/raccdoc.rb
32
33
  - LICENSE
33
34
  - README
34
35
  files:
36
+ - CHANGELOG
35
37
  - lib/raccdoc.rb
36
38
  - LICENSE
37
39
  - Manifest
@@ -49,7 +51,7 @@ rdoc_options:
49
51
  - --title
50
52
  - Raccdoc
51
53
  - --main
52
- - README.rdoc
54
+ - README
53
55
  require_paths:
54
56
  - lib
55
57
  required_ruby_version: !ruby/object:Gem::Requirement