mirror of
				https://github.com/python/cpython.git
				synced 2025-11-04 11:49:12 +00:00 
			
		
		
		
	
		
			
				
	
	
		
			212 lines
		
	
	
	
		
			7.2 KiB
		
	
	
	
		
			Python
		
	
	
	
	
	
			
		
		
	
	
			212 lines
		
	
	
	
		
			7.2 KiB
		
	
	
	
		
			Python
		
	
	
	
	
	
"""Tests for packaging.command.upload_docs."""
 | 
						|
import os
 | 
						|
import sys
 | 
						|
import shutil
 | 
						|
import zipfile
 | 
						|
 | 
						|
from packaging.command import upload_docs as upload_docs_mod
 | 
						|
from packaging.command.upload_docs import (upload_docs, zip_dir,
 | 
						|
                                           encode_multipart)
 | 
						|
from packaging.dist import Distribution
 | 
						|
from packaging.errors import PackagingFileError, PackagingOptionError
 | 
						|
 | 
						|
from packaging.tests import unittest, support
 | 
						|
try:
 | 
						|
    import threading
 | 
						|
    from packaging.tests.pypi_server import PyPIServerTestCase
 | 
						|
except ImportError:
 | 
						|
    threading = None
 | 
						|
    PyPIServerTestCase = object
 | 
						|
 | 
						|
 | 
						|
EXPECTED_MULTIPART_OUTPUT = [
 | 
						|
    b'---x',
 | 
						|
    b'Content-Disposition: form-data; name="username"',
 | 
						|
    b'',
 | 
						|
    b'wok',
 | 
						|
    b'---x',
 | 
						|
    b'Content-Disposition: form-data; name="password"',
 | 
						|
    b'',
 | 
						|
    b'secret',
 | 
						|
    b'---x',
 | 
						|
    b'Content-Disposition: form-data; name="picture"; filename="wok.png"',
 | 
						|
    b'',
 | 
						|
    b'PNG89',
 | 
						|
    b'---x--',
 | 
						|
    b'',
 | 
						|
]
 | 
						|
 | 
						|
PYPIRC = """\
 | 
						|
[distutils]
 | 
						|
index-servers = server1
 | 
						|
 | 
						|
[server1]
 | 
						|
repository = %s
 | 
						|
username = real_slim_shady
 | 
						|
password = long_island
 | 
						|
"""
 | 
						|
 | 
						|
 | 
						|
@unittest.skipIf(threading is None, "Needs threading")
 | 
						|
