Automatic Image & Video File(s) Hosting in Cloudinary through Python

1. Installing python3.#

Kita perlu meng-install Python3 terlebih dahulu jika belum memilikinya.

Untuk memastikan Python3 sudah terpasang, gunakan perintah:

1
python --version

2. Creating python venv.#

INFO

Apa itu virtual environment (venv)?

Sederhananya, virtual environment dalam Python adalah lingkungan khusus (virtual) yang menyediakan paket-paket penting (python interpreter, libraries, dan binaries) yang dapat mendukung pembuatan suatu project (library atau aplikasi). Disebut lingkungan khusus (virtual) karena lingkungan ini (atau kita sebut saja folder / direktori) terisolasi dari software/paket yang ter-install di sistem operasi.

Untuk membuat Python virtual environment untuk Cloudinary kita sekaligus mengaktifkannya, gunakan perintah:

1
python -m venv cloudinary # membuat virtual environment
2
source cloudinary/bin/activate # mengaktifkan virtual environment

Keterangan:
Bagian “cloudinary” tersebut adalah nama folder yang akan dibuat oleh Python. Jadi, bagian tersebut dapat diganti dengan preferensi nama yang diinginkan.

3. Installing cloudinary via pip#

Kita masuk ke dalam direktori “cloudinary” yang tadi sudah berhasil dibuat, kemudian, kita akan meng-install cloudinary melalui binary pip yang terdapat dalam virtual environment tersebut.

1
cd cloudinary
2
./bin/pip install cloudinary

4. Creating a script#

Sekarang, kita akan membuat script Python yang akan mengotomatisasi proses upload filenya.

Berikut adalah script Python yang sudah disediakan oleh Cloudinary:

1
import cloudinary
2
import cloudinary.uploader
3
from cloudinary.utils import cloudinary_url
4

5
# Configuration
6
cloudinary.config(
7
    cloud_name = "<your_cloud_name>",
8
    api_key = "<your_api_key>",
9
    api_secret = "<your_api_secret>", # Click 'View API Keys' above to copy your API secret
10
    secure=True
11
)
12

13
# Upload an image
14
upload_result = cloudinary.uploader.upload("https://res.cloudinary.com/demo/image/upload/getting-started/shoes.jpg",public_id="shoes")
15
print(upload_result["secure_url"])
16

17
# Optimize delivery by resizing and applying auto-format and auto-quality
18
optimize_url, _ = cloudinary_url("shoes", fetch_format="auto", quality="auto")
19
print(optimize_url)
20

21
# Transform the image: auto-crop to square aspect_ratio
22
auto_crop_url, _ = cloudinary_url("shoes", width=500, height=500, crop="auto", gravity="auto")
23
print(auto_crop_url)

Yang perlu kita perhatikan dari kode di atas adalah bagian API credentials-nya, yaitu:

• cloud_name
• api_key
• api_secret

Dan tentu saja:

• upload_result

APIs are mechanisms that enable two software components to communicate with each other using a set of definitions and protocols. For example, the weather bureau’s software system contains daily weather data. The weather app on your phone “talks” to this system via APIs and shows you daily weather updates on your phone.³

Kita perlu mengisi API creds-nya dengan value yang benar. Untuk mengetahuinya, kita hanya perlu mengklik bagian “View API keys” di bagian bawah:

Sebelum menjalankan script-nya, biasanya saya juga meng-comment bagian “Optimize delivery …” dan “Transform the image…” karena tidak memerlukannya.

Sehingga, kurang lebih, final script-nya nanti akan seperti ini:

Running the script#

Kita coba jalankan…

1
./bin/python main.py

Berhasil!

Kita juga dapat melihat file yang berhasil terunggah tersebut di akun Cloudinary kita, pada bagian “Media Explorer”: