historical/toontown-classic.git/panda/include/virtualFileSystem.h

173 lines
7 KiB
C
Raw Normal View History

2024-01-16 11:20:27 -06:00
/**
* PANDA 3D SOFTWARE
* Copyright (c) Carnegie Mellon University. All rights reserved.
*
* All use of this software is subject to the terms of the revised BSD
* license. You should have received a copy of this license along
* with this source code in a file named "LICENSE."
*
* @file virtualFileSystem.h
* @author drose
* @date 2002-08-03
*/
#ifndef VIRTUALFILESYSTEM_H
#define VIRTUALFILESYSTEM_H
#include "pandabase.h"
#include "virtualFile.h"
#include "virtualFileMount.h"
#include "virtualFileList.h"
#include "filename.h"
#include "dSearchPath.h"
#include "pointerTo.h"
#include "config_express.h"
#include "mutexImpl.h"
#include "pvector.h"
class Multifile;
class VirtualFileComposite;
/**
* A hierarchy of directories and files that appears to be one continuous file
* system, even though the files may originate from several different sources
* that may not be related to the actual OS's file system.
*
* For instance, a VirtualFileSystem can transparently mount one or more
* Multifiles as their own subdirectory hierarchies.
*/
class EXPCL_PANDA_EXPRESS VirtualFileSystem {
PUBLISHED:
VirtualFileSystem();
~VirtualFileSystem();
enum MountFlags {
MF_read_only = 0x0002,
};
BLOCKING bool mount(Multifile *multifile, const Filename &mount_point, int flags);
BLOCKING bool mount(const Filename &physical_filename, const Filename &mount_point,
int flags, const std::string &password = "");
BLOCKING bool mount_loop(const Filename &virtual_filename, const Filename &mount_point,
int flags, const std::string &password = "");
bool mount(VirtualFileMount *mount, const Filename &mount_point, int flags);
BLOCKING int unmount(Multifile *multifile);
BLOCKING int unmount(const Filename &physical_filename);
int unmount(VirtualFileMount *mount);
BLOCKING int unmount_point(const Filename &mount_point);
BLOCKING int unmount_all();
int get_num_mounts() const;
PT(VirtualFileMount) get_mount(int n) const;
MAKE_SEQ(get_mounts, get_num_mounts, get_mount);
MAKE_SEQ_PROPERTY(mounts, get_num_mounts, get_mount);
BLOCKING bool chdir(const Filename &new_directory);
BLOCKING Filename get_cwd() const;
BLOCKING bool make_directory(const Filename &filename);
BLOCKING bool make_directory_full(const Filename &filename);
BLOCKING PT(VirtualFile) get_file(const Filename &filename, bool status_only = false) const;
BLOCKING PT(VirtualFile) create_file(const Filename &filename);
BLOCKING PT(VirtualFile) find_file(const Filename &filename,
const DSearchPath &searchpath,
bool status_only = false) const;
BLOCKING bool delete_file(const Filename &filename);
BLOCKING bool rename_file(const Filename &orig_filename, const Filename &new_filename);
BLOCKING bool copy_file(const Filename &orig_filename, const Filename &new_filename);
BLOCKING bool resolve_filename(Filename &filename, const DSearchPath &searchpath,
const std::string &default_extension = std::string()) const;
BLOCKING int find_all_files(const Filename &filename, const DSearchPath &searchpath,
DSearchPath::Results &results) const;
BLOCKING INLINE bool exists(const Filename &filename) const;
BLOCKING INLINE bool is_directory(const Filename &filename) const;
BLOCKING INLINE bool is_regular_file(const Filename &filename) const;
BLOCKING INLINE PT(VirtualFileList) scan_directory(const Filename &filename) const;
INLINE void ls(const Filename &filename) const;
INLINE void ls_all(const Filename &filename) const;
void write(std::ostream &out) const;
static VirtualFileSystem *get_global_ptr();
EXTENSION(PyObject *read_file(const Filename &filename, bool auto_unwrap) const);
BLOCKING std::istream *open_read_file(const Filename &filename, bool auto_unwrap) const;
BLOCKING static void close_read_file(std::istream *stream);
EXTENSION(PyObject *write_file(const Filename &filename, PyObject *data, bool auto_wrap));
BLOCKING std::ostream *open_write_file(const Filename &filename, bool auto_wrap, bool truncate);
BLOCKING std::ostream *open_append_file(const Filename &filename);
BLOCKING static void close_write_file(std::ostream *stream);
BLOCKING std::iostream *open_read_write_file(const Filename &filename, bool truncate);
BLOCKING std::iostream *open_read_append_file(const Filename &filename);
BLOCKING static void close_read_write_file(std::iostream *stream);
public:
// We provide Python versions of these as efficient extension methods,
// above.
BLOCKING INLINE std::string read_file(const Filename &filename, bool auto_unwrap) const;
BLOCKING INLINE bool write_file(const Filename &filename, const std::string &data, bool auto_wrap);
bool atomic_compare_and_exchange_contents(const Filename &filename, std::string &orig_contents, const std::string &old_contents, const std::string &new_contents);
bool atomic_read_contents(const Filename &filename, std::string &contents) const;
INLINE bool read_file(const Filename &filename, std::string &result, bool auto_unwrap) const;
INLINE bool read_file(const Filename &filename, vector_uchar &result, bool auto_unwrap) const;
INLINE bool write_file(const Filename &filename, const unsigned char *data, size_t data_size, bool auto_wrap);
void scan_mount_points(vector_string &names, const Filename &path) const;
static void parse_options(const std::string &options,
int &flags, std::string &password);
static void parse_option(const std::string &option,
int &flags, std::string &password);
public:
// These flags are passed to do_get_file() and
// VirtualFileMount::make_virtual_file() to quality the kind of VirtualFile
// pointer we want to get.
enum OpenFlags {
OF_status_only = 0x0001,
OF_create_file = 0x0002,
OF_make_directory = 0x0004,
OF_allow_nonexist = 0x0008,
};
// These are declared as class instances, instead of as globals, to
// guarantee they will be initialized by the time the VirtualFileSystem's
// constructor runs.
ConfigVariableBool vfs_case_sensitive;
ConfigVariableBool vfs_implicit_pz;
ConfigVariableBool vfs_implicit_mf;
private:
Filename normalize_mount_point(const Filename &mount_point) const;
bool do_mount(VirtualFileMount *mount, const Filename &mount_point, int flags);
PT(VirtualFile) do_get_file(const Filename &filename, int open_flags) const;
bool consider_match(PT(VirtualFile) &found_file, VirtualFileComposite *&composite_file,
VirtualFileMount *mount, const Filename &local_filename,
const Filename &original_filename, bool implicit_pz_file,
int open_flags) const;
bool consider_mount_mf(const Filename &filename);
mutable MutexImpl _lock;
typedef pvector<PT(VirtualFileMount) > Mounts;
Mounts _mounts;
unsigned int _mount_seq;
Filename _cwd;
static VirtualFileSystem *_global_ptr;
};
#include "virtualFileSystem.I"
#endif