Skip to main content

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.

Metadata

Release files for fcust 1.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for fcust 1.0.0
File Size Uploaded
fcust-1.0.0.tar.gz 21.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for fcust 1.0.0
File Interpreter ABI Platform
fcust-1.0.0-py2.py3-none-any.whl Python 2, Python 3 none any Details

Total release size: 35.9 kB

Release files / fcust-1.0.0.tar.gz

Download URL fcust-1.0.0.tar.gz
Size 21.5 kB
Tags Source
SHA-256 checksum
How to use checksums
09432921f078c22b623d11a4f34db1368d8ac2230288665def6facffb7749f42
BLAKE2b-256 checksum
How to use checksums
b7c86dabaebd1c63fc8d609ca25de02f422878dd424650413cd79b1d094d445a
Upload date
Uploaded using Trusted Publishing?
What is 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

Release files / fcust-1.0.0-py2.py3-none-any.whl

Download URL fcust-1.0.0-py2.py3-none-any.whl
Size 14.4 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
faa02a65e982719ef3e228188f1404c3b787a5c49288b12f4edf0752068e0b43
BLAKE2b-256 checksum
How to use checksums
24094de981edc2f4384148fd1982017693df525bb2b1cf30d13f53060ec9f3ff
Upload date
Uploaded using Trusted Publishing?
What is 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

Release history Release notifications | RSS feed

This release

1.0.0 This release

2 release files

0.1.1

2 release files

0.0.15

2 release files

0.0.14

2 release files

0.0.8

2 release files

0.0.7

2 release files

0.0.6

2 release files

0.0.5

2 release files

0.0.4

2 release files

0.0.3

2 release files

0.0.1

2 release files

0.0.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page