From 2030b7e227409a07d45cb60b2c40aa4347cde566 Mon Sep 17 00:00:00 2001 From: Enol Fernandez Date: Thu, 29 Aug 2024 08:57:19 +0100 Subject: [PATCH] Update docs --- CHANGELOG.md | 12 ++++++++++-- LICENSE | 2 +- README.md | 14 +++++++------- RELEASE.md | 2 +- package.json | 9 +++++---- 5 files changed, 24 insertions(+), 15 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 2d352af..d838b0b 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,13 @@ # Changelog - +All notable changes to this project will be documented in this file. - +The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), +and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). + +## [Unreleased] + +### Added + +- First implementation of a simple notification emiter whenever the resource + usage gets into warning diff --git a/LICENSE b/LICENSE index 8186b70..e446389 100644 --- a/LICENSE +++ b/LICENSE @@ -1,6 +1,6 @@ BSD 3-Clause License -Copyright (c) 2024, Enol Fernandez +Copyright (c) 2024, EGI Foundation All rights reserved. Redistribution and use in source and binary forms, with or without diff --git a/README.md b/README.md index 559e99a..b1ada5c 100644 --- a/README.md +++ b/README.md @@ -1,8 +1,8 @@ -# resource_warning +# notebooks-resource-warning -[![Github Actions Status](https://github.com/enolfc/resource-warnings/workflows/Build/badge.svg)](https://github.com/enolfc/resource-warnings/actions/workflows/build.yml) +[![Github Actions Status](https://github.com/EGI-Federation/notebooks-resource-warnings/workflows/Build/badge.svg)](https://github.com/EGI-Federation/notebooks-resource-warnings/actions/workflows/build.yml) -A JupyterLab extension. +A JupyterLab extension that shows a notification whenever the usage of memory goes into `warn` status (as provided by the [Jupyter Resource Usage extension](https://github.com/jupyter-server/jupyter-resource-usage) ## Requirements @@ -13,7 +13,7 @@ A JupyterLab extension. To install the extension, execute: ```bash -pip install resource_warning +pip install notebooks-resource-warning ``` ## Uninstall @@ -21,7 +21,7 @@ pip install resource_warning To remove the extension, execute: ```bash -pip uninstall resource_warning +pip uninstall notebooks-resource-warning ``` ## Contributing @@ -36,7 +36,7 @@ The `jlpm` command is JupyterLab's pinned version of ```bash # Clone the repo to your local environment -# Change directory to the resource_warning directory +# Change directory to the notebooks-resource-warning directory # Install package in development mode pip install -e "." # Link your development version of the extension with JupyterLab @@ -65,7 +65,7 @@ jupyter lab build --minimize=False ### Development uninstall ```bash -pip uninstall resource_warning +pip uninstall notebooks-resource-warning ``` In development mode, you will also need to remove the symlink created by `jupyter labextension develop` diff --git a/RELEASE.md b/RELEASE.md index 915d71b..2f77049 100644 --- a/RELEASE.md +++ b/RELEASE.md @@ -1,4 +1,4 @@ -# Making a new release of resource_warning +# Making a new release of notebooks-resource-warning The extension can be published to `PyPI` and `npm` manually or using the [Jupyter Releaser](https://github.com/jupyter-server/jupyter_releaser). diff --git a/package.json b/package.json index 4beb6a5..e91cb9d 100644 --- a/package.json +++ b/package.json @@ -1,15 +1,15 @@ { "name": "resource_warning", "version": "0.1.0", - "description": "A JupyterLab extension.", + "description": "A JupyterLab extension that shows a notification when reaching warning level of resource consumption (memory).", "keywords": [ "jupyter", "jupyterlab", "jupyterlab-extension" ], - "homepage": "https://github.com/enolfc/resource-warnings", + "homepage": "https://github.com/EGI-Federation/resource-warnings", "bugs": { - "url": "https://github.com/enolfc/resource-warnings/issues" + "url": "https://github.com/EGI-Federation/resource-warnings/issues" }, "license": "BSD-3-Clause", "author": { @@ -26,7 +26,7 @@ "style": "style/index.css", "repository": { "type": "git", - "url": "https://github.com/enolfc/resource-warnings.git" + "url": "https://github.com/EGI-Federation/resource-warnings.git" }, "scripts": { "build": "jlpm build:lib && jlpm build:labextension:dev", @@ -55,6 +55,7 @@ "watch:labextension": "jupyter labextension watch ." }, "dependencies": { + "@jupyter-server/resource-usage": "^1.1.0", "@jupyterlab/application": "^4.0.0" }, "devDependencies": {