Skip to main content

Linux Common Folder Custodian

Project description

Folder Custodian

https://img.shields.io/pypi/v/fcust.svg https://github.com/Iolaum/fcust/workflows/CI/badge.svg Documentation Status Updates

Linux Common Folder Custodian

  • Free software: GNU General Public License v3

  • Documentation: Read the Docs

Why?

The family computer runs Fedora, has many users and we want to share some files with each other. To achive this we create a shared common folder. This package solves the problems that come with our use case.

Features

This package is intended to perform maintenance over a folder shared across many users in a Fedora Workstation. The folder should belong to a group for which all users are members.

  • Go through a folder’s content and enforce common group ownership.

  • Go through a folder’s content and enforce common group read and write permissions as well as set groupid sticky bit.

  • Provide a command line command with sane defaults for enforcing common folder group ownership and permissions.

  • Write logs to /tmp/fcust/$USER.log.

  • Provides user systemd service to periodically enforce common folder group ownership and permissions. Runs on user log out.

The key problem this package intends to solve is that files moved from one location to another do not inherit proper permissions in the commonly used folder and therefore when another user tries to access them they encounter problems.

Quick Start Guide

  • Install fcust:

    $ sudo dnf copr enable iolaum/fcust
    $ sudo dnf install fcust
  • Manually create a common group and add as members the users that will have access to it. For example:

    $ sudo groupadd family
    $ sudo usermod -a -G family user1
    $ sudo usermod -a -G family user1
  • Create that folder and assign proper permissions:

    $ mkdir /path/to/common/folder/
    $ chown :family /path/to/common/folder/
    $ chmod 2775 /path/to/common/folder/
  • Setup fcust:

    $ fcust setup /path/to/common/folder/
    $ fcust activate
  • In order to run fcust manually on a properly permissioned common folder run:

    $ fcust run /path/to/common/folder/

History

1.0.0 (2020-11-21)

  • Updated package for Fedora 35.

  • Releasing production version.

0.1.1 (2020-11-22)

  • Added ability to see recent service logs.

  • Releasing beta version of feature complete package.

0.0.14 (2020-11-10)

  • Adding functionality to create, start and stop systemd user service

0.0.10 (2020-11-07)

  • F33 release

  • Minor Documentation update

0.0.9 (2020-10-13)

  • Hotfixed log access path bug

0.0.8 (2020-10-10)

  • Draft packaging as a fedora 32 rpm package

0.0.5 (2020-10-07)

  • Added command line command for folder contents permission enformcement

  • Added documentation

0.0.3 (2020-10-05)

  • Alpha version with common folder enformcement functionality.

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

fcust-1.0.0.tar.gz (21.5 kB view details)

Uploaded Source

Built Distribution

fcust-1.0.0-py2.py3-none-any.whl (14.4 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file fcust-1.0.0.tar.gz.

File metadata

  • Download URL: fcust-1.0.0.tar.gz
  • Upload date:
  • Size: 21.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.10.0

File hashes

Hashes for fcust-1.0.0.tar.gz
Algorithm Hash digest
SHA256 09432921f078c22b623d11a4f34db1368d8ac2230288665def6facffb7749f42
MD5 379b723a14530680ac329eed0e4cf10e
BLAKE2b-256 b7c86dabaebd1c63fc8d609ca25de02f422878dd424650413cd79b1d094d445a

See more details on using hashes here.

File details

Details for the file fcust-1.0.0-py2.py3-none-any.whl.

File metadata

  • Download URL: fcust-1.0.0-py2.py3-none-any.whl
  • Upload date:
  • Size: 14.4 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.10.0

File hashes

Hashes for fcust-1.0.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 faa02a65e982719ef3e228188f1404c3b787a5c49288b12f4edf0752068e0b43
MD5 3fe4ce5b8ad3cba77fc8a42be113b364
BLAKE2b-256 24094de981edc2f4384148fd1982017693df525bb2b1cf30d13f53060ec9f3ff

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