Cara menggunakan bagaimana cara mendownload python?

The entire

cd c:\Temp\foo-1.0
python setup.py install
0 package has been deprecated and will be removed in Python 3.12. This documentation is retained as a reference only, and will be removed with the package. See the entry for more information.

Lihat juga

Dokumentasi instalasi modul terbaru. Untuk penggunaan Python biasa, Anda hampir pasti menginginkan dokumen itu daripada yang satu ini.

Catatan

Dokumen ini dipertahankan hanya sampai dokumentasi

cd c:\Temp\foo-1.0
python setup.py install
1 di https://setuptools.readthedocs.io/en/latest/setuptools.html secara independen mencakup semua informasi relevan yang saat ini disertakan di sini.

Catatan

Panduan ini hanya mencakup alat dasar untuk membangun dan mendistribusikan ekstensi yang disediakan sebagai bagian dari versi Python ini. Alat pihak ketiga menawarkan alternatif yang lebih mudah digunakan dan lebih aman. Lihat bagian rekomendasi cepat dalam Panduan Pengguna Pengemasan Python untuk informasi lebih lanjut.

Pengenalan

Di Python 2.0, API

cd c:\Temp\foo-1.0
python setup.py install
0 pertama kali ditambahkan ke pustaka standar. Ini menyediakan pengelola distro Linux dengan cara standar untuk mengubah proyek Python menjadi paket distro Linux, dan administrator sistem dengan cara standar untuk menginstalnya langsung ke sistem target.

Bertahun-tahun sejak Python 2.0 dirilis, menggabungkan sistem build dan penginstal paket dengan erat ke siklus rilis runtime bahasa ternyata menjadi masalah, dan sekarang direkomendasikan agar proyek menggunakan penginstal paket

cd c:\Temp\foo-1.0
python setup.py install
3 dan sistem build
cd c:\Temp\foo-1.0
python setup.py install
1, daripada menggunakan
cd c:\Temp\foo-1.0
python setup.py install
0 secara langsung.

Lihat dan untuk keterangan lebih lanjut.

Dokumentasi warisan ini dipertahankan hanya sampai kami yakin bahwa dokumentasi

cd c:\Temp\foo-1.0
python setup.py install
1 mencakup semua yang diperlukan.

Distribusi sumber berbasis distutils

If you download a module source distribution, you can tell pretty quickly if it was packaged and distributed in the standard way, i.e. using the Distutils. First, the distribution's name and version number will be featured prominently in the name of the downloaded archive, e.g.

cd c:\Temp\foo-1.0
python setup.py install
7 or
cd c:\Temp\foo-1.0
python setup.py install
8. Next, the archive will unpack into a similarly named directory:
cd c:\Temp\foo-1.0
python setup.py install
9 or
python setup.py build
python setup.py install
0. Additionally, the distribution will contain a setup script
python setup.py build
python setup.py install
1, and a file named
python setup.py build
python setup.py install
2 or possibly just
python setup.py build
python setup.py install
3, which should explain that building and installing the module distribution is a simple matter of running one command from a terminal:

python setup.py install

Untuk Windows, perintah ini harus dijalankan dari jendela prompt perintah (Start ‣ Accessories):

setup.py install

Jika semua ini benar, maka Anda telah mengetahui cara membuat dan menginstal modul yang baru saja Anda unduh: Jalankan perintah di atas. Kecuali Anda perlu menginstal sesuatu dengan cara non-standar atau menyesuaikan proses build, Anda tidak benar-benar membutuhkan manual ini. Atau lebih tepatnya, perintah di atas adalah semua yang Anda butuhkan untuk keluar dari manual ini.

Bangun dan Install Standar

Seperti yang dijelaskan di bagian , membangun dan menginstal distribusi modul menggunakan Distutils biasanya merupakan satu perintah sederhana untuk dijalankan dari terminal:

python setup.py install

Variasi platform

Anda harus selalu menjalankan perintah penyiapan dari direktori root distribusi, yaitu subdirektori tingkat atas yang diuraikan oleh distribusi sumber modul. Misalnya, jika Anda baru saja mengunduh distribusi sumber modul

cd c:\Temp\foo-1.0
python setup.py install
7 ke sistem Unix, hal yang normal untuk dilakukan adalah:

gunzip -c foo-1.0.tar.gz | tar xf -    # unpacks into directory foo-1.0
cd foo-1.0
python setup.py install

Di Windows, Anda mungkin mengunduh

python setup.py build
python setup.py install
5. Jika Anda mengunduh file arsip ke
python setup.py build
python setup.py install
6, maka file akan diurai menjadi
python setup.py build
python setup.py install
7; Anda dapat menggunakan manipulator arsip dengan antarmuka pengguna grafis (seperti WinZip) atau alat baris perintah (seperti unzip atau pkunzip) untuk mengekstrak arsip. Kemudian, buka jendela prompt perintah dan jalankan:

cd c:\Temp\foo-1.0
python setup.py install

Membagi pekerjaan

Menjalankan

python setup.py build
python setup.py install
8 akan membangun dan menginstal semua modul dalam satu proses. Jika Anda lebih suka bekerja secara bertahap---terutama berguna jika Anda ingin menyesuaikan proses build, atau jika ada yang sesuatu salah---Anda dapat menggunakan skrip penyiapan untuk melakukan satu hal dalam satu waktu. Ini sangat membantu ketika build dan install akan dilakukan oleh pengguna yang berbeda---misalnya, Anda mungkin ingin membangun distribusi modul dan menyerahkannya ke administrator sistem untuk instalasi (atau lakukan sendiri, dengan hak istimewa super-user ).

Misalnya, Anda bisa membangun semuanya dalam satu langkah, lalu menginstal semuanya di langkah kedua, dengan menjalankan skrip pengaturan dua kali:

python setup.py build
python setup.py install

Jika Anda melakukan ini, Anda akan melihat bahwa menjalankan perintah install pertama-tama akan menjalankan perintah build, yang---dalam hal ini---dapat dengan cepat memberi tahu bahwa itu tidak ada hubungannya, karena semua yang ada di direktori

python setup.py build
python setup.py install
9 adalah yang terbaru.

Anda mungkin tidak memerlukan kemampuan ini untuk memecah banyak hal jika yang Anda lakukan hanyalah menginstal modul yang diunduh dari 'net, tetapi ini sangat berguna untuk tugas-tugas yang lebih lanjut. Jika Anda mulai mendistribusikan modul dan ekstensi Python Anda sendiri, Anda akan menjalankan banyak perintah Distutils tersendiri.

