# Fil3s
Author(s): Daan van den Bergh.<br>
Copyright: © 2020 Daan van den Bergh All Rights Reserved.<br>
Supported Operating Systems: macos & linux.<br>
<br>
<br>
<p align="center">
<img src="https://raw.githubusercontent.com/vandenberghinc/public-storage/master/vandenberghinc/icon/icon.png" alt="Bergh-Encryption" width="50"/>
</p>
# Installation
pip3 install fil3s --upgrade
# Files:
## The Directory object class.
The Files.Directory() object class.
<br>Check the source code for more functions & options.
```python
# import the package.
import os
from fil3s import Files, Formats
# initialize a directory.
directory = Files.Directory(path='directory/')
# check the directory.
directory.check(
owner=os.eniron.get('USER'),
group=None,
permission=755,
sudo=True,
recursive=False,
silent=False,
hierarchy={
"subdir/":{
"path":"subdir/",
"directory":True,
"owner":os.eniron.get('USER'),
"group":None,
"permission":755,
"sudo":True,
},
})
# directory.file_path = <Formats.FilePath>
# directory.file_path.path
# content.
paths = directory.paths(
recursive=False,
banned=[],# use full file paths.
)
# check contains.
bool = directory.contains("subdir", "/", recursive=False)
# returnable functions.
path = directory.join("subdir", "/")
path = directory.join("subdir/settings", type="json")
path = directory.oldest_path()
path = directory.random_path(length=10, type="/")
path = directory.generate_path(length=10, type="/")
path = directory.structured_join("subdir", type="/", structure="alphabetical")
```
## The Dictionary object class.
The Files.Dictionary() object class.
<br>Check the source code for more functions & options.
```python
# import the package.
from fil3s import Files, Formats
# initialize the dictionary object.
dictionary = Files.Dictionary(
path='dictionary.json',
load=True,
default={
"Hello":'World!',
})
# dictionary.file_path = <Formats.FilePath>
# dictionary.file_path.path
# the dict is already loaded by the load=True parameter.
dictionary.load()
dictionary.dictionary
# saving.
dictionary.save({"Hello":"World!"})
# equal to.
dictionary.dictionary = {"Hello":"World!"}
dictionary.save()
# check dictionary.
dictionary.check(
save=True,
default={
"Hello":'World!',
"Hi":'World!',
})
# divide the dictionary into a list of dicts.
list = dictionary.divide(into=2)
```
## The Array object class.
The Files.Array() object class.
<br>Check the source code for more functions & options.
```python
# import the package.
from fil3s import Files, Formats
# initialize the array object.
array = Files.Array(path="array.json", load=False)
# loading the array.
array.load()
array.array
# saving the array.
array.save([1, 2, 3])
# equal to.
array.array = [1, 2, 4]
array.save()
# sum the array into a string.
str = array.string(joiner=' ')
# remove items from the array by value.
list = array.remove(items=[1])
# divide the array into multiple arrays.
list = array.divide(into=3)
```
## The Zip object class.
The Files.Zip() object class.
<br>Check the source code for more functions & options.
```python
# import the package.
from fil3s import Files, Formats
# initialize the zip object.
zip = Files.Zip(path="myzip.zip")
# create a zip from one dir / file.
zip.create(
source="directory/",
remove=False,
sudo=False)
# create a zip from multiple dirs / files.
zip.create(
source=["directory/", "file/"],
remove=False,
sudo=False)
# extracting the zip (leave the base None to use the zips base).
zip.extract(
base=None,
remove=False,
sudo=False)
```
# Formats:
## The FilePath object class.
The Formats.FilePath() object class.
Most Files.* classes contain a FilePath object.
<br>Check the source code for more functions & options.
```python
# import the package.
from fil3s import Files, Formats
# initialize the file path object.
file_path = Formats.FilePath(path='directory/', check_existance=False)
path = file_path.path
# returnable functions.
name = file_path.name()
extension = file_path.extension()
base = file_path.base(back=1)
size = file_path.size(mode="auto", options=["auto", "bytes", "kb", "mb", "gb", "tb"], type=str)
bool = file_path.exists()
bool = file_path.mount()
bool = file_path.directory()
# executable functions.
file_path.delete(forced=False, sudo=False, silent=False)
file_path.move(path="new-directory/", sudo=False, silent=False)
file_path.copy(path="new-directory/", sudo=False, silent=False)
file_path.open(sudo=False)
# file permissions.
permission = file_path.permission.get()
file_path.permission.set(permission=755, sudo=False, recursive=False, silent=False)
file_path.permission.check(permission=permission, sudo=False, recursive=False, silent=False)
# file ownership.
owner, group = file_path.ownership.get()
file_path.ownership.set(owner=owner, group=group, sudo=False, recursive=False, silent=False)
file_path.ownership.check(owner=owner, group=group, sudo=False, recursive=False, silent=False)
```
## The Date object class.
The Formats.Date() object class.
<br>Check the source code for more functions & options.
```python
# import the package.
from fil3s import Files, Formats
# initialize the date object.
date_object = Formats.Date()
# variables.
date_object.seconds
date_object.minute
date_object.hour
date_object.day
date_object.day_name
date_object.week
date_object.month
date_object.month_name
date_object.year
date_object.date
date_object.timestamp
date_object.shell_timestamp
date_object.seconds_timestamp
date_object.shell_seconds_timestamp
date_object.time
# functions.
stamp = increase(self, date_object.timestamp, weeks=0, days=1, hours=0, seconds=0, format="%d-%m-%y %H:%M")
stamp = decrease(self, date_object.timestamp, weeks=0, days=1, hours=0, seconds=0, format="%d-%m-%y %H:%M")
comparison = compare(self, stamp, date_object.timestamp, format="%d-%m-%y %H:%M")
stamp = convert(self, date_object.timestamp, input="%d-%m-%y %H:%M", output="%Y%m%d")
seconds = to_seconds(self, date_object.timestamp, format="%d-%m-%y %H:%M")
stamp = from_seconds(self, seconds, format="%d-%m-%y %H:%M")
```
### Response Object.
When a function completed successfully, the "success" variable will be "True". When an error has occured the "error" variable will not be "None". The function returnables will also be included in the response.
{
"success":False,
"message":None,
"error":None,
"...":"...",
}
Python库 | fil3s-1.7.5.tar.gz
版权申诉
133 浏览量
2022-04-08
20:30:58
上传
评论
收藏 20KB GZ 举报
挣扎的蓝藻
- 粉丝: 13w+
- 资源: 15万+
最新资源
- 驱动代码驱动代码驱动代码驱动代码
- SVID_20240523_141155_1.mp4
- Code for the complete guide to tkinter tutorial
- 关于百货中心供应链管理系统.zip
- SimpleFolderIcon-master 修改Unity的Project下的文件夹图标
- A python Tkinter widget to display tile based maps
- A pure Python library for adding tables to a Tkinter application
- Vector资源文件.zip
- MobaXterm-Installer
- 88-520告白(520气球).zip
资源上传下载、课程学习等过程中有任何疑问或建议,欢迎提出宝贵意见哦~我们会及时处理!
点击此处反馈