Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/natikgadzhi/baseport
Export your Basecamp3 to-dos into any project management service your want.
https://github.com/natikgadzhi/baseport
basecamp basecamp3 cli
Last synced: 23 days ago
JSON representation
Export your Basecamp3 to-dos into any project management service your want.
- Host: GitHub
- URL: https://github.com/natikgadzhi/baseport
- Owner: natikgadzhi
- License: apache-2.0
- Created: 2021-06-15T17:58:42.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2021-07-02T11:50:12.000Z (over 3 years ago)
- Last Synced: 2024-11-29T13:59:40.530Z (24 days ago)
- Topics: basecamp, basecamp3, cli
- Language: Python
- Homepage:
- Size: 33.2 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Baseport
Baseport is a small CLI tool to export your Basecamp to-dos into a CSV file. We
considered migrating to Jira, and I needed a way to pull all our Basecamp to-dos
into it, so I've written a quick script and thought I'd share it.
## Install
`pip install baseport`
## Usage
```
$ baseport --help
Usage: baseport [OPTIONS] COMMAND [ARGS]...
Baseport exports Basecamp 3 to-do lists to CSVs.
Options:
--help Show this message and exit.
Commands:
projects Project operations
todos To-Do lists operations
$ baseport todos --help
Usage: baseport todos [OPTIONS] COMMAND [ARGS]...
To-Do lists operations
Options:
--help Show this message and exit.
Commands:
export Export all todos in one or all lists into a CSV file
ls List all available to-do lists in a project
show List all todos in one or all lists in a project
```
To export all of the to-dos in a single project, you'll use something like this:
```
baseport todos export -p PROJECT_ID -o todos.csv
```
### Authentication
Baseport uses [`basecampy3`](https://github.com/phistrom/basecampy3) to talk to
Basecamp API. You'll need a `.conf` file with your OAuth app client_id and
secret, and OAuth token. Luckily, you can just run `bc3 configure` and it'll
guide you through the setup proces.
### Formatting and cleaning your CSV
We needed to do a bit of a company-specific cleanup (given that I needed to
import to-dos to Jira, and clean up our email addresses), so Baseport has
formatter support. You can implement your own formatter and add it to
`_format_todos()` function, and then just pass it in the terminal with
`--formatter` option.
## Contributing
Feel free to open a PR with additional formatters or documentation on how to use
`baseport` for other platform-specific exports.
If you found an issue, please do file it on this repo. I'll do my best to help
you out.
Baseport is not going to be actively maintained or developed, it's a one-off
quick tool I needed for myself, and it did it's job.