wtforum 0.0.1 → 0.1.0

data/.rspec

@@ -0,0 +1 @@
+--debug -c

data/README.md

@@ -21,49 +21,49 @@ Or install it yourself as:
 
 ## Features
 
-    WTForum has the following features:
-
-    * CRUD (create, read, update, & delete) user accounts
-      ```ruby
-      # modeled after ActiveRecord API
-      user = WTForum::User.create username: "wtforum_test_user", email: "wtforum_test_user@example.com"
-      user = WTForum::User.find(user.id)
-      user.update_attributes! username: "wtforum_test_user_2", email: "wtforum_test_user_2@example.com"
-      user.destroy
-      ```
-
-    * Log in your user via their Single Sign On (SSO) API
-      ```ruby
-      session = WTForum::Session.create(user.id)
-      session.token # => REiB6U5SkxB
-      ```
+WTForum has the following features:
+
+### CRUD (create, read, update, & delete) user accounts
+
+    # modeled after ActiveRecord API
+    WTForum::User.count
+    user = WTForum::User.create username: "wtforum_test_user", email: "wtforum_test_user@example.com"
+    user = WTForum::User.find(user.id)
+      user = WTForum::User.find_by_username(user.username)
+    user.update_attributes! username: "wtforum_test_user_2", email: "wtforum_test_user_2@example.com"
+    user.destroy
+
+### Log in your user via their Single Sign On (SSO) API
+
+    session = WTForum::Session.create(user.id)
+    session.token # => REiB6U5SkxB
 
 ## Configuration
 
-    Before using WTForum, you need to give it administrator credentials. It
-    needs four pieces of information:
-    1) Where the forum is hosted.
-    2) The API key that Website Toolbox provides.
-    3) Username of an admin account.
-    4) Password for said admin account.
+Before using WTForum, you need to give it administrator credentials. It
+needs four pieces of information:
+
+1. Where the forum is hosted.
+2. The API key that Website Toolbox provides.
+3. Username of an admin account.
+4. Password for said admin account.
+
+Example Rails config:
 
-    Example Rails config:
-    ```ruby
     # config/initializers/wtforum_credentials.rb
     WTForum.domain = "forum.example.com"
     WTForum.api_key = "TEgPYR4Zapz"
     WTForum.admin_username = "__admin_api_dont_delete__"
     WTForum.admin_password = "s0m3p4ssw0rd"
-    ```
 
 ## Why do we need to specify an admin user account in the credentials?
 
-    Unfortunately, Website Toolbox's Forum API is missing some functionality.
-    Specifically, you can only create a new forum user account. Need to read,
-    update, or delete an existing user via the API? You're out of luck! As a
-    workaround, this library uses an admin account and Mechanize to sign into
-    the website and manually fill out forms and screenscrape the results. I hope
-    that the API's breadth of functionality improves in the future.
+Unfortunately, Website Toolbox's Forum API is missing some functionality.
+Specifically, you can only create a new forum user account. Need to read,
+update, or delete an existing user via the API? You're out of luck! As a
+workaround, this library uses an admin account and Mechanize to sign into
+the website and manually fill out forms and screenscrape the results. I hope
+that the API's breadth of functionality improves in the future.
 
 ## Contributing
 

data/lib/wtforum/session.rb

@@ -5,7 +5,7 @@ module WTForum
     def self.create user_id
       uri = create_uri(user_id)
       page = Mechanize.new.get(uri)
-      auth_token = WTForum.extract_value(:authtoken, :from => page.body)
+      auth_token = WTForum.extract_value(:authtoken, from: page.body)
       new(auth_token)
     end
 

data/lib/wtforum/user.rb

@@ -31,6 +31,23 @@ module WTForum
       new(attributes)
     end
 
+    def self.find_by_username username
+      page = authorized_agent.get(find_by_username_uri(username))
+      body = Nokogiri::HTML.parse(page.body)
+
+      # scrape markup: <a href="/profile/1234567" title="View profile">username\t\n</a>
+      # search returns partial matches :( so find the exact match.
+      # hopefully there aren't more than 50 matches!
+      link = body.css("a[title='View profile']:contains('#{username}')").find do |a|
+        a.text.strip == username
+      end
+
+      link or raise NotFound
+
+      id = link["href"].split("/").last
+      find id
+    end
+
     def self.update user_id, attributes
       find(user_id).update_attributes!(attributes)
     end
@@ -123,6 +140,13 @@ module WTForum
       uri
     end
 
+    def self.find_by_username_uri username
+      uri = WTForum.base_uri
+      uri.path = "/register"
+      uri.query = "action=members&search=true&s_username=#{username}"
+      uri
+    end
+
     def self.edit_username_uri user_id
       uri = WTForum.base_uri
       uri.path = "/register/edit_username"

data/lib/wtforum/version.rb

@@ -1,5 +1,5 @@
 # encoding: utf-8
 
 module WTForum
-  VERSION = "0.0.1"
+  VERSION = "0.1.0"
 end

data/spec/integration/wtforum_user_spec.rb

@@ -17,7 +17,7 @@ describe WTForum::User do
 
       user.update_attributes! username: "wtforum_test_user_2", email: "wtforum_test_user_2@example.com"
 
-      user = WTForum::User.find(user.id)
+      user = WTForum::User.find_by_username("wtforum_test_user_2")
       user.username.should == "wtforum_test_user_2"
       user.email.should == "wtforum_test_user_2@example.com"
 

data/wtforum.gemspec

@@ -25,4 +25,5 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "bundler", "~> 1.3"
   spec.add_development_dependency "rake"
   spec.add_development_dependency "rspec"
+  spec.add_development_dependency "debugger"
 end

metadata

@@ -2,14 +2,14 @@
 name: wtforum
 version: !ruby/object:Gem::Version
   prerelease: 
-  version: 0.0.1
+  version: 0.1.0
 platform: ruby
 authors:
 - Micah Geisel
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-03-13 00:00:00.000000000 Z
+date: 2013-03-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   type: :runtime
@@ -107,6 +107,22 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
     none: false
+- !ruby/object:Gem::Dependency
+  type: :development
+  prerelease: false
+  name: debugger
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+    none: false
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+    none: false
 description: Ruby library that wraps Website Toolbox's forum API.
 email:
 - micah@botandrose.com
@@ -115,6 +131,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - .gitignore
+- .rspec
 - Gemfile
 - LICENSE.txt
 - README.md
@@ -138,7 +155,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
-      hash: 1995096068077646637
+      hash: 4273963902836204732
       segments:
       - 0
       version: '0'
@@ -147,7 +164,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
-      hash: 1995096068077646637
+      hash: 4273963902836204732
       segments:
       - 0
       version: '0'