class UploadDocsTestCase(support.TempdirManager,
 | 
						|
                         support.EnvironRestorer,
 | 
						|
                         support.LoggingCatcher,
 | 
						|
                         PyPIServerTestCase):
 | 
						|
 | 
						|
    restore_environ = ['HOME']
 | 
						|
 | 
						|
    def setUp(self):
 | 
						|
        super(UploadDocsTestCase, self).setUp()
 | 
						|
        self.tmp_dir = self.mkdtemp()
 | 
						|
        self.rc = os.path.join(self.tmp_dir, '.pypirc')
 | 
						|
        os.environ['HOME'] = self.tmp_dir
 | 
						|
        self.dist = Distribution()
 | 
						|
        self.dist.metadata['Name'] = "distr-name"
 | 
						|
        self.cmd = upload_docs(self.dist)
 | 
						|
 | 
						|
    def test_default_uploaddir(self):
 | 
						|
        sandbox = self.mkdtemp()
 | 
						|
        previous = os.getcwd()
 | 
						|
        os.chdir(sandbox)
 | 
						|
        try:
 | 
						|
            os.mkdir("build")
 | 
						|
            self.prepare_sample_dir("build")
 | 
						|
            self.cmd.ensure_finalized()
 | 
						|
            self.assertEqual(self.cmd.upload_dir, os.path.join("build", "docs"))
 | 
						|
        finally:
 | 
						|
            os.chdir(previous)
 | 
						|
 | 
						|
    def test_default_uploaddir_looks_for_doc_also(self):
 | 
						|
        sandbox = self.mkdtemp()
 | 
						|
        previous = os.getcwd()
 | 
						|
        os.chdir(sandbox)
 | 
						|
        try:
 | 
						|
            os.mkdir("build")
 | 
						|
            self.prepare_sample_dir("build")
 | 
						|
            os.rename(os.path.join("build", "docs"), os.path.join("build", "doc"))
 | 
						|
            self.cmd.ensure_finalized()
 | 
						|
            self.assertEqual(self.cmd.upload_dir, os.path.join("build", "doc"))
 | 
						|
        finally:
 | 
						|
            os.chdir(previous)
 | 
						|
 | 
						|
    def prepare_sample_dir(self, sample_dir=None):
 | 
						|
        if sample_dir is None:
 | 
						|
            sample_dir = self.mkdtemp()
 | 
						|
        os.mkdir(os.path.join(sample_dir, "docs"))
 | 
						|
        self.write_file(os.path.join(sample_dir, "docs", "index.html"), "Ce mortel ennui")
 | 
						|
        self.write_file(os.path.join(sample_dir, "index.html"), "Oh la la")
 | 
						|
        return sample_dir
 | 
						|
 | 
						|
    def test_zip_dir(self):
 | 
						|
        source_dir = self.prepare_sample_dir()
 | 
						|
        compressed = zip_dir(source_dir)
 | 
						|
 | 
						|
        zip_f = zipfile.ZipFile(compressed)
 | 
						|
        self.assertEqual(zip_f.namelist(), ['index.html', 'docs/index.html'])
 | 
						|
 | 
						|
    def test_encode_multipart(self):
 | 
						|
        fields = [('username', 'wok'), ('password', 'secret')]
 | 
						|
        files = [('picture', 'wok.png', b'PNG89')]
 | 
						|
        content_type, body = encode_multipart(fields, files, b'-x')
 | 
						|
        self.assertEqual(b'multipart/form-data; boundary=-x', content_type)
 | 
						|
        self.assertEqual(EXPECTED_MULTIPART_OUTPUT, body.split(b'\r\n'))
 | 
						|
 | 
						|
    def prepare_command(self):
 | 
						|
        self.cmd.upload_dir = self.prepare_sample_dir()
 | 
						|
        self.cmd.ensure_finalized()
 | 
						|
        self.cmd.repository = self.pypi.full_address
 | 
						|
        self.cmd.username = "username"
 | 
						|
        self.cmd.password = "password"
 | 
						|
 | 
						|
    def test_upload(self):
 | 
						|
        self.prepare_command()
 | 
						|
        self.cmd.run()
 | 
						|
 | 
						|
        self.assertEqual(len(self.pypi.requests), 1)
 | 
						|
        handler, request_data = self.pypi.requests[-1]
 | 
						|
        self.assertIn(b"content", request_data)
 | 
						|
        self.assertIn("Basic", handler.headers['authorization'])
 | 
						|
        self.assertTrue(handler.headers['content-type']
 | 
						|
            .startswith('multipart/form-data;'))
 | 
						|
 | 
						|
        action, name, version, content =\
 | 
						|
            request_data.split("----------------GHSKFJDLGDS7543FJKLFHRE75642756743254".encode())[1:5]
 | 
						|
 | 
						|
 | 
						|
        # check that we picked the right chunks
 | 
						|
        self.assertIn(b'name=":action"', action)
 | 
						|
        self.assertIn(b'name="name"', name)
 | 
						|
        self.assertIn(b'name="version"', version)
 | 
						|
        self.assertIn(b'name="content"', content)
 | 
						|
 | 
						|
        # check their contents
 | 
						|
        self.assertIn(b'doc_upload', action)
 | 
						|
        self.assertIn(b'distr-name', name)
 | 
						|
        self.assertIn(b'docs/index.html', content)
 | 
						|
        self.assertIn(b'Ce mortel ennui', content)
 | 
						|
 | 
						|
    def test_https_connection(self):
 | 
						|
        https_called = False
 | 
						|
 | 
						|
        orig_https = upload_docs_mod.http.client.HTTPSConnection
 | 
						|
 | 
						|
        def https_conn_wrapper(*args):
 | 
						|
            nonlocal https_called
 | 
						|
            https_called = True
 | 
						|
            # the testing server is http
 | 
						|
            return upload_docs_mod.http.client.HTTPConnection(*args)
 | 
						|
 | 
						|
        upload_docs_mod.http.client.HTTPSConnection = https_conn_wrapper
 | 
						|
        try:
 | 
						|
            self.prepare_command()
 | 
						|
            self.cmd.run()
 | 
						|
            self.assertFalse(https_called)
 | 
						|
 | 
						|
            self.cmd.repository = self.cmd.repository.replace("http", "https")
 | 
						|
            self.cmd.run()
 | 
						|
            self.assertTrue(https_called)
 | 
						|
        finally:
 | 
						|
            upload_docs_mod.http.client.HTTPSConnection = orig_https
 | 
						|
 | 
						|
    def test_handling_response(self):
 | 
						|
        self.pypi.default_response_status = '403 Forbidden'
 | 
						|
        self.prepare_command()
 | 
						|
        self.cmd.run()
 | 
						|
        self.assertIn('Upload failed (403): Forbidden', self.get_logs()[-1])
 | 
						|
 | 
						|
        self.pypi.default_response_status = '301 Moved Permanently'
 | 
						|
        self.pypi.default_response_headers.append(("Location", "brand_new_location"))
 | 
						|
        self.cmd.run()
 | 
						|
        self.assertIn('brand_new_location', self.get_logs()[-1])
 | 
						|
 | 
						|
    def test_reads_pypirc_data(self):
 | 
						|
        self.write_file(self.rc, PYPIRC % self.pypi.full_address)
 | 
						|
        self.cmd.repository = self.pypi.full_address
 | 
						|
        self.cmd.upload_dir = self.prepare_sample_dir()
 | 
						|
        self.cmd.ensure_finalized()
 | 
						|
        self.assertEqual(self.cmd.username, "real_slim_shady")
 | 
						|
        self.assertEqual(self.cmd.password, "long_island")
 | 
						|
 | 
						|
    def test_checks_index_html_presence(self):
 | 
						|
        self.cmd.upload_dir = self.prepare_sample_dir()
 | 
						|
        os.remove(os.path.join(self.cmd.upload_dir, "index.html"))
 | 
						|
        self.assertRaises(PackagingFileError, self.cmd.ensure_finalized)
 | 
						|
 | 
						|
    def test_checks_upload_dir(self):
 | 
						|
        self.cmd.upload_dir = self.prepare_sample_dir()
 | 
						|
        shutil.rmtree(os.path.join(self.cmd.upload_dir))
 | 
						|
        self.assertRaises(PackagingOptionError, self.cmd.ensure_finalized)
 | 
						|
 | 
						|
    def test_show_response(self):
 | 
						|
        self.prepare_command()
 | 
						|
        self.cmd.show_response = True
 | 
						|
        self.cmd.run()
 | 
						|
        record = self.get_logs()[-1]
 | 
						|
        self.assertTrue(record, "should report the response")
 | 
						|
        self.assertIn(self.pypi.default_response_data, record)
 | 
						|
 | 
						|
def test_suite():
 | 
						|
    return unittest.makeSuite(UploadDocsTestCase)
 | 
						|
 | 
						|
if __name__ == "__main__":
 | 
						|
    unittest.main(defaultTest="test_suite")
 |