Bagaimana pembangunan bekerja

Seperti yang tersirat di atas, perintah build bertanggung jawab untuk menempatkan file yang akan diinstal ke dalam direktori build. Standarnya, ini adalah

python setup.py build
python setup.py install
9 di bawah root distribusi; jika Anda terlalu mengkhawatirkan kecepatan, atau ingin menjaga struktur kode sumber tetap murni, Anda dapat mengubah direktori build dengan opsi
python setup.py build --build-base=/path/to/pybuild/foo-1.0
1. Sebagai contoh:

python setup.py build --build-base=/path/to/pybuild/foo-1.0

(Atau Anda dapat melakukan ini secara permanen dengan arahan di sistem Anda atau file konfigurasi Distutils pribadi; lihat bagian .) Biasanya, ini tidak perlu.

Tata letak default untuk build tree adalah sebagai berikut:

--- build/ --- lib/
or
--- build/ --- lib.<plat>/
               temp.<plat>/

di mana

python setup.py build --build-base=/path/to/pybuild/foo-1.0
2 berkembang menjadi deskripsi singkat tentang OS/platform perangkat keras dan versi Python saat ini. Bentuk pertama, hanya dengan direktori
python setup.py build --build-base=/path/to/pybuild/foo-1.0
3, digunakan untuk "distribusi modul murni"---yaitu, distribusi modul yang hanya menyertakan modul Python murni. Jika distribusi modul berisi ekstensi apa pun (modul yang ditulis dalam C/C++), maka bentuk kedua, dengan dua direktori
python setup.py build --build-base=/path/to/pybuild/foo-1.0
2, digunakan. Dalam hal ini, direktori
python setup.py build --build-base=/path/to/pybuild/foo-1.0
5 menyimpan file sementara yang dihasilkan oleh proses kompilasi/tautan yang sebenarnya tidak terinstal. Dalam kedua kasus tersebut, direktori
python setup.py build --build-base=/path/to/pybuild/foo-1.0
3 (atau
python setup.py build --build-base=/path/to/pybuild/foo-1.0
7) berisi semua modul Python (Python murni dan ekstensi) yang akan diinstal.

Di masa mendatang, lebih banyak direktori akan ditambahkan untuk menangani skrip Python, dokumentasi, biner yang dapat dieksekusi, dan apa pun yang diperlukan untuk menangani pekerjaan penginstalan modul dan aplikasi Python.

Bagaimana instalasi bekerja

Setelah perintah build dijalankan (apakah Anda menjalankannya secara eksplisit, atau perintah install yang melakukannya untuk Anda), cara kerja perintah install relatif sederhana: semua yang harus dilakukan adalah menyalin semua yang ada di bawah

python setup.py build --build-base=/path/to/pybuild/foo-1.0
8 (atau
python setup.py build --build-base=/path/to/pybuild/foo-1.0
9) ke direktori instalasi yang Anda pilih.

If you don't choose an installation directory---i.e., if you just run

python setup.py build
python setup.py install
8---then the install command installs to the standard location for third-party Python modules. This location varies by platform and by how you built/installed Python itself. On Unix (and macOS, which is also Unix-based), it also depends on whether the module distribution being installed is pure Python or contains extensions ("non-pure"):

Platform

Lokasi installasi standar

Nilai bawaan

Catatan

Unix (murni)

--- build/ --- lib/
or
--- build/ --- lib.<plat>/
               temp.<plat>/
1

--- build/ --- lib/
or
--- build/ --- lib.<plat>/
               temp.<plat>/
2

(1)

Unix (tidak murni)

--- build/ --- lib/
or
--- build/ --- lib.<plat>/
               temp.<plat>/
3

--- build/ --- lib/
or
--- build/ --- lib.<plat>/
               temp.<plat>/
2

(1)

Windows

--- build/ --- lib/
or
--- build/ --- lib.<plat>/
               temp.<plat>/
5

--- build/ --- lib/
or
--- build/ --- lib.<plat>/
               temp.<plat>/
6

(2)

