PageRenderTime 60ms CodeModel.GetById 29ms RepoModel.GetById 0ms app.codeStats 0ms

/README.txt

#
Plain Text | 94 lines | 57 code | 37 blank | 0 comment | 0 complexity | a9ede2bfea201c1db60494c5bf78e4e7 MD5 | raw file
  1. #####################################################################################################
  2. README: Quick and Dirty Feed Parser 1.01
  3. 1. About Quick and Dirty Feed Parser
  4. 2. Features
  5. 3. License Terms (MS-PL)
  6. 4. Contributing to Quick and Dirty Feed Parser
  7. Developed by Aaron Stannard (http://www.aaronstannard.com/) (Twitter: @Aaronontheweb)
  8. If you'd like to contribute to the project, join us at CodePlex! http://qdfeed.codeplex.com/
  9. #####################################################################################################
  10. 1. About Quick and Dirty Feed Parser
  11. What's Quick and Dirty Feed Parser for?
  12. Quick and Dirty Feed Parser is a lightweight .NET library designed to give developers an agnostic way of parsing RSS 2.0 and Atom 1.0 XML syndication formats. QD Feed Parser parses both Atom and RSS feeds into business objects with common interfaces which expose the substance of the feeds - that way you can get to the business of syndicating content without worrying about what format it's in.
  13. Quick and Dirty Feed Parser works with .NET 4.0, Silverlight 4, and Windows Phone 7.
  14. Why should I use Quick and Dirty Feed Parser?
  15. Because it's awesome. QD Feed Parser spares you the banality known as XML parsing. It has a straightforward contract with the developers who use this library:
  16. Pass the URI of a valid RSS/Atom feed to any IFeedFactory object's .CreateFeed method.
  17. Receive a fully populated IFeed object in return, which has all of the same members regardless of whether or not it's an RSS or an Atom feed.
  18. Do anything which violates this contact, promptly receive an Exception in return.
  19. That's it. You send the parser the URI of a valid RSS 2.0 / Atom 1.0 feed and get a simple, populated .NET object in return. No XPath, no LINQ-to-XML, no dicking around with XML namespaces, no XML whatsoever. It's easy.
  20. #####################################################################################################
  21. 2. Quick and Dirty Feed Parser Features
  22. Here's a quick summary of some of the features you might in Quick and Dirty Feed Parser:
  23. -Format-agnostic parsing of Atom 1.0 and RSS 2.0 feeds;
  24. -Seamless consumption of feeds over Http and the file system;
  25. -Synchronous and Asynchronous methods for querying feeds;
  26. -Low memory consumption RSS/Atom objects that are easy to use;
  27. -Easily serializable classes built to work with any type of storage, including IsolatedStorage; and
  28. -Simple, simple, simple interfaces which abstract away 100% of the XML from your feeds. No more parsing. Ever.
  29. If you'd like to learn more, check out our documentation: http://qdfeed.codeplex.com/documentation
  30. #####################################################################################################
  31. 3. Quick and Dirty Feed Parser License (MS-PL)
  32. Microsoft Public License (Ms-PL)
  33. This license governs use of the accompanying software. If you use the software, you accept this license. If you do not accept the license, do not use the software.
  34. 1. Definitions
  35. The terms "reproduce," "reproduction," "derivative works," and "distribution" have the same meaning here as under U.S. copyright law.
  36. A "contribution" is the original software, or any additions or changes to the software.
  37. A "contributor" is any person that distributes its contribution under this license.
  38. "Licensed patents" are a contributor's patent claims that read directly on its contribution.
  39. 2. Grant of Rights
  40. (A) Copyright Grant- Subject to the terms of this license, including the license conditions and limitations in section 3, each contributor grants you a non-exclusive, worldwide, royalty-free copyright license to reproduce its contribution, prepare derivative works of its contribution, and distribute its contribution or any derivative works that you create.
  41. (B) Patent Grant- Subject to the terms of this license, including the license conditions and limitations in section 3, each contributor grants you a non-exclusive, worldwide, royalty-free license under its licensed patents to make, have made, use, sell, offer for sale, import, and/or otherwise dispose of its contribution in the software or derivative works of the contribution in the software.
  42. 3. Conditions and Limitations
  43. (A) No Trademark License- This license does not grant you rights to use any contributors' name, logo, or trademarks.
  44. (B) If you bring a patent claim against any contributor over patents that you claim are infringed by the software, your patent license from such contributor to the software ends automatically.
  45. (C) If you distribute any portion of the software, you must retain all copyright, patent, trademark, and attribution notices that are present in the software.
  46. (D) If you distribute any portion of the software in source code form, you may do so only under this license by including a complete copy of this license with your distribution. If you distribute any portion of the software in compiled or object code form, you may only do so under a license that complies with this license.
  47. (E) The software is licensed "as-is." You bear the risk of using it. The contributors give no express warranties, guarantees or conditions. You may have additional consumer rights under your local laws which this license cannot change. To the extent permitted under your local laws, the contributors exclude the implied warranties of merchantability, fitness for a particular purpose and non-infringement.
  48. #####################################################################################################
  49. 4. Contributing to Quick and Dirty Feed Parser
  50. We'd love to have you contribute to the project and make it better. You can contribute to the project by going to http://qdfeed.codeplex.com/
  51. and joining us on the discussion board, creating issues, or even better - forking the repository and committing changesets!
  52. Here's the software you're going to need to modify Quick and Dirty Feed Parser:
  53. 1. Visual Studio 2010 and above
  54. 2. TortoiseHg (for Mercurial source control)
  55. 3. TortoiseMerge (used by ApprovalTests for executing some of our test cases.)
  56. If you have any questions about the project, please ask them on our discussion board on CodePlex or feel free to reach out to me at http://www.aaronstannard.com/ !
  57. #####################################################################################################