view src/org/tmatesoft/hg/repo/HgLookup.java @ 698:822f3a83ff57

in, out and clone tests pass for ssh repositories. Infrastructure to decouple HgRemoteRepository from specific Connector implementation
author Artem Tikhomirov <tikhomirov.artem@gmail.com>
date Tue, 06 Aug 2013 21:18:33 +0200
parents 6526d8adbc0f
children a483b2b68a2e
line wrap: on
line source
/*
 * Copyright (c) 2010-2013 TMate Software Ltd
 *  
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; version 2 of the License.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * For information on how to redistribute this software under
 * the terms of a license other than GNU General Public License
 * contact TMate Software at support@hg4j.com
 */
package org.tmatesoft.hg.repo;

import static org.tmatesoft.hg.util.LogFacility.Severity.Warn;

import java.io.File;
import java.io.InputStream;
import java.net.URI;
import java.net.URISyntaxException;
import java.net.URL;
import java.net.URLStreamHandler;
import java.net.URLStreamHandlerFactory;

import org.tmatesoft.hg.core.HgBadArgumentException;
import org.tmatesoft.hg.core.HgIOException;
import org.tmatesoft.hg.core.HgRepositoryNotFoundException;
import org.tmatesoft.hg.core.SessionContext;
import org.tmatesoft.hg.internal.BasicSessionContext;
import org.tmatesoft.hg.internal.ConfigFile;
import org.tmatesoft.hg.internal.DataAccessProvider;
import org.tmatesoft.hg.internal.Experimental;
import org.tmatesoft.hg.internal.RequiresFile;
import org.tmatesoft.hg.repo.HgRepoConfig.PathsSection;

/**
 * Utility methods to find Mercurial repository at a given location
 * 
 * @author Artem Tikhomirov
 * @author TMate Software Ltd.
 */
public class HgLookup implements SessionContext.Source {

	private ConfigFile globalCfg;
	private SessionContext sessionContext;
	
	public HgLookup() {
	}
	
	public HgLookup(SessionContext ctx) {
		sessionContext = ctx;
	}

	public HgRepository detectFromWorkingDir() throws HgRepositoryNotFoundException {
		return detect(System.getProperty("user.dir"));
	}

	public HgRepository detect(String location) throws HgRepositoryNotFoundException {
		return detect(new File(location));
	}

	/**
	 * Look up repository in specified location and above
	 * 
	 * @param location where to look for .hg directory, never <code>null</code>
	 * @return repository object, never <code>null</code>
	 * @throws HgRepositoryNotFoundException if no repository found, or repository version is not supported
	 */
	public HgRepository detect(File location) throws HgRepositoryNotFoundException {
		File dir = location.getAbsoluteFile();
		File repository;
		do {
			repository = new File(dir, ".hg");
			if (repository.exists() && repository.isDirectory()) {
				break;
			}
			repository = null;
			dir = dir.getParentFile();
			
		} while(dir != null);
		if (repository == null) {
			throw new HgRepositoryNotFoundException(String.format("Can't locate .hg/ directory of Mercurial repository in %s nor in parent dirs", location)).setLocation(location.getPath());
		}
		try {
			String repoPath = repository.getParentFile().getAbsolutePath();
			HgRepository rv = new HgRepository(getSessionContext(), repoPath, repository);
			int requiresFlags = rv.getImplHelper().getRequiresFlags();
			if ((requiresFlags & RequiresFile.REVLOGV1) == 0) {
				throw new HgRepositoryNotFoundException(String.format("%s: repository version is not supported (Mercurial <0.9?)", repoPath)).setLocation(location.getPath());
			}
			return rv;
		} catch (HgRuntimeException ex) {
			HgRepositoryNotFoundException e = new HgRepositoryNotFoundException("Failed to initialize Hg4J library").setLocation(location.getPath());
			e.initCause(ex);
			throw e;
		}
	}
	
	public HgBundle loadBundle(File location) throws HgRepositoryNotFoundException {
		if (location == null || !location.canRead()) {
			throw new HgRepositoryNotFoundException(String.format("Can't read file %s", location)).setLocation(String.valueOf(location));
		}
		return new HgBundle(getSessionContext(), new DataAccessProvider(getSessionContext()), location).link();
	}
	