Catatan:

  1. Kebanyakan distribusi Linux menyertakan Python sebagai bagian standar sistem, jadi

    --- build/ --- lib/
    or
    --- build/ --- lib.<plat>/
                   temp.<plat>/
    
    7 dan
    --- build/ --- lib/
    or
    --- build/ --- lib.<plat>/
                   temp.<plat>/
    
    8 biasanya keduanya
    --- build/ --- lib/
    or
    --- build/ --- lib.<plat>/
                   temp.<plat>/
    
    9 di Linux. Jika Anda membuat Python sendiri di Linux (atau sistem serupa Unix), bawaan
    --- build/ --- lib/
    or
    --- build/ --- lib.<plat>/
                   temp.<plat>/
    
    7 dan
    --- build/ --- lib/
    or
    --- build/ --- lib.<plat>/
                   temp.<plat>/
    
    8 adalah
    Python 2.4 (#26, Aug  7 2004, 17:19:02)
    Type "help", "copyright", "credits" or "license" for more information.
    >>> import sys
    >>> sys.prefix
    '/usr'
    >>> sys.exec_prefix
    '/usr'
    
    2.

  2. Direktori instalasi default pada Windows adalah

    Python 2.4 (#26, Aug  7 2004, 17:19:02)
    Type "help", "copyright", "credits" or "license" for more information.
    >>> import sys
    >>> sys.prefix
    '/usr'
    >>> sys.exec_prefix
    '/usr'
    
    3 di bawah Python 1.6a1, 1.5.2, dan sebelumnya.

--- build/ --- lib/
or
--- build/ --- lib.<plat>/
               temp.<plat>/
7 and
--- build/ --- lib/
or
--- build/ --- lib.<plat>/
               temp.<plat>/
8 stand for the directories that Python is installed to, and where it finds its libraries at run-time. They are always the same under Windows, and very often the same under Unix and macOS. You can find out what your Python installation uses for
--- build/ --- lib/
or
--- build/ --- lib.<plat>/
               temp.<plat>/
7 and
--- build/ --- lib/
or
--- build/ --- lib.<plat>/
               temp.<plat>/
8 by running Python in interactive mode and typing a few simple commands. Under Unix, just type
Python 2.4 (#26, Aug  7 2004, 17:19:02)
Type "help", "copyright", "credits" or "license" for more information.
>>> import sys
>>> sys.prefix
'/usr'
>>> sys.exec_prefix
'/usr'
8 at the shell prompt. Under Windows, choose Start ‣ Programs ‣ Python X.Y ‣ Python (command line). Once the interpreter is started, you type Python code at the prompt. For example, on my Linux system, I type the three Python statements shown below, and get the output as shown, to find out my
--- build/ --- lib/
or
--- build/ --- lib.<plat>/
               temp.<plat>/
7 and
--- build/ --- lib/
or
--- build/ --- lib.<plat>/
               temp.<plat>/
8:

Python 2.4 (#26, Aug  7 2004, 17:19:02)
Type "help", "copyright", "credits" or "license" for more information.
>>> import sys
>>> sys.prefix
'/usr'
>>> sys.exec_prefix
'/usr'

Beberapa placeholder lain digunakan dalam dokumen ini:

python setup.py install --user
1 adalah singkatan dari versi Python, misalnya
python setup.py install --user
2 di UNIX biasanya akan menggunakan
python setup.py install --user
3 di Windows.

Jika Anda tidak ingin menginstal modul ke lokasi standar, atau jika Anda tidak memiliki izin untuk menulis di sana, maka Anda perlu membaca tentang instalasi alternatif di bagian . Jika Anda ingin mengubah direktori instalasi Anda lebih berat, lihat bagian pada instalasi kustom.

Instalasi Alternatif

Seringkali, kita perlu atau ingin menginstal modul ke lokasi selain lokasi standar untuk modul Python pihak ketiga. Misalnya, pada sistem Unix Anda mungkin tidak memiliki izin untuk menulis ke direktori modul standar pihak ketiga. Atau Anda mungkin ingin mencoba modul sebelum menjadikannya sebagai bagian standar dari instalasi Python lokal Anda. Hal ini terutama berlaku saat memutakhirkan distribusi yang sudah ada: Anda ingin memastikan basis skrip yang ada masih berfungsi dengan versi baru sebelum benar-benar memutakhirkan.

Perintah Distutils install dirancang untuk membuat distribusi modul instalasi ke lokasi alternatif sederhana dan tidak menyakitkan. Ide dasarnya adalah Anda menyediakan direktori dasar untuk instalasi, dan perintah install memilih sekumpulan direktori (disebut skema instalasi) di bawah direktori dasar ini untuk menginstal file. Detailnya berbeda di setiap platform, jadi bacalah bagian mana pun berikut ini yang sesuai untuk Anda.

Perhatikan bahwa berbagai skema instalasi alternatif sama-sama eksklusif: Anda dapat memberikan

python setup.py install --user
4, atau
python setup.py install --user
5, atau
python setup.py install --user
6 dan
python setup.py install --user
7, atau
python setup.py install --user
8 dan
python setup.py install --user
9, tetapi Anda tidak dapat mencampur dari grup ini.

Instalasi alternatif: skema user

Skema ini dirancang untuk menjadi solusi yang paling nyaman bagi pengguna yang tidak memiliki izin menulis ke direktori paket situs global atau tidak ingin menginstalnya. Ini diaktifkan dengan opsi sederhana:

python setup.py install --user

Files will be installed into subdirectories of (written as

setup.py install
01 hereafter). This scheme installs pure Python modules and extension modules in the same location (also known as ). Here are the values for UNIX, including macOS:

Tipe file

Direktori instalasi

modul

setup.py install
03

skrip

setup.py install
04

data

setup.py install
01

C header

setup.py install
06

Dan inilah nilai yang digunakan di Windows:

Tipe file

Direktori instalasi

modul

setup.py install
07

skrip

setup.py install
08

data

setup.py install
01

C header

setup.py install
10

Keuntungan menggunakan skema ini dibandingkan dengan skema lain yang dijelaskan di bawah ini adalah direktori paket situs pengguna dalam kondisi normal selalu disertakan dalam (lihat untuk informasi lebih lanjut), yang mana berarti tidak ada langkah tambahan yang harus dilakukan setelah menjalankan skrip

python setup.py build
python setup.py install
1 untuk menyelesaikan instalasi.

Perintah build_ext juga memiliki opsi

python setup.py install --user
4 untuk menambahkan
setup.py install
15 ke path pencarian compiler untuk file header dan
setup.py install
16 ke path pencarian compiler untuk pustaka serta ke path pencarian runtime untuk pustaka C bersama (rpath).

Instalasi alternatif: skema home

Ide di balik "skema home" adalah Anda membangun dan memelihara simpanan pribadi modul Python. Nama skema ini berasal dari ide direktori "home" di Unix, karena bukan hal yang aneh bagi pengguna Unix untuk membuat direktori home mereka memiliki layout yang mirip dengan

setup.py install
17 atau
setup.py install
18. Skema ini dapat digunakan oleh siapa saja, terlepas dari sistem operasi yang mereka instal.

Menginstal distribusi modul baru semudah

setup.py install
0

di mana Anda dapat menyediakan direktori apa pun yang Anda suka untuk opsi

python setup.py install --user
5. Di Unix, juru ketik yang malas cukup mengetik tilde (
setup.py install
20); perintah install akan memperluas ini ke direktori home Anda:

setup.py install
1

Untuk membuat Python menemukan distribusi yang diinstal dengan skema ini, Anda mungkin harus atau edit

setup.py install
21 (lihat ) untuk memanggil atau edit .

Opsi

python setup.py install --user
5 menentukan direktori dasar instalasi. File diinstal ke direktori berikut di bawah basis penginstalan sebagai berikut:

Tipe file

Direktori instalasi

modul

setup.py install
26

skrip

setup.py install
27

data

setup.py install
28

C header

setup.py install
29

(Ganti garis miring dengan garis miring terbalik jika Anda menggunakan Windows.)

Instalasi alternatif: Unix (skema prefiks)

"Skema prefiks" berguna ketika Anda ingin menggunakan satu instalasi Python untuk melakukan build/install (yaitu, untuk menjalankan skrip pengaturan), tetapi menginstal modul ke direktori modul pihak ketiga dari instalasi Python yang berbeda (atau sesuatu yang terlihat seperti instalasi Python yang berbeda). Jika ini terdengar agak tidak biasa, itulah mengapa skema pengguna dan home datang sebelumnya. Namun, setidaknya ada dua kasus yang diketahui di mana skema prefiks akan berguna.

Pertama, pertimbangkan bahwa banyak distribusi Linux meletakkan Python di

--- build/ --- lib/
or
--- build/ --- lib.<plat>/
               temp.<plat>/
9, daripada yang lebih tradisional
Python 2.4 (#26, Aug  7 2004, 17:19:02)
Type "help", "copyright", "credits" or "license" for more information.
>>> import sys
>>> sys.prefix
'/usr'
>>> sys.exec_prefix
'/usr'
2. Ini sepenuhnya sesuai, karena dalam kasus tersebut Python adalah bagian dari "sistem" daripada add-on lokal. Namun, jika Anda menginstal modul Python dari sumber, Anda mungkin ingin modul tersebut masuk ke
setup.py install
32 daripada
setup.py install
33. Ini dapat dilakukan dengan:

setup.py install
2

Kemungkinan lain adalah sistem file jaringan di mana nama yang digunakan untuk menulis ke direktori remote berbeda dari nama yang digunakan untuk membacanya: misalnya, interpreter Python diakses sebagai

setup.py install
34 mungkin mencari modul dalam
setup.py install
32, tetapi modul tersebut harus dipasang ke, misalnya,
setup.py install
36. Ini bisa dilakukan dengan

setup.py install
3

Dalam kedua kasus tersebut, opsi

python setup.py install --user
6 menentukan basis instalasi, dan opsi
python setup.py install --user
7 menentukan basis instalasi khusus platform, yang digunakan untuk file khusus platform. (Saat ini, ini hanya berarti distribusi modul non-murni, tetapi dapat diperluas ke pustaka C, biner yang dapat dieksekusi, dll.) Jika
python setup.py install --user
7 tidak disediakan, defaultnya adalah
python setup.py install --user
6. File diinstal sebagai berikut:

Tipe file

Direktori instalasi

Modul Python

--- build/ --- lib/
or
--- build/ --- lib.<plat>/
               temp.<plat>/
1

modul ekstensi

--- build/ --- lib/
or
--- build/ --- lib.<plat>/
               temp.<plat>/
3

skrip

setup.py install
43

data

--- build/ --- lib/
or
--- build/ --- lib.<plat>/
               temp.<plat>/
7

C header

setup.py install
45

Tidak ada persyaratan bahwa

python setup.py install --user
6 atau
python setup.py install --user
7 sebenarnya mengarah ke instalasi Python alternatif; jika direktori yang tercantum di atas belum ada, mereka dibuat pada saat instalasi.

Secara kebetulan, alasan sebenarnya mengapa skema prefiks penting adalah karena instalasi Unix standar menggunakan skema prefiks, tetapi dengan

python setup.py install --user
6 dan
python setup.py install --user
7 disediakan oleh Python sendiri sebagai
setup.py install
50 dan
setup.py install
51. Jadi, Anda mungkin berpikir Anda tidak akan pernah menggunakan skema prefiks, tetapi setiap kali Anda menjalankan
setup.py install
52 tanpa opsi lain, Anda menggunakannya.

Perhatikan bahwa menginstal ekstensi ke instalasi Python alternatif tidak berpengaruh pada bagaimana ekstensi tersebut dibuat: khususnya, file header Python (

setup.py install
53 dan teman-teman) yang diinstal dengan interpreter Python yang digunakan untuk menjalankan skrip pengaturan akan digunakan dalam menyusun ekstensi. Anda bertanggung jawab untuk memastikan bahwa penafsir yang digunakan untuk menjalankan ekstensi yang dipasang dengan cara ini kompatibel dengan interpreter yang digunakan untuk membuatnya. Cara terbaik untuk melakukannya adalah dengan memastikan bahwa kedua interpreter adalah versi Python yang sama (kemungkinan build berbeda, atau mungkin salinan build yang sama). (Tentu saja, jika
python setup.py install --user
6 dan
python setup.py install --user
7 Anda bahkan tidak menunjuk ke instalasi Python alternatif, ini tidak penting.)

Instalasi alternatif: Windows (skema prefiks)

Windows tidak memiliki konsep direktori home pengguna, dan karena instalasi Python standar di bawah Windows lebih sederhana daripada di bawah Unix, opsi

python setup.py install --user
6 secara tradisional digunakan untuk menginstal paket tambahan di lokasi terpisah pada Windows.:

setup.py install
4

untuk menginstal modul ke direktori

setup.py install
57 pada drive saat ini.

Basis instalasi ditentukan oleh opsi

python setup.py install --user
6; opsi
python setup.py install --user
7 tidak didukung pada Windows, yang berarti modul Python murni dan modul ekstensi diinstal ke lokasi yang sama. File diinstal sebagai berikut:

Tipe file

Direktori instalasi

modul

--- build/ --- lib/
or
--- build/ --- lib.<plat>/
               temp.<plat>/
5

skrip

setup.py install
61

data

--- build/ --- lib/
or
--- build/ --- lib.<plat>/
               temp.<plat>/
7

C header

setup.py install
63

Instalasi kustom

Terkadang, skema instalasi alternatif yang dijelaskan di bagian tidak melakukan apa yang Anda inginkan. Anda mungkin ingin mengubah hanya satu atau dua direktori sambil menyimpan semuanya di bawah direktori dasar yang sama, atau Anda mungkin ingin sepenuhnya mendefinisikan ulang skema instalasi. Dalam kedua kasus tersebut, Anda membuat skema penginstalan kustom.

Untuk membuat skema penginstalan kustom, Anda mulai dengan salah satu skema alternatif dan mengganti beberapa direktori penginstalan yang digunakan untuk berbagai jenis file, menggunakan opsi berikut:

Tipe file

Opsi timpa

Modul Python

setup.py install
64

modul ekstensi

setup.py install
65

semua modul

setup.py install
66

skrip

setup.py install
67

data

setup.py install
68

C header

setup.py install
69

Opsi timpa ini dapat bersifat relatif, absolut, atau secara eksplisit ditentukan dalam salah satu direktori dasar instalasi. (Ada dua direktori dasar instalasi, dan biasanya sama---mereka hanya berbeda ketika Anda menggunakan "skema prefiks" Unix dan memberikan opsi

python setup.py install --user
6 dan
python setup.py install --user
7 yang berbeda; menggunakan
setup.py install
72 dan
setup.py install
65, dan direkomendasikan untuk skema yang tidak membuat perbedaan antara Python dan modul ekstensi.)

Misalnya, Anda menginstal distribusi modul ke direktori home Anda di bawah Unix---tetapi Anda ingin skrip masuk ke dalam

setup.py install
74 daripada
setup.py install
75. Seperti yang Anda duga, Anda dapat mengganti direktori ini dengan opsi
setup.py install
67; dalam kasus ini, akan lebih masuk akal untuk menyediakan jalur relatif, yang akan ditafsirkan relatif terhadap direktori dasar instalasi (direktori home Anda, dalam hal ini):

setup.py install
5

Contoh Unix lainnya: misalkan instalasi Python Anda dibangun dan diinstal dengan prefiks

setup.py install
77, jadi di bawah skrip instalasi standar akan berakhir di
setup.py install
78. Jika Anda menginginkannya di
setup.py install
79, Anda harus menyediakan direktori absolut ini untuk opsi
setup.py install
67:

setup.py install
6

(Ini melakukan instalasi menggunakan "skema prefiks", di mana prefix adalah apa pun yang telah diinstal interpreter Python Anda dengan---

setup.py install
77 dalam kasus ini.)

Jika Anda mempertahankan Python di Windows, Anda mungkin ingin modul pihak ketiga berada di subdirektori

--- build/ --- lib/
or
--- build/ --- lib.<plat>/
               temp.<plat>/
7, bukan tepat di dalam
--- build/ --- lib/
or
--- build/ --- lib.<plat>/
               temp.<plat>/
7 itu sendiri. Ini hampir semudah menyesuaikan direktori instalasi skrip---Anda hanya perlu ingat bahwa ada dua jenis modul yang perlu dikhawatirkan, Python dan modul ekstensi, yang dapat dikontrol dengan mudah oleh satu opsi:

setup.py install
7

Direktori instalasi yang ditentukan relatif terhadap

--- build/ --- lib/
or
--- build/ --- lib.<plat>/
               temp.<plat>/
7. Tentu saja, Anda juga harus memastikan bahwa direktori ini berada di path pencarian modul Python, seperti dengan meletakkan file
setup.py install
85 di direktori situs (lihat ). Lihat bagian untuk mengetahui cara memodifikasi path pencarian Python.

Jika Anda ingin menentukan seluruh skema instalasi, Anda hanya perlu menyediakan semua opsi direktori instalasi. Cara yang disarankan untuk melakukan ini adalah dengan menyediakan path relatif; misalnya, jika Anda ingin mempertahankan semua file terkait modul Python di bawah

Python 2.4 (#26, Aug  7 2004, 17:19:02)
Type "help", "copyright", "credits" or "license" for more information.
>>> import sys
>>> sys.prefix
'/usr'
>>> sys.exec_prefix
'/usr'
8 di direktori home Anda, dan Anda ingin direktori terpisah untuk setiap platform tempat Anda menggunakan direktori home, Anda dapat menentukan skema instalasi berikut:

setup.py install
8

atau, setara,

setup.py install
9

setup.py install
88 bukanlah (harus) variabel environment---itu akan diperluas oleh Distutils saat ia mem-parsing opsi baris perintah Anda, seperti yang dilakukannya saat mem-parsing file konfigurasi Anda.

Jelas, menentukan seluruh skema instalasi setiap kali Anda menginstal distribusi modul baru akan sangat membosankan. Dengan demikian, Anda dapat meletakkan opsi ini ke dalam file konfigurasi Distutils Anda (lihat bagian ):

python setup.py install
0

atau, setara,

python setup.py install
1

Perhatikan bahwa keduanya tidak setara jika Anda menyediakan direktori dasar penginstalan yang berbeda saat Anda menjalankan skrip penataan. Sebagai contoh,:

python setup.py install
2

akan menginstal modul murni ke

setup.py install
89 dalam kasus pertama, dan ke
setup.py install
90 dalam kasus kedua. (Untuk kasus kedua, Anda mungkin ingin menyediakan basis instalasi
setup.py install
91.)

Anda mungkin memperhatikan penggunaan

setup.py install
92 dan
setup.py install
88 di sampel input file konfigurasi. Ini adalah variabel konfigurasi Distutils, yang memiliki kemiripan yang kuat dengan variabel environment. Faktanya, Anda dapat menggunakan variabel environment dalam file konfigurasi pada platform yang memiliki gagasan seperti itu tetapi Distutils juga menetapkan beberapa variabel tambahan yang mungkin tidak ada di environment Anda, seperti
setup.py install
88. (Dan tentu saja, pada sistem yang tidak memiliki variabel environment, seperti Mac OS 9, variabel konfigurasi yang disediakan oleh Distutils adalah satu-satunya yang dapat Anda gunakan.) Lihat bagian untuk detailnya.

Catatan

Ketika a diaktifkan, setiap opsi yang mengubah path instalasi akan diabaikan dari semua file konfigurasi distutils untuk mencegah penginstalan proyek di luar lingkungan virtual secara tidak sengaja.

Memodifikasi Path Pencarian Python

Ketika interpreter Python menjalankan , ia mencari kode Python dan modul ekstensi di sepanjang path pencarian. Nilai default untuk path dikonfigurasikan ke dalam biner Python saat interpreter dibuat. Anda dapat menentukan path dengan mengimport modul dan mencetak nilai

setup.py install
11.:

python setup.py install
3

String null dalam

setup.py install
11 mewakili direktori kerja saat ini.

Konvensi yang diharapkan untuk paket yang diinstal secara lokal adalah dengan meletakkannya di direktori

setup.py install
99, tetapi Anda mungkin ingin menginstal modul Python ke dalam direktori arbitrer. Misalnya, situs Anda mungkin memiliki konvensi untuk menyimpan semua perangkat lunak yang terkait dengan server web di bawah
python setup.py install
00. Add-on modul Python mungkin termasuk dalam
python setup.py install
01, dan untuk mengimpornya, direktori ini harus ditambahkan ke
setup.py install
11. Ada beberapa cara berbeda untuk menambahkan direktori.

Cara yang paling mudah adalah dengan menambahkan path file konfigurasi ke direktori yang sudah ada di path Python, biasanya ke direktori

python setup.py install
03. File konfigurasi path memiliki ekstensi
setup.py install
85, dan setiap baris harus berisi satu path yang akan ditambahkan ke
setup.py install
11. (Karena path baru ditambahkan ke
setup.py install
11, modul dalam direktori yang ditambahkan tidak akan menimpa modul standar. Ini berarti Anda tidak dapat menggunakan mekanisme ini untuk menginstal versi tetap dari modul standar.)

Path bisa absolut atau relatif, dalam hal ini mereka relatif terhadap direktori yang berisi file

setup.py install
85. Lihat dokumentasi modul untuk informasi lebih lanjut.

Cara yang sedikit kurang nyaman adalah dengan mengedit file

python setup.py install
09 di pustaka standar Python, dan memodifikasi
setup.py install
11.
python setup.py install
09 secara otomatis diimpor saat interpreter Python dijalankan, kecuali jika opsi disediakan untuk menahan perilaku ini. Jadi Anda cukup mengedit
python setup.py install
09 dan menambahkan dua baris padanya:

python setup.py install
4

Namun, jika Anda menginstal ulang versi utama Python yang sama (mungkin saat meningkatkan dari 2.2 ke 2.2.2, misalnya)

python setup.py install
09 akan ditimpa oleh versi stok. Anda harus ingat bahwa itu telah diubah dan menyimpan salinannya sebelum melakukan instalasi.

Ada dua variabel environment yang dapat mengubah

setup.py install
11. menetapkan nilai alternatif untuk prefiks instalasi Python. Misalnya, jika disetel ke
python setup.py install
01, path pencarian akan disetel ke
python setup.py install
19.

Variabel dapat disetel ke daftar path yang akan ditambahkan ke awal

setup.py install
11. Misalnya, jika disetel ke
python setup.py install
23, pencarian path akan dimulai dengan
python setup.py install
24. (Perhatikan bahwa direktori harus ada agar dapat ditambahkan ke
setup.py install
11; modul menghapus path yang tidak ada.)

Akhirnya,

setup.py install
11 hanyalah daftar Python biasa, jadi aplikasi Python apa pun dapat memodifikasinya dengan menambahkan atau menghapus entri.

File Konfigurasi Distutils

Seperti disebutkan di atas, Anda dapat menggunakan file konfigurasi Distutils untuk merekam preferensi pribadi atau situs untuk setiap opsi Distutils. Artinya, opsi apa pun untuk perintah apa pun dapat disimpan di salah satu dari dua atau tiga file konfigurasi (bergantung pada platform Anda), yang akan dikonsultasikan sebelum baris perintah diurai. Ini berarti bahwa file konfigurasi akan menimpa nilai default, dan baris perintah pada gilirannya akan menimpa file konfigurasi. Selain itu, jika beberapa file konfigurasi diterapkan, nilai dari file "sebelumnya" akan ditimpa oleh file "nantinya".

Lokasi dan nama file konfigurasi

The names and locations of the configuration files vary slightly across platforms. On Unix and macOS, the three configuration files (in the order they are processed) are:

Tipe file

Lokasi dan nama file

Catatan

system

python setup.py install
28

(1)

personal

python setup.py install
29

(2)

lokal

python setup.py install
30

(3)

Dan di Windows, file konfigurasinya adalah:

Tipe file

Lokasi dan nama file

Catatan

system

python setup.py install
31

(4)

personal

python setup.py install
32

(5)

lokal

python setup.py install
30

(3)

On all platforms, the "personal" file can be temporarily disabled by passing the

python setup.py install
34 option.

Catatan:

  1. Sebenarnya, file konfigurasi seluruh sistem berada di direktori tempat Distutils diinstal; di bawah Python 1.6 dan yang lebih baru di Unix, ini seperti yang ditunjukkan. Untuk Python 1.5.2, Distutils biasanya akan diinstal ke

    python setup.py install
    
    35, jadi file konfigurasi sistem harus diletakkan di sana dengan Python 1.5.2.

  2. Pada Unix, jika variabel environment

    python setup.py install
    
    36 tidak ditentukan, direktori home pengguna akan ditentukan dengan fungsi
    python setup.py install
    
    37 dari modul standar . Ini dilakukan oleh fungsi yang digunakan oleh Distutils.

  3. Yaitu, di direktori saat ini (biasanya lokasi skrip pengaturan).

  4. (Lihat juga catatan (1).) Di bawah Python 1.6 dan yang lebih baru, "prefiks instalasi" default Python adalah

    python setup.py install
    
    40, jadi file konfigurasi sistem biasanya
    python setup.py install
    
    41. Di bawah Python 1.5.2, prefiks defaultnya adalah
    Python 2.4 (#26, Aug  7 2004, 17:19:02)
    Type "help", "copyright", "credits" or "license" for more information.
    >>> import sys
    >>> sys.prefix
    '/usr'
    >>> sys.exec_prefix
    '/usr'
    
    3, dan Distutils bukan bagian dari standar pustaka---jadi file konfigurasi sistemnya adalah
    python setup.py install
    
    43 dalam instalasi Python 1.5.2 standar pada Windows.

  5. Pada Windows, jika variabel environment

    python setup.py install
    
    36 tidak ditentukan,
    python setup.py install
    
    45 maka
    python setup.py install
    
    46 dan
    python setup.py install
    
    47 akan dicoba. Ini dilakukan oleh fungsi yang digunakan oleh Distutils.

Sintaks file konfigurasi

Semua file konfigurasi Distutils memiliki sintaks yang sama. File konfigurasi dikelompokkan menjadi beberapa bagian. Ada satu bagian untuk setiap perintah Distutils, ditambah bagian

python setup.py install
49 untuk opsi global yang memengaruhi setiap perintah. Setiap bagian terdiri dari satu opsi per baris, ditentukan sebagai
python setup.py install
50.

Misalnya, berikut ini adalah file konfigurasi lengkap yang memaksa semua perintah untuk berjalan diam-diam secara default:

python setup.py install
5

Jika ini dipasang sebagai file konfigurasi sistem, ini akan memengaruhi semua pemrosesan distribusi modul Python oleh pengguna mana pun di sistem saat ini. Jika diinstal sebagai file konfigurasi pribadi Anda (pada sistem yang mendukungnya), ini hanya akan memengaruhi distribusi modul yang diproses oleh Anda. Dan jika digunakan sebagai

python setup.py install
30 untuk distribusi modul tertentu, ini hanya mempengaruhi distribusi tersebut.

Anda dapat menimpa direktori "build base" default dan membuat perintah build* selalu secara paksa membangun kembali semua file dengan yang berikut ini:

python setup.py install
6

yang sesuai dengan argumen baris perintah

python setup.py install
7

kecuali itu menyertakan perintah build pada baris perintah berarti bahwa perintah akan dijalankan. Memasukkan perintah tertentu dalam file konfigurasi tidak memiliki implikasi seperti itu; ini hanya berarti bahwa jika perintah dijalankan, opsi di file konfigurasi akan diterapkan. (Atau jika perintah lain yang memperoleh nilai darinya dijalankan, perintah tersebut akan menggunakan nilai di file konfigurasi.)

Anda dapat menemukan daftar lengkap opsi untuk setiap perintah menggunakan opsi

python setup.py install
52, misalnya:

python setup.py install
8

dan Anda dapat mengetahui daftar lengkap opsi global dengan menggunakan

python setup.py install
52 tanpa perintah:

python setup.py install
9

Lihat juga bagian "Referensi" dari manual "Mendistribusikan Modul Python".

Membangun Ekstensi: Tip dan Trik

Jika memungkinkan, Distutils mencoba menggunakan informasi konfigurasi yang disediakan oleh interpreter Python yang digunakan untuk menjalankan skrip

python setup.py build
python setup.py install
1. Misalnya, penanda compiler dan linker yang sama yang digunakan untuk mengompilasi Python juga akan digunakan untuk mengompilasi ekstensi. Biasanya ini akan bekerja dengan baik, tetapi dalam situasi yang rumit ini mungkin tidak tepat. Bagian ini membahas cara mengganti perilaku Distutils yang biasa.

Menyesuaikan penanda compiler/linker

Mengompilasi ekstensi Python yang ditulis dalam C atau C ++ kadang-kadang akan memerlukan spesifikasi penanda khusus untuk compiler dan linker untuk menggunakan library tertentu atau menghasilkan jenis kode objek khusus. Ini terutama benar jika ekstensi belum diuji pada platform Anda, atau jika Anda mencoba mengkompilasi silang Python.

Dalam kasus yang paling umum, pembuat ekstensi mungkin telah memperkirakan bahwa kompilasi ekstensi akan menjadi rumit, dan menyediakan file

python setup.py install
55 file untuk Anda edit. Ini kemungkinan besar hanya akan dilakukan jika distribusi modul berisi banyak modul ekstensi terpisah, atau jika mereka sering membutuhkan kumpulan tanda compiler yang rumit agar dapat berfungsi.

File

python setup.py install
55, jika ada, diurai untuk mendapatkan daftar ekstensi yang akan dibuat. Setiap baris dalam
python setup.py install
55 menjelaskan modul tunggal. Garis memiliki struktur berikut:

gunzip -c foo-1.0.tar.gz | tar xf -    # unpacks into directory foo-1.0
cd foo-1.0
python setup.py install
0

Mari kita periksa masing-masing bidang secara bergantian.

  • module adalah nama modul ekstensi yang akan dibuat, dan harus merupakan Python identifier yang valid. Anda tidak bisa begitu saja mengubah ini untuk mengganti nama modul (pengeditan ke kode sumber juga akan diperlukan), jadi ini harus dibiarkan saja.

  • sourcefile adalah segala sesuatu yang cenderung menjadi file kode sumber, setidaknya dilihat dari nama filenya. Nama file yang diakhiri dengan

    python setup.py install
    
    58 diasumsikan ditulis dalam C, nama file yang diakhiri dengan
    python setup.py install
    
    59,
    python setup.py install
    
    60, dan
    python setup.py install
    
    61 diasumsikan sebagai C++, dan nama file yang diakhiri dengan
    python setup.py install
    
    62 atau
    python setup.py install
    
    63 diasumsikan berada dalam Objective C.

  • cpparg adalah argumen untuk preprocessor C, dan apa pun yang dimulai dengan

    python setup.py install
    
    64,
    python setup.py install
    
    65,
    python setup.py install
    
    66 atau :option:!-C .

  • library adalah apapun yang diakhiri dengan

    python setup.py install
    
    67 atau dimulai dengan
    python setup.py install
    
    68 atau
    python setup.py install
    
    69.

Jika platform tertentu memerlukan pustaka khusus pada platform Anda, Anda dapat menambahkannya dengan mengedit file

python setup.py install
55 dan menjalankan
python setup.py install
71. Misalnya, jika modul ditentukan oleh baris:

gunzip -c foo-1.0.tar.gz | tar xf -    # unpacks into directory foo-1.0
cd foo-1.0
python setup.py install
1

harus ditautkan dengan pustaka math

python setup.py install
72 pada platform Anda, cukup tambahkan
python setup.py install
73 ke baris:

gunzip -c foo-1.0.tar.gz | tar xf -    # unpacks into directory foo-1.0
cd foo-1.0
python setup.py install
2

Sakelar arbitrer yang ditujukan untuk compiler atau linker dapat diberikan dengan opsi

python setup.py install
74 arg dan opsi
python setup.py install
75 arg:

gunzip -c foo-1.0.tar.gz | tar xf -    # unpacks into directory foo-1.0
cd foo-1.0
python setup.py install
3

Opsi berikutnya setelah

python setup.py install
74 dan
python setup.py install
75 akan ditambahkan ke baris perintah yang tepat, jadi pada contoh di atas kompilator akan diberikan opsi
python setup.py install
78, dan penaut akan diberikan
python setup.py install
79. Jika opsi kompilator membutuhkan sebuah argumen, Anda harus menyediakan beberapa opsi
python setup.py install
74; misalnya, untuk meneruskan
python setup.py install
81 file
python setup.py install
55 harus berisi
python setup.py install
83.

Penanda compiler juga bisa diberikan melalui pengaturan variabel environment . Jika disetel, konten akan ditambahkan ke penanda kompilator yang ditentukan dalam file

python setup.py install
55.

Menggunakan kompiler non-Microsoft di Windows

Borland/CodeGear C ++

This subsection describes the necessary steps to use Distutils with the Borland C++ compiler version 5.5. First you have to know that Borland's object file format (OMF) is different from the format used by the Python version you can download from the Python or ActiveState web site. (Python is built with Microsoft Visual C++, which uses COFF as the object file format.) For this reason you have to convert Python's library

python setup.py install
87 into the Borland format. You can do this as follows:

gunzip -c foo-1.0.tar.gz | tar xf -    # unpacks into directory foo-1.0
cd foo-1.0
python setup.py install
4

Program

python setup.py install
88 dilengkapi dengan compiler Borland. File
python setup.py install
87 ada di direktori
python setup.py install
90 dari instalasi Python Anda. Jika ekstensi Anda menggunakan pustaka lain (zlib, ...) Anda juga harus mengonversinya.

File yang dikonversi harus berada di direktori yang sama dengan pustaka normal.

Bagaimana Distutils mengelola untuk menggunakan pustaka ini dengan nama yang berubah? Jika ekstensi memerlukan pustaka (mis.

python setup.py install
91) Distutils memeriksa terlebih dahulu apakah ia menemukan pustaka dengan sufiks
python setup.py install
92 (mis.
python setup.py install
93) dan kemudian menggunakan pustaka ini. Dalam kasus ia tidak menemukan pustaka khusus ia menggunakan nama default (
python setup.py install
94.) [#] _

Untuk mengizinkan Distutils mengkompilasi ekstensi Anda dengan Borland C++, Anda harus mengetik:

gunzip -c foo-1.0.tar.gz | tar xf -    # unpacks into directory foo-1.0
cd foo-1.0
python setup.py install
5

Jika Anda ingin menggunakan kompiler Borland C++ sebagai default, Anda dapat menentukannya di file konfigurasi pribadi atau sistem untuk Distutils (lihat bagian .)

Lihat juga

C++ Builder Compiler

Informasi tentang compiler C++ gratis dari Borland, termasuk link ke halaman download.

Membuat Ekstensi Python Menggunakan Kompiler Borland Gratis <http://www.cyberus.ca/~g_will/pyExtenDL.shtml> _

Dokumen yang menjelaskan cara menggunakan compiler C++ baris perintah gratis dari Borland untuk membuat Python.

GNU C / Cygwin / MinGW

Bagian ini menjelaskan langkah-langkah yang diperlukan untuk menggunakan Distutils dengan kompiler GNU C/C++ di distribusi Cygwin dan MinGW mereka. Untuk interpreter Python yang dibangun dengan Cygwin, semuanya harus bekerja tanpa langkah-langkah berikut ini.

Tidak semua ekstensi dapat dibuat dengan MinGW atau Cygwin, tetapi banyak yang bisa. Ekstensi yang paling mungkin tidak berfungsi adalah ekstensi yang menggunakan C++ atau bergantung pada ekstensi Microsoft Visual C.

Untuk mengizinkan Distutils mengkompilasi ekstensi Anda dengan Cygwin, Anda harus mengetik:

gunzip -c foo-1.0.tar.gz | tar xf -    # unpacks into directory foo-1.0
cd foo-1.0
python setup.py install
6

dan untuk Cygwin dalam mode no-cygwin atau untuk tipe MinGW:

gunzip -c foo-1.0.tar.gz | tar xf -    # unpacks into directory foo-1.0
cd foo-1.0
python setup.py install
7

Jika Anda ingin menggunakan salah satu opsi/kompiler ini sebagai default, Anda harus mempertimbangkan untuk menulisnya di file konfigurasi pribadi atau seluruh sistem Anda untuk Distutils (lihat bagian .)

Versi Lama Python dan MinGW

Petunjuk berikut hanya berlaku jika Anda menggunakan versi Python yang lebih rendah dari 2.4.1 dengan MinGW yang lebih rendah dari 3.0.0 (dengan binutils-2.13.90-20030111-1).

Kompiler ini membutuhkan beberapa pustaka khusus. Tugas ini lebih kompleks daripada C++ Borland, karena tidak ada program untuk mengonversi pustaka. Pertama, Anda harus membuat daftar simbol yang diekspor Python DLL. (Anda dapat menemukan program yang bagus untuk tugas ini di https://sourceforge.net/projects/mingw/files/MinGW/Extension/pexports/).

gunzip -c foo-1.0.tar.gz | tar xf -    # unpacks into directory foo-1.0
cd foo-1.0
python setup.py install
8

Lokasi dari file yang diinstal

python setup.py install
95 akan tergantung pada opsi instalasi dan versi serta bahasa Windows. Dalam instalasi "hanya untuk saya", ini akan muncul di root direktori instalasi. Dalam instalasi bersama, itu akan ditempatkan di direktori sistem.

Kemudian Anda dapat membuat dari informasi ini pustaka impor untuk gcc.

gunzip -c foo-1.0.tar.gz | tar xf -    # unpacks into directory foo-1.0
cd foo-1.0
python setup.py install
9

Pustaka yang dihasilkan harus ditempatkan di direktori yang sama dengan

python setup.py install
87. (Seharusnya direktori
python setup.py install
97 di bawah direktori instalasi Python Anda.)

Jika ekstensi Anda menggunakan pustaka lain (zlib, ...) Anda mungkin harus mengonversinya juga. File yang dikonversi harus berada di direktori yang sama seperti pustaka normal.

Lihat juga

Building Python modules on MS Windows platform with MinGW

Informasi tentang membangun pustaka yang diperlukan untuk environment MinGW.

Catatan kaki

Ini juga berarti Anda dapat mengganti semua pustaka COFF yang ada dengan pustaka OMF dengan nama yang sama.

Apakah download Python gratis?

Python Tersedia Gratis dan Open-Source Untuk mendownload versi terbaru Python, cukup kunjungi website resmi Python, lalu klik Downloads pada navigation bar, lalu klik tombol Download Python.

Dimana kita bisa mendapatkan aplikasi python?

Cara mendownloadnya adalah cukup dengan cara sederhana dibawah ini:.
Kunjungi www.python.org..
Kamu bisa download python versi terbaru. ... .
Jika kamu memilih mendownload otomatis maka akan langsung terdownload file python-3.10.0-amd64.exe di PC atau laptop kamu..

Bagaimana memulai python?

Buka terminal CTRL + ALT + T..
Ketik python maka Anda akan masuk ke Python shell..
Tuliskan script Python Anda, contoh: print("Selamat datang di Python") . jika sudah tekan tombol ENTER , dan script Python akan dijalankan/eksekusi..
Untuk keluar dari Python shell ketik exit().

Apa itu python dan fungsinya?

Python adalah sebuah bahasa pemrograman yang digunakan untuk membuat aplikasi, perintah komputer, dan melakukan analisis data. Sebagai general-purpose language, Python bisa digunakan untuk membuat program apa saja dan menyelesaikan berbagai permasalahan. Selain itu, Python juga dinilai mudah untuk dipelajari.