Google Git
Sign in
apache / dolphinscheduler-sdk-python / 871e8f3d09acbddf9177eac69984aa8042daa1f5
commit871e8f3d09acbddf9177eac69984aa8042daa1f5[log] [tgz]
authorJay Chung <zhongjiajie955@gmail.com>Fri Nov 11 09:37:02 2022 +0800
committerGitHub <noreply@github.com>Fri Nov 11 09:37:02 2022 +0800
tree55d58042a5da809d4133fdd3ec7b6573ba470af2
parented62a3706a0bd45e00886ee36a237cdabe1e88b3 [diff]
[chore] Improve CI and fix deadlink (#11)

* Add coverage for PR and badge. fix: https://github.com/apache/dolphinscheduler/issues/8256
* Add schedule job to check upstream apache/dolphinscheduler
  code work or not
* Fix deadlink
5 files changed
tree: 55d58042a5da809d4133fdd3ec7b6573ba470af2
  1. .github/
  2. docs/
  3. examples/
  4. src/
  5. tests/
  6. .asf.yaml
  7. .coveragerc
  8. .dlc.json
  9. .flake8
  10. .gitignore
  11. .isort.cfg
  12. .licenserc.yaml
  13. .pre-commit-config.yaml
  14. DEVELOP.md
  15. LICENSE
  16. NOTICE
  17. pytest.ini
  18. README.md
  19. RELEASE.md
  20. setup.cfg
  21. setup.py
  22. tox.ini
  23. UPDATING.md
README.md

pydolphinscheduler

PyPi Version PyPi Python Versions PyPi License PyPi Status PyPi Downloads Coverage Status Code style: black Imports: isort CI

PyDolphinScheduler is python API for Apache DolphinScheduler, which allow you definition your workflow by python code, aka workflow-as-codes.

Quick Start

Installation

# Install
python -m pip install apache-dolphinscheduler

# Verify installation is successful, it will show the version of apache-dolphinscheduler, here we use 0.1.0 as example
pydolphinscheduler version
# 0.1.0

NOTE: package apache-dolphinscheduler not work on above Python version 3.10(including itself) in Window operating system due to dependence py4j not work on those environments.

Here we show you how to install and run a simple example of pydolphinscheduler

Start Server And Run Example

Before you run an example, you have to start backend server. You could follow development setup section “DolphinScheduler Standalone Quick Start” to set up developer environment. You have to start backend and frontend server in this step, which mean that you could view DolphinScheduler UI in your browser with URL http://localhost:12345/dolphinscheduler

After backend server is being start, all requests from pydolphinscheduler would be sent to backend server. And for now we could run a simple example by:

# Please make sure your terminal could 
curl https://raw.githubusercontent.com/apache/dolphinscheduler-sdk-python/main/src/pydolphinscheduler/examples/tutorial.py -o ./tutorial.py
python ./tutorial.py

NOTICE: Since Apache DolphinScheduler's tenant is requests while running command, you might need to change tenant value in example/tutorial.py. For now the value is tenant_exists, please change it to username exists in you environment.

After command execute, you could see a new project with single process definition named tutorial in the UI-project list.

Develop

Until now, we finish quick start by an example of pydolphinscheduler and run it. If you want to inspect or join pydolphinscheduler develop, you could take a look at develop

Release

If you are interested in how to release PyDolphinScheduler, you could go and see at release

What's more

For more detail information, please go to see PyDolphinScheduler latest(unreleased) document