Package Health Score

75 / 100

security
Security review needed
popularity
Recognized
maintenance
Healthy
community
Active

Popularity

Recognized

GitHub Stars: 401
Forks: 50
Contributors: 6

Direct Usage Popularity

Based on project statistics from the GitHub repository for the PyPI package airflow-code-editor, we found that it has been starred 401 times.

Security

Security review needed

Security and license risk for latest version

Release Date: Aug 26, 2024
Direct Vulnerabilities: 0
C
0
H
0
M
0
L
Indirect Vulnerabilities: 0
C
0
H
0
M
0
L
License Risk: 0
H
6
M
0
L

All security vulnerabilities belong to production dependencies of direct and indirect packages.

License

Apache-2.0

Security Policy

We found a way for you to contribute to the project! Looks like airflow-code-editor is missing a security policy.

You can connect your project's repository to Snyk to stay up to date on security alerts and receive automatic fix pull requests.

Keep your project free of vulnerabilities with Snyk

Maintenance

Healthy

Commit Frequency

Open Issues: 1
Open PR: 0
Last Release: 3 months ago
Last Commit: 29 days ago

Further analysis of the maintenance status of airflow-code-editor based on released PyPI versions cadence, the repository activity, and other data points determined that its maintenance is Healthy.

We found that airflow-code-editor demonstrates a positive version release cadence with at least one new version released in the past 3 months.

As a healthy sign for on-going project maintenance, we found that the GitHub repository had at least 1 pull request or issue interacted with by the community.

Community

Active

Readme: Yes
Contributing.md: Yes
Code of Conduct: Yes
Contributors: 6
Funding: No

This project has seen only 10 or less contributors.

Embed Package Health Score Badge

Keep your project healthy

Check your requirements.txt

Ensure all the packages you're using are healthy and well-maintained

Snyk Vulnerability Scanner

Get health score & security insights directly in your IDE

Package

Python Versions Compatibility: >=3.6

Age: 5 years
Latest Release: 3 months ago
Dependencies: 1 Direct / 127 Total
Versions: 52
Maintainers: 1
Wheels: OS Independent

Readme

Airflow Code Editor Plugin

This plugin for Apache Airflow allows you to edit DAGs directly within your browser, providing a seamless and efficient workflow for managing your pipelines. Offering a user-friendly file management interface within designated directories, it facilitates effortless editing, uploading, and downloading of files. With Git support enabled, DAGs are stored in a Git repository, enabling users to explore Git history, review local modifications, and commit changes.

System Requirements

Airflow Versions
- 1.10.3 or newer
git Versions (git is not required if git support is disabled)
- 2.0 or newer

Screenshots

File Manager

Editor

Search

Git History

Git Workspace

Install Instructions

Docker Images

For the ease of deployment, use the production-ready reference container image. The image is based on the reference images for Apache Airflow.

You can find the following images there:

andreax79/airflow-code-editor:latest - the latest released Airflow Code Editor image with the latest Apache Airflow version
andreax79/airflow-code-editor:2.10.0 - the latest released Airflow Code Editor with specific Airflow version
andreax79/airflow-code-editor:2.10.0-7.7.0 - specific version of Airflow and Airflow Code Editor

Installing from PyPI

Install the plugin

  pip install airflow-code-editor

Install optional dependencies

black - Black Python code formatter
isort - A Python utility/library to sort imports
fs-s3fs - S3FS Amazon S3 Filesystem
fs-gcsfs - Google Cloud Storage Filesystem
... other filesystems supported by PyFilesystem - see https://www.pyfilesystem.org/page/index-of-filesystems/
```
  pip install black isort fs-s3fs fs-gcsfs
```

Restart the Airflow Web Server
Open Admin - DAGs Code Editor

Config Options

You can set options editing the Airflow's configuration file or setting environment variables. You can edit your airflow.cfg adding any of the following settings in the [code_editor] section. All the settings are optional.

enabled enable this plugin (default: True).
git_enabled enable git support (default: True). If git is not installed, disable this option.
git_cmd git command (path)
git_default_args git arguments added to each call (default: -c color.ui=true)
git_author_name human-readable name in the author/committer (default logged user first and last names)
git_author_email email for the author/committer (default: logged user email)
git_init_repo initialize a git repo in DAGs folder (default: True)
root_directory root folder (default: Airflow DAGs folder)
line_length Python code formatter - max line length (default: 88)
string_normalization Python code formatter - if true normalize string quotes and prefixes (default: False)
mount, mount1, ... configure additional folder (mount point) - format: name=xxx,path=yyy
ignored_entries comma-separated list of entries to be excluded from file/directory list (default: .*,__pycache__)

   [code_editor]
   enabled = True
   git_enabled = True
   git_cmd = /usr/bin/git
   git_default_args = -c color.ui=true
   git_init_repo = False
   root_directory = /home/airflow/dags
   line_length = 88
   string_normalization = False
   mount = name=data,path=/home/airflow/data
   mount1 = name=logs,path=/home/airflow/logs
   mount2 = name=data,path=s3://example

