This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description

This is a python 3 port of desktop package.

The desktop package provides desktop environment detection and resource opening support for a selection of common and standardised desktop environments.

Insallation

pip install desktop3

Usage

Launch folders, files, … etc:

import desktop
desktop.open("what/you/want/to/open")

Introduction

The desktop package provides desktop environment detection and resource opening support for a selection of common and standardised desktop environments.

Currently, in Python’s standard library, there is apparently no coherent, cross-platform way of getting the user’s environment to “open” files or resources (showing such files in browsers or editors, for example) when requested by a Python program. There is an os.startfile function which works for Windows, but no equivalent function for other desktop environments - the webbrowser module seems to employ alternative mechanisms in choosing and running external programs and presumably does not seek to provide general support for non-URL resources anyway.

Since desktop environments like KDE and GNOME provide mechanisms for running browsers and editors according to the identified type of a file or resource, just as Windows “runs” files or resources, it is appropriate to have a module which accesses these mechanisms. It is this kind of functionality that the desktop package aims to support. Note that this approach is arguably better than that employed by the webbrowser module since most desktop environments already provide mechanisms for configuring and choosing the user’s preferred programs for various activities, whereas the webbrowser module makes relatively uninformed guesses (for example, opening Firefox on a KDE desktop configured to use Konqueror as the default browser).

Some ideas for desktop detection (XFCE) and URL opening (XFCE, X11) were obtained from the xdg-utils project which seeks to implement programs performing similar functions to those found in the desktop module. The xdg-utils project can be found here:

http://portland.freedesktop.org/

Other information regarding desktop icons and menus, screensavers and MIME configuration can also be found in xdg-utils.

Notes

Notes on desktop application/environment support:

KDE Supports file and URL opening using kfmclient, where the openURL command opens the resource and the exec command runs the resource.
KDE 4 Similar to KDE but uses kioclient instead of kfmclient.
GNOME Supports file and URL opening using gnome-open.
XFCE Supports file and URL opening using exo-open.
ROX-Filer Supports file opening using “rox <filename>” but not URL opening.

Changelog

  • 0.5.2 (Oct 26, 2016)
    • Add docs folder into dist file.
  • 0.5.1 (Oct 25, 2016)
    • Fix letter case issue in setup.py.
  • 0.5.0 (Jul 2, 2016)
    • First release.

Old Changelog

New in desktop 0.4.3 (Changes since desktop 0.4.2)

  • Added missing KDE 4 support to the desktop.dialog module.

New in desktop 0.4.2 (Changes since desktop 0.4.1)

  • Added XFCE 4.10 “mailto:” fix contributed by Jérôme Laheurte.

New in desktop 0.4.1 (Changes since desktop 0.4)

  • Added KDE 4 and Lubuntu support contributed by Jérôme Laheurte.

New in desktop 0.4 (Changes since desktop 0.3)

  • Improved docstrings.
  • Fixed support for examining the root window.
  • Changed the licence to the LGPL version 3 (or later).

New in desktop 0.3 (Changes since desktop 0.2.4)

  • Made desktop a package.
  • Added support for graphical dialogue boxes through programs such as kdialog, zenity and Xdialog.
  • Added support for inspecting desktop windows (currently only for X11).

New in desktop 0.2.4 (Changes since desktop 0.2.3)

  • Added XFCE support (with advice from Miki Tebeka).
  • Added Ubuntu Feisty (7.04) package support.

New in desktop 0.2.3 (Changes since desktop 0.2.2)

  • Added Python 2.3 support (using popen2 instead of subprocess).

New in desktop 0.2.2 (Changes since desktop 0.2.1)

  • Changed the licence to LGPL.

New in desktop 0.2.1 (Changes since desktop 0.2)

  • Added Debian/Ubuntu package support.

New in desktop 0.2 (Changes since desktop 0.1)

  • Added support for waiting for launcher processes.
  • Added a tests directory.
Release History

Release History

0.5.2

This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.5.1

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.5.0

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.4.3

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
desktop3-0.5.2-py3-none-any.whl (17.0 kB) Copy SHA256 Checksum SHA256 py3 Wheel Oct 26, 2016
desktop3-0.5.2.zip (35.9 kB) Copy SHA256 Checksum SHA256 Source Oct 26, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS HPE HPE Development Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting