steverobbins / magedownload-cli

CLI for downloading Magento patches and releases

MageDownload CLI

A PHP tool to automate Magento release and patch downloads using Magento's download API.

Installation

.phar

Download the latest magedownload.phar release.

It's now ready to use: php magedownload.phar help

If you want to make it available anywhere on your system

chmod +x magedownload.phar
mv magedownload.phar /usr/local/bin/magedownload

And can be used: magedownload help

n98 magerun

• Clone to your modules directory
• Install with composer

mkdir -p ~/.n98-magerun/modules
git clone https://github.com/steverobbins/magedownload-cli ~/.n98-magerun/modules/magedownload-cli
cd ~/.n98-magerun/modules/magedownload-cli
curl -sS https://getcomposer.org/installer | php
php composer.phar install

Source

• Clone this repository
• Install with composer

git clone https://github.com/steverobbins/magedownload-cli
cd magedownload-cli
curl -sS https://getcomposer.org/installer | php
php composer.phar install

Usage

See the help command for all command information:

$ php magedownload.phar help

Configuration

To use the Magento download API you must have a user ID and token. These can be generated by logging into your account on magento.com and navigating to Account Settings -> Downloads Access Token.

Once you have your credentials, you can either specify them with each command (using --id and --token options), or use the configure command to save the settings to your environment (in ~/.magedownload/config.yaml).

See php magedownload.phar help configure for details.

Commands

download

$ php magedownload.phar download [<name>] [<destination>] [--extract]

or

$ php n98-magerun.phar download:download [<name>] [<destination>] [--extract]

Downloads the specified file to the given destination. Use the files command to find the correct <name>.

If no name is given, you will be prompted to select a file to download.

If no destination is given, the file is downloaded to current directory.

When --extract is given, the downloaded file will be extracted when possible. The destination must end with .zip, .tar.bz2, or .tar.gz. The files will be extracted to a folder of the same name, without the file extension.

files

$ php magedownload.phar files

or

$ php n98-magerun.phar download:files

Lists files that are available for download.

You may use either --filter-version or --filter-type options to narrow your search. Examples:

• php magedownload.phar files --filter-version 1.9.2.2
• php magedownload.phar files --filter-version "1.9.*"
• php magedownload.phar files --filter-type ce-full

* Due to limitiations with the API, only one filter may be used at a time.

versions

$ php magedownload.phar versions

or

$ php n98-magerun.phar download:versions

Lists all Magento versions that have been released.

Support

Please create an issue for all bugs and feature requests.

Contributing

Fork this repository and send a pull request to the dev branch.

License

Creative Commons Attribution 4.0 International

magedownload-cli's Issues

Command to download all files of one SUPEE patch

It would be quite useful for my workflow, to be able to download all patch files for a specific SUPEE patch, as I manage multiple magento installations with different versions. This might be useful for other users as well, I guess.

My current workflow is to download all patch files manually and put those on my FTP server so I can download the appropriate patch file from all my other servers easily. Also, a colleague has to check each patch file first.

btw: Thanks for this great tool!

Feature: add checksum to info command

Would be nice if we can somehow display the checksums of the files mentioned in the files command.

Can't filter by type and version together

Doesnt work
magedownload files --filter-version 1.9.2.* --filter-type ce-patch
but magedownload files --filter-version 1.9.2.* works fine

PHP Warning: array_merge(): Argument #1 is not an array

PHP Warning:  array_merge(): Argument #1 is not an array in /Users/jeushy/.n98-magerun/modules/magedownload-cli/vendor/steverobbins/magedownload/src/MageDownload/Config.php on line 93

I've tried installing several ways and have tested it with PHP 5.5 and PHP 5.6 installed via homebrew but am having issues with the configuration step saving my account ID and token:

$ n98 download:download --id <MY_MAGENTO_ID> --token <MY_TOKEN> 1.9.2.3
Downloading to /Users/jeushy/code/sandbox/magento/community/test/1.9.2.3...
PHP Warning:  file_get_contents(https://[email protected]/products/downloads/file/1.9.2.3): failed to open stream: HTTP request failed! HTTP/1.1 401 Unauthorized
 in /Users/jeushy/.n98-magerun/modules/magedownload-cli/vendor/steverobbins/magedownload/src/MageDownload/AbstractMageDownload.php on line 45

Warning: file_get_contents(https://[email protected]/products/downloads/file/1.9.2.3): failed to open stream: HTTP request failed! HTTP/1.1 401 Unauthorized
 in /Users/jeushy/.n98-magerun/modules/magedownload-cli/vendor/steverobbins/magedownload/src/MageDownload/AbstractMageDownload.php on line 45

"File Description" is missing

Compared to the output of "www.magentocommerce.com/products/downloads/info/files", the column "File Description" is missing.
This data would be useful to exactly see for which Magento versions the patch is suitable.

missing magento-1.9.1.1

looks like magento-1.9.1.0 download is missing?

download link broken

http://magedownload.steverobbins.com/download/latest/magedownload.phar is currently not reachable (empty response)

Edit: I saw your last commit removed the link to this location. This just broke my MageTestStand (automated) setup. I switched to getting the latest release from github - although it's not that easy to always get the latest release location. Save to close though.

format json returns a list of one big encoded string

Previously this used to return a list of strings of versions

perhaps the API changed?