LibCurl for AHK

[mcl]

Binding of LibCurl's easy interface for AHK, in case you need more control than WinINET/WinHTTP allows.
Provides functions for ease of use in most common HTTP operations: downloading to file/memory, POSTing forms, handling cookies and tracking progress.

Code: Select all

; Simple example
#Include Libcurl.ahk

; Don't forget to put dlls there!
Curl.Initialize(A_ScriptDir . "\libs")
; Curl.Deinitialize will be called automatically on exit.

myCurl := new Curl()
myCurl.SetUrl("http://example.com")
myCurl.WriteToFile("example_1_httpget.htm")
headBuffer := myCurl.HeaderToMem()
myCurl.Perform()

MsgBox % "Perform result:`n`n"
. myCurl.lastCode " : " myCurl.lastCodeText  ; Should be '0 : No error'

MsgBox % "Headers:`n`n"
. headBuffer.GetAsText("UTF-8")

MsgBox % "Info:`n"
. "`n" . myCurl.GetInfo(Curl.Info.EFFECTIVE_URL)
. "`n" . myCurl.GetInfo(Curl.Info.RESPONSE_CODE)
. "`n" . myCurl.GetInfo(Curl.Info.TOTAL_TIME_T) / 1000000

Required dll-libraries:
• libcurl
• openssl (libcrypto + libssl)

You can download them yourself (links can be found inside LibCurl.ahk file), or take a 7z-archive i prepared here: https://yadi.sk/d/jG67uSxLOHaJOQ
Archive includes both 32/64-bit libcurl and certificate bundle (from curl.se) and openssl libraries from François Piette, all digitally signed and tested.

---

UPDATED 2021-01-06:
Completely rewritten from scratch, fixed storing data in memory, fixed urlencoding/urldecoding, added human-readable error codes (via curl_easy_strerror), added extended curl_version_info, why do you read this, it's not that interesting, you'll probably won't need this anyway, more details in Opt/Info enum tables, some extra functions, handles now cleanup automatically, better callback mechanics and some other things i want to forget.

[mcl]

I rewrote this completely, links and details are in the first post.

If you used it before − get the update, it's much better now (and sometimes even works!)
If you didn't used it − maybe you don't need it, but it's still much better now, just so you know.
If you don't know what it is − it's still a binding of libcurl, all that nerdy network stuff.
If you found a bug − let me know. I won't fix it, but it will lower my self-esteem, so give it a try.
If you have a github − please consider to adopt this ugly piece of code (and all the suffering that comes with it).

[mstrauss2021]

In regards to your script above.

I am learning how to use libcurl and once in awhile I see a script that shows commands that I can't find anywhere else - like yours

Code: Select all

myCurl := new Curl()
myCurl.SetUrl
myCurl.WriteToFile
headBuffer := myCurl.HeaderToMem()
myCurl.Perform()
myCurl.GetInfo

Where can I fins information explaing these commands and showing me more?

I am trying to pull individual string values from website to make it easier to choose what I want and assign to variables. Currently, I can only grab the standard output which is everything.

Any help is appreciated

Mike

[MrHue]

Thank you very much for sharing this library! I learnt a lot from your source!
I tested it very briefly.
Compared to WinInet / WinHttp / XmlHttp, some advantages of Libcurl are
- support for other protocols FTP/SMTP etc (WinInet also supports FTP)
- TLS1.3 support (Windows 11 supports it)
- decode gzip/deflate/broli (WinInet, Xmlhttp also supports it, WinHttp does not support br)
- has many options

Some disadvantages
- Does not support Unicode
- External Libcurl dll required

[thanhkiem]

Code: Select all

Curl.Initialize("Libs")
; Create instance of curl's easy interface
myCurl := new Curl()

myCurl.SetUrl("ftp://xxxx.me/files/a.exe")
myCurl.SetOpt(Curl.Opt.USERNAME, "sammy")
myCurl.SetOpt(Curl.Opt.PASSWORD, "123456")
myCurl.SetOpt(Curl.Opt.UPLOAD, true)

Filename := A_ScriptDir . "\" . "MyIp.exe"
File := FileOpen(Filename, "r")
File.RawRead(BinData, FileLen := File.Length())

myCurl.SetOpt(Curl.Opt.READDATA, &BinData)
myCurl.SetOpt(Curl.Opt.VERBOSE, true)
myCurl.WriteToFile("ftp.txt")
myCurl.Perform()
MsgBox % "Example result:`n"
. "`n" . myCurl.lastCode " : " myCurl.lastCodeText " (from " . myCurl.lastCodeSource . ")"

I want to upload file with ftp but file upload allway have 0 kb.
Can anyone explain it to me?