Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/raku-community-modules/lwp-simple
LWP::Simple quick & dirty implementation for Rakudo
https://github.com/raku-community-modules/lwp-simple
raku
Last synced: about 1 month ago
JSON representation
LWP::Simple quick & dirty implementation for Rakudo
- Host: GitHub
- URL: https://github.com/raku-community-modules/lwp-simple
- Owner: raku-community-modules
- License: artistic-2.0
- Created: 2015-12-24T19:06:00.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2023-08-23T22:50:00.000Z (over 1 year ago)
- Last Synced: 2024-07-30T20:11:36.690Z (5 months ago)
- Topics: raku
- Language: Raku
- Homepage: http://www.streppone.it/cosimo/blog/tag/LWP::Simple/
- Size: 181 KB
- Stars: 7
- Watchers: 138
- Forks: 9
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- Changelog: Changes
- License: LICENSE
Awesome Lists containing this project
README
LWP::Simple for Raku
=================
This is a quick & dirty implementation of a LWP::Simple clone for Raku; it does both `GET` and `POST` requests.
Dependencies
============
LWP::Simple depends on the modules MIME::Base64 and URI,
which you can find at http://modules.raku.org/. The tests depends
on [JSON::Tiny](https://github.com/moritz/json).
Write:
zef install --deps-only .
You'll have to
install [IO::Socket::SSL](https://github.com/sergot/io-socket-ssl) via
zef install IO::Socket::SSL
if you want to work with `https` too.
Synopsis
========
```raku
use LWP::Simple;
my $content = LWP::Simple.get("https://raku.org");
my $response = LWP::Simple.post("https://somewhere.topo.st", { so => True }
```
Methods
=======
## get ( $url, [ %headers = {}, Bool :$exception ] )
Sends a GET request to the value of `$url`. Returns the content of the return
request. Errors are ignored and will result in a `Nil` value unless
`$exception` is set to `True`, in which case an `LWP::Simple::Response` object
containing the status code and brief description of the error will be returned.
Requests are make with a default user agent of `LWP::Simple/$VERSION
Raku/$*PERL.compiler.name()` which may get blocked by some web servers. Try
overriding the default user agent header by passing a user agent string to the
`%headers` argument with something like `{ 'User-Agent' => 'Your User-Agent
String' }` if you have trouble getting content back.
Current status
==============
You can
use [HTTP::UserAgent](https://github.com/sergot/http-useragent)
instead, with more options. However, this module will do just fine in
most cases.
The documentation of this module is incomplete. Contributions are appreciated.
Use
===
Use the installed commands:
lwp-download.p6 http://eu.httpbin.org
Or
lwp-download.p6 https://docs.perl6.org
If `ÌO::Socket::SSL` has been installed.
lwp-get.p6 https://raku.org
will instead print to standard output.
Known bugs
==========
According
to
[issues raised](https://github.com/raku-community-modules/LWP-Simple/issues/40),
[in this repo](https://github.com/raku-community-modules/LWP-Simple/issues/28),
there could be some issues with older versions of MacOSx. This issue
does not affect the functionality of the module, but just the test
script itself, so you can safely install with `--force`. Right now,
it's working correctly (as far as tests go) with Windows, MacOSx and
Linux.
License
=======
This distribution is licensed under the terms of
the
[Artistic 2.0 license](https://www.perlfoundation.org/artistic-license-20.html#). You
can find a [copy](LICENSE) in the repository itself.