module documentation
        
        Import a new upstream version into a Git repository
| Function | build | 
    Undocumented | 
| Function | debian | 
    Undocumented | 
| Function | debian | 
    Undocumented | 
| Function | debian | 
    Undocumented | 
| Function | debian | 
    Undocumented | 
| Function | detect | 
    Undocumented | 
| Function | find | 
    Find the main tarball to import - either via uscan or via command line argument | 
| Function | is | 
    Undocumented | 
| Function | main | 
    Undocumented | 
| Function | maybe | 
    Create a symlink named link pointing to orig if that is not the case already. | 
| Function | parse | 
    Parse the command line arguments | 
| Function | postimport | 
    Undocumented | 
| Function | postunpack | 
    Undocumented | 
| Function | prepare | 
    Prepare the upstream source for pristine tar import. | 
| Function | rollback | 
    Undocumented | 
| Function | set | 
    Modify options for import into a bare repository | 
| Function | unpack | 
    Undocumented | 
| Function | upstream | 
    Undocumented | 
Find the main tarball to import - either via uscan or via command line argument
| Returns | |
| string | upstream source filename or None if nothing to import | 
| Raises | |
GbpError | raised on all detected errors >>> find_upstream(False, ['too', 'many']) Traceback (most recent call last): ... gbp.errors.GbpError: More than one archive specified. Try --help. >>> find_upstream(False, []) Traceback (most recent call last): ... gbp.errors.GbpError: No archive to import specified. Try --help. >>> find_upstream(True, ['tarball']) Traceback (most recent call last): ... gbp.errors.GbpError: you can't pass both --uscan and a filename. >>> find_upstream(False, ['tarball']).path 'tarball'  | 
Prepare the upstream source for pristine tar import.
This checks if the upstream source is actually a tarball and creates a symlink from archive to <pkg>_<version>.orig.tar.<ext> so pristine-tar will see the correct basename. Same goes for an optional signature.
| Parameters | |
| archive:str | the upstream source's name | 
| pkg:str | the source package's name | 
| version:str | the upstream version number | 
| Returns | |
| str | Undocumented |