Skip to content

Commit

Permalink
docs: update with location of new repository fetchers repo (#107)
Browse files Browse the repository at this point in the history
  • Loading branch information
sjungling authored Nov 19, 2024
1 parent d62e2d8 commit 4249080
Show file tree
Hide file tree
Showing 5 changed files with 2 additions and 235 deletions.
83 changes: 2 additions & 81 deletions repo-fetchers/README.md
Original file line number Diff line number Diff line change
@@ -1,82 +1,3 @@
## Repo Fetchers

This directory contains three bash scripts that can be used to fetch repositories. Below are the details of each script along with examples of how to invoke them and their required/optional arguments.

### `bitbucket-data-center.sh`

This script fetches all repositories from a Bitbucket Data Center instance and assumes the project as the organization.

#### Usage
```sh
./bitbucket-data-center.sh <bitbucket_url>
```

#### Description
This script fetches all repositories from the specified Bitbucket Data Center URL. If the `AUTH_TOKEN` environment variable is set, it will be used for authentication.

#### Example
To fetch all repositories from a Bitbucket Data Center instance:
```sh
./bitbucket-data-center.sh https://my-bitbucket.com/stash
```

### `bitbucket-cloud.sh`

This script fetches all repositories from a Bitbucket Cloud workspace and assumes the workspace as the organization.
Note: Email addresses do not work, you need your Bitbucket username which you can find (here)[https://bitbucket.org/account/settings/]

#### Using paremeters
```sh
./bitbucket-cloud.sh -u <username> -p <app_password> <workspace> > repos.csv
```

#### Using env vars
```sh
env BITBUCKET_USERNAME="<username>" BITBUCKET_APP_PASSWORD="<app_password>" ./bitbucket-cloud.sh <workspace>
```

#### Description
This script fetches all repositories from the specified Bitbucket Cloud workspace.

#### Example
To fetch all repositories from a Bitbucket Data Center instance:
```sh
./bitbucket-cloud.sh -u moderne -p secret moderneinc > repos.csv
```

### `gitlab.sh`

This script fetches all repositories from a GitLab instance or a specific group within a GitLab instance using the (sub)group path as the organization

#### Usage
```sh
./gitlab.sh [-g <group>] [-h <gitlab_domain>]
```

#### Description
This script fetches all repositories from a GitLab instance or a specific group within a GitLab instance. The `AUTH_TOKEN` environment variable must be set for authentication. The `-g` option specifies a group to fetch repositories from. The `-h` option specifies the GitLab domain (defaults to `https://gitlab.com` if not provided).

#### Example
To fetch all repositories from a specific group on a custom GitLab domain:
```sh
./gitlab.sh -g my-group -h https://my-gitlab.com
```

### `github.sh`

This script fetches all repositories from a GitHub organization.

#### Usage
```sh
./github.sh <organization_name>
```

#### Description
This script fetches all repositories from the specified GitHub organization. The `GITHUB_TOKEN` environment variable must be set for authentication.

#### Example
To fetch all repositories from a GitHub organization:
```sh
./github.sh my-organization
```
## We've moved!

You can now find our collection of scripts to help create your `repos.csv` at our new home https://github.com/moderneinc/repository-fetchers
67 changes: 0 additions & 67 deletions repo-fetchers/bitbucket-cloud.sh

This file was deleted.

32 changes: 0 additions & 32 deletions repo-fetchers/bitbucket-data-center.sh

This file was deleted.

19 changes: 0 additions & 19 deletions repo-fetchers/github.sh

This file was deleted.

36 changes: 0 additions & 36 deletions repo-fetchers/gitlab.sh

This file was deleted.

0 comments on commit 4249080

Please sign in to comment.