Skip to main content

The extension to feedback on CKAN datasets such as review, number of downloads,use-cases,resolved-problems, and way of use

Project description

ckanext-feedback

codecov

このCKAN Extensionはデータ利用者からのフィードバックを得るための機能を提供します。 本Extensionの利用者からの意見・要望や活用事例の報告を受け付ける仕組み等によって、データ利用者はデータの理解が進みデータ利活用が促進され、データ提供者はデータのニーズ理解やデータ改善プロセスの効率化が行えます。

This CKAN Extension provides functionality to obtain feedback from data users. The mechanism for receiving opinions/requests and reports on usage examples from users of this extension will help data users understand data and promote data utilization, while data providers will be able to understand data needs and improve the data improvement process. You can improve efficiency.

フィードバックにより利用者と提供者間でデータを改善し続けるエコシステムを実現することができます。

Feedback enables an ecosystem between users and providers that continually improves the data.

Main features

  • 👀 集計情報の可視化機能(ダウンロード数、利活用数、課題解決数)
    • Visualization function for aggregate information (number of downloads, number of uses, number of problems solved)
  • 💬 データおよび利活用方法に対するコメント・評価機能
    • Comment and evaluation function for data and usage methods
  • 🖼 データを利活用したアプリやシステムの紹介機能
    • Feature to introduce apps and systems that utilize data
  • 🏆 データを利活用したアプリやシステムの課題解決認定機能
    • Problem-solving certification function for apps and systems that utilize data

Quick Start

  1. CKANの仮想環境をアクティブにする(CKANコンテナ等の環境内で実行してください)

    . /usr/lib/ckan/venv/bin/activate
    
  2. 仮想環境にckanext-feedbackをインストールする

    pip install ckanext-feedback
    
  3. 以下のコマンドで設定を行うファイルを開く

    vim /etc/ckan/production.ini
    
  4. 以下の行にfeedbackを追加

    ckan.plugins = stats ・・・ recline_view feedback
    
  5. フィードバック機能に必要なテーブルを作成する

    ckan db upgrade -p feedback
    

構成

本Extensionは3つのモジュールで構成されています

設定や管理に関するドキュメント

開発者向け

ビルド方法

  1. ckanext-feedbackをローカル環境にGitHub上からクローンする

    git clone https://github.com/c-3lab/ckanext-feedback.git
    
  2. ckanext-feedback/development下にあるcontainer_setup.shを実行し、コンテナを起動

  3. ckanext-feedbackをインストールして必要なテーブルを作成するために、ckanext-feedback/development下にあるfeedback_setup.shを実行する

  4. http://localhost:5000にアクセスする

LinterとFomatterの設定

  1. poetryをインストールする

    pip install poetry
    
  2. LinterとFomatterを使えるようにする

    poetry install
    poetry run pre-commit install
    
    • 以後、git commit 時に、staging されているファイルに対して isort, black, pflake8 が実行され、それらによる修正が発生すると、commit されなくなる。
    • 手動で isort, black, pflake8 を行いたい場合、poetry run pre-commit で可能。

参考ドキュメント

テスト

  1. 上記のビルド方法に従い、ビルドを行う

  2. コンテナ内に入る

    docker exec -it --user root ckan-docker-ckan-dev-1 /bin/bash
    
  3. その他の必要なものをインストールする

    pip install -r /srv/app/src/ckan/dev-requirements.txt
    pip install pytest-ckan
    
  4. ディレクトリを移動

    cd /usr/lib/python3.10/site-packages/ckanext/feedback/tests
    
  5. テストを実行

    CKAN_SQLALCHEMY_URL= CKAN_DATASTORE_READ_URL= CKAN_DATASTORE_WRITE_URL= pytest -s --ckan-ini=config/test.ini --cov=ckanext.feedback --cov-branch --disable-warnings ./
    

LICENSE

AGPLv3 LICENSE

CopyRight

Copyright (c) 2023 C3Lab

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

ckanext_feedback-1.3.3.tar.gz (239.9 kB view details)

Uploaded Source

Built Distribution

ckanext_feedback-1.3.3-py3-none-any.whl (296.5 kB view details)

Uploaded Python 3

File details

Details for the file ckanext_feedback-1.3.3.tar.gz.

File metadata

  • Download URL: ckanext_feedback-1.3.3.tar.gz
  • Upload date:
  • Size: 239.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.8.16

File hashes

Hashes for ckanext_feedback-1.3.3.tar.gz
Algorithm Hash digest
SHA256 16e4cc09fd42276fae66ca7b7d499c253f06dfce0c83674fa598b40acae87e14
MD5 6c0743204e2c581081175edef63e3f5f
BLAKE2b-256 cc48564a41fd816d64dd52370d972f7a856cb0255e8ae4ac8882cf955bef9549

See more details on using hashes here.

File details

Details for the file ckanext_feedback-1.3.3-py3-none-any.whl.

File metadata

File hashes

Hashes for ckanext_feedback-1.3.3-py3-none-any.whl
Algorithm Hash digest
SHA256 556dafbdfc4a95480b10a0066edba9e5871003f4787143f04d412c3c0bde1f4f
MD5 4eae37e7ae45b841223dd3baa48c9eda
BLAKE2b-256 da5d5b71876c5b52adbed3775886ce805ad60da95f5507bc7e6abaf3e6fc2d97

See more details on using hashes here.

Supported by

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