mirror of
https://github.com/clementine-player/Clementine
synced 2024-12-24 16:51:59 +01:00
249 lines
8.7 KiB
Python
249 lines
8.7 KiB
Python
#!/usr/bin/env python
|
|
#
|
|
# Copyright 2006, 2007 Google Inc. All Rights Reserved.
|
|
# Author: danderson@google.com (David Anderson)
|
|
#
|
|
# Script for uploading files to a Google Code project.
|
|
#
|
|
# This is intended to be both a useful script for people who want to
|
|
# streamline project uploads and a reference implementation for
|
|
# uploading files to Google Code projects.
|
|
#
|
|
# To upload a file to Google Code, you need to provide a path to the
|
|
# file on your local machine, a small summary of what the file is, a
|
|
# project name, and a valid account that is a member or owner of that
|
|
# project. You can optionally provide a list of labels that apply to
|
|
# the file. The file will be uploaded under the same name that it has
|
|
# in your local filesystem (that is, the "basename" or last path
|
|
# component). Run the script with '--help' to get the exact syntax
|
|
# and available options.
|
|
#
|
|
# Note that the upload script requests that you enter your
|
|
# googlecode.com password. This is NOT your Gmail account password!
|
|
# This is the password you use on googlecode.com for committing to
|
|
# Subversion and uploading files. You can find your password by going
|
|
# to http://code.google.com/hosting/settings when logged in with your
|
|
# Gmail account. If you have already committed to your project's
|
|
# Subversion repository, the script will automatically retrieve your
|
|
# credentials from there (unless disabled, see the output of '--help'
|
|
# for details).
|
|
#
|
|
# If you are looking at this script as a reference for implementing
|
|
# your own Google Code file uploader, then you should take a look at
|
|
# the upload() function, which is the meat of the uploader. You
|
|
# basically need to build a multipart/form-data POST request with the
|
|
# right fields and send it to https://PROJECT.googlecode.com/files .
|
|
# Authenticate the request using HTTP Basic authentication, as is
|
|
# shown below.
|
|
#
|
|
# Licensed under the terms of the Apache Software License 2.0:
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
#
|
|
# Questions, comments, feature requests and patches are most welcome.
|
|
# Please direct all of these to the Google Code users group:
|
|
# http://groups.google.com/group/google-code-hosting
|
|
|
|
"""Google Code file uploader script.
|
|
"""
|
|
|
|
__author__ = 'danderson@google.com (David Anderson)'
|
|
|
|
import httplib
|
|
import os.path
|
|
import optparse
|
|
import getpass
|
|
import base64
|
|
import sys
|
|
|
|
|
|
def upload(file, project_name, user_name, password, summary, labels=None):
|
|
"""Upload a file to a Google Code project's file server.
|
|
|
|
Args:
|
|
file: The local path to the file.
|
|
project_name: The name of your project on Google Code.
|
|
user_name: Your Google account name.
|
|
password: The googlecode.com password for your account.
|
|
Note that this is NOT your global Google Account password!
|
|
summary: A small description for the file.
|
|
labels: an optional list of label strings with which to tag the file.
|
|
|
|
Returns: a tuple:
|
|
http_status: 201 if the upload succeeded, something else if an
|
|
error occured.
|
|
http_reason: The human-readable string associated with http_status
|
|
file_url: If the upload succeeded, the URL of the file on Google
|
|
Code, None otherwise.
|
|
"""
|
|
# The login is the user part of user@gmail.com. If the login provided
|
|
# is in the full user@domain form, strip it down.
|
|
if user_name.endswith('@gmail.com'):
|
|
user_name = user_name[:user_name.index('@gmail.com')]
|
|
|
|
form_fields = [('summary', summary)]
|
|
if labels is not None:
|
|
form_fields.extend([('label', l.strip()) for l in labels])
|
|
|
|
content_type, body = encode_upload_request(form_fields, file)
|
|
|
|
upload_host = '%s.googlecode.com' % project_name
|
|
upload_uri = '/files'
|
|
auth_token = base64.b64encode('%s:%s'% (user_name, password))
|
|
headers = {
|
|
'Authorization': 'Basic %s' % auth_token,
|
|
'User-Agent': 'Googlecode.com uploader v0.9.4',
|
|
'Content-Type': content_type,
|
|
}
|
|
|
|
server = httplib.HTTPSConnection(upload_host)
|
|
server.request('POST', upload_uri, body, headers)
|
|
resp = server.getresponse()
|
|
server.close()
|
|
|
|
if resp.status == 201:
|
|
location = resp.getheader('Location', None)
|
|
else:
|
|
location = None
|
|
return resp.status, resp.reason, location
|
|
|
|
|
|
def encode_upload_request(fields, file_path):
|
|
"""Encode the given fields and file into a multipart form body.
|
|
|
|
fields is a sequence of (name, value) pairs. file is the path of
|
|
the file to upload. The file will be uploaded to Google Code with
|
|
the same file name.
|
|
|
|
Returns: (content_type, body) ready for httplib.HTTP instance
|
|
"""
|
|
BOUNDARY = '----------Googlecode_boundary_reindeer_flotilla'
|
|
CRLF = '\r\n'
|
|
|
|
body = []
|
|
|
|
# Add the metadata about the upload first
|
|
for key, value in fields:
|
|
body.extend(
|
|
['--' + BOUNDARY,
|
|
'Content-Disposition: form-data; name="%s"' % key,
|
|
'',
|
|
value,
|
|
])
|
|
|
|
# Now add the file itself
|
|
file_name = os.path.basename(file_path)
|
|
f = open(file_path, 'rb')
|
|
file_content = f.read()
|
|
f.close()
|
|
|
|
body.extend(
|
|
['--' + BOUNDARY,
|
|
'Content-Disposition: form-data; name="filename"; filename="%s"'
|
|
% file_name,
|
|
# The upload server determines the mime-type, no need to set it.
|
|
'Content-Type: application/octet-stream',
|
|
'',
|
|
file_content,
|
|
])
|
|
|
|
# Finalize the form body
|
|
body.extend(['--' + BOUNDARY + '--', ''])
|
|
|
|
return 'multipart/form-data; boundary=%s' % BOUNDARY, CRLF.join(body)
|
|
|
|
|
|
def upload_find_auth(file_path, project_name, summary, labels=None,
|
|
user_name=None, password=None, tries=3):
|
|
"""Find credentials and upload a file to a Google Code project's file server.
|
|
|
|
file_path, project_name, summary, and labels are passed as-is to upload.
|
|
|
|
Args:
|
|
file_path: The local path to the file.
|
|
project_name: The name of your project on Google Code.
|
|
summary: A small description for the file.
|
|
labels: an optional list of label strings with which to tag the file.
|
|
config_dir: Path to Subversion configuration directory, 'none', or None.
|
|
user_name: Your Google account name.
|
|
tries: How many attempts to make.
|
|
"""
|
|
|
|
while tries > 0:
|
|
if user_name is None:
|
|
# Read username if not specified or loaded from svn config, or on
|
|
# subsequent tries.
|
|
sys.stdout.write('Please enter your googlecode.com username: ')
|
|
sys.stdout.flush()
|
|
user_name = sys.stdin.readline().rstrip()
|
|
if password is None:
|
|
# Read password if not loaded from svn config, or on subsequent tries.
|
|
print 'Please enter your googlecode.com password.'
|
|
print '** Note that this is NOT your Gmail account password! **'
|
|
print 'It is the password you use to access Subversion repositories,'
|
|
print 'and can be found here: http://code.google.com/hosting/settings'
|
|
password = getpass.getpass()
|
|
|
|
status, reason, url = upload(file_path, project_name, user_name, password,
|
|
summary, labels)
|
|
# Returns 403 Forbidden instead of 401 Unauthorized for bad
|
|
# credentials as of 2007-07-17.
|
|
if status in [httplib.FORBIDDEN, httplib.UNAUTHORIZED]:
|
|
# Rest for another try.
|
|
user_name = password = None
|
|
tries = tries - 1
|
|
else:
|
|
# We're done.
|
|
break
|
|
|
|
return status, reason, url
|
|
|
|
|
|
def main():
|
|
parser = optparse.OptionParser(usage='googlecode-upload.py -s SUMMARY '
|
|
'-p PROJECT [options] FILE')
|
|
parser.add_option('-s', '--summary', dest='summary',
|
|
help='Short description of the file')
|
|
parser.add_option('-p', '--project', dest='project',
|
|
help='Google Code project name')
|
|
parser.add_option('-u', '--user', dest='user',
|
|
help='Your Google Code username')
|
|
parser.add_option('-w', '--password', dest='password',
|
|
help='Your Google Code password')
|
|
parser.add_option('-l', '--labels', dest='labels',
|
|
help='An optional list of comma-separated labels to attach '
|
|
'to the file')
|
|
|
|
options, args = parser.parse_args()
|
|
|
|
if not options.summary:
|
|
parser.error('File summary is missing.')
|
|
elif not options.project:
|
|
parser.error('Project name is missing.')
|
|
elif len(args) < 1:
|
|
parser.error('File to upload not provided.')
|
|
elif len(args) > 1:
|
|
parser.error('Only one file may be specified.')
|
|
|
|
file_path = args[0]
|
|
|
|
if options.labels:
|
|
labels = options.labels.split(',')
|
|
else:
|
|
labels = None
|
|
|
|
status, reason, url = upload_find_auth(file_path, options.project,
|
|
options.summary, labels,
|
|
options.user, options.password)
|
|
if url:
|
|
print 'The file was uploaded successfully.'
|
|
print 'URL: %s' % url
|
|
return 0
|
|
else:
|
|
print 'An error occurred. Your file was not uploaded.'
|
|
print 'Google Code upload server said: %s (%s)' % (reason, status)
|
|
return 1
|
|
|
|
|
|
if __name__ == '__main__':
|
|
sys.exit(main())
|