Skip to main content

A bitbucket server helper for working with lots of repos.

Project description

#bitbucket-helper A command-line utility for working with lots of bitbucket server projects and repositories.

The helper allows you to clone or pull every bitbucket repository you have access too. Repositories are pathed under their parent project, making it easy to identify the source project.

Installation

The utility requires python3.7

pip install -u bitbucket-helper

Setup

The first time you attempt to clone, you will get prompted to provide your bitbucket server hostname, username, a personal access token and a working directory where projects will get cloned.

To generate a read-only personal access token. Go to Bitbucket -> Manage account -> Personal Access Tokens.

bitbucket-helper sync

[Bitbucket server hostname]: myserver.domain    
[Bitbucket username]: myusername
[Personal access token]: secret
[Working directory (defaults to ~/bitbucket/)]: 
[Clone using http or ssh]: http

All configuration settings get stored in ~/.bitbucket-helper.config.

Synchronising

The synchronisation function uses bitbucket APIs to get all accessible projects and repositories. For each project, it will create a directory using its key. For each repository, we perform a git clone or a git pull if we already have a local copy. After the pull, we prune and delete local branches that have been merged at the origin.

Local directory structure:

  • working_directory (~/bitbucket)
    • proj1
      • repo1
      • repo2
    • proj2
      • repo1
      • repo2
bitbucket-helper sync

Git log commands

Bitbucket helper makes it easy to search for commits across all of your repositories using simple filters. Log commands operate on locally synched repositories, so remember to do a bitbucket-helper sync first.

You can find all commits after a specified date using:

bitbucket-helper log --after=2020-03-02

To search from commits between two tags:

bitbucket-helper log --from_tag=1.9.0 --to_tag=1.9.1

The command outputs the following quoted comma-separated values:

"repo","commit_hash","unix_time","iso_date","commit_message","author"

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

bitbucket-helper-0.0.2.tar.gz (4.3 kB view details)

Uploaded Source

File details

Details for the file bitbucket-helper-0.0.2.tar.gz.

File metadata

  • Download URL: bitbucket-helper-0.0.2.tar.gz
  • Upload date:
  • Size: 4.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/45.2.0 requests-toolbelt/0.9.1 tqdm/4.43.0 CPython/3.7.5

File hashes

Hashes for bitbucket-helper-0.0.2.tar.gz
Algorithm Hash digest
SHA256 f1014deff565e2a631ce7c9e58e5f09c176991a7925a2906e9fc35828432d9e2
MD5 9a97106c507e14f7e75c9f5aa8ad8b50
BLAKE2b-256 bcea5210d9fd5da6ba91274cfac9a4317b7ac997b867fe4bda21fab2b5e414e0

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page