Mount Options:

name: mount name (destination)
path: local path or PyFilesystem FS URLs - see https://docs.pyfilesystem.org/en/latest/openers.html

Example:

name=ftp_server,path=ftp://user:pass@ftp.example.org/private
name=data,path=s3://example
name=tmp,path=/tmp

You can also set options with the following environment variables:

AIRFLOW__CODE_EDITOR__ENABLED
AIRFLOW__CODE_EDITOR__GIT_ENABLED
AIRFLOW__CODE_EDITOR__GIT_CMD
AIRFLOW__CODE_EDITOR__GIT_DEFAULT_ARGS
AIRFLOW__CODE_EDITOR__GIT_AUTHOR_NAME
AIRFLOW__CODE_EDITOR__GIT_AUTHOR_EMAIL
AIRFLOW__CODE_EDITOR__GIT_INIT_REPO
AIRFLOW__CODE_EDITOR__ROOT_DIRECTORY
AIRFLOW__CODE_EDITOR__LINE_LENGTH
AIRFLOW__CODE_EDITOR__STRING_NORMALIZATION
AIRFLOW__CODE_EDITOR__MOUNT, AIRFLOW__CODE_EDITOR__MOUNT1, AIRFLOW__CODE_EDITOR__MOUNT2, ...
AIRFLOW__CODE_EDITOR__IGNORED_ENTRIES

Example:

   export AIRFLOW__CODE_EDITOR__STRING_NORMALIZATION=True
   export AIRFLOW__CODE_EDITOR__MOUNT='name=data,path=/home/airflow/data'
   export AIRFLOW__CODE_EDITOR__MOUNT1='name=logs,path=/home/airflow/logs'
   export AIRFLOW__CODE_EDITOR__MOUNT2='name=tmp,path=/tmp'

REST API

Airflow Code Editor provides a REST API. Through this API, users can interact with the application programmatically, enabling automation, data retrieval, and integration with other software.

For detailed information on how to use each endpoint, refer to the API documentation.

REST API Authentication

The API authentication is inherited from the Apache Airflow.

If you want to check which auth backend is currently set, you can use airflow config get-value api auth_backends command as in the example below.

$ airflow config get-value api auth_backends
airflow.api.auth.backend.basic_auth

For details on configuring the authentication, see API Authorization.

Development Instructions

Fork the repo
Clone it on the local machine

  git clone https://github.com/andreax79/airflow-code-editor.git
  cd airflow-code-editor

Create dev image

  make dev-image

Switch node version

  nvm use

Make changes you need. Build npm package with:

  make npm-build

You can start Airflow webserver with:

  make webserver

Run tests

  make test

Commit and push changes
Create pull request to the original repo

airflow-code-editor dependencies

apache-airflow

FAQs

What is airflow-code-editor?

Apache Airflow code editor and file manager. Visit Snyk Advisor to see a full health score report for airflow-code-editor, including popularity, security, maintenance & community analysis.

Is airflow-code-editor popular?

The python package airflow-code-editor receives a total of 33,535 weekly downloads. As such, airflow-code-editor popularity was classified as a recognized. Visit the popularity section on Snyk Advisor to see the full health analysis.

Is airflow-code-editor well maintained?

We found that airflow-code-editor demonstrated a healthy version release cadence and project activity. It has a community of 6 open source contributors collaborating on the project. See the full package health analysis to learn more about the package maintenance status.

Is airflow-code-editor safe to use?

While scanning the latest version of airflow-code-editor, we found that a security review is needed. A total of 0 vulnerabilities or license issues were detected. See the full security scan results.

Last updated on 21 November-2024, at 05:33 (UTC).

Build a secure application checklist

Select a recommended open source package

Minimize your risk by selecting secure & well maintained open source packages

DONE

Scan your app for vulnerabilities

Scan your application to find vulnerabilities in your: source code, open source dependencies, containers and configuration files

SCAN NOW

Fix identified vulnerabilities

Easily fix your code by leveraging automatically generated PRs

AUTO FIX

Monitor for new issues

New vulnerabilities are discovered every day. Get notified if your application is affected

MONITOR APP