User:SRodlund/PAWS (staging)

From Wikitech-static
Jump to navigation Jump to search
PAWS.svg


NEW Landing page design with links out to other pages: https://wikitech.wikimedia.org/wiki/User:SRodlund/PAWS_(staging)/pagedesign

Design: Use this as the basis for your landing page: https://wikitech.wikimedia.org/wiki/Blubber

Rethink in terms of audiences (and tasks)

  1. Newcomers to the Wikimedia technical community -- automated tasks many newcomers can do to contribute to Wikimedia Projects
  2. Data Scientists -- Jupyter is the computational notebook of choice for data scientists -- share how they can use it to contribute to Wikimedia Projects
  3. Existing volunteers -- this is another good tool, with solid suppor that they can use to contribut to Wikimedia Projects

https://openstack-browser.toolforge.org/project/paws

Articles I like:

Overview

PAWS is a service. Jupyter notebook is a tool for non-complex jobs -- mostly used for Python. Open-Source

PAWS: A Web Shell (PAWS) is a Jupyter notebooks deployment hosted by Wikimedia.

PAWS is web-based and makes it possible for users to launch, publish, and fork notebooks without installing Jupyter. Jupyter notebooks hosted on PAWS allow users to create and share documents that contain live code, visualizations such as graphs, rich text, etc.

More of an intro here for each of the audiences noted above.

Is PAWS right for your project?

Example Uses

Why to use

  • For teaching, documenting and running smaller tasks
  • For exploration, not production.

Why to use something else (Toolforge)

  • You are collaborating and want to use code versioning through Gerrit or GitHub -- It is not possible to merge Jupyter notebooks
    • Notebooks don't support test-driven debelopment. For repetitive and replicable jobs -- step up to a proper python project
  • For long asynchronus tasks or continuous jobs -- okay for small jobs and data sets, but if you plan on running big jobs and data sets, create a proper project and deploy in Toolforge.
  • The nonlinear nature of notebooks is frustrating for you (You have to pay attention to the order you run code in)
  • Notebooks do not integrate with IDEs, have no linters or code style correction to ensure you are writing quality code.

Terms of use

All notebooks hosted on PAWS are available to the public. Notebooks should be relate to and support Wikimedia technical projects. Content hosted on PAWS should follow the Wikimedia Code of Conduct for technical spaces.

Tutorials, examples, and recipes

A page where all PAWS tutorials, examples, and recipes are hosted.

Getting started with PAWS

This Quickstart

Since PAWS is hosted in the cloud and requires no installation, you can get started right away without installing any software.

  1. Open PAWS
  2. Click the Sign in with MediaWiki button.
  3. Allow permission for PAWS to perform some actions on your behalf.
  4. It's that easy!

Create

Create a new or upload an existing notebook.

  1. Click the New button and choose your notebook type. You can choose Python 3, Bash and R or Folder, Text File or Terminal.

Share

Share your notebook using a public link.

  1. Use the Public Link button to generate a public URL, or
  2. Alter the URL manually to make your notebook public: https://public.paws.wmcloud.org/User:YOURUSERNAME/YOURNOTEBOOK.ipynb

Fork

Fork an existing notebook

  1. Get the URL of another public PAWS notebook. Example: https://public.paws.wmcloud.org/YOURUSERNAME/YOURNOTEBOOK.ipynb
  2. Add ?format=raw to the end of the URL to download a raw .ipynb file. Example: https://public.paws.wmcloud.org/YOURUSERNAME/YOURNOTEBOOK.ipynb?format=raw
  3. Log into your PAWS account and use "upload" to upload this copy into your own directory.
  • Link to Getting started with PAWS Tutorial

Tutorials

General Use


PAWS and Pywikibot

PAWS and Pywikibot

Pywikibot is a Python library and collection of tools that automate work on MediaWiki sites. Originally designed for Wikipedia, it is now used throughout the Wikimedia Foundation's projects and on many other MediaWiki wikis.

For detailed information about PAWS/Pywikibot integration, log-in, and set-up instructions see: The PAWS Pywikibot manual.

  • PAWS & Pywikibot tutorial
  • Examples and recipes

Maintainance and administration

Learn more about how PAWS is administered and maintained.

Report bugs, request features

Source code

See also

Note: Do not put passwords in notebooks (They are all public)