Package for easy working with files.
Project description
Из России? Тебе сюда --> русскоязычная версия.
Simple_file_user is the package for easy working with files.
This package has some functions and one class for working with files.
Installing
To install this package write in command line:python -m pip install simple_file_user
Quick start.
To import class use:from simple_file_user.File import File
This imports File class from package. Let's make new file with it:
file = File("file.txt", "utf-8", True)
Let's write something into our file:
file.rewrite("Something.")
And check if has it written into file by read function:
file.read()
Output:
Something
Importing
import simple_file_user # Importing all, but you can call package's facilities only with the prefix simple_file_user.
from simple_file_user import * # Importing all from the package.
from simple_file_user import name_of_function # Importing certain function or functions.
from simple_file_user.File import File # Importing File class.
Functions overview
This is list of functions included this package:read(path: str, encoding: str = "utf-8", binary_mode: bool = False) -> str
---- Read file and return it's content.rewrite(path: str, content: str, encoding: str = "utf-8") -> int
---- Clear file and write content into it. Return amount of written symbols.add(path: str, content: str, encoding = "utf-8") -> int
---- Add content into file. Return amount of written symbols.remove(path: str) -> None
---- Remove file.rename(path: str, new_name: str) -> None
---- Rename file (path).getSize(path: str) -> int
---- Return size of file (path) in bytes.writeToFile(path: str, encoding: str = "utf-8")
---- It is decorator. Return function that write to file (path) returning of decorated callable object.addToFile(path: str, encoding: str = "utf-8")
---- It is decorator. Return function that add to file (path) returning of decorated callable object.
help(name_of_function)
. So you will get a more extended description.
File class
There is a file class in this package. It is situated in module named File. It has two private fields. They are path and encoding. There are methodsgetPath()
and getEncoding()
to get value from these fields.
Creating file object.
File(path: str, , encoding: str = "utf-8", new: bool = False)
Methods overview
read() -> str
---- Read file and return it's content.write(content: str, mod: str) -> int
---- Write content into file by mod.rewrite(content: str) -> int
---- Clear file and write content into it. Return amount of written symbols.add(content: str) -> int
---- Add content into file. Return amount of written symbols.readLine(number_of_line: int) -> str
---- Read line from file.rename(new_name: str) -> None
---- Rename file.getSize() -> int
---- Return size of file in bytes.getName() -> str
---- Return name of file.getEncoding() -> str
---- Return encoding of file.remove() -> None
---- Remove file and destroy object.split(key: str) -> list
---- Return splited file's content.rsplit(key: str) -> list
---- Return reversed splited file's content.
Compairing File objects.
You can compair File objects. If you try to compair File object and something else, you will get a TypeError. Compairing operators==
and !=
compair content of given Files. Others (< > <= >=
) compair their size.
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
simple_file_user-0.1.1.tar.gz
(5.4 kB
view hashes)
Built Distribution
Close
Hashes for simple_file_user-0.1.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 54d188dcca4681143babe141c912b88da26c99b8a452077eb5ddc7ead8a105a2 |
|
MD5 | b195f86efa8aaa3adc4b4abe662dbf63 |
|
BLAKE2b-256 | e997fc1fdc6c747ff2fa5079bea23d27f78fdbe7ad15282b28744ce234d43144 |