Databases
StackOverflow2013
Postsdbo
POHow do I make sense of Ruby documentation?
 

Note that there are some explanatory texts on larger screens.

plurals
  1. POHow do I make sense of Ruby documentation?
    primarykey
    data
    text
    <p>I have seen code such as: </p> <pre><code>Net::HTTP::Post.new(url) </code></pre> <p>If I then use <code>ri</code> as follows:</p> <pre><code>$ ri Net::HTTP::Post </code></pre> <p>I get almost no documentation, and:</p> <pre><code>$ ri Net::HTTP::Post.new </code></pre> <p>results in</p> <pre><code>Nothing known about Net::HTTP::Post.new </code></pre> <p>When reading the documentation for <code>Net::HTTP</code>, I get the suspicion that the code should be using <code>Net::HTTP#request_post</code> instead. I still find the correct way to use this module confusing. Why does <code>Net::HTTP::Post.net</code> seem to work? Even with the <code>Net::HTTP.request_post</code>, I get:</p> <pre><code>undefined method `request_post' for Net::HTTP:Class. </code></pre> <p>To clarify my question, what I want is to know how to:</p> <ul> <li>Find the best documentation for ruby.</li> <li>Given the example provided, obtain the best way to achieve the aim (which is, to make an HTTP POST request, I'll add that I need to use provide authentication, cookie, and data in the body).</li> <li>Make sense of what it means when the methods have been annotated with 'R' (does that mean 'read-only'? That doesn't make sense because I need to set the request body, which implies write...</li> </ul> <p>As a contrast, this is equivalent documentation for Python, which I understand (being a python dev myself): <a href="http://docs.python.org/2/library/httplib.html" rel="nofollow">http://docs.python.org/2/library/httplib.html</a></p>
    singulars
    1. This table or related slice is empty.
    1. This table or related slice is empty.
    1. PTQuestion
    1. USArafangion
    1. USArafangion
    plurals
    1. PL
      singulars
      1. LTLinked
    2. PL
      singulars
      1. LTLinked
    1. This table or related slice is empty.
    1. This table or related slice is empty.
    1. PO
      singulars
      1. PTAnswer
    1. VO
      singulars
      1. POHow do I make sense of Ruby documentation?
      1. This table or related slice is empty.
      1. VTUpMod
    2. VO
      singulars
      1. POHow do I make sense of Ruby documentation?
      1. This table or related slice is empty.
      1. VTUpMod
    1. CORemember that Ruby does a lot of metaprogramming. `Net::HTTP::Post` might be a reference to a class created at runtime or dynamically somehow. Its [ruby-doc page](http://ruby-doc.org/stdlib-2.0.0/libdoc/net/http/rdoc/Net/HTTP/Post.html) implies as much, I'm guessing that it's just an alias for `HTTPGenericRequest` with the HTTP method preinitialised to `"POST"`
      singulars
      1. POHow do I make sense of Ruby documentation?
      1. USmillimoose
    2. COmillimoose: I've noticed that. Are there any conventions there that will give me some idea as to how to do that? Any good documentation on using the Net::HTTP module given that ri doesn't always provide good documentation in this situation?
      singulars
      1. POHow do I make sense of Ruby documentation?
      1. USArafangion
    3. COWhich version of Ruby are you running?
      singulars
      1. POHow do I make sense of Ruby documentation?
      1. USVidya
 

Querying!

 
Guidance
A row detail

Detail views are divided into sections. All the information in the data section comes from columns in the selected row. The other sections display data from other, related rows.

Related data can be related in a to-one or a to-many fashion. Captions of data related in a to-many fashion link to a list view showing a filtered view of the table.

Try moving around until you find a non-empty to-many entry and click on the label to get to one. You can move back to the root by clicking on the database name in the header.

SQuiL has stopped working due to an internal error.

If you are curious you may find further information in the browser console, which is accessible through the devtools (F12).

Reload