[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[nongnu] elpa/xml-rpc 960b2510e3 61/64: Update README
From: |
Stefan Kangas |
Subject: |
[nongnu] elpa/xml-rpc 960b2510e3 61/64: Update README |
Date: |
Fri, 31 Dec 2021 20:11:16 -0500 (EST) |
branch: elpa/xml-rpc
commit 960b2510e3bc05ba94bff95d9f20a5443b2d2058
Author: Mark A. Hershberger <mah@nichework.com>
Commit: Mark A. Hershberger <mah@nichework.com>
Update README
---
README.org | 149 ++++++++++++++++++++++++++++++++++++++++++++++++++++---------
xml-rpc.el | 4 +-
2 files changed, 131 insertions(+), 22 deletions(-)
diff --git a/README.org b/README.org
index ac678853cf..f0d4e5ff3c 100644
--- a/README.org
+++ b/README.org
@@ -1,13 +1,26 @@
* Commentary:
+[[https://melpa.org/#/xml-rpc][file:https://melpa.org/packages/xml-rpc-badge.svg]]
+
+This is an [[http://xmlrpc.com/][XML-RPC]] client implementation in elisp,
capable of both synchronous and asynchronous method calls (using the url
package's async retrieval functionality).
-This is an XML-RPC client implementation in elisp, capable of both synchronous
and asynchronous method calls (using the url package's async retrieval
functionality).
XML-RPC is remote procedure calls over HTTP using XML to describe the function
call and return values.
xml-rpc.el represents XML-RPC datatypes as lisp values, automatically
converting to and from the XML datastructures as needed, both for method
parameters and return values, making using XML-RPC methods fairly transparent
to the lisp code.
* Installation:
-If you use ELPA (http://tromey.com/elpa), you can install via the M-x
package-list-packages interface. This is preferrable as you will have access to
updates automatically.
+If you use [[http://elpa.gnu.org/][ELPA]], and have configured the
[[https://melpa.org/][MELPA]] repository, then =M-x package-install RET xml-rpc
RET= interface. This is preferrable as you will have access to updates
automatically.
+
+If you would like to use ELPA, but this is your first time to use it or MELPA,
then try evaluating the following code in emacs:
+#+begin_src elisp
+ (progn
+ (require 'package)
+ (add-to-list 'package-archives '("melpa" . "https://melpa.org/packages/")
t)
+ (unless (package-installed-p 'xml-rpc)
+ (with-temp-buffer
+ (url-insert-file-contents
"https://raw.githubusercontent.com/xml-rpc-el/xml-rpc-el/master/xml-rpc.el")
+ (package-install-from-buffer))))
+#+end_src
Otherwise, just make sure this file in your load-path (usually =~/.emacs.d= is
included) and put
#+begin_src elisp
@@ -17,7 +30,7 @@ in your =~/.emacs= or =~/.emacs.d/init.el= file.
* Requirements
-xml-rpc.el uses the url package for http handling and =xml.el= for XML parsing
or, if you have Emacs 27 with =libxml= included, =libxml=. url is a part of the
W3 browser package. The url package that is part of Emacs 22+ works great.
+xml-rpc.el uses the url package for http handling and =xml.el= for XML parsing
or, if you have Emacs 27+ with =libxml= included, =libxml=. The url package
that is part of Emacs works fine.
* Bug reports
@@ -59,25 +72,121 @@ Here follows some examples demonstrating the use of
xml-rpc.el
#+end_src
** Some real world working examples for fun and play
-
-*** Check the temperature (celsius) outside jonas@codefactory.se's apartment
+These were last tested working on 2020-09-06.
+*** Fetch the first state name from UserLand's server
#+begin_src elisp
-(xml-rpc-method-call
- "http://flint.bengburken.net:80/xmlrpc/onewire_temp.php"
- 'onewire.getTemp)
+ (xml-rpc-method-call "http://betty.userland.com/rpc2"
+ 'examples.getStateName '(1))
#+end_src
-*** Fetch the latest NetBSD news the past 5 days from O'reillynet
+#+RESULTS:
+: Alabama
+*** Get a list of supported methods from a blog
#+begin_src elisp
-(xml-rpc-method-call "http://www.oreillynet.com/meerkat/xml-rpc/server.php"
- 'meerkat.getItems
- '(("channel" . 1024)
- ("search" . "/NetBSD/")
- ("time_period" . "5DAY")
- ("ids" . 0)
- ("descriptions" . 200)
- ("categories" . 0)
- ("channels" . 0)
- ("dates" . 0)
- ("num_items" . 5)))
+ (mapconcat (lambda (s) (when s s))
+ (xml-rpc-method-call "https://hexmode.wordpress.com/xmlrpc.php"
+ 'mt.supportedMethods)
+ "\n")
#+end_src
+
+#+RESULTS:
+#+begin_example
+wp.getUsersBlogs
+wp.newPost
+wp.editPost
+wp.deletePost
+wp.getPost
+wp.getPosts
+wp.newTerm
+wp.editTerm
+wp.deleteTerm
+wp.getTerm
+wp.getTerms
+wp.getTaxonomy
+wp.getTaxonomies
+wp.getUser
+wp.getUsers
+wp.getProfile
+wp.editProfile
+wp.getPage
+wp.getPages
+wp.newPage
+wp.deletePage
+wp.editPage
+wp.getPageList
+wp.getAuthors
+wp.getCategories
+wp.getTags
+wp.newCategory
+wp.deleteCategory
+wp.suggestCategories
+wp.uploadFile
+wp.deleteFile
+wp.getCommentCount
+wp.getPostStatusList
+wp.getPageStatusList
+wp.getPageTemplates
+wp.getOptions
+wp.setOptions
+wp.getComment
+wp.getComments
+wp.deleteComment
+wp.editComment
+wp.newComment
+wp.getCommentStatusList
+wp.getMediaItem
+wp.getMediaLibrary
+wp.getPostFormats
+wp.getPostType
+wp.getPostTypes
+wp.getRevisions
+wp.restoreRevision
+blogger.getUsersBlogs
+blogger.getUserInfo
+blogger.getPost
+blogger.getRecentPosts
+blogger.newPost
+blogger.editPost
+blogger.deletePost
+metaWeblog.newPost
+metaWeblog.editPost
+metaWeblog.getPost
+metaWeblog.getRecentPosts
+metaWeblog.getCategories
+metaWeblog.newMediaObject
+metaWeblog.deletePost
+metaWeblog.getUsersBlogs
+mt.getCategoryList
+mt.getRecentPostTitles
+mt.getPostCategories
+mt.setPostCategories
+mt.supportedMethods
+mt.supportedTextFilters
+mt.getTrackbackPings
+mt.publishPost
+pingback.ping
+pingback.extensions.getPingbacks
+demo.sayHello
+demo.addTwoNumbers
+wpStats.get_key
+wpStats.check_key
+wpStats.get_blog_id
+wpStats.get_site_id
+wpStats.update_bloginfo
+wpStats.update_postinfo
+wpStats.ping_blog
+wpStats.flush_posts
+wpcom.get_user_blogids
+wpcom.getFeatures
+wpcom.addApplicationPassword
+wpcom.blackberryUploadFile
+wpcom.blackberryGetUploadingFileKeys
+wpcom.getUsersSubs
+wpcom.set_mobile_push_notification_settings
+wpcom.get_mobile_push_notification_settings
+wpcom.mobile_push_register_token
+wpcom.mobile_push_unregister_token
+wpcom.mobile_push_set_blogs_list
+wpcom.mobile_push_win_phone_get_last_notification
+#+end_example
+
diff --git a/xml-rpc.el b/xml-rpc.el
index 9b9463410a..46e4772a1f 100644
--- a/xml-rpc.el
+++ b/xml-rpc.el
@@ -11,8 +11,8 @@
;; Version: 1.6.15
;; Created: May 13 2001
;; Keywords: xml rpc network
-;; URL: http://github.com/hexmode/xml-rpc-el
-;; Last Modified: <2020-09-06 18:40:07 mah>
+;; URL: http://github.com/xml-rpc-el/xml-rpc-el
+;; Last Modified: <2020-09-06 20:07:23 mah>
(defconst xml-rpc-version "1.6.15"
"Current version of xml-rpc.el")
- [nongnu] elpa/xml-rpc 750fd4fb15 17/64: On functions that are conditionally defined, (xml-debug-print, timezone-parse-date), take them out of the eval-when-compile block so that they're compiled into .elc files. (url): Make sure url-http is loaded to avoid warnings later about let-bound variables. (xml-rpc-value-arrayp): Also verify that it is not a dateTime value., (continued)
- [nongnu] elpa/xml-rpc 750fd4fb15 17/64: On functions that are conditionally defined, (xml-debug-print, timezone-parse-date), take them out of the eval-when-compile block so that they're compiled into .elc files. (url): Make sure url-http is loaded to avoid warnings later about let-bound variables. (xml-rpc-value-arrayp): Also verify that it is not a dateTime value., Stefan Kangas, 2021/12/31
- [nongnu] elpa/xml-rpc c8b5e022cd 23/64: Apply Leo's patches, Stefan Kangas, 2021/12/31
- [nongnu] elpa/xml-rpc 0bdeb7d339 26/64: fix problem with debugging & another extra var xemacs found, Stefan Kangas, 2021/12/31
- [nongnu] elpa/xml-rpc 8d06f89027 35/64: xml-rpc.el: add xml-rpc-request-extra-headers variable, Stefan Kangas, 2021/12/31
- [nongnu] elpa/xml-rpc 822f5bc020 34/64: Incorporate changes from LaTeX Track Changes, Stefan Kangas, 2021/12/31
- [nongnu] elpa/xml-rpc 80809710fc 31/64: Integrate patches from Stefan Kangas: * add support for i8 * fix byte compile warnings, Stefan Kangas, 2021/12/31
- [nongnu] elpa/xml-rpc 6019352966 39/64: Add the beginning of rudimentary tests., Stefan Kangas, 2021/12/31
- [nongnu] elpa/xml-rpc 7a4ea6c22e 38/64: History update and version bump, Stefan Kangas, 2021/12/31
- [nongnu] elpa/xml-rpc 86c73a69fa 48/64: Use lexical-binding, Stefan Kangas, 2021/12/31
- [nongnu] elpa/xml-rpc bc781d6edd 51/64: Merge pull request #15 from skangas/lexical-binding, Stefan Kangas, 2021/12/31
- [nongnu] elpa/xml-rpc 960b2510e3 61/64: Update README,
Stefan Kangas <=
- [nongnu] elpa/xml-rpc bc331d010b 56/64: Test CI, Stefan Kangas, 2021/12/31
- [nongnu] elpa/xml-rpc 9fa979302b 63/64: Merge pull request #17 from xml-rpc-el/ci, Stefan Kangas, 2021/12/31
- [nongnu] elpa/xml-rpc 7b4d6c4820 04/64: Update copyright. (xml-rpc-response-errorp): make safe., Stefan Kangas, 2021/12/31
- [nongnu] elpa/xml-rpc 4efc188b7f 53/64: Merge pull request #13 from skangas/version-number, Stefan Kangas, 2021/12/31
- [nongnu] elpa/xml-rpc a190759da8 41/64: Merge pull request #2 from mdorman/master, Stefan Kangas, 2021/12/31
- [nongnu] elpa/xml-rpc 7bcf1427b7 07/64: (xml-rpc-value-datep): New function to determine if a string is an ISO date. (xml-rpc-value-to-xml-list): Add support for vector inputs. Add support for strings that are really dates., Stefan Kangas, 2021/12/31
- [nongnu] elpa/xml-rpc bfa3f97259 09/64: Clean up long lines, address bugs, use string-to-number instead of obsolete string-to-int., Stefan Kangas, 2021/12/31
- [nongnu] elpa/xml-rpc 417f3d2a94 12/64: (xml-entity-alist): provide a definition for really old versions of xml.el. (xml-rpc-use-coding-system): Make unicode variables dependent on the existence of utf-8 coding-system. Generally allow use of Emacs that don't understand Unicode -- although the HTTP headers still claim to be UTF-8. Update backwards-compatibility code after testing against XEmacs21., Stefan Kangas, 2021/12/31
- [nongnu] elpa/xml-rpc 725bc20829 14/64: Bump the version. (xml-rpc-fault-string, xml-rpc-fault-code): Defvar some previously un-declared vars. (xml-rpc-value-intp, xml-rpc-value-doublep) (xml-rpc-value-stringp): Change from defun to defsubst for consistency. (xml-rpc-request, xml-rpc-list-to-value, xml-rpc-clean): Fix compilation warnings, Stefan Kangas, 2021/12/31
- [nongnu] elpa/xml-rpc 68d54c3c0f 11/64: (xml-rpc-xml-list-to-value): Make sure XML-RPC's dateTime.iso8601 is handled. (xml-rpc-datetime-to-string): Grab the right piece of data. (xml-rpc-request-process-buffer): Kill buffer if not debugging. (timezone-parse-date): Conditionally override if the version we have can't handle iso8601 basic format., Stefan Kangas, 2021/12/31