	/**
	 * Try to instantiate remote server using an immediate url or an url from configuration files
	 * 
	 * @param key either URL or a key from configuration file that points to remote server; if <code>null</code> or empty string, default remote location of the supplied repository (if any) is looked up
	 * @param hgRepo optional local repository to get default or otherwise configured remote location
	 * @return an instance featuring access to remote repository, check {@link HgRemoteRepository#isInvalid()} before actually using it
	 * @throws HgBadArgumentException if anything is wrong with the remote server's URL
	 */
	public HgRemoteRepository detectRemote(String key, HgRepository hgRepo) throws HgBadArgumentException {
		URI uri;
		Exception toReport;
		try {
			uri = new URI(key);
			toReport = null;
		} catch (URISyntaxException ex) {
			uri = null;
			toReport = ex;
		}
		if (uri == null) {
			String server = null;
			if (hgRepo != null && !hgRepo.isInvalid()) {
				PathsSection ps = hgRepo.getConfiguration().getPaths();
				server = key == null || key.trim().length() == 0 ? ps.getDefault() : ps.getString(key, null); // XXX Java 1.5 isEmpty() 
			} else if (key == null || key.trim().length() == 0) {
				throw new HgBadArgumentException("Can't look up empty key in a global configuration", null);
			}
			if (server == null) {
				server = getGlobalConfig().getSection("paths").get(key);
			}
			if (server == null) {
				throw new HgBadArgumentException(String.format("Can't find server %s specification in the config", key), toReport);
			}
			try {
				uri = new URI(server);
			} catch (URISyntaxException ex) {
				throw new HgBadArgumentException(String.format("Found %s server spec in the config, but failed to initialize with it", key), ex);
			}
		}
		return detectRemote(uri);
	}
	
	/**
	 * Detect remote repository
	 * <p>Use of this method is discouraged, please use {@link #detectRemote(URI)} instead}
	 * 
	 * @param url location of remote repository
	 * @return instance to interact with remote repository
	 * @throws HgBadArgumentException if location format is not a valid {@link URI}
	 * @throws IllegalArgumentException if url is <code>null</code>
	 */
	public HgRemoteRepository detect(URL url) throws HgBadArgumentException {
		if (url == null) {
			throw new IllegalArgumentException();
		}
		try {
			return detectRemote(url.toURI());
		} catch (URISyntaxException ex) {
			throw new HgBadArgumentException(String.format("Bad remote repository location: %s", url), ex);
		}
	}
	
	/**
	 * Resolves location of remote repository.
	 * 
	 * <p>Choice between {@link URI URIs} and {@link URL URLs} done in favor of former because they are purely syntactical,
	 * while latter have semantics of {@link URL#openConnection() connection} establishing, which is not always possible.
	 * E.g. one can't instantiate <code>new URL("ssh://localhost/")</code> as long as there's no local {@link URLStreamHandler} 
	 * for the protocol, which is the case for certain JREs out there. The way {@link URLStreamHandlerFactory URLStreamHandlerFactories} 
	 * are installed (static field/method) is quite fragile, and definitely not the one to rely on from a library's code (apps can carefully
	 * do this, but library can't install own nor expect anyone outside there would do). Use of fake {@link URLStreamHandler} (fails to open
	 * every connection) is possible, of course, although it seems to be less appropriate when there is alternative with {@link URI URIs}.
	 * 
	 * @param uriRemote remote repository location
	 * @return instance to interact with remote repository
	 * @throws HgBadArgumentException
	 */
	public HgRemoteRepository detectRemote(URI uriRemote) throws HgBadArgumentException {
		RemoteDescriptor rd = getSessionContext().getRemoteDescriptor(uriRemote);
		if (rd == null) {
			throw new HgBadArgumentException(String.format("Unsupported remote repository location:%s", uriRemote), null);
		}
		return new HgRemoteRepository(getSessionContext(), rd);
	}

	private ConfigFile getGlobalConfig() {
		if (globalCfg == null) {
			globalCfg = new ConfigFile(getSessionContext());
			try {
				globalCfg.addLocation(new File(System.getProperty("user.home"), ".hgrc"));
			} catch (HgIOException ex) {
				// XXX perhaps, makes sense to let caller/client know that we've failed to read global config? 
				getSessionContext().getLog().dump(getClass(), Warn, ex, null);
			}
		}
		return globalCfg;
	}

	public SessionContext getSessionContext() {
		if (sessionContext == null) {
			sessionContext = new BasicSessionContext(null);
		}
		return sessionContext;
	}

	
	/**
	 * Session context  ({@link SessionContext#getRemoteDescriptor(URI)} gives descriptor of remote when asked.
	 */
	@Experimental(reason="Work in progress")
	public interface RemoteDescriptor {
		URI getURI();
		Authenticator getAuth();
	}
	
	@Experimental(reason="Work in progress")
	public interface Authenticator {
		public void authenticate(RemoteDescriptor remote, AuthMethod authMethod);
	}

	/**
	 * Clients do not implement this interface, instead, they invoke appropriate authentication method
	 * once they got user input
	 */
	@Experimental(reason="Work in progress")
	public interface AuthMethod {
		public void noCredentials() throws AuthFailedException;
		public boolean supportsPassword();
		public void withPassword(String username, byte[] password) throws AuthFailedException;
		public boolean supportsPublicKey();
		public void withPublicKey(String username, InputStream publicKey, String passphrase) throws AuthFailedException;
		public boolean supportsCertificate();
		public void withCertificate() throws AuthFailedException;
	}
	
	@SuppressWarnings("serial")
	public class AuthFailedException extends Exception /*XXX HgRemoteException?*/ {
		public AuthFailedException(String message, Throwable cause) {
			super(message, cause);
		}
	}
}