pax_global_header00006660000000000000000000000064132017042720014510gustar00rootroot0000000000000052 comment=5b2cf118263937e62faa23a6dc502898a739a205 ocaml-fileutils-0.5.3/000077500000000000000000000000001320170427200146065ustar00rootroot00000000000000ocaml-fileutils-0.5.3/.announce000066400000000000000000000013701320170427200164160ustar00rootroot00000000000000To: caml-list@inria.fr Bcc: hump@caml.inria.fr Subject: [ANN] ocaml-fileutils v0.4.0 Ocaml fileutils is aimed to be a platform independent library to perform operation on file like: - mv - cp - rm - mkdir - touch - which... Comes also with a module to manipulate abstract filename: - classification - make_relative: made a filename relative to another - make_absolute This new release simplify module structure (nested modules are not required anymore) and comes with a more clear documentation. It also removes parser/lexer for path which was little bit overkilling. Some operations have been optimized for speed (like find) -- coming close in term of performance to standard POSIX commands. Link: http://le-gall.net/sylvain+violaine/ocaml-fileutils.html ocaml-fileutils-0.5.3/.gitignore000066400000000000000000000002211320170427200165710ustar00rootroot00000000000000/_build/ /setup.data /setup.log /dist/ /test.byte /test/oUnit.log /website/website-tools/ /website/dist/ /BenchFind.native /api-fileutils.docdir ocaml-fileutils-0.5.3/.merlin000066400000000000000000000001261320170427200160740ustar00rootroot00000000000000S src/** S test/** B _build/src/** B _build/test/** PKG unix PKG oUnit FLG -w +a-4-44 ocaml-fileutils-0.5.3/AUTHORS.txt000066400000000000000000000002131320170427200164700ustar00rootroot00000000000000(* OASIS_START *) (* DO NOT EDIT (digest: b204ed8ec7b36cfa8acd16444d82e8cf) *) Authors of ocaml-fileutils Sylvain Le Gall (* OASIS_STOP *) ocaml-fileutils-0.5.3/CHANGELOG.txt000066400000000000000000000210441320170427200166370ustar00rootroot00000000000000v0.5.3: * Minor release: - Use bytes rather than string to be compatible with OCaml 4.06.0. (Closes: Issue#5) -- Sylvain Le Gall Sun, 12 Nov 2017 00:29:46 +0100 v0.5.2: * Minor release: - Test file existence with Unix.LargeFile.lstat in FileUtilRM. (Closes: #1749) -- Sylvain Le Gall Tue, 23 May 2017 22:09:38 +0200 v0.5.1: * Minor release: - Fix non POSIX behavior of cp with links when "recurse:false". (Closes: #1649) -- Sylvain Le Gall Wed, 02 Nov 2016 00:19:58 +0100 v0.5.0: * Major release to account all the API changes: * Rebuild the exception/reporting framework: - Remove exceptions in favor of a single exception per command and a polymorphic variant tag. - Use a reporting function that can be passed as a parameter [?error:'a error_handler] to most of the functions. * Reimplement functions to be more POSIX compliant implementation (Closes: #761): (functions: cp, umask, chmod, mkdir, rm, mv, touch) * Make sure dead symlinks are handled properly (Closes: #712, #711): - derefenced when needed (functions: test) - offer the choice when possible (function: stat) * Implement symbolic mode that may have contextual meaning. * Improve documentation (add links to POSIX doc, reorganize content in section). * Split FileUtil.ml into multiple files. * Implement chmod (Closes: #416). * [cp] now propagate timestamp when invoked with [~preserve] (Closes: #709). * Upgrade OUnit to OUnit2. * Fix typo in cp (Closes: #816, #1317). -- Sylvain Le Gall Fri, 10 Jul 2015 01:44:54 +0200 v0.4.5: * Fix fd leaking cmp (Closes: #1012). * Fix test suite for BSD system. -- Sylvain Le Gall Mon, 03 Jun 2013 01:00:26 +0200 v0.4.4: * Regenerate with oasis 0.3.0~rc6 -- Sylvain Le Gall Tue, 12 Jun 2012 22:11:00 +0000 v0.4.3: * OASIS enabled -- Sylvain Le Gall Thu, 26 May 2011 09:47:22 +0000 v0.4.2: * Apply patch from Rüdiger Schmitt, fix handling for '.' in find and ls (Close: #418, #736) -- Sylvain Le Gall Mon, 06 Sep 2010 09:34:17 +0000 v0.4.1: * Apply patch from S. Glondu to use the right find function in FileUtilStr (Closes: #731) * Fix some typo in documentation * Apply patch from Debian to use a byte plugin for ocamlbuild -- Sylvain Le Gall Wed, 01 Sep 2010 15:09:17 +0200 v0.4.0: * Simplify interface, avoid nested module when possible: * Add filename information to all exception * FileUtil: * size is now a 64bits integer, functions are restricted to 4 most useful operations * Str match is now separated into another module (FileUtilStr, package fileutils-str) * All operations are now directly in FileUtil and not in FileUtil.StrUtil * FilePath: * Remove is_implicit, use is_relative as replacement * All functions of FilePath.DefaultPath are now directly accessible in FilePath * Default operation on string, use sub-module Abstract for abstract operations * FilePath.reduce don't reduce ".." except if asked to (i.e. no symlink) * CygwinPath related function use directly UnixPath * Make documentation more clear * Introduce fast operation for string filename: when possible to operate directly on string use it * Drop parser/lexer for path: this is complicated and not efficient. Prefer simple string manipulation which is more efficient * Replace build system by ocamlbuild, ocamlfind, a simple Makefile, ocaml-autoconf macros and configure * Adapt compilation and test to Windows * Simplify rm and avoid asking question twice (Closes: #FS79) * Use Unix.LargeFile to handle huge file (Closes: FS#77) * Simplify size operation. Now all operation is done on Int64 (Closes: FS#76) * Implement FileUtilStr that allow Str.regexp match outside the core FileUtil module (Closes: FS#13) * Add a wildcard on .a and .lib to allow installation on Windows (Closes: FS#84) * Update license header (Closes: FS#8, FS#55) * Accept "/" as separator for Win32 (Closes: FS#78, FS#83, FS#68) * For win32, use PATHEXT to locate executable with "which" (Closes: FS#73) * Don't suppose ".." can be reduced and test it (Closes: FS#10) * Fix "mv" and allow to copy data between filesystem (Closes: FS#6, FS#7) * Optimize FileUtil.find speed, now only 2x slower than UNIX find (was 40x slower before) (Closes: FS#65) -- Sylvain Le Gall Wed, 09 Sep 2009 15:29:38 +0200 v0.3.0: * Change the version to 0.3 (lot of changes for a minor version) * Update webpages * Correct a bug that prevent sr\@Ltn to be parsed (which comes from the lexer of UnixPath, there is [^'.''/''\\']* which can produce empty token) * Correct a bug that prevent to parse the initial current dir (ie produce nothing when use find "." or find "/a/") v0.2.2: * Changes the version to 0.2.2 in TopMakefile.in (closes: #33) * Stop removing Makefile in distclean target (closes: #31) * Change --enable-docdir --enable-builddir to --withXX (closes: #32) * Configure now test that ocamlfind is not detected and that we want to use ocamlfind (closes: #34) * Correct error concerning parsing of "" as a current dir (closes: #40) * Correct error concerning the test Has_extension (closes: #41) * Use a new CurrenDir of (Long|Short) to denote the difference between "" and "." * Implement readlink * Implement pwd (closes: #39) * Implement cmp (closes: #37, #38) * Implement new test: Has_no_extension | Basename_is | Dirname_is * Implement an anti recursion system (experimental, need to be tested) : * Use a type action_link: Follow, Skip, SkipInform, AskFollow * Maitain a set of visited directories * Implement new test: Is_older_than_date, Is_newer_than_date, Size_bigger_than, Size_smaller_than, Size_equal_to, Size_fuzzy_equal_to, Custom * Rewrite the test: Is_older_than, Is_newer_than, now takes only one args * Implement type size and operation coming along (add, sub, convert, compare, string_of_size). * Implement type permission / base_permission and operation coming along ( permission_of_int, int_of_permission). * Implement type kind (Dir, File...). * Implement function stat * Rewrite find, in order to be able to execute codes foreach filename. Very useful for rewriting other functions (rm, cp, mv) * Use list argument in place of single filename for rm, cp * Fix a bug that prevent ls to be able to list "" * Reworked unitary tests: include test for symlink and anti recursion * Unitary tests change from Fort to OUnit test suite v0.2.1: * Minor bug fixes to correct website aspect v0.2: * Use module/functor to abstract a lot of operation. * Generate a decent ocamldoc documentation * Abstract regexp matching using functor * Separate the sysPath modules in two: Abstract and not. Abstract permits to parse once and for all the filename, and then operate on it. It allows to handle fast all operation. Concrete module are only proxy that do the conversion to/from the Abstract implementation. * Introduce relation (updir, subdir, compare) to allow manipulating filename in classical structure (Set, Map...) * Rename sysPath, sysUtil to filePath, fileUtil since it appears that it is more consistent regarding the name of the library (i was not convinced, that sysPath represents anything). v0.1.1 (devel): * Fix some weird comportement with reduce (especially when trying to reduce filename which try to .. a root) and add the possibility to reduce relative filename * Rework on the way everything is made : * Support 4 different scheme of filename (Unix (the native way), MacOS, Win32, Cygwin) * Each scheme use a parser/lexer to decompose his filename and a .ml to handle the whole discriminant element of a specific scheme (ie the way filename are decomposed and the way path like variable are decomposed) * All the operation are defined relatively to the discriminant operation in a functorized module * Each scheme produces a module from his discriminant element and from the generic operation. These modules are defined in SysPath.{UnixPath|Win32Path|CygwinPath|MacOSPath}. * Depending on the current environement one of the module above is the default binding for all the operation. * Add SysUtil which try to create some portable file operation : mv, cp, touch, mkdir, test, find. This module abandon any non cross platform operation and will never support it (ie links for example, won't be supported). * This release is an alpha release. 0.2 will be the stable one. -- Sylvain LE GALL Thu, 30 Jan 2004 00:29:00 +0200 ocaml-fileutils-0.5.3/COPYING.txt000066400000000000000000000654401320170427200164700ustar00rootroot00000000000000As a special exception to the GNU Lesser General Public License, you may link, statically or dynamically, a "work that uses the Library" with a publicly distributed version of the Library to produce an executable file containing portions of the Library, and distribute that executable file under terms of your choice, without any of the additional requirements listed in clause 6 of the GNU Library General Public License. By "a publicly distributed version of the Library", we mean either the unmodified Library as distributed by INRIA, or a modified version of the Library that is distributed under the conditions defined in clause 3 of the GNU Library General Public License. This exception does not however invalidate any other reasons why the executable file might be covered by the GNU Library General Public License. ----------------------------------------------------------------------- GNU LESSER GENERAL PUBLIC LICENSE Version 2.1, February 1999 Copyright (C) 1991, 1999 Free Software Foundation, Inc. 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. [This is the first released version of the Lesser GPL. It also counts as the successor of the GNU Library Public License, version 2, hence the version number 2.1.] Preamble The licenses for most software are designed to take away your freedom to share and change it. By contrast, the GNU General Public Licenses are intended to guarantee your freedom to share and change free software--to make sure the software is free for all its users. This license, the Lesser General Public License, applies to some specially designated software packages--typically libraries--of the Free Software Foundation and other authors who decide to use it. You can use it too, but we suggest you first think carefully about whether this license or the ordinary General Public License is the better strategy to use in any particular case, based on the explanations below. When we speak of free software, we are referring to freedom of use, not price. Our General Public Licenses are designed to make sure that you have the freedom to distribute copies of free software (and charge for this service if you wish); that you receive source code or can get it if you want it; that you can change the software and use pieces of it in new free programs; and that you are informed that you can do these things. To protect your rights, we need to make restrictions that forbid distributors to deny you these rights or to ask you to surrender these rights. These restrictions translate to certain responsibilities for you if you distribute copies of the library or if you modify it. For example, if you distribute copies of the library, whether gratis or for a fee, you must give the recipients all the rights that we gave you. You must make sure that they, too, receive or can get the source code. If you link other code with the library, you must provide complete object files to the recipients, so that they can relink them with the library after making changes to the library and recompiling it. And you must show them these terms so they know their rights. We protect your rights with a two-step method: (1) we copyright the library, and (2) we offer you this license, which gives you legal permission to copy, distribute and/or modify the library. To protect each distributor, we want to make it very clear that there is no warranty for the free library. Also, if the library is modified by someone else and passed on, the recipients should know that what they have is not the original version, so that the original author's reputation will not be affected by problems that might be introduced by others. Finally, software patents pose a constant threat to the existence of any free program. We wish to make sure that a company cannot effectively restrict the users of a free program by obtaining a restrictive license from a patent holder. Therefore, we insist that any patent license obtained for a version of the library must be consistent with the full freedom of use specified in this license. Most GNU software, including some libraries, is covered by the ordinary GNU General Public License. This license, the GNU Lesser General Public License, applies to certain designated libraries, and is quite different from the ordinary General Public License. We use this license for certain libraries in order to permit linking those libraries into non-free programs. When a program is linked with a library, whether statically or using a shared library, the combination of the two is legally speaking a combined work, a derivative of the original library. The ordinary General Public License therefore permits such linking only if the entire combination fits its criteria of freedom. The Lesser General Public License permits more lax criteria for linking other code with the library. We call this license the "Lesser" General Public License because it does Less to protect the user's freedom than the ordinary General Public License. It also provides other free software developers Less of an advantage over competing non-free programs. These disadvantages are the reason we use the ordinary General Public License for many libraries. However, the Lesser license provides advantages in certain special circumstances. For example, on rare occasions, there may be a special need to encourage the widest possible use of a certain library, so that it becomes a de-facto standard. To achieve this, non-free programs must be allowed to use the library. A more frequent case is that a free library does the same job as widely used non-free libraries. In this case, there is little to gain by limiting the free library to free software only, so we use the Lesser General Public License. In other cases, permission to use a particular library in non-free programs enables a greater number of people to use a large body of free software. For example, permission to use the GNU C Library in non-free programs enables many more people to use the whole GNU operating system, as well as its variant, the GNU/Linux operating system. Although the Lesser General Public License is Less protective of the users' freedom, it does ensure that the user of a program that is linked with the Library has the freedom and the wherewithal to run that program using a modified version of the Library. The precise terms and conditions for copying, distribution and modification follow. Pay close attention to the difference between a "work based on the library" and a "work that uses the library". The former contains code derived from the library, whereas the latter must be combined with the library in order to run. GNU LESSER GENERAL PUBLIC LICENSE TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION 0. This License Agreement applies to any software library or other program which contains a notice placed by the copyright holder or other authorized party saying it may be distributed under the terms of this Lesser General Public License (also called "this License"). Each licensee is addressed as "you". A "library" means a collection of software functions and/or data prepared so as to be conveniently linked with application programs (which use some of those functions and data) to form executables. The "Library", below, refers to any such software library or work which has been distributed under these terms. A "work based on the Library" means either the Library or any derivative work under copyright law: that is to say, a work containing the Library or a portion of it, either verbatim or with modifications and/or translated straightforwardly into another language. (Hereinafter, translation is included without limitation in the term "modification".) "Source code" for a work means the preferred form of the work for making modifications to it. For a library, complete source code means all the source code for all modules it contains, plus any associated interface definition files, plus the scripts used to control compilation and installation of the library. Activities other than copying, distribution and modification are not covered by this License; they are outside its scope. The act of running a program using the Library is not restricted, and output from such a program is covered only if its contents constitute a work based on the Library (independent of the use of the Library in a tool for writing it). Whether that is true depends on what the Library does and what the program that uses the Library does. 1. You may copy and distribute verbatim copies of the Library's complete source code as you receive it, in any medium, provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice and disclaimer of warranty; keep intact all the notices that refer to this License and to the absence of any warranty; and distribute a copy of this License along with the Library. You may charge a fee for the physical act of transferring a copy, and you may at your option offer warranty protection in exchange for a fee. 2. You may modify your copy or copies of the Library or any portion of it, thus forming a work based on the Library, and copy and distribute such modifications or work under the terms of Section 1 above, provided that you also meet all of these conditions: a) The modified work must itself be a software library. b) You must cause the files modified to carry prominent notices stating that you changed the files and the date of any change. c) You must cause the whole of the work to be licensed at no charge to all third parties under the terms of this License. d) If a facility in the modified Library refers to a function or a table of data to be supplied by an application program that uses the facility, other than as an argument passed when the facility is invoked, then you must make a good faith effort to ensure that, in the event an application does not supply such function or table, the facility still operates, and performs whatever part of its purpose remains meaningful. (For example, a function in a library to compute square roots has a purpose that is entirely well-defined independent of the application. Therefore, Subsection 2d requires that any application-supplied function or table used by this function must be optional: if the application does not supply it, the square root function must still compute square roots.) These requirements apply to the modified work as a whole. If identifiable sections of that work are not derived from the Library, and can be reasonably considered independent and separate works in themselves, then this License, and its terms, do not apply to those sections when you distribute them as separate works. But when you distribute the same sections as part of a whole which is a work based on the Library, the distribution of the whole must be on the terms of this License, whose permissions for other licensees extend to the entire whole, and thus to each and every part regardless of who wrote it. Thus, it is not the intent of this section to claim rights or contest your rights to work written entirely by you; rather, the intent is to exercise the right to control the distribution of derivative or collective works based on the Library. In addition, mere aggregation of another work not based on the Library with the Library (or with a work based on the Library) on a volume of a storage or distribution medium does not bring the other work under the scope of this License. 3. You may opt to apply the terms of the ordinary GNU General Public License instead of this License to a given copy of the Library. To do this, you must alter all the notices that refer to this License, so that they refer to the ordinary GNU General Public License, version 2, instead of to this License. (If a newer version than version 2 of the ordinary GNU General Public License has appeared, then you can specify that version instead if you wish.) Do not make any other change in these notices. Once this change is made in a given copy, it is irreversible for that copy, so the ordinary GNU General Public License applies to all subsequent copies and derivative works made from that copy. This option is useful when you wish to copy part of the code of the Library into a program that is not a library. 4. You may copy and distribute the Library (or a portion or derivative of it, under Section 2) in object code or executable form under the terms of Sections 1 and 2 above provided that you accompany it with the complete corresponding machine-readable source code, which must be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange. If distribution of object code is made by offering access to copy from a designated place, then offering equivalent access to copy the source code from the same place satisfies the requirement to distribute the source code, even though third parties are not compelled to copy the source along with the object code. 5. A program that contains no derivative of any portion of the Library, but is designed to work with the Library by being compiled or linked with it, is called a "work that uses the Library". Such a work, in isolation, is not a derivative work of the Library, and therefore falls outside the scope of this License. However, linking a "work that uses the Library" with the Library creates an executable that is a derivative of the Library (because it contains portions of the Library), rather than a "work that uses the library". The executable is therefore covered by this License. Section 6 states terms for distribution of such executables. When a "work that uses the Library" uses material from a header file that is part of the Library, the object code for the work may be a derivative work of the Library even though the source code is not. Whether this is true is especially significant if the work can be linked without the Library, or if the work is itself a library. The threshold for this to be true is not precisely defined by law. If such an object file uses only numerical parameters, data structure layouts and accessors, and small macros and small inline functions (ten lines or less in length), then the use of the object file is unrestricted, regardless of whether it is legally a derivative work. (Executables containing this object code plus portions of the Library will still fall under Section 6.) Otherwise, if the work is a derivative of the Library, you may distribute the object code for the work under the terms of Section 6. Any executables containing that work also fall under Section 6, whether or not they are linked directly with the Library itself. 6. As an exception to the Sections above, you may also combine or link a "work that uses the Library" with the Library to produce a work containing portions of the Library, and distribute that work under terms of your choice, provided that the terms permit modification of the work for the customer's own use and reverse engineering for debugging such modifications. You must give prominent notice with each copy of the work that the Library is used in it and that the Library and its use are covered by this License. You must supply a copy of this License. If the work during execution displays copyright notices, you must include the copyright notice for the Library among them, as well as a reference directing the user to the copy of this License. Also, you must do one of these things: a) Accompany the work with the complete corresponding machine-readable source code for the Library including whatever changes were used in the work (which must be distributed under Sections 1 and 2 above); and, if the work is an executable linked with the Library, with the complete machine-readable "work that uses the Library", as object code and/or source code, so that the user can modify the Library and then relink to produce a modified executable containing the modified Library. (It is understood that the user who changes the contents of definitions files in the Library will not necessarily be able to recompile the application to use the modified definitions.) b) Use a suitable shared library mechanism for linking with the Library. A suitable mechanism is one that (1) uses at run time a copy of the library already present on the user's computer system, rather than copying library functions into the executable, and (2) will operate properly with a modified version of the library, if the user installs one, as long as the modified version is interface-compatible with the version that the work was made with. c) Accompany the work with a written offer, valid for at least three years, to give the same user the materials specified in Subsection 6a, above, for a charge no more than the cost of performing this distribution. d) If distribution of the work is made by offering access to copy from a designated place, offer equivalent access to copy the above specified materials from the same place. e) Verify that the user has already received a copy of these materials or that you have already sent this user a copy. For an executable, the required form of the "work that uses the Library" must include any data and utility programs needed for reproducing the executable from it. However, as a special exception, the materials to be distributed need not include anything that is normally distributed (in either source or binary form) with the major components (compiler, kernel, and so on) of the operating system on which the executable runs, unless that component itself accompanies the executable. It may happen that this requirement contradicts the license restrictions of other proprietary libraries that do not normally accompany the operating system. Such a contradiction means you cannot use both them and the Library together in an executable that you distribute. 7. You may place library facilities that are a work based on the Library side-by-side in a single library together with other library facilities not covered by this License, and distribute such a combined library, provided that the separate distribution of the work based on the Library and of the other library facilities is otherwise permitted, and provided that you do these two things: a) Accompany the combined library with a copy of the same work based on the Library, uncombined with any other library facilities. This must be distributed under the terms of the Sections above. b) Give prominent notice with the combined library of the fact that part of it is a work based on the Library, and explaining where to find the accompanying uncombined form of the same work. 8. You may not copy, modify, sublicense, link with, or distribute the Library except as expressly provided under this License. Any attempt otherwise to copy, modify, sublicense, link with, or distribute the Library is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance. 9. You are not required to accept this License, since you have not signed it. However, nothing else grants you permission to modify or distribute the Library or its derivative works. These actions are prohibited by law if you do not accept this License. Therefore, by modifying or distributing the Library (or any work based on the Library), you indicate your acceptance of this License to do so, and all its terms and conditions for copying, distributing or modifying the Library or works based on it. 10. Each time you redistribute the Library (or any work based on the Library), the recipient automatically receives a license from the original licensor to copy, distribute, link with or modify the Library subject to these terms and conditions. You may not impose any further restrictions on the recipients' exercise of the rights granted herein. You are not responsible for enforcing compliance by third parties with this License. 11. If, as a consequence of a court judgment or allegation of patent infringement or for any other reason (not limited to patent issues), conditions are imposed on you (whether by court order, agreement or otherwise) that contradict the conditions of this License, they do not excuse you from the conditions of this License. If you cannot distribute so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not distribute the Library at all. For example, if a patent license would not permit royalty-free redistribution of the Library by all those who receive copies directly or indirectly through you, then the only way you could satisfy both it and this License would be to refrain entirely from distribution of the Library. If any portion of this section is held invalid or unenforceable under any particular circumstance, the balance of the section is intended to apply, and the section as a whole is intended to apply in other circumstances. It is not the purpose of this section to induce you to infringe any patents or other property right claims or to contest validity of any such claims; this section has the sole purpose of protecting the integrity of the free software distribution system which is implemented by public license practices. Many people have made generous contributions to the wide range of software distributed through that system in reliance on consistent application of that system; it is up to the author/donor to decide if he or she is willing to distribute software through any other system and a licensee cannot impose that choice. This section is intended to make thoroughly clear what is believed to be a consequence of the rest of this License. 12. If the distribution and/or use of the Library is restricted in certain countries either by patents or by copyrighted interfaces, the original copyright holder who places the Library under this License may add an explicit geographical distribution limitation excluding those countries, so that distribution is permitted only in or among countries not thus excluded. In such case, this License incorporates the limitation as if written in the body of this License. 13. The Free Software Foundation may publish revised and/or new versions of the Lesser General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. Each version is given a distinguishing version number. If the Library specifies a version number of this License which applies to it and "any later version", you have the option of following the terms and conditions either of that version or of any later version published by the Free Software Foundation. If the Library does not specify a license version number, you may choose any version ever published by the Free Software Foundation. 14. If you wish to incorporate parts of the Library into other free programs whose distribution conditions are incompatible with these, write to the author to ask for permission. For software which is copyrighted by the Free Software Foundation, write to the Free Software Foundation; we sometimes make exceptions for this. Our decision will be guided by the two goals of preserving the free status of all derivatives of our free software and of promoting the sharing and reuse of software generally. NO WARRANTY 15. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE LIBRARY "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE LIBRARY IS WITH YOU. SHOULD THE LIBRARY PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. 16. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE LIBRARY AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE LIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE LIBRARY TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. END OF TERMS AND CONDITIONS How to Apply These Terms to Your New Libraries If you develop a new library, and you want it to be of the greatest possible use to the public, we recommend making it free software that everyone can redistribute and change. You can do so by permitting redistribution under these terms (or, alternatively, under the terms of the ordinary General Public License). To apply these terms, attach the following notices to the library. It is safest to attach them to the start of each source file to most effectively convey the exclusion of warranty; and each file should have at least the "copyright" line and a pointer to where the full notice is found. Copyright (C) This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version. This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details. You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA Also add information on how to contact you by electronic and paper mail. You should also get your employer (if you work as a programmer) or your school, if any, to sign a "copyright disclaimer" for the library, if necessary. Here is a sample; alter the names: Yoyodyne, Inc., hereby disclaims all copyright interest in the library `Frob' (a library for tweaking knobs) written by James Random Hacker. , 1 April 1990 Ty Coon, President of Vice That's all there is to it! ocaml-fileutils-0.5.3/INSTALL.txt000066400000000000000000000016451320170427200164630ustar00rootroot00000000000000(* OASIS_START *) (* DO NOT EDIT (digest: 4e83ad97c1be62ac6f21dcde0e48262d) *) This is the INSTALL file for the ocaml-fileutils distribution. This package uses OASIS to generate its build system. See section OASIS for full information. Dependencies ============ In order to compile this package, you will need: * ocaml for all, test bench-find, test main, doc api-fileutils * findlib * oUnit for executable test Installing ========== 1. Uncompress the source archive and go to the root of the package 2. Run 'ocaml setup.ml -configure' 3. Run 'ocaml setup.ml -build' 4. Run 'ocaml setup.ml -install' Uninstalling ============ 1. Go to the root of the package 2. Run 'ocaml setup.ml -uninstall' OASIS ===== OASIS is a program that generates a setup.ml file using a simple '_oasis' configuration file. The generated setup only depends on the standard OCaml installation: no additional library is required. (* OASIS_STOP *) ocaml-fileutils-0.5.3/Makefile000066400000000000000000000074241320170427200162550ustar00rootroot00000000000000############################################################################## # ocaml-fileutils: files and filenames common operations # # # # Copyright (C) 2003-2014, Sylvain Le Gall # # # # This library is free software; you can redistribute it and/or modify it # # under the terms of the GNU Lesser General Public License as published by # # the Free Software Foundation; either version 2.1 of the License, or (at # # your option) any later version, with the OCaml static compilation # # exception. # # # # This library is distributed in the hope that it will be useful, but # # WITHOUT ANY WARRANTY; without even the implied warranty of # # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the file # # COPYING for more details. # # # # You should have received a copy of the GNU Lesser General Public License # # along with this library; if not, write to the Free Software Foundation, # # Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA # ############################################################################## defaultl: test # OASIS_START # DO NOT EDIT (digest: a3c674b4239234cbbe53afe090018954) SETUP = ocaml setup.ml build: setup.data $(SETUP) -build $(BUILDFLAGS) doc: setup.data build $(SETUP) -doc $(DOCFLAGS) test: setup.data build $(SETUP) -test $(TESTFLAGS) all: $(SETUP) -all $(ALLFLAGS) install: setup.data $(SETUP) -install $(INSTALLFLAGS) uninstall: setup.data $(SETUP) -uninstall $(UNINSTALLFLAGS) reinstall: setup.data $(SETUP) -reinstall $(REINSTALLFLAGS) clean: $(SETUP) -clean $(CLEANFLAGS) distclean: $(SETUP) -distclean $(DISTCLEANFLAGS) setup.data: $(SETUP) -configure $(CONFIGUREFLAGS) configure: $(SETUP) -configure $(CONFIGUREFLAGS) .PHONY: build doc test all install uninstall reinstall clean distclean configure # OASIS_STOP # Precommit target # Check style of code. PRECOMMIT_ARGS= \ --exclude myocamlbuild.ml \ --exclude setup.ml \ --exclude README.txt \ --exclude INSTALL.txt \ --exclude Makefile \ --exclude configure \ --exclude _tags precommit: -@if command -v OCamlPrecommit > /dev/null; then \ OCamlPrecommit $(PRECOMMIT_ARGS); \ else \ echo "Skipping precommit checks.";\ fi precommit-full: OCamlPrecommit --full $(PRECOMMIT_ARGS) test: precommit .PHONY: precommit # Headache target # Fix license header of file. headache: find ./ \ -name _darcs -prune -false -o \ -name .git -prune -false -o \ -name _build -prune -false -o \ -type f \ | xargs headache -h _header -c _headache.config .PHONY: headache doc-dev-dist: doc fix-perms ./doc-dist.sh --version dev .PHONY: doc-dev-dist # Deploy target # Deploy/release the software. deploy: doc mkdir dist || true ./doc-dist.sh --version $(shell oasis query version) admin-gallu-deploy --verbose \ --forge_upload --forge_group ocaml-fileutils --forge_user gildor-admin \ --forge_extra_file "dist/ocaml-fileutils-doc-$(shell oasis query version).tar.gz" admin-gallu-oasis-increment \ --setup_run --setup_args "-setup-update dynamic" --use_vcs .PHONY: deploy fix-perms: chmod +x doc-dist.sh .PHONY: fix-perms website-clean: cd website && $(MAKE) clean clean: website-clean website-distclean: cd website && $(MAKE) distclean distclean: website-distclean .PHONY: website-distclean website-clean ocaml-fileutils-0.5.3/README.txt000066400000000000000000000037071320170427200163130ustar00rootroot00000000000000******************************************************************************** * ocaml-fileutils: files and filenames common operations * * * * Copyright (C) 2003-2011, Sylvain Le Gall * * * * This library is free software; you can redistribute it and/or modify it * * under the terms of the GNU Lesser General Public License as published by * * the Free Software Foundation; either version 2.1 of the License, or (at * * your option) any later version, with the OCaml static compilation * * exception. * * * * This library is distributed in the hope that it will be useful, but * * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY * * or FITNESS FOR A PARTICULAR PURPOSE. See the file COPYING for more * * details. * * * * You should have received a copy of the GNU Lesser General Public License * * along with this library; if not, write to the Free Software Foundation, * * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA * ******************************************************************************** (* OASIS_START *) (* DO NOT EDIT (digest: c28decb1f59be8a894299140e5f843b9) *) This is the README file for the ocaml-fileutils distribution. (C) 2003-2011 Sylvain Le Gall Functions to manipulate real file (POSIX like) and filename. See the files INSTALL.txt for building and installation instructions. See the file LICENSE for copying conditions. (* OASIS_STOP *) ocaml-fileutils-0.5.3/TODO.txt000066400000000000000000000012231320170427200161120ustar00rootroot00000000000000 Must: - implement a basic glob function to replace the Str implementation (*, ?). - add more test to the test.ml file ( should have at least 200 test - only 133 at the time I am writing this line ) - create a URI parser, in order to be able to adress different filesystem using the same string (example file:/coucou/ to indicate the subdir coucou of the current dir) - install - pathchk Wishlist: - Create a libtar-ocaml, to handle the tar format - Investigate on the different UNIX command that should be great to have... Maybe go and see if some interesting command exist on other OS... Bugs: - should not take into account files that are links ocaml-fileutils-0.5.3/_headache.config000066400000000000000000000073171320170427200176660ustar00rootroot00000000000000############################################################################## # ocaml-fileutils: files and filenames common operations # # # # Copyright (C) 2003-2014, Sylvain Le Gall # # # # This library is free software; you can redistribute it and/or modify it # # under the terms of the GNU Lesser General Public License as published by # # the Free Software Foundation; either version 2.1 of the License, or (at # # your option) any later version, with the OCaml static compilation # # exception. # # # # This library is distributed in the hope that it will be useful, but # # WITHOUT ANY WARRANTY; without even the implied warranty of # # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the file # # COPYING for more details. # # # # You should have received a copy of the GNU Lesser General Public License # # along with this library; if not, write to the Free Software Foundation, # # Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA # ############################################################################## | "aclocal\\.m4" -> no | ".*\\.patch" -> no | "install-sh" -> no | "missing" -> no | "config\\.log" -> no | "config\\.status" -> no | "configure" -> no | ".*\\.sh" -> skip match:"#!.*" | ".*\\.sh" -> frame open:"#" line:"#" close:"#" | "autogen\\.sh" -> frame open:"#" line:"#" close:"#" | "configure\\.in" -> frame open:"dnl *" line:"*" close:"*" | "configure\\.ac" -> frame open:"dnl *" line:"*" close:"*" | ".*\\.xml" -> skip match:"<\?xml.*>" | ".*\\.xml" -> lines open:"" | ".*\\.ml\\.in" -> frame open:"(*" line:"*" close:"*)" | ".*\\.ml" -> skip match:"(\\*pp .* \\*)" | "_headache\\.config" -> frame open:"#" line:"#" close:"#" | ".*\\.swp" -> no | ".*\\.po" -> no | ".*\\.mo" -> no | "META" -> frame open:"#" line:"#" close:"#" | "META\\.in" -> frame open:"#" line:"#" close:"#" | "POTFILES" -> no | "LINGUAS" -> no | ".*\\.pot" -> no | ".*\\.png" -> no | "\\.announce" -> no | ".*\\.mllib" -> frame open:"#" line:"#" close:"#" | ".*\\.itarget" -> frame open:"#" line:"#" close:"#" | ".*\\.itarget.in" -> frame open:"#" line:"#" close:"#" | ".*\\.odocl" -> frame open:"#" line:"#" close:"#" | "_tags" -> frame open:"#" line:"#" close:"#" | "\\.boring" -> no | "\\.gitignore" -> no | ".*\\.txt" -> no | ".*\.tar\\.gz" -> no | ".*\.tar\\.gz\\.asc" -> no | "setup\\.log" -> no | "setup\\.data" -> no | ".*\\.bak" -> no | "_oasis" -> no | "_header" -> no | ".*\\.lua" -> no | ".*\\.py" -> no | ".*\\.pyc" -> no | ".*\\.ico" -> no | ".*\\.mkd\\.tmpl" -> no | ".*\\.mkd" -> no | ".*\\.html" -> no | ".*\\.css" -> frame open:"/*" line:"*" close:"*/" | ".*\\.svg" -> skip match:"<\?xml.*>" | ".*\\.svg" -> lines open:"" ocaml-fileutils-0.5.3/_header000066400000000000000000000014641320170427200161250ustar00rootroot00000000000000ocaml-fileutils: files and filenames common operations Copyright (C) 2003-2014, Sylvain Le Gall This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version, with the OCaml static compilation exception. This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the file COPYING for more details. You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA ocaml-fileutils-0.5.3/_oasis000066400000000000000000000046561320170427200160210ustar00rootroot00000000000000OASISFormat: 0.4 Name: ocaml-fileutils Version: 0.5.3 Authors: Sylvain Le Gall Maintainers: Sylvain Le Gall Copyrights: (C) 2003-2014 Sylvain Le Gall License: LGPL-2.1 with OCaml linking exception LicenseFile: LICENSE BuildTools: ocamlbuild Plugins: DevFiles (0.4), StdFiles (0.4), META (0.4) Synopsis: Functions to manipulate real file (POSIX like) and filename. BugReports: https://forge.ocamlcore.org/tracker/?func=add&group_id=128&atid=589 Library "fileutils" Path: src/ Modules: FileUtil, FilePath InternalModules: CommonPath, ExtensionPath, FilePath_type, FileStringExt, MacOSPath, UnixPath, Win32Path, FileUtilMode, FileUtilTypes, FileUtilPermission, FileUtilSize, FileUtilMisc, FileUtilSTAT, FileUtilUMASK, FileUtilLS, FileUtilCHMOD, FileUtilTEST, FileUtilPWD, FileUtilREADLINK, FileUtilWHICH, FileUtilMKDIR, FileUtilTOUCH, FileUtilFIND, FileUtilRM, FileUtilCP, FileUtilMV, FileUtilCMP, FileUtilDU BuildDepends: unix, bytes Library "fileutils-str" FindlibParent: fileutils FindlibName: str Path: src/ Modules: FileUtilStr BuildDepends: fileutils, str Document "api-fileutils" Title: API reference for fileutils Type: ocamlbuild (0.4) InstallDir: $htmldir/api BuildTools+: ocamldoc XOCamlbuildPath: src/ XOCamlbuildLibraries: fileutils, fileutils.str SourceRepository head Type: git Location: https://github.com/gildor478/ocaml-fileutils.git Browser: https://github.com/gildor478/ocaml-fileutils Executable BenchFind Path: test MainIs: BenchFind.ml BuildDepends: fileutils Build$: flag(tests) Install: false CompiledObject: best Executable test Path: test MainIs: test.ml BuildDepends: fileutils, fileutils.str, oUnit (>= 2.0.0) Build$: flag(tests) Install: false Test "bench-find" Type: custom (0.4) Command: $BenchFind Run: false Test main Type: custom (0.4) Command: $test WorkingDirectory: test ocaml-fileutils-0.5.3/ardivink.lua000066400000000000000000000007711320170427200171250ustar00rootroot00000000000000oasis = require("oasis") ci = require("ci") dist = require("dist") ci.init() dist.init() oasis.init() ci.prependenv("PATH", "/usr/opt/godi/bin") ci.prependenv("PATH", "/usr/opt/godi/sbin") ci.putenv("OUNIT_OUTPUT_HTML_DIR", dist.make_filename("ounit-log.html")) ci.putenv("OUNIT_OUTPUT_JUNIT_FILE", dist.make_filename("junit.xml")) ci.putenv("OUNIT_OUTPUT_FILE", dist.make_filename("ounit-log.txt")) oasis.std_process("--enable-tests") -- Create documentation package. ci.exec("make", "doc-dev-dist") ocaml-fileutils-0.5.3/configure000077500000000000000000000005531320170427200165200ustar00rootroot00000000000000#!/bin/sh # OASIS_START # DO NOT EDIT (digest: dc86c2ad450f91ca10c931b6045d0499) set -e FST=true for i in "$@"; do if $FST; then set -- FST=false fi case $i in --*=*) ARG=${i%%=*} VAL=${i##*=} set -- "$@" "$ARG" "$VAL" ;; *) set -- "$@" "$i" ;; esac done ocaml setup.ml -configure "$@" # OASIS_STOP ocaml-fileutils-0.5.3/doc-dist.sh000077500000000000000000000036651320170427200166650ustar00rootroot00000000000000#!/bin/bash ############################################################################## # ocaml-fileutils: files and filenames common operations # # # # Copyright (C) 2003-2014, Sylvain Le Gall # # # # This library is free software; you can redistribute it and/or modify it # # under the terms of the GNU Lesser General Public License as published by # # the Free Software Foundation; either version 2.1 of the License, or (at # # your option) any later version, with the OCaml static compilation # # exception. # # # # This library is distributed in the hope that it will be useful, but # # WITHOUT ANY WARRANTY; without even the implied warranty of # # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the file # # COPYING for more details. # # # # You should have received a copy of the GNU Lesser General Public License # # along with this library; if not, write to the Free Software Foundation, # # Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA # ############################################################################## . admin-gallu-common || exit 1 set -e arg_string_set version --default "dev" \ "Version of OUnit." arg_parse arg_anon_fail "$@" CURDIR=$(pwd) TOPDIR="ocaml-fileutils-doc-$version" get_tmpdir TEMPDIR mkdir -p "$TEMPDIR/$TOPDIR/api-fileutils" cp -R _build/src/api-fileutils.docdir/* "$TEMPDIR/$TOPDIR/api-fileutils" tar czf "$CURDIR/dist/$TOPDIR.tar.gz" -C $TEMPDIR $TOPDIR ocaml-fileutils-0.5.3/setup.ml000066400000000000000000000072471320170427200163120ustar00rootroot00000000000000(******************************************************************************) (* ocaml-fileutils: files and filenames common operations *) (* *) (* Copyright (C) 2003-2014, Sylvain Le Gall *) (* *) (* This library is free software; you can redistribute it and/or modify it *) (* under the terms of the GNU Lesser General Public License as published by *) (* the Free Software Foundation; either version 2.1 of the License, or (at *) (* your option) any later version, with the OCaml static compilation *) (* exception. *) (* *) (* This library is distributed in the hope that it will be useful, but *) (* WITHOUT ANY WARRANTY; without even the implied warranty of *) (* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the file *) (* COPYING for more details. *) (* *) (* You should have received a copy of the GNU Lesser General Public License *) (* along with this library; if not, write to the Free Software Foundation, *) (* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA *) (******************************************************************************) (* setup.ml generated for the first time by OASIS v0.2.0 *) (* OASIS_START *) (* DO NOT EDIT (digest: a426e2d026defb34183b787d31fbdcff) *) (******************************************************************************) (* OASIS: architecture for building OCaml libraries and applications *) (* *) (* Copyright (C) 2011-2016, Sylvain Le Gall *) (* Copyright (C) 2008-2011, OCamlCore SARL *) (* *) (* This library is free software; you can redistribute it and/or modify it *) (* under the terms of the GNU Lesser General Public License as published by *) (* the Free Software Foundation; either version 2.1 of the License, or (at *) (* your option) any later version, with the OCaml static compilation *) (* exception. *) (* *) (* This library is distributed in the hope that it will be useful, but *) (* WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY *) (* or FITNESS FOR A PARTICULAR PURPOSE. See the file COPYING for more *) (* details. *) (* *) (* You should have received a copy of the GNU Lesser General Public License *) (* along with this library; if not, write to the Free Software Foundation, *) (* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA *) (******************************************************************************) let () = try Topdirs.dir_directory (Sys.getenv "OCAML_TOPLEVEL_PATH") with Not_found -> () ;; #use "topfind";; #require "oasis.dynrun";; open OASISDynRun;; let setup_t = BaseCompat.Compat_0_4.adapt_setup_t setup_t open BaseCompat.Compat_0_4 (* OASIS_STOP *) let () = setup ();; ocaml-fileutils-0.5.3/src/000077500000000000000000000000001320170427200153755ustar00rootroot00000000000000ocaml-fileutils-0.5.3/src/CommonPath.ml000066400000000000000000000040061320170427200177740ustar00rootroot00000000000000(******************************************************************************) (* ocaml-fileutils: files and filenames common operations *) (* *) (* Copyright (C) 2003-2014, Sylvain Le Gall *) (* *) (* This library is free software; you can redistribute it and/or modify it *) (* under the terms of the GNU Lesser General Public License as published by *) (* the Free Software Foundation; either version 2.1 of the License, or (at *) (* your option) any later version, with the OCaml static compilation *) (* exception. *) (* *) (* This library is distributed in the hope that it will be useful, but *) (* WITHOUT ANY WARRANTY; without even the implied warranty of *) (* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the file *) (* COPYING for more details. *) (* *) (* You should have received a copy of the GNU Lesser General Public License *) (* along with this library; if not, write to the Free Software Foundation, *) (* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA *) (******************************************************************************) (** A fast operation cannot be done, will continue by trying more complex processing *) module StringExt = FileStringExt exception CannotHandleFast let fast_concat _ _ = raise CannotHandleFast let fast_basename _ = raise CannotHandleFast let fast_dirname _ = raise CannotHandleFast let fast_is_relative _ = raise CannotHandleFast let fast_is_current _ = raise CannotHandleFast let fast_is_parent _ = raise CannotHandleFast ocaml-fileutils-0.5.3/src/ExtensionPath.ml000066400000000000000000000042311320170427200205200ustar00rootroot00000000000000(******************************************************************************) (* ocaml-fileutils: files and filenames common operations *) (* *) (* Copyright (C) 2003-2014, Sylvain Le Gall *) (* *) (* This library is free software; you can redistribute it and/or modify it *) (* under the terms of the GNU Lesser General Public License as published by *) (* the Free Software Foundation; either version 2.1 of the License, or (at *) (* your option) any later version, with the OCaml static compilation *) (* exception. *) (* *) (* This library is distributed in the hope that it will be useful, but *) (* WITHOUT ANY WARRANTY; without even the implied warranty of *) (* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the file *) (* COPYING for more details. *) (* *) (* You should have received a copy of the GNU Lesser General Public License *) (* along with this library; if not, write to the Free Software Foundation, *) (* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA *) (******************************************************************************) (** Manipulate path extension *) let get fn = let start_pos = (String.rindex fn '.') + 1 in let fn_len = String.length fn in if start_pos = fn_len then "" else String.sub fn start_pos (fn_len - start_pos) let check fn ext = try (get fn) = ext with Not_found -> false let chop fn = try let end_pos = String.rindex fn '.' in if end_pos = 0 then "" else String.sub fn 0 end_pos with Not_found -> fn let add fn ext = fn ^ "." ^ ext let replace fn ext = add (chop fn) ext ocaml-fileutils-0.5.3/src/FilePath.ml000066400000000000000000000374211320170427200174320ustar00rootroot00000000000000(******************************************************************************) (* ocaml-fileutils: files and filenames common operations *) (* *) (* Copyright (C) 2003-2014, Sylvain Le Gall *) (* *) (* This library is free software; you can redistribute it and/or modify it *) (* under the terms of the GNU Lesser General Public License as published by *) (* the Free Software Foundation; either version 2.1 of the License, or (at *) (* your option) any later version, with the OCaml static compilation *) (* exception. *) (* *) (* This library is distributed in the hope that it will be useful, but *) (* WITHOUT ANY WARRANTY; without even the implied warranty of *) (* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the file *) (* COPYING for more details. *) (* *) (* You should have received a copy of the GNU Lesser General Public License *) (* along with this library; if not, write to the Free Software Foundation, *) (* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA *) (******************************************************************************) open FilePath_type exception BaseFilenameRelative of filename exception UnrecognizedOS of string exception EmptyFilename exception NoExtension of filename exception InvalidFilename of filename module type OS_SPECIFICATION = sig val dir_writer: (filename_part list) -> filename val dir_reader: filename -> (filename_part list) val path_writer: (filename list) -> string val path_reader: string -> (filename list) val fast_concat: filename -> filename -> filename val fast_basename: filename -> filename val fast_dirname: filename -> filename val fast_is_relative: filename -> bool val fast_is_current: filename -> bool val fast_is_parent: filename -> bool end module type PATH_SPECIFICATION = sig type filename type extension val string_of_filename: filename -> string val filename_of_string: string -> filename val extension_of_string: string -> extension val string_of_extension: extension -> string val make_filename: string list -> filename val is_subdir: filename -> filename -> bool val is_updir: filename -> filename -> bool val compare: filename -> filename -> int val basename: filename -> filename val dirname: filename -> filename val concat: filename -> filename -> filename val reduce: ?no_symlink:bool -> filename -> filename val make_absolute: filename -> filename -> filename val make_relative: filename -> filename -> filename val reparent: filename -> filename -> filename -> filename val identity: filename -> filename val is_valid: filename -> bool val is_relative: filename -> bool val is_current: filename -> bool val is_parent: filename -> bool val chop_extension: filename -> filename val get_extension: filename -> extension val check_extension: filename -> extension -> bool val add_extension: filename -> extension -> filename val replace_extension: filename -> extension -> filename val string_of_path: filename list -> string val path_of_string: string -> filename list val current_dir: filename val parent_dir: filename end module type PATH_STRING_SPECIFICATION = sig module Abstract: PATH_SPECIFICATION include PATH_SPECIFICATION with type filename = string and type extension = string end (* Convert an OS_SPECIFICATION to PATH_SPECIFICATION *) module GenericPath = functor (OsOperation: OS_SPECIFICATION) -> struct type filename = FilePath_type.filename_part list type extension = FilePath_type.extension (* Filename_from_string *) let filename_of_string str = try OsOperation.dir_reader str with Parsing.Parse_error -> raise (InvalidFilename str) (* String_from_filename *) let string_of_filename path = OsOperation.dir_writer path (* Reduce *) let reduce ?(no_symlink=false) path = (* TODO: not tail recursive ! *) let rec reduce_aux lst = match lst with | ParentDir :: tl when no_symlink -> begin match reduce_aux tl with | Root s :: tl -> Root s :: tl | ParentDir :: tl -> ParentDir :: ParentDir :: tl | [] -> ParentDir :: tl | _ :: tl -> tl end | ParentDir :: tl -> ParentDir :: (reduce_aux tl) | CurrentDir _ :: tl | Component "" :: tl -> (reduce_aux tl) | Component s :: tl -> Component s :: (reduce_aux tl) | Root s :: tl -> Root s :: (reduce_aux tl) | [] -> [] in let rev_path = List.rev path in match reduce_aux rev_path with | [] when no_symlink = false-> (* assert * ( List.for_all ( function | Component "" * | CurrentDir _ -> true | _ -> false ) rev_path ) *) (try (* use last CurrentDir _ *) [ List.find ( function | CurrentDir _ -> true | _ -> false ) rev_path ] with | Not_found -> [] ) (* Only Component "" *) |l -> List.rev l (* Compare, subdir, updir *) type filename_relation = SubDir | UpDir | Equal | NoRelation of int let relation_of_filename path1 path2 = let rec relation_of_filename_aux path1 path2 = match (path1, path2) with ([], []) -> Equal | (hd1 :: tl1, hd2 :: tl2) -> if hd1 = hd2 then relation_of_filename_aux tl1 tl2 else begin NoRelation (String.compare (string_of_filename [hd1]) (string_of_filename [hd2]) ) end | (_, []) -> SubDir | ([], _) -> UpDir in relation_of_filename_aux path1 path2 let is_subdir path1 path2 = match relation_of_filename path1 path2 with SubDir -> true | _ -> false let is_updir path1 path2 = match relation_of_filename path1 path2 with UpDir -> true | _ -> false let compare path1 path2 = match relation_of_filename path1 path2 with SubDir -> -1 | UpDir -> 1 | Equal -> 0 | NoRelation i -> i (* Concat *) let concat lst_path1 lst_path2 = reduce (match lst_path2 with | CurrentDir Short :: tl_path2 -> lst_path1 @ tl_path2 | _ -> lst_path1 @ lst_path2) (* Is_relative *) let is_relative lst_path = match lst_path with (Root _) :: _ -> false | _ -> true (* Is_valid *) let is_valid path = (* As we are manipulating abstract filename, and that it has been parsed, we are sure that all is correct *) true let is_current path = match path with [ (CurrentDir _) ] -> true | _ -> false let is_parent path = match path with [ ParentDir ] -> true | _ -> false (* Basename *) let basename path = match List.rev path with | hd :: _ -> [hd] | [] -> raise EmptyFilename (* Dirname *) let dirname path = match List.rev path with | _ :: tl -> List.rev tl | [] -> raise EmptyFilename (* Extension manipulation *) let wrap_extension f path = match basename path with | [Component fn] -> f fn | _ -> raise (NoExtension (string_of_filename path)) let check_extension path ext = wrap_extension (fun fn -> ExtensionPath.check fn ext) path let get_extension path = wrap_extension (fun fn -> ExtensionPath.get fn) path let chop_extension path = wrap_extension (fun fn -> concat (dirname path) [Component (ExtensionPath.chop fn)]) path let add_extension path ext = wrap_extension (fun fn -> concat (dirname path) [Component (ExtensionPath.add fn ext)]) path let replace_extension path ext = wrap_extension (fun fn -> concat (dirname path) [Component (ExtensionPath.replace fn ext)]) path let extension_of_string x = x let string_of_extension x = x (* Make_asbolute *) let make_absolute path_base path_path = reduce (if is_relative path_base then raise (BaseFilenameRelative (string_of_filename path_base)) else if is_relative path_path then path_base @ path_path else path_path) (* Make_relative *) let make_relative path_base path_path = let rec make_relative_aux lst_base lst_path = match (lst_base, lst_path) with x :: tl_base, a :: tl_path when x = a -> make_relative_aux tl_base tl_path | _, _ -> let back_to_base = List.rev_map (fun _ -> ParentDir) lst_base in back_to_base @ lst_path in reduce (if is_relative path_base then raise (BaseFilenameRelative (string_of_filename path_base)) else if is_relative path_path then path_path else make_relative_aux path_base path_path) (* Make_filename *) let make_filename lst_path = reduce (List.flatten (List.map filename_of_string lst_path)) (* Reparent *) let reparent path_src path_dst path = let path_relative = make_relative path_src path in make_absolute path_dst path_relative (* Identity *) let identity path = path (* Manipulate path like variable *) let string_of_path lst = OsOperation.path_writer (List.map string_of_filename lst) let path_of_string str = List.map filename_of_string (OsOperation.path_reader str) (* Generic filename component *) let current_dir = [ CurrentDir Long ] let parent_dir = [ ParentDir ] end (* Convert an OS_SPECIFICATION to PATH_STRING_SPECIFICATION *) module GenericStringPath = functor (OsOperation: OS_SPECIFICATION) -> struct module Abstract = GenericPath(OsOperation) type filename = string type extension = string let string_of_filename path = path let filename_of_string path = path let string_of_extension ext = ext let extension_of_string str = str let f2s = Abstract.string_of_filename let s2f = Abstract.filename_of_string let e2s = Abstract.string_of_extension let s2e = Abstract.extension_of_string let is_subdir path1 path2 = Abstract.is_subdir (s2f path1) (s2f path2) let is_updir path1 path2 = Abstract.is_updir (s2f path1) (s2f path2) let compare path1 path2 = Abstract.compare (s2f path1) (s2f path2) let basename path = try OsOperation.fast_basename path with CommonPath.CannotHandleFast -> f2s (Abstract.basename (s2f path)) let dirname path = try OsOperation.fast_dirname path with CommonPath.CannotHandleFast -> f2s (Abstract.dirname (s2f path)) let concat path1 path2 = try OsOperation.fast_concat path1 path2 with CommonPath.CannotHandleFast -> f2s (Abstract.concat (s2f path1) (s2f path2)) let make_filename path_lst = f2s (Abstract.make_filename path_lst) let reduce ?no_symlink path = f2s (Abstract.reduce ?no_symlink (s2f path)) let make_absolute base_path path = f2s (Abstract.make_absolute (s2f base_path) (s2f path)) let make_relative base_path path = f2s (Abstract.make_relative (s2f base_path) (s2f path)) let reparent path_src path_dst path = f2s (Abstract.reparent (s2f path_src) (s2f path_dst) (s2f path)) let identity path = f2s (Abstract.identity (s2f path)) let is_valid path = try Abstract.is_valid (s2f path) with InvalidFilename _ -> false let is_relative path = try OsOperation.fast_is_relative path with CommonPath.CannotHandleFast -> Abstract.is_relative (s2f path) let is_current path = try OsOperation.fast_is_current path with CommonPath.CannotHandleFast -> Abstract.is_current (s2f path) let is_parent path = try OsOperation.fast_is_parent path with CommonPath.CannotHandleFast -> Abstract.is_parent (s2f path) let wrap_extension f path = let bfn = OsOperation.fast_basename path in if OsOperation.fast_is_parent bfn || OsOperation.fast_is_current bfn || not (OsOperation.fast_is_relative bfn) then raise (NoExtension path) else f bfn let chop_extension path = try wrap_extension (fun fn -> OsOperation.fast_concat (OsOperation.fast_dirname path) (ExtensionPath.chop fn)) path with CommonPath.CannotHandleFast -> f2s (Abstract.chop_extension (s2f path)) let get_extension path = try wrap_extension (fun fn -> ExtensionPath.get fn) path with CommonPath.CannotHandleFast -> e2s (Abstract.get_extension (s2f path)) let check_extension path ext = try wrap_extension (fun fn -> ExtensionPath.check fn ext) path with CommonPath.CannotHandleFast -> Abstract.check_extension (s2f path) (s2e ext) let add_extension path ext = try wrap_extension (fun fn -> OsOperation.fast_concat (OsOperation.fast_dirname path) (ExtensionPath.add fn ext)) path with CommonPath.CannotHandleFast -> f2s (Abstract.add_extension (s2f path) (s2e ext)) let replace_extension path ext = try wrap_extension (fun fn -> OsOperation.fast_concat (OsOperation.fast_dirname path) (ExtensionPath.replace fn ext)) path with CommonPath.CannotHandleFast -> f2s (Abstract.replace_extension (s2f path) (s2e ext)) let string_of_path path_lst = Abstract.string_of_path (List.map s2f path_lst) let path_of_string str = List.map f2s (Abstract.path_of_string str) let current_dir = f2s (Abstract.current_dir) let parent_dir = f2s (Abstract.parent_dir) end module DefaultPath = GenericStringPath(struct let os_depend unix macos win32 = match Sys.os_type with "Unix" | "Cygwin" -> unix | "MacOS" -> macos | "Win32" -> win32 | s -> raise (UnrecognizedOS s) let dir_writer = os_depend UnixPath.dir_writer MacOSPath.dir_writer Win32Path.dir_writer let dir_reader = os_depend UnixPath.dir_reader MacOSPath.dir_reader Win32Path.dir_reader let path_writer = os_depend UnixPath.path_writer MacOSPath.path_writer Win32Path.path_writer let path_reader = os_depend UnixPath.path_reader MacOSPath.path_reader Win32Path.path_reader let fast_concat = os_depend UnixPath.fast_concat MacOSPath.fast_concat Win32Path.fast_concat let fast_basename = os_depend UnixPath.fast_basename MacOSPath.fast_basename Win32Path.fast_basename let fast_dirname = os_depend UnixPath.fast_dirname MacOSPath.fast_dirname Win32Path.fast_dirname let fast_is_relative = os_depend UnixPath.fast_is_relative MacOSPath.fast_is_relative Win32Path.fast_is_relative let fast_is_current = os_depend UnixPath.fast_is_current MacOSPath.fast_is_current Win32Path.fast_is_current let fast_is_parent = os_depend UnixPath.fast_is_parent MacOSPath.fast_is_parent Win32Path.fast_is_parent end) module UnixPath = GenericStringPath(UnixPath) module MacOSPath = GenericStringPath(MacOSPath) module Win32Path = GenericStringPath(Win32Path) module CygwinPath = UnixPath include DefaultPath ocaml-fileutils-0.5.3/src/FilePath.mli000066400000000000000000000230131320170427200175730ustar00rootroot00000000000000(******************************************************************************) (* ocaml-fileutils: files and filenames common operations *) (* *) (* Copyright (C) 2003-2014, Sylvain Le Gall *) (* *) (* This library is free software; you can redistribute it and/or modify it *) (* under the terms of the GNU Lesser General Public License as published by *) (* the Free Software Foundation; either version 2.1 of the License, or (at *) (* your option) any later version, with the OCaml static compilation *) (* exception. *) (* *) (* This library is distributed in the hope that it will be useful, but *) (* WITHOUT ANY WARRANTY; without even the implied warranty of *) (* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the file *) (* COPYING for more details. *) (* *) (* You should have received a copy of the GNU Lesser General Public License *) (* along with this library; if not, write to the Free Software Foundation, *) (* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA *) (******************************************************************************) (** Operations on abstract filenames. This module allow to manipulate string or abstract representation of a filename. Abstract representation of a filename allow to decode it only once, and should speed up further operation on it (comparison in particular). If you intend to do a lot of processing on filename, you should consider using its abstract representation. This module manipulate abstract path that are not bound to a real filesystem. In particular, it makes the assumption that there is no symbolic link that should modify the meaning of a path. If you intend to use this module against a real set of filename, the best solution is to apply to every filename to solve symbolic link through {!FileUtil.readlink}. @author Sylvain Le Gall *) (** Filename type. *) type filename = string (** Extension type. *) type extension = string (** {2 Exceptions and types} *) (** Cannot pass a base filename which is relative. *) exception BaseFilenameRelative of filename (** We do not have recognized any OS, please contact upstream. *) exception UnrecognizedOS of string (** The filename use was empty. *) exception EmptyFilename (** The last component of the filename does not support extension (Root, ParentDir...) *) exception NoExtension of filename (** The filename used is invalid. *) exception InvalidFilename of filename (** {2 Ordering} *) (** [is_subdir fl1 fl2] Is [fl2] a sub directory of [fl1] *) val is_subdir: filename -> filename -> bool (** [is_updir fl1 fl2] Is [fl1] a sub directory of [fl2] *) val is_updir: filename -> filename -> bool (** [compare fl1 fl2] Give an order between the two filename. The classification is done by sub directory relation, [fl1] < [fl2] iff [fl1] is a subdirectory of [fl2], and lexicographical order of each part of the reduce filename when [fl1] and [fl2] has no hierarchical relation *) val compare: filename -> filename -> int (** {2 Standard operations } *) (** Current dir. *) val current_dir: filename (** Upper dir. *) val parent_dir: filename (** Make a filename from a set of strings. *) val make_filename: string list -> filename (** Extract only the file name of a filename. *) val basename: filename -> filename (** Extract the directory name of a filename. *) val dirname: filename -> filename (** Append a filename to a filename. *) val concat: filename -> filename -> filename (** Return the shortest filename which is equal to the filename given. It remove the "." in Unix filename, for example. If [no_symlink] flag is set, consider that the path doesn't contain symlink and in this case ".." for Unix filename are also reduced. *) val reduce: ?no_symlink:bool -> filename -> filename (** Create an absolute filename from a filename relative and an absolute base filename. *) val make_absolute: filename -> filename -> filename (** Create a filename which is relative to the base filename. *) val make_relative: filename -> filename -> filename (** [reparent fln_src fln_dst fln] Return the same filename as [fln] but the root is no more [fln_src] but [fln_dst]. It replaces the [fln_src] prefix by [fln_dst]. *) val reparent: filename -> filename -> filename -> filename (** Identity for testing the stability of implode/explode. *) val identity: filename -> filename (** Test if the filename is a valid one. *) val is_valid: filename -> bool (** Check if the filename is relative to a dir or not. *) val is_relative: filename -> bool (** Check if the filename is the current directory. *) val is_current: filename -> bool (** Check if the filename is the parent directory. *) val is_parent: filename -> bool (** {2 Extension}*) (** Extension is define as the suffix of a filename, just after the last ".". *) (** Remove extension and the trailing ".". *) val chop_extension: filename -> filename (** Extract the extension. *) val get_extension: filename -> extension (** Check the extension. *) val check_extension: filename -> extension -> bool (** Add an extension with a "." before. *) val add_extension: filename -> extension -> filename (** Replace extension. *) val replace_extension: filename -> extension -> filename (** {2 PATH-like operation}*) (** PATH-like refers the environment variable PATH. This variable holds a list of filename. The functions [string_of_path] and [path_of_string] allow to convert this kind of list by using the good separator between filename. *) (** Create a PATH-like string. *) val string_of_path: filename list -> string (** Extract filenames from a PATH-like string. *) val path_of_string: string -> filename list (** {2 Filename specifications} *) (** Definition of operations for path manipulation. *) (** Generic operations. *) module type PATH_SPECIFICATION = sig type filename type extension (** {3 Converting abstract type from/to string } *) (** Create a filename from a string. *) val string_of_filename: filename -> string (** Create a string from a filename. *) val filename_of_string: string -> filename (** Create an extension from a string. *) val extension_of_string: string -> extension (** Return string representation of an extension. *) val string_of_extension: extension -> string (** {3 Standard operations} *) (** See {!FilePath.make_filename} *) val make_filename: string list -> filename (** See {!FilePath.is_subdir} *) val is_subdir: filename -> filename -> bool (** See {!FilePath.is_updir} *) val is_updir: filename -> filename -> bool (** See {!FilePath.compare} *) val compare: filename -> filename -> int (** See {!FilePath.basename} *) val basename: filename -> filename (** See {!FilePath.dirname} *) val dirname: filename -> filename (** See {!FilePath.concat} *) val concat: filename -> filename -> filename (** See {!FilePath.reduce} *) val reduce: ?no_symlink:bool -> filename -> filename (** See {!FilePath.make_absolute} *) val make_absolute: filename -> filename -> filename (** See {!FilePath.make_relative} *) val make_relative: filename -> filename -> filename (** See {!FilePath.reparent} *) val reparent: filename -> filename -> filename -> filename (** See {!FilePath.identity} *) val identity: filename -> filename (** See {!FilePath.is_valid} *) val is_valid: filename -> bool (** See {!FilePath.is_relative} *) val is_relative: filename -> bool (** See {!FilePath.is_current} *) val is_current: filename -> bool (** See {!FilePath.is_parent} *) val is_parent: filename -> bool (** See {!FilePath.chop_extension} *) val chop_extension: filename -> filename (** See {!FilePath.get_extension} *) val get_extension: filename -> extension (** See {!FilePath.check_extension} *) val check_extension: filename -> extension -> bool (** See {!FilePath.add_extension} *) val add_extension: filename -> extension -> filename (** See {!FilePath.replace_extension} *) val replace_extension: filename -> extension -> filename (** See {!FilePath.string_of_path} *) val string_of_path: filename list -> string (** See {!FilePath.path_of_string} *) val path_of_string: string -> filename list (** See {!FilePath.current_dir} *) val current_dir: filename (** See {!FilePath.parent_dir} *) val parent_dir: filename end (** Generic operations, with type filename and extension as strings. *) module type PATH_STRING_SPECIFICATION = sig module Abstract: PATH_SPECIFICATION include PATH_SPECIFICATION with type filename = string and type extension = string end (** Operations on filenames for other OS. The {!DefaultPath} always match the current OS. *) (** Default operating system. *) module DefaultPath: PATH_STRING_SPECIFICATION (** Unix operating system. *) module UnixPath: PATH_STRING_SPECIFICATION (** MacOS operating system. *) module MacOSPath: PATH_STRING_SPECIFICATION (** Win32 operating system. *) module Win32Path: PATH_STRING_SPECIFICATION (** Cygwin operating system. *) module CygwinPath: PATH_STRING_SPECIFICATION ocaml-fileutils-0.5.3/src/FilePath_type.ml000066400000000000000000000040551320170427200204700ustar00rootroot00000000000000(******************************************************************************) (* ocaml-fileutils: files and filenames common operations *) (* *) (* Copyright (C) 2003-2014, Sylvain Le Gall *) (* *) (* This library is free software; you can redistribute it and/or modify it *) (* under the terms of the GNU Lesser General Public License as published by *) (* the Free Software Foundation; either version 2.1 of the License, or (at *) (* your option) any later version, with the OCaml static compilation *) (* exception. *) (* *) (* This library is distributed in the hope that it will be useful, but *) (* WITHOUT ANY WARRANTY; without even the implied warranty of *) (* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the file *) (* COPYING for more details. *) (* *) (* You should have received a copy of the GNU Lesser General Public License *) (* along with this library; if not, write to the Free Software Foundation, *) (* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA *) (******************************************************************************) type current_dir_type = Short | Long type filename_part = Root of string | ParentDir | CurrentDir of current_dir_type | Component of string type filename = string type extension = string (* Utility function to parse filename *) let begin_string str lst = (str, lst) let add_string str1 (str2, lst) = (str1 ^ str2, lst) let end_string (str, lst) = (Component str) :: lst (* Definition of the caracteristic length of a path *) let path_length = 80 ocaml-fileutils-0.5.3/src/FileStringExt.ml000066400000000000000000000051421320170427200204600ustar00rootroot00000000000000(******************************************************************************) (* ocaml-fileutils: files and filenames common operations *) (* *) (* Copyright (C) 2003-2014, Sylvain Le Gall *) (* *) (* This library is free software; you can redistribute it and/or modify it *) (* under the terms of the GNU Lesser General Public License as published by *) (* the Free Software Foundation; either version 2.1 of the License, or (at *) (* your option) any later version, with the OCaml static compilation *) (* exception. *) (* *) (* This library is distributed in the hope that it will be useful, but *) (* WITHOUT ANY WARRANTY; without even the implied warranty of *) (* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the file *) (* COPYING for more details. *) (* *) (* You should have received a copy of the GNU Lesser General Public License *) (* along with this library; if not, write to the Free Software Foundation, *) (* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA *) (******************************************************************************) (** Extended String module *) (** Split a string, separator not included *) let split ?(start_acc=[]) ?(start_pos=0) ~map sep str = let str_len = String.length str in let rec split_aux acc pos = if pos < str_len then begin let pos_sep = try String.index_from str pos sep with Not_found -> str_len in let part = String.sub str pos (pos_sep - pos) in let acc = (map part) :: acc in if pos_sep >= str_len then (* Nothing more in the string *) List.rev acc else if pos_sep = (str_len - 1) then (* String end with a separator *) List.rev ((map "") :: acc) else split_aux acc (pos_sep + 1) end else List.rev acc in split_aux start_acc start_pos (** Cut in two a string, separator not included *) let break_at_first sep str = let pos_sep = String.index str sep in (String.sub str 0 pos_sep), (String.sub str (pos_sep + 1) ((String.length str) - pos_sep - 1)) ocaml-fileutils-0.5.3/src/FileUtil.ml000066400000000000000000000041161320170427200174460ustar00rootroot00000000000000(******************************************************************************) (* ocaml-fileutils: files and filenames common operations *) (* *) (* Copyright (C) 2003-2014, Sylvain Le Gall *) (* *) (* This library is free software; you can redistribute it and/or modify it *) (* under the terms of the GNU Lesser General Public License as published by *) (* the Free Software Foundation; either version 2.1 of the License, or (at *) (* your option) any later version, with the OCaml static compilation *) (* exception. *) (* *) (* This library is distributed in the hope that it will be useful, but *) (* WITHOUT ANY WARRANTY; without even the implied warranty of *) (* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the file *) (* COPYING for more details. *) (* *) (* You should have received a copy of the GNU Lesser General Public License *) (* along with this library; if not, write to the Free Software Foundation, *) (* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA *) (******************************************************************************) include FileUtilTypes include FileUtilPermission include FileUtilSize include FileUtilSTAT include FileUtilUMASK include FileUtilLS include FileUtilCHMOD include FileUtilTEST include FileUtilPWD include FileUtilREADLINK include FileUtilWHICH include FileUtilMKDIR include FileUtilTOUCH include FileUtilFIND include FileUtilRM include FileUtilCP include FileUtilMV include FileUtilCMP include FileUtilDU type exc = FileUtilMisc.exc type 'a error_handler = string -> 'a -> unit module Mode = FileUtilMode ocaml-fileutils-0.5.3/src/FileUtil.mli000066400000000000000000000413551320170427200176250ustar00rootroot00000000000000(******************************************************************************) (* ocaml-fileutils: files and filenames common operations *) (* *) (* Copyright (C) 2003-2014, Sylvain Le Gall *) (* *) (* This library is free software; you can redistribute it and/or modify it *) (* under the terms of the GNU Lesser General Public License as published by *) (* the Free Software Foundation; either version 2.1 of the License, or (at *) (* your option) any later version, with the OCaml static compilation *) (* exception. *) (* *) (* This library is distributed in the hope that it will be useful, but *) (* WITHOUT ANY WARRANTY; without even the implied warranty of *) (* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the file *) (* COPYING for more details. *) (* *) (* You should have received a copy of the GNU Lesser General Public License *) (* along with this library; if not, write to the Free Software Foundation, *) (* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA *) (******************************************************************************) (** POSIX utilities for files and directories. A module to provide the core POSIX utilities to manipulate files and directories. All functions try to mimic common POSIX utilities but are written in pure OCaml. @author Sylvain Le Gall *) open FilePath (*********************************************************************) (** {2 Types and exceptions } *) exception FileDoesntExist of filename exception RecursiveLink of filename (** Generic error handling functions. Whenever such a function is available it helps report the error and allows to raise an exception. The [string] provided is the human readable version of ['a]. In most cases ['a] is a polymorphic variant. *) type 'a error_handler = string -> 'a -> unit (** Exception raised when after an [error_handler] the execution cannot continue. The rest of the workflow logic cannot handle the default case and the whole operation can be in the middle of transformation. *) exception Fatal of string (** Policy concerning links which are directories. *) type action_link = | Follow (** We consider link as simple directory (it is dangerous) *) | Skip (** Just skip it *) | SkipInform of (filename -> unit) (** Skip and execute an action *) | AskFollow of (filename -> bool) (** Ask and wait for input, false means skip *) (** For certain command, you should need to ask the user wether or not he wants to act. *) type interactive = | Force (** Do it anyway *) | Ask of (filename -> bool) (** Promp the user *) (*********************************************************************) (** {2 Permission } *) (** Base permission. This is the permission corresponding to one user or group. *) type base_permission = { sticky: bool; exec: bool; write: bool; read: bool; } (** Full permission. All the base permissions of a file. *) type permission = { user: base_permission; group: base_permission; other: base_permission; } (** Translate POSIX integer permission. *) val permission_of_int: int -> permission (** Return the POSIX integer permission *) val int_of_permission: permission -> int (** Permission symbolic mode. *) module Mode: sig type who = [`User | `Group | `Other | `All] type wholist = [ who | `List of who list ] type permcopy = [`User | `Group | `Other] type perm = [ `Read | `Write | `Exec | `ExecX | `Sticky | `StickyO ] type permlist = [ perm | `List of perm list ] type actionarg = [ permlist | permcopy ] type action = [ `Set of actionarg | `Add of actionarg | `Remove of actionarg] type actionlist = [ action | `List of action list ] type clause = [ `User of actionlist | `Group of actionlist | `Other of actionlist | `All of actionlist | `None of actionlist ] (** Typical symbolic mode: - g+r -> [`Group (`Add `Read)] - u=rw,g+rw,o-rwx -> [`User (`Set (`List [`Read; `Write])); `Group (`Add (`List [`Read; `Write])); `Other (`Remove (`List [`Read; `Write; `Exec]))] *) type t = clause list end (*********************************************************************) (** {2 Size operation} *) (** File size *) type size = TB of int64 (** Tera bytes *) | GB of int64 (** Giga bytes *) | MB of int64 (** Mega bytes *) | KB of int64 (** Kilo bytes *) | B of int64 (** Bytes *) (** Convert size to bytes. *) val byte_of_size: size -> int64 (** Add two sizes. *) val size_add: size -> size -> size (** Compare two sizes, using the classical compare function. If fuzzy is set to true, the comparison is done on the most significant size unit of both value. *) val size_compare: ?fuzzy:bool -> size -> size -> int (** Convert a value to a string representation. If fuzzy is set to true, only consider the most significant unit *) val string_of_size: ?fuzzy:bool -> size -> string (*********************************************************************) (** {2 stat } *) (** Kind of file. This set is a combination of all POSIX file, some of them doesn't exist at all on certain file system or OS. *) type kind = Dir | File | Dev_char | Dev_block | Fifo | Socket | Symlink (** @since 0.4.6 *) (** Information about a file. This type is derived from Unix.stat *) type stat = { kind: kind; is_link: bool; permission: permission; size: size; owner: int; group_owner: int; access_time: float; modification_time: float; creation_time: float; device: int; inode: int; } (** [stat fln] Return information about the file (like Unix.stat) Non POSIX command. *) val stat: ?dereference:bool -> filename -> stat (*********************************************************************) (** {2 umask } *) exception UmaskError of string (** Possible umask errors. *) type umask_error = [ `Exc of exn | `NoStickyBit of int ] (** Get or set the file mode creation mask. See {{:http://pubs.opengroup.org/onlinepubs/007904875/utilities/umask.html}POSIX documentation}. *) val umask: ?error:(umask_error error_handler) -> ?mode:[< `Octal of int | `Symbolic of Mode.t ] -> [< `Octal of int -> 'a | `Symbolic of Mode.t -> 'a] -> 'a (** Apply umask to a given file permission. *) val umask_apply: int -> int (*********************************************************************) (** {2 test } *) (** Pattern you can use to test file. If the file doesn't exist the result is always false. *) type test_file = | Is_dev_block (** FILE is block special *) | Is_dev_char (** FILE is character special *) | Is_dir (** FILE is a directory *) | Exists (** FILE exists *) | Is_file (** FILE is a regular file *) | Is_set_group_ID (** FILE is set-group-ID *) | Has_sticky_bit (** FILE has its sticky bit set *) | Is_link (** FILE is a symbolic link *) | Is_pipe (** FILE is a named pipe *) | Is_readable (** FILE is readable *) | Is_writeable (** FILE is writeable *) | Size_not_null (** FILE has a size greater than zero *) | Size_bigger_than of size (** FILE has a size greater than given size *) | Size_smaller_than of size (** FILE has a size smaller than given size *) | Size_equal_to of size (** FILE has the same size as given size *) | Size_fuzzy_equal_to of size (** FILE has approximatively the same size as given size *) | Is_socket (** FILE is a socket *) | Has_set_user_ID (** FILE its set-user-ID bit is set *) | Is_exec (** FILE is executable *) | Is_owned_by_user_ID (** FILE is owned by the effective user ID *) | Is_owned_by_group_ID (** FILE is owned by the effective group ID *) | Is_newer_than of filename (** FILE1 is newer (modification date) than FILE2 *) | Is_older_than of filename (** FILE1 is older than FILE2 *) | Is_newer_than_date of float (** FILE is newer than given date *) | Is_older_than_date of float (** FILE is older than given date *) | And of test_file * test_file (** Result of TEST1 and TEST2 *) | Or of test_file * test_file (** Result of TEST1 or TEST2 *) | Not of test_file (** Result of not TEST *) | Match of string (** Compilable match (Str or PCRE or ...) *) | True (** Always true *) | False (** Always false *) | Has_extension of extension (** Check extension *) | Has_no_extension (** Check absence of extension *) | Is_parent_dir (** Basename is the parent dir *) | Is_current_dir (** Basename is the current dir *) | Basename_is of filename (** Check the basename *) | Dirname_is of filename (** Check the dirname *) | Custom of (filename -> bool) (** Custom operation on filename *) (** Test a file. See {{:http://pubs.opengroup.org/onlinepubs/007904875/utilities/test.html}POSIX documentation}. *) val test: ?match_compile:(filename -> filename -> bool) -> test_file -> filename -> bool (*********************************************************************) (** {2 chmod } *) exception ChmodError of string (** Possible chmod errors. *) type chmod_error = [`Exc of exn] (** Change permissions of files. See {{:http://pubs.opengroup.org/onlinepubs/007904875/utilities/chmod.html}POSIX documentation}. *) val chmod: ?error:(chmod_error error_handler) -> ?recurse:bool -> [< `Octal of Unix.file_perm | `Symbolic of Mode.t ] -> filename list -> unit (*********************************************************************) (** {2 mkdir } *) exception MkdirError of string (** Possible mkdir errors. *) type mkdir_error = [ `DirnameAlreadyUsed of filename | `Exc of exn | `MissingComponentPath of filename | `MkdirChmod of filename * Unix.file_perm * string * chmod_error ] (** Create the directory which name is provided. Set [~parent] to true if you also want to create every directory of the path. Use mode to provide some specific right. See {{:http://pubs.opengroup.org/onlinepubs/007904875/utilities/mkdir.html}POSIX documentation}. *) val mkdir: ?error:(mkdir_error error_handler) -> ?parent:bool -> ?mode:[< `Octal of Unix.file_perm | `Symbolic of FileUtilMode.t ] -> filename -> unit (*********************************************************************) (** {2 rm } *) exception RmError of string (** Possible rm errors. *) type rm_error = [ `DirNotEmpty of filename | `Exc of exn | `NoRecurse of filename ] (** Remove the filename provided. Set [~recurse] to true in order to completely delete a directory. See {{:http://pubs.opengroup.org/onlinepubs/007904875/utilities/rm.html}POSIX documentation}. *) val rm: ?error:(rm_error error_handler) -> ?force:interactive -> ?recurse:bool -> filename list -> unit (*********************************************************************) (** {2 cp } *) exception CpError of string (** Possible cp errors. *) type cp_error = [ `CannotChmodDstDir of filename * exn | `CannotCopyDir of filename | `CannotCopyFilesToFile of filename list * filename | `CannotCreateDir of filename * exn | `CannotListSrcDir of filename * exn | `CannotOpenDstFile of filename * exn | `CannotOpenSrcFile of filename * exn | `CannotRemoveDstFile of filename * exn | `DstDirNotDir of filename | `ErrorRead of filename * exn | `ErrorWrite of filename * exn | `Exc of exn | `NoSourceFile of filename | `PartialWrite of filename * int * int | `SameFile of filename * filename | `UnhandledType of filename * kind ] (** Copy the hierarchy of files/directory to another destination. See {{:http://pubs.opengroup.org/onlinepubs/007904875/utilities/cp.html}POSIX documentation}. *) val cp: ?follow:action_link -> ?force:interactive -> ?recurse:bool -> ?preserve:bool -> ?error:(cp_error error_handler) -> filename list -> filename -> unit (*********************************************************************) (** {2 mv } *) exception MvError of string (** Possible mv errors. *) type mv_error = [ `Exc of exn | `MvCp of filename * filename * string * cp_error | `MvRm of filename * string * rm_error | `NoSourceFile ] (** Move files/directories to another destination. See {{:http://pubs.opengroup.org/onlinepubs/007904875/utilities/mv.html}POSIX documentation}. *) val mv: ?error:(mv_error error_handler) -> ?force:interactive -> filename -> filename -> unit (*********************************************************************) (** {2 touch } *) (** Time for file *) type touch_time_t = | Touch_now (** Use Unix.gettimeofday *) | Touch_file_time of filename (** Get mtime of file *) | Touch_timestamp of float (** Use GMT timestamp *) (** Modify the timestamp of the given filename. See {{:http://pubs.opengroup.org/onlinepubs/007904875/utilities/touch.html}POSIX documentation}. If atime and mtime are not specified, they are both considered true. If only atime or mtime is sepcified, the other is false. @param atime modify access time. @param mtime modify modification time. @param create if file doesn't exist, create it, default true @param time what time to set, default Touch_now *) val touch: ?atime:bool -> ?mtime:bool -> ?create:bool -> ?time:touch_time_t -> filename -> unit (*********************************************************************) (** {2 ls } *) (** Apply a filtering pattern to a filename. *) val filter: test_file -> filename list -> filename list (** List the content of a directory. See {{:http://pubs.opengroup.org/onlinepubs/007904875/utilities/ls.html}POSIX documentation}. *) val ls: filename -> filename list (*********************************************************************) (** {2 Misc operations } *) (** Return the current dir. See {{:http://pubs.opengroup.org/onlinepubs/007904875/utilities/pwd.html}POSIX documentation}. *) val pwd: unit -> filename (** Resolve to the real filename removing symlink. Non POSIX command. *) val readlink: filename -> filename (** Try to find the executable in the PATH. Use environement variable PATH if none is provided. Non POSIX command. *) val which: ?path:filename list -> filename -> filename (** [cmp skip1 fln1 skip2 fln2] Compare files [fln1] and [fln2] starting at pos [skip1] [skip2] and returning the first octect where a difference occurs. Returns [Some -1] if one of the file is not readable or if it is not a file. See {{:http://pubs.opengroup.org/onlinepubs/007904875/utilities/cmp.html}POSIX documentation}. *) val cmp: ?skip1:int -> filename -> ?skip2:int -> filename -> int option (** [du fln_lst] Return the amount of space of all the file which are subdir of fln_lst. Also return details for each file scanned. See {{:http://pubs.opengroup.org/onlinepubs/007904875/utilities/du.html}POSIX documentation}. *) val du: filename list -> size * (filename * size) list (** [find ~follow:fol tst fln exec accu] Descend the directory tree starting from the given filename and using the test provided. You cannot match [current_dir] and [parent_dir]. For every file found, the action [exec] is done, using the [accu] to start. For a simple file listing, you can use [find True "." (fun x y -> y :: x) []] See {{:http://pubs.opengroup.org/onlinepubs/007904875/utilities/find.html}POSIX documentation}. *) val find: ?follow:action_link -> ?match_compile:(filename -> filename -> bool) -> test_file -> filename -> ('a -> filename -> 'a) -> 'a -> 'a (** For future release: - [val pathchk: filename -> boolean * string], check whether file names are valid or portable - [val setfacl: filename -> permission -> unit], set file access control lists (UNIX + extended attribute) - [val getfacl: filename -> permission], get file access control lists ACL related function will be handled through a plugin system to handle at runtime which attribute can be read/write (i.e. Win32 ACL, NFS acl, Linux ACL -- or none). *) ocaml-fileutils-0.5.3/src/FileUtilCHMOD.ml000066400000000000000000000052121320170427200202170ustar00rootroot00000000000000(******************************************************************************) (* ocaml-fileutils: files and filenames common operations *) (* *) (* Copyright (C) 2003-2014, Sylvain Le Gall *) (* *) (* This library is free software; you can redistribute it and/or modify it *) (* under the terms of the GNU Lesser General Public License as published by *) (* the Free Software Foundation; either version 2.1 of the License, or (at *) (* your option) any later version, with the OCaml static compilation *) (* exception. *) (* *) (* This library is distributed in the hope that it will be useful, but *) (* WITHOUT ANY WARRANTY; without even the implied warranty of *) (* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the file *) (* COPYING for more details. *) (* *) (* You should have received a copy of the GNU Lesser General Public License *) (* along with this library; if not, write to the Free Software Foundation, *) (* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA *) (******************************************************************************) open FileUtilTypes open FileUtilMisc open FileUtilPermission open FileUtilSTAT open FileUtilLS open FileUtilUMASK exception ChmodError of string type chmod_error = [`Exc of exn] let chmod ?(error=fun str _ -> raise (ChmodError str)) ?(recurse=false) mode lst = let _, handle_exception = handle_error_gen "chmod" error (function #exc -> "") in let rec chmod_one fn = let st = stat fn in if st.kind = Dir && recurse then begin List.iter chmod_one (ls fn) end; if not st.is_link then begin let int_perm = match mode with | `Octal i -> i | `Symbolic t -> FileUtilMode.apply ~is_dir:(st.kind = Dir) ~umask:(umask (`Octal (fun i -> i))) (int_of_permission st.permission) t in if int_perm <> int_of_permission st.permission then try Unix.chmod fn int_perm with e -> handle_exception ~fatal:true e end in List.iter chmod_one lst ocaml-fileutils-0.5.3/src/FileUtilCMP.ml000066400000000000000000000057241320170427200200140ustar00rootroot00000000000000(******************************************************************************) (* ocaml-fileutils: files and filenames common operations *) (* *) (* Copyright (C) 2003-2014, Sylvain Le Gall *) (* *) (* This library is free software; you can redistribute it and/or modify it *) (* under the terms of the GNU Lesser General Public License as published by *) (* the Free Software Foundation; either version 2.1 of the License, or (at *) (* your option) any later version, with the OCaml static compilation *) (* exception. *) (* *) (* This library is distributed in the hope that it will be useful, but *) (* WITHOUT ANY WARRANTY; without even the implied warranty of *) (* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the file *) (* COPYING for more details. *) (* *) (* You should have received a copy of the GNU Lesser General Public License *) (* along with this library; if not, write to the Free Software Foundation, *) (* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA *) (******************************************************************************) open FileUtilTypes open FilePath open FileUtilTEST let cmp ?(skip1 = 0) fln1 ?(skip2 = 0) fln2 = if (reduce fln1) = (reduce fln2) then None else if (test (And(Is_readable, Is_file)) fln1) && (test (And(Is_readable, Is_file)) fln2) then begin let fd1 = open_in_bin fln1 in let fd2 = open_in_bin fln2 in let clean_fd () = let () = try close_in fd1 with _ -> () in let () = try close_in fd2 with _ -> () in () in let test_empty st = try Stream.empty st; true with Stream.Failure -> false in let _ = seek_in fd1 skip1 in let _ = seek_in fd2 skip2 in let stream1 = Stream.of_channel fd1 in let stream2 = Stream.of_channel fd2 in try begin while ((Stream.next stream1) = (Stream.next stream2)) do () done; clean_fd (); Some (Stream.count stream1) end with | Stream.Failure -> begin match ((test_empty stream1), (test_empty stream2)) with true, true -> None | true, false | false, true (* Don't know how this case could be... *) | false, false -> clean_fd (); Some (Stream.count stream1) end | e -> clean_fd (); raise e end else Some (-1) ocaml-fileutils-0.5.3/src/FileUtilCP.ml000066400000000000000000000241151320170427200176720ustar00rootroot00000000000000(******************************************************************************) (* ocaml-fileutils: files and filenames common operations *) (* *) (* Copyright (C) 2003-2014, Sylvain Le Gall *) (* *) (* This library is free software; you can redistribute it and/or modify it *) (* under the terms of the GNU Lesser General Public License as published by *) (* the Free Software Foundation; either version 2.1 of the License, or (at *) (* your option) any later version, with the OCaml static compilation *) (* exception. *) (* *) (* This library is distributed in the hope that it will be useful, but *) (* WITHOUT ANY WARRANTY; without even the implied warranty of *) (* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the file *) (* COPYING for more details. *) (* *) (* You should have received a copy of the GNU Lesser General Public License *) (* along with this library; if not, write to the Free Software Foundation, *) (* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA *) (******************************************************************************) open FileUtilTypes open FilePath open FileUtilMisc open FileUtilPermission open FileUtilTOUCH open FileUtilRM open FileUtilSTAT open FileUtilUMASK open FileUtilMKDIR open FileUtilCHMOD open FileUtilTEST exception CpError of string exception CpSkip type cp_error = [ `CannotChmodDstDir of filename * exn | `CannotCopyDir of filename | `CannotCopyFilesToFile of filename list * filename | `CannotCreateDir of filename * exn | `CannotListSrcDir of filename * exn | `CannotOpenDstFile of filename * exn | `CannotOpenSrcFile of filename * exn | `CannotRemoveDstFile of filename * exn | `DstDirNotDir of filename | `ErrorRead of filename * exn | `ErrorWrite of filename * exn | `Exc of exn | `NoSourceFile of filename | `PartialWrite of filename * int * int | `SameFile of filename * filename | `UnhandledType of filename * kind ] let same_file st1 st2 = st1.device = st2.device && st1.inode = st2.inode let cp ?(follow=Skip) ?(force=Force) ?(recurse=false) ?(preserve=false) ?(error=(fun str _ -> raise (CpError str))) fln_src_lst fln_dst = let herror, _ = let spf fmt = Printf.sprintf fmt in let exs () e = match e with | Unix.Unix_error(err, _, _) -> Unix.error_message err | e -> Printexc.to_string e in handle_error_gen "cp" error (function | `CannotRemoveDstFile(fn_dst, e) -> spf "Cannot remove destination file '%s': %a." fn_dst exs e | `CannotOpenDstFile(fn_dst, e) -> spf "Cannot open destination file '%s': %a." fn_dst exs e | `CannotOpenSrcFile(fn_src, e) -> spf "Cannot open source file '%s': %a." fn_src exs e | `ErrorRead(fn_src, e) -> spf "Error reading file '%s': %a." fn_src exs e | `ErrorWrite(fn_dst, e) -> spf "Error writing file '%s': %a." fn_dst exs e | `PartialWrite(fn_dst, read, written) -> spf "Partial write to file '%s': %d read, %d written." fn_dst read written | `CannotCopyDir fn_src -> spf "Cannot copy directory '%s' recursively." fn_src | `DstDirNotDir fn_dst -> spf "Destination '%s' is not a directory." fn_dst | `CannotCreateDir(fn_dst, e) -> spf "Cannot create directory '%s': %a." fn_dst exs e | `CannotListSrcDir(fn_src, e) -> spf "Cannot list directory '%s': %a." fn_src exs e | `CannotChmodDstDir(fn_dst, e) -> spf "'Cannot chmod directory %s': %a." fn_dst exs e | `NoSourceFile fn_src -> spf "Source file '%s' doesn't exist." fn_src | `SameFile(fn_src, fn_dst) -> spf "'%s' and '%s' are the same file." fn_src fn_dst | `UnhandledType(fn_src, _) -> spf "Cannot handle the type of kind for file '%s'." fn_src | `CannotCopyFilesToFile(fn_src_lst, fn_dst) -> spf "Cannot copy a list of files to another file '%s'." fn_dst | #exc -> "") in let handle_error e = herror ~fatal:false e; raise CpSkip in let handle_exception f a h = try f a with e -> herror ~fatal:false (h e); raise CpSkip in let copy_time_props st_src fln_dst = if preserve then begin touch ~time:(Touch_timestamp st_src.modification_time) ~mtime:true ~create:false fln_dst; touch ~time:(Touch_timestamp st_src.access_time) ~atime:true ~create:false fln_dst; end in let buffer = Bytes.make 1024 ' ' in let cp_file st_src dst_exists fn_src fn_dst = let mode = int_of_permission st_src.permission in (* POSIX conditions: *) (* 3a *) let fd_dst = (* 3ai *) if dst_exists && doit force fn_dst then begin try (* 3aii *) Unix.openfile fn_dst [Unix.O_WRONLY; Unix.O_TRUNC] mode with _ -> (* 3aii *) handle_exception (fun lst -> rm lst) [fn_dst] (fun e -> `CannotRemoveDstFile(fn_dst, e)); handle_exception (Unix.openfile fn_dst [Unix.O_WRONLY; Unix.O_CREAT]) mode (fun e -> `CannotOpenDstFile(fn_dst, e)) end else if not dst_exists then begin handle_exception (Unix.openfile fn_dst [Unix.O_WRONLY; Unix.O_CREAT]) mode (fun e -> `CannotOpenDstFile(fn_dst, e)) end else begin raise CpSkip end in let read = ref 0 in try let fd_src = handle_exception (Unix.openfile fn_src [Unix.O_RDONLY]) 0o600 (fun e -> `CannotOpenSrcFile(fn_src, e)) in try while (read := handle_exception (Unix.read fd_src buffer 0) (Bytes.length buffer) (fun e -> `ErrorRead(fn_src, e)); !read <> 0) do let written = handle_exception (Unix.write fd_dst buffer 0) !read (fun e -> `ErrorWrite(fn_dst, e)) in if written != !read then handle_error (`PartialWrite(fn_src, !read, written)) done; Unix.close fd_src; Unix.close fd_dst; copy_time_props st_src fn_dst with e -> Unix.close fd_src; raise e with e -> Unix.close fd_dst; raise e in let cp_symlink fn_src fn_dst = (* No Unix.lutimes to set time of the symlink. *) Unix.symlink (Unix.readlink fn_src) fn_dst in let rec cp_dir st_src dst_exists fn_src fn_dst = (* 2a *) if not recurse then begin handle_error (`CannotCopyDir fn_src) (* 2d, 2c *) end else if dst_exists && (stat fn_dst).kind <> Dir then begin handle_error (`DstDirNotDir fn_dst) end else begin (* 2e *) let dst_created = if not dst_exists then begin let mode = let src_mode = int_of_permission st_src.permission in let dst_mode = if preserve then src_mode else umask_apply src_mode in `Octal (dst_mode lor 0o0700) in handle_exception (fun fn -> mkdir ~mode fn) fn_dst (fun e -> `CannotCreateDir(fn_dst, e)); true end else begin false end in (* 2f *) Array.iter (fun bn -> if not (is_current bn || is_parent bn) then cp_one (concat fn_src bn) (concat fn_dst bn)) (handle_exception Sys.readdir fn_src (fun e -> `CannotListSrcDir(fn_src, e))); (* 2g *) if dst_created then begin let mode = let src_mode = int_of_permission st_src.permission in `Octal (if preserve then src_mode else umask_apply src_mode) in handle_exception (chmod mode) [fn_dst] (fun e -> `CannotChmodDstDir(fn_dst, e)); copy_time_props st_src fn_dst end end and cp_one fn_src fn_dst = let st_src, st_src_deref = (* Check existence of source files. *) if test_exists fn_src then begin let st = stat fn_src in if st.kind = Symlink && not recurse then begin st, stat ~dereference:true fn_src end else begin st, st end end else begin handle_error (`NoSourceFile fn_src) end in let same_file, dst_exists = (* Test if fn_dst exists and if it is the same file as fn_src. *) try same_file st_src (stat fn_dst), true with FileDoesntExist _ -> false, false in if same_file then begin handle_error (`SameFile(fn_src, fn_dst)) end; try match st_src.kind with | Dir -> cp_dir st_src dst_exists fn_src fn_dst | File -> cp_file st_src dst_exists fn_src fn_dst | Symlink -> if st_src_deref.kind = Dir || recurse then cp_symlink fn_src fn_dst else cp_file st_src_deref dst_exists fn_src fn_dst | Fifo | Dev_char | Dev_block | Socket -> handle_error (`UnhandledType(fn_src, st_src.kind)) with CpSkip -> () in if test Is_dir fln_dst then List.iter (fun fn_src -> cp_one fn_src (concat fln_dst (basename fn_src))) fln_src_lst else if List.length fln_src_lst <= 1 then List.iter (fun fn_src -> cp_one fn_src fln_dst) fln_src_lst else handle_error (`CannotCopyFilesToFile(fln_src_lst, fln_dst)) ocaml-fileutils-0.5.3/src/FileUtilDU.ml000066400000000000000000000036021320170427200176760ustar00rootroot00000000000000(******************************************************************************) (* ocaml-fileutils: files and filenames common operations *) (* *) (* Copyright (C) 2003-2014, Sylvain Le Gall *) (* *) (* This library is free software; you can redistribute it and/or modify it *) (* under the terms of the GNU Lesser General Public License as published by *) (* the Free Software Foundation; either version 2.1 of the License, or (at *) (* your option) any later version, with the OCaml static compilation *) (* exception. *) (* *) (* This library is distributed in the hope that it will be useful, but *) (* WITHOUT ANY WARRANTY; without even the implied warranty of *) (* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the file *) (* COPYING for more details. *) (* *) (* You should have received a copy of the GNU Lesser General Public License *) (* along with this library; if not, write to the Free Software Foundation, *) (* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA *) (******************************************************************************) open FileUtilTypes open FileUtilSize open FileUtilSTAT open FileUtilFIND let du fln_lst = let du_aux (sz, lst) fln = let st = stat fln in (size_add sz st.size, (fln, st.size) :: lst) in List.fold_left (fun accu fln -> find True fln du_aux accu) (B 0L, []) fln_lst ocaml-fileutils-0.5.3/src/FileUtilFIND.ml000066400000000000000000000077211320170427200201140ustar00rootroot00000000000000(******************************************************************************) (* ocaml-fileutils: files and filenames common operations *) (* *) (* Copyright (C) 2003-2014, Sylvain Le Gall *) (* *) (* This library is free software; you can redistribute it and/or modify it *) (* under the terms of the GNU Lesser General Public License as published by *) (* the Free Software Foundation; either version 2.1 of the License, or (at *) (* your option) any later version, with the OCaml static compilation *) (* exception. *) (* *) (* This library is distributed in the hope that it will be useful, but *) (* WITHOUT ANY WARRANTY; without even the implied warranty of *) (* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the file *) (* COPYING for more details. *) (* *) (* You should have received a copy of the GNU Lesser General Public License *) (* along with this library; if not, write to the Free Software Foundation, *) (* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA *) (******************************************************************************) open FileUtilTypes open FilePath open FileUtilMisc open FileUtilTEST open FileUtilSTAT open FileUtilREADLINK let find ?(follow=Skip) ?match_compile tst fln exec user_acc = let user_test = compile_filter ?match_compile tst in let skip_action = match follow with | Skip | AskFollow _ | Follow -> ignore | SkipInform f -> f in let should_skip fln already_followed = match follow with | Skip | SkipInform _ -> true | AskFollow f -> if not already_followed then f fln else true | Follow -> if already_followed then raise (RecursiveLink fln) else false in let already_read = ref SetFilename.empty in let rec find_aux acc fln = let st_opt = try Some (stat fln) with FileDoesntExist _ -> None in let stL_opt = match st_opt with | Some st when st.is_link -> begin try Some (stat ~dereference:true fln) with FileDoesntExist _ -> None end | _ -> st_opt in let acc = if user_test ?st_opt ?stL_opt fln then exec acc fln else acc in match st_opt with | Some st -> if st.kind = Symlink then begin follow_symlink stL_opt acc fln end else if st.kind = Dir then begin enter_dir acc fln end else begin acc end | None -> acc and enter_dir acc drn = Array.fold_left (fun acc rfln -> if is_parent rfln || is_current rfln then acc else find_aux acc (concat drn rfln)) acc (Sys.readdir drn) and follow_symlink stL_opt acc fln = match stL_opt with | Some stL when stL.kind = Dir -> let cur_link = readlink fln in let already_followed = try already_read := prevent_recursion !already_read cur_link; false with RecursiveLink _ -> true in if should_skip fln already_followed then begin skip_action fln; acc end else begin enter_dir acc fln end | _ -> acc in find_aux user_acc (reduce fln) ocaml-fileutils-0.5.3/src/FileUtilLS.ml000066400000000000000000000034461320170427200177120ustar00rootroot00000000000000(******************************************************************************) (* ocaml-fileutils: files and filenames common operations *) (* *) (* Copyright (C) 2003-2014, Sylvain Le Gall *) (* *) (* This library is free software; you can redistribute it and/or modify it *) (* under the terms of the GNU Lesser General Public License as published by *) (* the Free Software Foundation; either version 2.1 of the License, or (at *) (* your option) any later version, with the OCaml static compilation *) (* exception. *) (* *) (* This library is distributed in the hope that it will be useful, but *) (* WITHOUT ANY WARRANTY; without even the implied warranty of *) (* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the file *) (* COPYING for more details. *) (* *) (* You should have received a copy of the GNU Lesser General Public License *) (* along with this library; if not, write to the Free Software Foundation, *) (* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA *) (******************************************************************************) open FileUtilMisc let ls dirname = let array_dir = Sys.readdir (solve_dirname dirname) in let list_dir = Array.to_list array_dir in List.map (fun x -> FilePath.concat dirname x) list_dir ocaml-fileutils-0.5.3/src/FileUtilMKDIR.ml000066400000000000000000000071741320170427200202440ustar00rootroot00000000000000(******************************************************************************) (* ocaml-fileutils: files and filenames common operations *) (* *) (* Copyright (C) 2003-2014, Sylvain Le Gall *) (* *) (* This library is free software; you can redistribute it and/or modify it *) (* under the terms of the GNU Lesser General Public License as published by *) (* the Free Software Foundation; either version 2.1 of the License, or (at *) (* your option) any later version, with the OCaml static compilation *) (* exception. *) (* *) (* This library is distributed in the hope that it will be useful, but *) (* WITHOUT ANY WARRANTY; without even the implied warranty of *) (* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the file *) (* COPYING for more details. *) (* *) (* You should have received a copy of the GNU Lesser General Public License *) (* along with this library; if not, write to the Free Software Foundation, *) (* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA *) (******************************************************************************) open FileUtilTypes open FilePath open FileUtilMisc open FileUtilTEST open FileUtilUMASK open FileUtilCHMOD exception MkdirError of string type mkdir_error = [ `DirnameAlreadyUsed of filename | `Exc of exn | `MissingComponentPath of filename | `MkdirChmod of filename * Unix.file_perm * string * exc ] let mkdir ?(error=(fun str _ -> raise (MkdirError str))) ?(parent=false) ?mode dn = let handle_error, handle_exception = handle_error_gen "mkdir" error (function | `DirnameAlreadyUsed fn -> Printf.sprintf "Directory %s already exists and is a file." fn | `MissingComponentPath fn -> Printf.sprintf "Unable to create directory %s, an upper directory is missing." fn | `MkdirChmod (dn, mode, str, e) -> Printf.sprintf "Recursive error in 'mkdir %s' in 'chmod %04o %s': %s" dn mode dn str | #exc -> "") in let mode_apply = FileUtilMode.apply ~is_dir:true ~umask:(umask (`Octal (fun i -> i))) in let mode_self = match mode with | Some (`Octal m) -> m | Some (`Symbolic t) -> mode_apply 0o777 t | None -> umask_apply 0o0777 in let mode_parent = umask (`Symbolic (fun t -> mode_apply 0 (t @ [`User (`Add (`List [`Write; `Exec]))]))) in let rec mkdir_simple mode dn = if test_exists dn then begin if test (Not Is_dir) dn then handle_error ~fatal:true (`DirnameAlreadyUsed dn); end else begin if parent then mkdir_simple mode_parent (dirname dn); try Unix.mkdir dn mode; chmod ~error:(fun str e -> handle_error ~fatal:true (`MkdirChmod (dn, mode, str, e))) (`Octal mode) [dn] with Unix.Unix_error(Unix.ENOENT, _, _) | Unix.Unix_error(Unix.ENOTDIR, _, _) -> handle_error ~fatal:true (`MissingComponentPath dn) | e -> handle_exception ~fatal:true e end in mkdir_simple mode_self dn ocaml-fileutils-0.5.3/src/FileUtilMV.ml000066400000000000000000000067711320170427200177220ustar00rootroot00000000000000(******************************************************************************) (* ocaml-fileutils: files and filenames common operations *) (* *) (* Copyright (C) 2003-2014, Sylvain Le Gall *) (* *) (* This library is free software; you can redistribute it and/or modify it *) (* under the terms of the GNU Lesser General Public License as published by *) (* the Free Software Foundation; either version 2.1 of the License, or (at *) (* your option) any later version, with the OCaml static compilation *) (* exception. *) (* *) (* This library is distributed in the hope that it will be useful, but *) (* WITHOUT ANY WARRANTY; without even the implied warranty of *) (* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the file *) (* COPYING for more details. *) (* *) (* You should have received a copy of the GNU Lesser General Public License *) (* along with this library; if not, write to the Free Software Foundation, *) (* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA *) (******************************************************************************) open FileUtilTypes open FilePath open FileUtilMisc open FileUtilPWD open FileUtilRM open FileUtilCP open FileUtilTEST exception MvError of string type mv_error = [ `Exc of exn | `MvCp of filename * filename * string * cp_error | `MvRm of filename * string * rm_error | `NoSourceFile ] let rec mv ?(error=fun str _ -> raise (MvError str)) ?(force=Force) fln_src fln_dst = let handle_error, _ = handle_error_gen "mv" error (function | `NoSourceFile -> "Cannot move an empty list of files." | `MvCp (fn_src, fn_dst, str, _) -> Printf.sprintf "Recursive error in 'mv %s %s' for 'cp %s %s': %s" fn_src fn_dst fn_src fn_dst str | `MvRm (fn, str, _) -> Printf.sprintf "Recursive error in 'mv %s ..' for 'rm %s': %s" fn fn str | #exc -> "") in let fln_src_abs = make_absolute (pwd ()) fln_src in let fln_dst_abs = make_absolute (pwd ()) fln_dst in if compare fln_src_abs fln_dst_abs <> 0 then begin if test_exists fln_dst_abs && doit force fln_dst then begin rm [fln_dst_abs]; mv fln_src_abs fln_dst_abs end else if test Is_dir fln_dst_abs then begin mv ~force ~error fln_src_abs (make_absolute fln_dst_abs (basename fln_src_abs)) end else if test_exists fln_src_abs then begin try Sys.rename fln_src_abs fln_dst_abs with Sys_error _ -> cp ~force ~error:(fun str e -> handle_error ~fatal:true (`MvCp (fln_src_abs, fln_dst_abs, str, e))) ~recurse:true [fln_src_abs] fln_dst_abs; rm ~force ~error:(fun str e -> handle_error ~fatal:true (`MvRm (fln_src_abs, str, e))) ~recurse:true [fln_src_abs] end else handle_error ~fatal:true `NoSourceFile end ocaml-fileutils-0.5.3/src/FileUtilMisc.ml000066400000000000000000000054361320170427200202700ustar00rootroot00000000000000(******************************************************************************) (* ocaml-fileutils: files and filenames common operations *) (* *) (* Copyright (C) 2003-2014, Sylvain Le Gall *) (* *) (* This library is free software; you can redistribute it and/or modify it *) (* under the terms of the GNU Lesser General Public License as published by *) (* the Free Software Foundation; either version 2.1 of the License, or (at *) (* your option) any later version, with the OCaml static compilation *) (* exception. *) (* *) (* This library is distributed in the hope that it will be useful, but *) (* WITHOUT ANY WARRANTY; without even the implied warranty of *) (* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the file *) (* COPYING for more details. *) (* *) (* You should have received a copy of the GNU Lesser General Public License *) (* along with this library; if not, write to the Free Software Foundation, *) (* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA *) (******************************************************************************) open FileUtilTypes open FilePath module SetFilename = Set.Make (struct type t = filename let compare = FilePath.compare end) let doit force fln = match force with Force -> true | Ask ask -> ask fln let prevent_recursion fln_set fln = (* TODO: use a set of dev/inode *) if SetFilename.mem fln fln_set then raise (RecursiveLink fln) else SetFilename.add fln fln_set let solve_dirname dirname = (* We have an ambiguity concerning "" and "." *) if is_current dirname then current_dir else reduce dirname type exc = [ `Exc of exn ] let handle_error_gen nm error custom = let handle_error ~fatal e = let str = match e with | `Exc (Unix.Unix_error(err, nm, arg)) -> Printf.sprintf "%s: %s (%s, %S)" nm (Unix.error_message err) nm arg | `Exc exc -> Printf.sprintf "%s: %s" nm (Printexc.to_string exc) | e -> custom e in if fatal then begin try error str e; raise (Fatal str) with exc -> raise exc end else begin error str e end in let handle_exception ~fatal exc = handle_error ~fatal (`Exc exc) in handle_error, handle_exception ocaml-fileutils-0.5.3/src/FileUtilMode.ml000066400000000000000000000157641320170427200202660ustar00rootroot00000000000000(******************************************************************************) (* ocaml-fileutils: files and filenames common operations *) (* *) (* Copyright (C) 2003-2014, Sylvain Le Gall *) (* *) (* This library is free software; you can redistribute it and/or modify it *) (* under the terms of the GNU Lesser General Public License as published by *) (* the Free Software Foundation; either version 2.1 of the License, or (at *) (* your option) any later version, with the OCaml static compilation *) (* exception. *) (* *) (* This library is distributed in the hope that it will be useful, but *) (* WITHOUT ANY WARRANTY; without even the implied warranty of *) (* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the file *) (* COPYING for more details. *) (* *) (* You should have received a copy of the GNU Lesser General Public License *) (* along with this library; if not, write to the Free Software Foundation, *) (* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA *) (******************************************************************************) type who = [`User | `Group | `Other | `All] type wholist = [ who | `List of who list ] type permcopy = [`User | `Group | `Other] type perm = [ `Read | `Write | `Exec | `ExecX | `Sticky | `StickyO ] type permlist = [ perm | `List of perm list ] type actionarg = [ permlist | permcopy ] type action = [ `Set of actionarg | `Add of actionarg | `Remove of actionarg] type actionlist = [ action | `List of action list ] type clause = [ `User of actionlist | `Group of actionlist | `Other of actionlist | `All of actionlist | `None of actionlist ] type t = clause list let all_masks = [ `User, `Sticky, 0o4000; `User, `Exec, 0o0100; `User, `Write, 0o0200; `User, `Read, 0o0400; `Group, `Sticky, 0o2000; `Group, `Exec, 0o0010; `Group, `Write, 0o0020; `Group, `Read, 0o0040; `Other, `StickyO, 0o1000; `Other, `Exec, 0o0001; `Other, `Write, 0o0002; `Other, `Read, 0o0004; ] let mask = let module M = Map.Make (struct type t = who * perm let compare = Pervasives.compare end) in let m = List.fold_left (fun m (who, prm, msk) -> M.add (who, prm) msk m) M.empty all_masks in fun who prm -> try M.find (who, prm) m with Not_found -> 0 let of_int i = let user, group, other = List.fold_left (fun (user, group, other) (who, perm, mask) -> if (i land mask) <> 0 then begin match who with | `User -> perm :: user, group, other | `Group -> user, perm :: group, other | `Other -> user, group, perm :: other end else begin (user, group, other) end) ([], [], []) all_masks in [`User (`Set (`List user)); `Group (`Set (`List group)); `Other (`Set (`List other))] let to_string = let perm = function | `Read -> "r" | `Write -> "w" | `Exec -> "x" | `Sticky -> "s" | `ExecX -> "X" | `StickyO -> "t" in let permlist = function | `List lst -> String.concat "" (List.map perm lst) | #perm as prm -> perm prm in let permcopy = function | `User -> "u" | `Group -> "g" | `Other -> "o" in let action act = let sact, arg = match act with | `Set arg -> "=", arg | `Add arg -> "+", arg | `Remove arg -> "-", arg in let sarg = match arg with | #permlist as lst -> permlist lst | #permcopy as prm -> permcopy prm in sact^sarg in let actionlist = function | `List lst -> String.concat "" (List.map action lst) | #action as act -> action act in let clause cls = let swho, lst = match cls with | `User lst -> "u", lst | `Group lst -> "g", lst | `Other lst -> "o", lst | `All lst -> "a", lst | `None lst -> "", lst in swho^(actionlist lst) in fun t -> String.concat "," (List.map clause t) let apply ~is_dir ~umask i (t: t) = let set who prm b i = let m = mask who prm in if b then i lor m else i land (lnot m) in let get who prm i = let m = mask who prm in (i land m) <> 0 in let permlist _who i lst = List.fold_left (fun acc -> function | `Exec | `Read | `Write | `Sticky | `StickyO as a -> a :: acc | `ExecX -> if is_dir || List.exists (fun who -> get who `Exec i) [`User; `Group; `Other] then `Exec :: acc else acc) [] (match lst with | `List lst -> lst | #perm as prm -> [prm]) in let permcopy _who i = List.fold_left (fun acc (who, prm, _) -> if get who prm i then prm :: acc else acc) [] all_masks in let args who i = function | #permlist as lst -> permlist who i lst | #permcopy as who -> permcopy who i in let rec action who i act = match act with | `Set arg -> action who (action who i (`Remove (`List (permcopy who i)))) (`Add arg) | `Add arg -> List.fold_left (fun i prm -> set who prm true i) i (args who i arg) | `Remove arg -> List.fold_left (fun i prm -> set who prm false i) i (args who i arg) in let actionlist who i lst = match lst with | `List lst -> List.fold_left (action who) i lst | #action as act -> action who i act in let actionlist_none i lst = let numask = lnot umask in let arg_set_if_mask who i arg b = List.fold_left (fun i prm -> if get who prm numask then set who prm b i else i) i (args who i arg) in List.fold_left (fun i who -> List.fold_left (fun i -> function | `Set _ -> i | `Add arg -> arg_set_if_mask who i arg true | `Remove arg -> arg_set_if_mask who i arg false) i (match lst with | `List lst -> lst | #action as act -> [act])) i [`User; `Group; `Other] in let rec clause i cls = match cls with | `User lst -> actionlist `User i lst | `Group lst -> actionlist `Group i lst | `Other lst -> actionlist `Other i lst | `All lst -> List.fold_left clause i [`User lst; `Group lst; `Other lst] | `None lst -> actionlist_none i lst in List.fold_left clause i t ocaml-fileutils-0.5.3/src/FileUtilPWD.ml000066400000000000000000000032021320170427200200140ustar00rootroot00000000000000(******************************************************************************) (* ocaml-fileutils: files and filenames common operations *) (* *) (* Copyright (C) 2003-2014, Sylvain Le Gall *) (* *) (* This library is free software; you can redistribute it and/or modify it *) (* under the terms of the GNU Lesser General Public License as published by *) (* the Free Software Foundation; either version 2.1 of the License, or (at *) (* your option) any later version, with the OCaml static compilation *) (* exception. *) (* *) (* This library is distributed in the hope that it will be useful, but *) (* WITHOUT ANY WARRANTY; without even the implied warranty of *) (* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the file *) (* COPYING for more details. *) (* *) (* You should have received a copy of the GNU Lesser General Public License *) (* along with this library; if not, write to the Free Software Foundation, *) (* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA *) (******************************************************************************) let pwd () = FilePath.reduce (Sys.getcwd ()) ocaml-fileutils-0.5.3/src/FileUtilPermission.ml000066400000000000000000000054001320170427200215140ustar00rootroot00000000000000(******************************************************************************) (* ocaml-fileutils: files and filenames common operations *) (* *) (* Copyright (C) 2003-2014, Sylvain Le Gall *) (* *) (* This library is free software; you can redistribute it and/or modify it *) (* under the terms of the GNU Lesser General Public License as published by *) (* the Free Software Foundation; either version 2.1 of the License, or (at *) (* your option) any later version, with the OCaml static compilation *) (* exception. *) (* *) (* This library is distributed in the hope that it will be useful, but *) (* WITHOUT ANY WARRANTY; without even the implied warranty of *) (* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the file *) (* COPYING for more details. *) (* *) (* You should have received a copy of the GNU Lesser General Public License *) (* along with this library; if not, write to the Free Software Foundation, *) (* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA *) (******************************************************************************) open FileUtilTypes let permission_of_int pr = let perm_match oct = (pr land oct) <> 0 in { user = { sticky = perm_match 0o4000; exec = perm_match 0o0100; write = perm_match 0o0200; read = perm_match 0o0400; }; group = { sticky = perm_match 0o2000; exec = perm_match 0o0010; write = perm_match 0o0020; read = perm_match 0o0040; }; other = { sticky = perm_match 0o1000; exec = perm_match 0o0001; write = perm_match 0o0002; read = perm_match 0o0004; }; } let int_of_permission pr = let permission_int = [ (pr.user.sticky, 0o4000); (pr.user.exec, 0o0100); (pr.user.write, 0o0200); (pr.user.read, 0o0400); (pr.group.sticky, 0o2000); (pr.group.exec, 0o0010); (pr.group.write, 0o0020); (pr.group.read, 0o0040); (pr.other.sticky, 0o1000); (pr.other.exec, 0o0001); (pr.other.write, 0o0002); (pr.other.read, 0o0004) ] in List.fold_left (fun full_perm (b, perm) -> if b then perm lor full_perm else full_perm) 0o0000 permission_int ocaml-fileutils-0.5.3/src/FileUtilREADLINK.ml000066400000000000000000000052021320170427200205550ustar00rootroot00000000000000(******************************************************************************) (* ocaml-fileutils: files and filenames common operations *) (* *) (* Copyright (C) 2003-2014, Sylvain Le Gall *) (* *) (* This library is free software; you can redistribute it and/or modify it *) (* under the terms of the GNU Lesser General Public License as published by *) (* the Free Software Foundation; either version 2.1 of the License, or (at *) (* your option) any later version, with the OCaml static compilation *) (* exception. *) (* *) (* This library is distributed in the hope that it will be useful, but *) (* WITHOUT ANY WARRANTY; without even the implied warranty of *) (* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the file *) (* COPYING for more details. *) (* *) (* You should have received a copy of the GNU Lesser General Public License *) (* along with this library; if not, write to the Free Software Foundation, *) (* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA *) (******************************************************************************) open FileUtilTypes open FilePath open FileUtilMisc open FileUtilPWD open FileUtilTEST let readlink fln = let all_upper_dir fln = let rec all_upper_dir_aux lst fln = let dir = dirname fln in match lst with | prev_dir :: _ when prev_dir = dir -> lst | _ -> all_upper_dir_aux (dir :: lst) dir in all_upper_dir_aux [fln] fln in let ctst = let st_opt, stL_opt = None, None in compile_filter ?st_opt ?stL_opt Is_link in let rec readlink_aux already_read fln = let newly_read = prevent_recursion already_read fln in let dirs = all_upper_dir fln in try let src_link = List.find ctst (List.rev dirs) in let dst_link = Unix.readlink src_link in let real_link = if is_relative dst_link then reduce (concat (dirname src_link) dst_link) else reduce dst_link in readlink_aux newly_read (reparent src_link real_link fln) with Not_found -> fln in readlink_aux SetFilename.empty (make_absolute (pwd ()) fln) ocaml-fileutils-0.5.3/src/FileUtilRM.ml000066400000000000000000000061421320170427200177060ustar00rootroot00000000000000(******************************************************************************) (* ocaml-fileutils: files and filenames common operations *) (* *) (* Copyright (C) 2003-2014, Sylvain Le Gall *) (* *) (* This library is free software; you can redistribute it and/or modify it *) (* under the terms of the GNU Lesser General Public License as published by *) (* the Free Software Foundation; either version 2.1 of the License, or (at *) (* your option) any later version, with the OCaml static compilation *) (* exception. *) (* *) (* This library is distributed in the hope that it will be useful, but *) (* WITHOUT ANY WARRANTY; without even the implied warranty of *) (* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the file *) (* COPYING for more details. *) (* *) (* You should have received a copy of the GNU Lesser General Public License *) (* along with this library; if not, write to the Free Software Foundation, *) (* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA *) (******************************************************************************) open FileUtilTypes open FilePath open FileUtilMisc open FileUtilTEST open FileUtilLS exception RmError of string type rm_error = [ `DirNotEmpty of filename | `Exc of exn | `NoRecurse of filename ] let rm ?(error=fun str _ -> raise (RmError str)) ?(force=Force) ?(recurse=false) fln_lst = let handle_error, handle_exception = handle_error_gen "rm" error (function | `DirNotEmpty fn -> Printf.sprintf "Directory %s not empty." fn | `NoRecurse fn -> Printf.sprintf "Cannot delete directory %s when recurse is not set." fn | #exc -> "") in let test_dir = test (And(Is_dir, Not(Is_link))) in let rmdir fn = try Unix.rmdir fn with | Unix.Unix_error(Unix.ENOTEMPTY, _, _) -> handle_error ~fatal:true (`DirNotEmpty fn) | e -> handle_exception ~fatal:true e in let rec rm_aux lst = List.iter (fun fn -> let exists = try let _st: Unix.LargeFile.stats = Unix.LargeFile.lstat fn in true with Unix.Unix_error(Unix.ENOENT, _, _) -> false in if exists && (doit force fn) then begin if test_dir fn then begin if recurse then begin rm_aux (ls fn); rmdir fn end else handle_error ~fatal:true (`NoRecurse fn) end else Unix.unlink fn end) lst in rm_aux fln_lst ocaml-fileutils-0.5.3/src/FileUtilSTAT.ml000066400000000000000000000055171320170427200201500ustar00rootroot00000000000000(******************************************************************************) (* ocaml-fileutils: files and filenames common operations *) (* *) (* Copyright (C) 2003-2014, Sylvain Le Gall *) (* *) (* This library is free software; you can redistribute it and/or modify it *) (* under the terms of the GNU Lesser General Public License as published by *) (* the Free Software Foundation; either version 2.1 of the License, or (at *) (* your option) any later version, with the OCaml static compilation *) (* exception. *) (* *) (* This library is distributed in the hope that it will be useful, but *) (* WITHOUT ANY WARRANTY; without even the implied warranty of *) (* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the file *) (* COPYING for more details. *) (* *) (* You should have received a copy of the GNU Lesser General Public License *) (* along with this library; if not, write to the Free Software Foundation, *) (* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA *) (******************************************************************************) open FileUtilTypes open FileUtilPermission let stat ?(dereference=false) fln = let kind_of_stat ustat = match ustat.Unix.LargeFile.st_kind with | Unix.S_REG -> File | Unix.S_DIR -> Dir | Unix.S_CHR -> Dev_char | Unix.S_BLK -> Dev_block | Unix.S_FIFO -> Fifo | Unix.S_SOCK -> Socket | Unix.S_LNK -> Symlink in try let ustat = Unix.LargeFile.lstat fln in let is_link = (kind_of_stat ustat = Symlink) in let ustat = if is_link && dereference then Unix.LargeFile.stat fln else ustat in { kind = kind_of_stat ustat; is_link = is_link; permission = permission_of_int ustat.Unix.LargeFile.st_perm; size = B ustat.Unix.LargeFile.st_size; owner = ustat.Unix.LargeFile.st_uid; group_owner = ustat.Unix.LargeFile.st_gid; access_time = ustat.Unix.LargeFile.st_atime; modification_time = ustat.Unix.LargeFile.st_mtime; creation_time = ustat.Unix.LargeFile.st_ctime; device = ustat.Unix.LargeFile.st_dev; inode = ustat.Unix.LargeFile.st_ino; } with Unix.Unix_error(Unix.ENOENT, _, _) -> raise (FileDoesntExist fln) ocaml-fileutils-0.5.3/src/FileUtilSize.ml000066400000000000000000000107021320170427200202770ustar00rootroot00000000000000(******************************************************************************) (* ocaml-fileutils: files and filenames common operations *) (* *) (* Copyright (C) 2003-2014, Sylvain Le Gall *) (* *) (* This library is free software; you can redistribute it and/or modify it *) (* under the terms of the GNU Lesser General Public License as published by *) (* the Free Software Foundation; either version 2.1 of the License, or (at *) (* your option) any later version, with the OCaml static compilation *) (* exception. *) (* *) (* This library is distributed in the hope that it will be useful, but *) (* WITHOUT ANY WARRANTY; without even the implied warranty of *) (* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the file *) (* COPYING for more details. *) (* *) (* You should have received a copy of the GNU Lesser General Public License *) (* along with this library; if not, write to the Free Software Foundation, *) (* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA *) (******************************************************************************) open FileUtilTypes let byte_of_size sz = let rec mul_1024 n i = if n > 0 then mul_1024 (n - 1) (Int64.mul 1024L i) else i in match sz with | B i -> i | KB i -> mul_1024 1 i | MB i -> mul_1024 2 i | GB i -> mul_1024 3 i | TB i -> mul_1024 4 i let size_add sz1 sz2 = B (Int64.add (byte_of_size sz1) (byte_of_size sz2)) let size_compare ?(fuzzy=false) sz1 sz2 = let by1 = byte_of_size sz1 in let by2 = byte_of_size sz2 in if fuzzy then begin let rec fuzzy_comp n1 n2 = if n1 = n2 then 0 else begin let up_unit_n1 = Int64.div n1 1024L in let up_unit_n2 = Int64.div n2 1024L in if up_unit_n1 <> 0L && up_unit_n2 <> 0L then fuzzy_comp up_unit_n1 up_unit_n2 else Int64.compare n1 n2 end in fuzzy_comp by1 by2 end else Int64.compare by1 by2 let string_of_size ?(fuzzy=false) sz = let szstr i unt (cur_i, cur_unt, tl) = let tl = (cur_i, cur_unt) :: tl in i, unt, tl in let rec decomp_continue fup i unt acc = if i = 0L then szstr i unt acc else begin (** Continue with upper unit *) let r = Int64.rem i 1024L in let q = Int64.div i 1024L in decomp_start (szstr r unt acc) (fup q) end and decomp_start acc sz = (* Decompose size for current unit and try * to use upper unit *) match sz with | TB i -> szstr i "TB" acc | GB i -> decomp_continue (fun n -> TB n) i "GB" acc | MB i -> decomp_continue (fun n -> GB n) i "MB" acc | KB i -> decomp_continue (fun n -> MB n) i "KB" acc | B i -> decomp_continue (fun n -> KB n) i "B" acc in (* Only accumulate significant unit in tail *) let only_significant_unit (cur_i, cur_unt, lst) = let significant_lst = List.filter (fun (i, _) -> i <> 0L) ((cur_i, cur_unt) :: lst) in match significant_lst with | [] -> cur_i, cur_unt, [] | (cur_i, cur_unt) :: tl -> (cur_i, cur_unt, tl) in let main_i, main_unt, rem_lst = only_significant_unit (decomp_start (0L, "B", []) sz) in if fuzzy then begin let _, rem = List.fold_left (fun (div, acc) (i, _unt) -> let acc = acc +. ((Int64.to_float i) /. div) in div *. 1024.0, acc) (1024.0, 0.0) rem_lst in Printf.sprintf "%.2f %s" ((Int64.to_float main_i) +. rem) main_unt end else begin String.concat " " (List.map (fun (i, unt) -> Printf.sprintf "%Ld %s" i unt) ((main_i, main_unt) :: rem_lst)) end ocaml-fileutils-0.5.3/src/FileUtilStr.ml000066400000000000000000000037531320170427200201450ustar00rootroot00000000000000(******************************************************************************) (* ocaml-fileutils: files and filenames common operations *) (* *) (* Copyright (C) 2003-2014, Sylvain Le Gall *) (* *) (* This library is free software; you can redistribute it and/or modify it *) (* under the terms of the GNU Lesser General Public License as published by *) (* the Free Software Foundation; either version 2.1 of the License, or (at *) (* your option) any later version, with the OCaml static compilation *) (* exception. *) (* *) (* This library is distributed in the hope that it will be useful, but *) (* WITHOUT ANY WARRANTY; without even the implied warranty of *) (* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the file *) (* COPYING for more details. *) (* *) (* You should have received a copy of the GNU Lesser General Public License *) (* along with this library; if not, write to the Free Software Foundation, *) (* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA *) (******************************************************************************) (** FileUtil with Str regexp match test @author Sylvain Le Gall *) (** Compile [FileUtil.Match] expression using [Str.regexp] *) let match_compile str = let regex = Str.regexp str in fun fn -> Str.string_match regex fn 0 (** See {!FileUtil.test} *) let test = FileUtil.test ~match_compile:match_compile (** See {!FileUtil.find} *) let find = FileUtil.find ~match_compile:match_compile ocaml-fileutils-0.5.3/src/FileUtilTEST.ml000066400000000000000000000211311320170427200201420ustar00rootroot00000000000000(******************************************************************************) (* ocaml-fileutils: files and filenames common operations *) (* *) (* Copyright (C) 2003-2014, Sylvain Le Gall *) (* *) (* This library is free software; you can redistribute it and/or modify it *) (* under the terms of the GNU Lesser General Public License as published by *) (* the Free Software Foundation; either version 2.1 of the License, or (at *) (* your option) any later version, with the OCaml static compilation *) (* exception. *) (* *) (* This library is distributed in the hope that it will be useful, but *) (* WITHOUT ANY WARRANTY; without even the implied warranty of *) (* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the file *) (* COPYING for more details. *) (* *) (* You should have received a copy of the GNU Lesser General Public License *) (* along with this library; if not, write to the Free Software Foundation, *) (* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA *) (******************************************************************************) open FileUtilTypes open FilePath open FileUtilMisc open FileUtilSize open FileUtilSTAT let compile_filter ?(match_compile=(fun s fn -> s = fn)) flt = let cflt = let rec cc = function | True -> `Val true | False -> `Val false | Is_dev_block -> `Stat (`Kind Dev_block) | Is_dev_char -> `Stat (`Kind Dev_char) | Is_dir -> `Stat (`Kind Dir) | Is_file -> `Stat (`Kind File) | Is_socket -> `Stat (`Kind Socket) | Is_pipe -> `Stat (`Kind Fifo) | Is_link -> `Is_link | Is_set_group_ID -> `Stat `Is_set_group_ID | Has_sticky_bit -> `Stat `Has_sticky_bit | Has_set_user_ID -> `Stat `Has_set_user_ID | Is_readable -> `Stat `Is_readable | Is_writeable -> `Stat `Is_writeable | Is_exec -> `Stat `Is_exec | Size_not_null -> `Stat (`Size (`Bigger, B 0L)) | Size_bigger_than sz -> `Stat (`Size (`Bigger, sz)) | Size_smaller_than sz -> `Stat (`Size (`Smaller, sz)) | Size_equal_to sz -> `Stat (`Size (`Equal, sz)) | Size_fuzzy_equal_to sz -> `Stat (`Size (`FuzzyEqual, sz)) | Is_owned_by_user_ID -> `Stat (`Is_owned_by_user_ID (Unix.geteuid ())) | Is_owned_by_group_ID -> `Stat (`Is_owned_by_group_ID (Unix.getegid ())) | Exists -> `Stat `Exists | Is_newer_than fn1 -> `Stat (`Newer (stat fn1).modification_time) | Is_older_than fn1 -> `Stat (`Older (stat fn1).modification_time) | Is_newer_than_date(dt) -> `Stat (`Newer dt) | Is_older_than_date(dt) -> `Stat (`Older dt) | Has_extension ext -> `Has_extension ext | Has_no_extension -> `Has_no_extension | Is_current_dir -> `Is_current_dir | Is_parent_dir -> `Is_parent_dir | Basename_is s -> `Basename_is s | Dirname_is s -> `Dirname_is s | Custom f -> `Custom f | Match str -> `Custom (match_compile str) | And(flt1, flt2) -> begin match cc flt1, cc flt2 with | `Val true, cflt | cflt, `Val true -> cflt | `Val false, _ | _, `Val false -> `Val false | cflt1, cflt2 -> `And (cflt1, cflt2) end | Or(flt1, flt2) -> begin match cc flt1, cc flt2 with | `Val true, _ | _, `Val true -> `Val true | `Val false, cflt | cflt, `Val false -> cflt | cflt1, cflt2 -> `Or (cflt1, cflt2) end | Not flt -> begin match cc flt with | `Val b -> `Val (not b) | cflt -> `Not cflt end in cc flt in let need_statL, need_stat = let rec dfs = function | `Val _ | `Has_extension _ | `Has_no_extension | `Is_current_dir | `Is_parent_dir | `Basename_is _ | `Dirname_is _ | `Custom _ -> false, false | `Stat _ -> true, false | `Is_link -> false, true | `And (cflt1, cflt2) | `Or (cflt1, cflt2) -> let need_stat1, need_statL1 = dfs cflt1 in let need_stat2, need_statL2 = dfs cflt2 in need_stat1 || need_stat2, need_statL1 || need_statL2 | `Not cflt -> dfs cflt in dfs cflt in (* Compiled function to return. *) fun ?st_opt ?stL_opt fn -> let st_opt = if need_stat && st_opt = None then begin try match stL_opt with | Some st when not st.is_link -> stL_opt | _ -> Some (stat fn) with FileDoesntExist _ -> None end else st_opt in let stL_opt = if need_statL && stL_opt = None then begin try match st_opt with | Some st when not st.is_link -> st_opt | _ -> Some (stat ~dereference:true fn) with FileDoesntExist _ -> None end else stL_opt in let rec eval = function | `Val b -> b | `Has_extension ext -> begin try check_extension fn ext with FilePath.NoExtension _ -> false end | `Has_no_extension -> begin try let _str: filename = chop_extension fn in false with FilePath.NoExtension _ -> true end | `Is_current_dir -> is_current (basename fn) | `Is_parent_dir -> is_parent (basename fn) | `Basename_is bn -> (FilePath.compare (basename fn) bn) = 0 | `Dirname_is dn -> (FilePath.compare (dirname fn) dn) = 0 | `Custom f -> f fn | `Stat e -> begin match stL_opt, e with | Some _, `Exists -> true | Some stL, `Kind knd -> stL.kind = knd | Some stL, `Is_set_group_ID -> stL.permission.group.sticky | Some stL, `Has_sticky_bit -> stL.permission.other.sticky | Some stL, `Has_set_user_ID -> stL.permission.user.sticky | Some stL, `Size (cmp, sz) -> begin let diff = size_compare stL.size sz in match cmp with | `Bigger -> diff > 0 | `Smaller -> diff < 0 | `Equal -> diff = 0 | `FuzzyEqual -> (size_compare ~fuzzy:true stL.size sz) = 0 end | Some stL, `Is_owned_by_user_ID uid -> uid = stL.owner | Some stL, `Is_owned_by_group_ID gid -> gid = stL.group_owner | Some stL, `Is_readable -> let perm = stL.permission in perm.user.read || perm.group.read || perm.other.read | Some stL, `Is_writeable -> let perm = stL.permission in perm.user.write || perm.group.write || perm.other.write | Some stL, `Is_exec -> let perm = stL.permission in perm.user.exec || perm.group.exec || perm.other.exec | Some stL, `Newer dt -> stL.modification_time > dt | Some stL, `Older dt -> stL.modification_time < dt | None, _ -> false end | `Is_link -> begin match st_opt with | Some st -> st.is_link | None -> false end | `And (cflt1, cflt2) -> (eval cflt1) && (eval cflt2) | `Or (cflt1, cflt2) -> (eval cflt1) || (eval cflt2) | `Not cflt -> not (eval cflt) in eval cflt let test ?match_compile tst = let ctst = compile_filter ?match_compile tst in fun fln -> ctst (solve_dirname fln) let filter flt lst = List.filter (test flt) lst let test_exists = test (Or(Exists, Is_link)) ocaml-fileutils-0.5.3/src/FileUtilTOUCH.ml000066400000000000000000000051651320170427200202560ustar00rootroot00000000000000(******************************************************************************) (* ocaml-fileutils: files and filenames common operations *) (* *) (* Copyright (C) 2003-2014, Sylvain Le Gall *) (* *) (* This library is free software; you can redistribute it and/or modify it *) (* under the terms of the GNU Lesser General Public License as published by *) (* the Free Software Foundation; either version 2.1 of the License, or (at *) (* your option) any later version, with the OCaml static compilation *) (* exception. *) (* *) (* This library is distributed in the hope that it will be useful, but *) (* WITHOUT ANY WARRANTY; without even the implied warranty of *) (* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the file *) (* COPYING for more details. *) (* *) (* You should have received a copy of the GNU Lesser General Public License *) (* along with this library; if not, write to the Free Software Foundation, *) (* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA *) (******************************************************************************) open FileUtilTypes open FileUtilSTAT open FileUtilTEST let touch ?atime ?mtime ?(create=true) ?(time=Touch_now) fln = let atime, mtime = match atime, mtime with | None, None -> true, true | Some b, None -> b, false | None, Some b -> false, b | Some b1, Some b2 -> b1, b2 in let set_time () = let fatime, fmtime = match time with | Touch_now -> 0.0, 0.0 | Touch_timestamp time_ref -> time_ref, time_ref | Touch_file_time fln_ref -> let st = stat fln_ref in st.access_time, st.modification_time in let fatime, fmtime = if not (atime && mtime) then begin let st = stat fln in (if atime then fatime else st.access_time), (if mtime then fmtime else st.modification_time) end else begin fatime, fmtime end in Unix.utimes fln fatime fmtime in (* Create file if required *) if test_exists fln then begin set_time () end else if create then begin close_out (open_out fln); set_time () end ocaml-fileutils-0.5.3/src/FileUtilTypes.ml000066400000000000000000000071751320170427200205030ustar00rootroot00000000000000(******************************************************************************) (* ocaml-fileutils: files and filenames common operations *) (* *) (* Copyright (C) 2003-2014, Sylvain Le Gall *) (* *) (* This library is free software; you can redistribute it and/or modify it *) (* under the terms of the GNU Lesser General Public License as published by *) (* the Free Software Foundation; either version 2.1 of the License, or (at *) (* your option) any later version, with the OCaml static compilation *) (* exception. *) (* *) (* This library is distributed in the hope that it will be useful, but *) (* WITHOUT ANY WARRANTY; without even the implied warranty of *) (* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the file *) (* COPYING for more details. *) (* *) (* You should have received a copy of the GNU Lesser General Public License *) (* along with this library; if not, write to the Free Software Foundation, *) (* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA *) (******************************************************************************) open FilePath exception FileDoesntExist of filename exception RecursiveLink of filename exception Fatal of string (** See FileUtil.mli *) type action_link = | Follow | Skip | SkipInform of (filename -> unit) | AskFollow of (filename -> bool) (** See FileUtil.mli *) type interactive = Force | Ask of (filename -> bool) (** See FileUtil.mli *) type size = TB of int64 | GB of int64 | MB of int64 | KB of int64 | B of int64 (** See FileUtil.mli *) type kind = Dir | File | Dev_char | Dev_block | Fifo | Socket | Symlink (** See FileUtil.mli *) type base_permission = { sticky: bool; exec: bool; write: bool; read: bool; } (** See FileUtil.mli *) type permission = { user: base_permission; group: base_permission; other: base_permission; } (** See FileUtil.mli *) type stat = { kind: kind; is_link: bool; permission: permission; size: size; owner: int; group_owner: int; access_time: float; modification_time: float; creation_time: float; device: int; inode: int; } (** See FileUtil.mli *) type test_file = | Is_dev_block | Is_dev_char | Is_dir | Exists | Is_file | Is_set_group_ID | Has_sticky_bit | Is_link | Is_pipe | Is_readable | Is_writeable | Size_not_null | Size_bigger_than of size | Size_smaller_than of size | Size_equal_to of size | Size_fuzzy_equal_to of size | Is_socket | Has_set_user_ID | Is_exec | Is_owned_by_user_ID | Is_owned_by_group_ID | Is_newer_than of filename | Is_older_than of filename | Is_newer_than_date of float | Is_older_than_date of float | And of test_file * test_file | Or of test_file * test_file | Not of test_file | Match of string | True | False | Has_extension of extension | Has_no_extension | Is_parent_dir | Is_current_dir | Basename_is of filename | Dirname_is of filename | Custom of (filename -> bool) (** See FileUtil.mli *) type touch_time_t = | Touch_now | Touch_file_time of filename | Touch_timestamp of float ocaml-fileutils-0.5.3/src/FileUtilUMASK.ml000066400000000000000000000055301320170427200202500ustar00rootroot00000000000000(******************************************************************************) (* ocaml-fileutils: files and filenames common operations *) (* *) (* Copyright (C) 2003-2014, Sylvain Le Gall *) (* *) (* This library is free software; you can redistribute it and/or modify it *) (* under the terms of the GNU Lesser General Public License as published by *) (* the Free Software Foundation; either version 2.1 of the License, or (at *) (* your option) any later version, with the OCaml static compilation *) (* exception. *) (* *) (* This library is distributed in the hope that it will be useful, but *) (* WITHOUT ANY WARRANTY; without even the implied warranty of *) (* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the file *) (* COPYING for more details. *) (* *) (* You should have received a copy of the GNU Lesser General Public License *) (* along with this library; if not, write to the Free Software Foundation, *) (* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA *) (******************************************************************************) open FileUtilMisc exception UmaskError of string type umask_error = [ `Exc of exn | `NoStickyBit of int ] let umask ?(error=(fun str _ -> raise (UmaskError str))) ?mode out = let handle_error, handle_exception = handle_error_gen "umask" error (function | `NoStickyBit i -> Printf.sprintf "Cannot set sticky bit in umask 0o%04o" i | #exc -> "") in let complement i = 0o0777 land (lnot i) in let try_umask i = try Unix.umask i with e -> handle_exception ~fatal:true e; raise e in let get () = let cmask = try_umask 0o777 in let _mask: int = try_umask cmask in cmask in let set i = let eff_i = i land 0o777 in let _i: int = if i <> eff_i then handle_error ~fatal:true (`NoStickyBit i); try_umask eff_i in eff_i in let v = match mode with | Some (`Symbolic s) -> let v = get () in set (complement (FileUtilMode.apply ~is_dir:false ~umask:0 (complement v) s)) | Some (`Octal i) -> set i | None -> get () in match out with | `Symbolic f -> f (FileUtilMode.of_int (0o0777 land (lnot v))) | `Octal f -> f v let umask_apply m = m land (lnot (umask (`Octal (fun i -> i)))) ocaml-fileutils-0.5.3/src/FileUtilWHICH.ml000066400000000000000000000066051320170427200202360ustar00rootroot00000000000000(******************************************************************************) (* ocaml-fileutils: files and filenames common operations *) (* *) (* Copyright (C) 2003-2014, Sylvain Le Gall *) (* *) (* This library is free software; you can redistribute it and/or modify it *) (* under the terms of the GNU Lesser General Public License as published by *) (* the Free Software Foundation; either version 2.1 of the License, or (at *) (* your option) any later version, with the OCaml static compilation *) (* exception. *) (* *) (* This library is distributed in the hope that it will be useful, but *) (* WITHOUT ANY WARRANTY; without even the implied warranty of *) (* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the file *) (* COPYING for more details. *) (* *) (* You should have received a copy of the GNU Lesser General Public License *) (* along with this library; if not, write to the Free Software Foundation, *) (* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA *) (******************************************************************************) open FileUtilTypes open FilePath open FileUtilTEST let which ?(path) fln = let real_path = match path with | None -> path_of_string (try Sys.getenv "PATH" with Not_found -> "") | Some x -> x in let exec_test = test (And(Is_exec, Is_file)) in let which_path = match Sys.os_type with | "Win32" -> begin let real_ext = List.map (fun dot_ext -> (* Remove leading "." if it exists *) if (String.length dot_ext) >= 1 && dot_ext.[0] = '.' then String.sub dot_ext 1 ((String.length dot_ext) - 1) else dot_ext) (* Extract possible extension from PATHEXT *) (path_of_string (try Sys.getenv "PATHEXT" with Not_found -> "")) in let to_filename dirname ext = add_extension (concat dirname fln) ext in let ctst dirname ext = exec_test (to_filename dirname ext) in List.fold_left (fun found dirname -> if found = None then begin try let ext = List.find (ctst dirname) real_ext in Some (to_filename dirname ext) with Not_found -> None end else found) None real_path end | _ -> begin let to_filename dirname = concat dirname fln in try Some (to_filename (List.find (fun dirname -> exec_test (to_filename dirname)) real_path)) with Not_found -> None end in match which_path with | Some fn -> fn | None -> raise Not_found ocaml-fileutils-0.5.3/src/MacOSPath.ml000066400000000000000000000056711320170427200175170ustar00rootroot00000000000000(******************************************************************************) (* ocaml-fileutils: files and filenames common operations *) (* *) (* Copyright (C) 2003-2014, Sylvain Le Gall *) (* *) (* This library is free software; you can redistribute it and/or modify it *) (* under the terms of the GNU Lesser General Public License as published by *) (* the Free Software Foundation; either version 2.1 of the License, or (at *) (* your option) any later version, with the OCaml static compilation *) (* exception. *) (* *) (* This library is distributed in the hope that it will be useful, but *) (* WITHOUT ANY WARRANTY; without even the implied warranty of *) (* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the file *) (* COPYING for more details. *) (* *) (* You should have received a copy of the GNU Lesser General Public License *) (* along with this library; if not, write to the Free Software Foundation, *) (* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA *) (******************************************************************************) open FilePath_type include CommonPath let dir_writer lst = let buffer = Buffer.create path_length in let rec dir_writer_aux lst = match lst with Root s :: tl -> Buffer.add_string buffer s; Buffer.add_char buffer ':'; dir_writer_aux tl | (CurrentDir _) :: tl | ParentDir :: tl -> Buffer.add_char buffer ':'; dir_writer_aux tl | (Component "") :: tl -> dir_writer_aux tl | (Component s) :: [] -> Buffer.add_string buffer s; dir_writer_aux [] | (Component s) :: tl -> Buffer.add_string buffer s; Buffer.add_char buffer ':'; dir_writer_aux tl | [] -> Buffer.contents buffer in match lst with ParentDir :: _ -> dir_writer_aux ( (CurrentDir Long) :: lst ) | [ CurrentDir Short ] -> "" | _ -> dir_writer_aux lst let dir_reader str = let rec dir_reader_aux = function | [""] -> [] | "" :: tl -> ParentDir :: (dir_reader_aux tl) | str :: tl -> Component str :: (dir_reader_aux tl) | [] -> [] in match StringExt.split ~map:(fun s -> s) ':' str with | [] -> [CurrentDir Short] | "" :: tl -> CurrentDir Long :: (dir_reader_aux tl) | [id] -> [Component id] | root :: tl -> Root root :: (dir_reader_aux tl) let path_writer lst = String.concat ";" lst let path_reader = StringExt.split ~map:(fun s -> s) ';' ocaml-fileutils-0.5.3/src/UnixPath.ml000066400000000000000000000070041320170427200174700ustar00rootroot00000000000000(******************************************************************************) (* ocaml-fileutils: files and filenames common operations *) (* *) (* Copyright (C) 2003-2014, Sylvain Le Gall *) (* *) (* This library is free software; you can redistribute it and/or modify it *) (* under the terms of the GNU Lesser General Public License as published by *) (* the Free Software Foundation; either version 2.1 of the License, or (at *) (* your option) any later version, with the OCaml static compilation *) (* exception. *) (* *) (* This library is distributed in the hope that it will be useful, but *) (* WITHOUT ANY WARRANTY; without even the implied warranty of *) (* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the file *) (* COPYING for more details. *) (* *) (* You should have received a copy of the GNU Lesser General Public License *) (* along with this library; if not, write to the Free Software Foundation, *) (* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA *) (******************************************************************************) open FilePath_type include CommonPath let rec dir_writer lst = match lst with Root _ :: tl -> "/"^(dir_writer tl) | [ CurrentDir Short ] -> "" | lst -> let dir_writer_aux cmp = match cmp with Root _ -> "" | ParentDir -> ".." | CurrentDir _ -> "." | Component s -> s in String.concat "/" ( List.map dir_writer_aux lst ) let dir_reader fn = let sep = '/' in let fn_part_of_string = function | "." -> CurrentDir Long | ".." -> ParentDir | str -> Component str in if (String.length fn) > 0 then begin if fn.[0] = sep then StringExt.split ~start_acc:[Root ""] ~start_pos:1 ~map:fn_part_of_string sep fn else StringExt.split ~map:fn_part_of_string sep fn end else [CurrentDir Short] let path_writer lst = String.concat ":" lst let path_reader str = StringExt.split ~map:(fun s -> s) ':' str let fast_concat fn1 fn2 = let fn1_len = String.length fn1 in if fn1_len = 0 || fn1.[fn1_len - 1] = '/' then fn1 ^ fn2 else fn1 ^ "/" ^ fn2 let fast_basename fn = try let start_pos = (String.rindex fn '/') + 1 in let fn_len = String.length fn in if start_pos = fn_len then "" else String.sub fn start_pos (fn_len - start_pos) with Not_found -> fn let fast_dirname fn = try let last_pos = String.rindex fn '/' in if last_pos = 0 then "/" else String.sub fn 0 last_pos with Not_found -> "" let fast_is_relative fn = if String.length fn = 0 || fn.[0] <> '/' then true else false let fast_is_current fn = if String.length fn = 0 || fn = "." then true else if fn.[0] <> '.' then false else raise CannotHandleFast let fast_is_parent fn = if fn = ".." then true else if String.length fn < 2 || fn.[0] <> '.' || fn.[1] <> '.' then false else raise CannotHandleFast ocaml-fileutils-0.5.3/src/Win32Path.ml000066400000000000000000000053601320170427200174520ustar00rootroot00000000000000(******************************************************************************) (* ocaml-fileutils: files and filenames common operations *) (* *) (* Copyright (C) 2003-2014, Sylvain Le Gall *) (* *) (* This library is free software; you can redistribute it and/or modify it *) (* under the terms of the GNU Lesser General Public License as published by *) (* the Free Software Foundation; either version 2.1 of the License, or (at *) (* your option) any later version, with the OCaml static compilation *) (* exception. *) (* *) (* This library is distributed in the hope that it will be useful, but *) (* WITHOUT ANY WARRANTY; without even the implied warranty of *) (* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the file *) (* COPYING for more details. *) (* *) (* You should have received a copy of the GNU Lesser General Public License *) (* along with this library; if not, write to the Free Software Foundation, *) (* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA *) (******************************************************************************) open FilePath_type include CommonPath let rec dir_writer lst = match lst with Root s :: tl -> (s^":\\")^(dir_writer tl) | [ CurrentDir Short ] -> "" | lst -> let dir_writer_aux cmp = match cmp with (* We should raise an exception here *) Root s -> s | ParentDir -> ".." | CurrentDir _ -> "." | Component s -> s in String.concat "\\" (List.map dir_writer_aux lst) let dir_reader str = let fn_part_of_string = function | ".." -> ParentDir | "." -> CurrentDir Long | str -> Component str in let fn_part_split str = let lst = List.flatten (List.map (StringExt.split ~map:fn_part_of_string '\\') (StringExt.split ~map:(fun s -> s) '/' str)) in match lst with (* TODO: we don't make the difference between c:a and c:\a *) | Component "" :: tl -> tl | lst -> lst in try let drive_letter, str = StringExt.break_at_first ':' str in Root drive_letter :: (fn_part_split str) with Not_found -> fn_part_split str let path_writer lst = String.concat ";" lst let path_reader str = StringExt.split ~map:(fun s -> s) ';' str ocaml-fileutils-0.5.3/test/000077500000000000000000000000001320170427200155655ustar00rootroot00000000000000ocaml-fileutils-0.5.3/test/BenchFind.ml000066400000000000000000000062371320170427200177470ustar00rootroot00000000000000(******************************************************************************) (* ocaml-fileutils: files and filenames common operations *) (* *) (* Copyright (C) 2003-2014, Sylvain Le Gall *) (* *) (* This library is free software; you can redistribute it and/or modify it *) (* under the terms of the GNU Lesser General Public License as published by *) (* the Free Software Foundation; either version 2.1 of the License, or (at *) (* your option) any later version, with the OCaml static compilation *) (* exception. *) (* *) (* This library is distributed in the hope that it will be useful, but *) (* WITHOUT ANY WARRANTY; without even the implied warranty of *) (* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the file *) (* COPYING for more details. *) (* *) (* You should have received a copy of the GNU Lesser General Public License *) (* along with this library; if not, write to the Free Software Foundation, *) (* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA *) (******************************************************************************) (* What should be the fastest possible function in OCaml. *) let rec simple fn = let st = Unix.lstat fn in match st.Unix.st_kind with | Unix.S_DIR -> begin let fd = Unix.opendir fn in try while true do let bn = Unix.readdir fd in if bn <> "." && bn <> ".." then simple (Filename.concat fn bn) done with End_of_file -> Unix.closedir fd end | Unix.S_LNK -> () | _ -> () let () = let dir = "/home/gildor" in let sys_find () = let _i: int = Sys.command ("find "^(Filename.quote dir)^" -name '*.mp3' \ | (echo -n 'Count: '; wc -l)") in () in let fileutils_find () = let count = FileUtil.find (FileUtil.Has_extension "mp3") dir (fun i _ -> i + 1) 0 in Printf.eprintf "Count: %d\n%!" count in let time str f = let start_time = Unix.gettimeofday () in let time = prerr_endline str; f (); (Unix.gettimeofday ()) -. start_time in Printf.eprintf "Time: %.2fs\n%!" time; time in let () = prerr_endline "System find (load)"; sys_find () in let time_ref = time "System find (reference)" sys_find in let time_fileutils = time "FileUtil find" fileutils_find in let _time_simple = time "Simple" (fun () -> simple dir) in Printf.eprintf "Performance: %.2f%%\n%!" (100.0 *. (time_ref /. time_fileutils)) ocaml-fileutils-0.5.3/test/test.ml000066400000000000000000001341231320170427200171020ustar00rootroot00000000000000(******************************************************************************) (* ocaml-fileutils: files and filenames common operations *) (* *) (* Copyright (C) 2003-2014, Sylvain Le Gall *) (* *) (* This library is free software; you can redistribute it and/or modify it *) (* under the terms of the GNU Lesser General Public License as published by *) (* the Free Software Foundation; either version 2.1 of the License, or (at *) (* your option) any later version, with the OCaml static compilation *) (* exception. *) (* *) (* This library is distributed in the hope that it will be useful, but *) (* WITHOUT ANY WARRANTY; without even the implied warranty of *) (* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the file *) (* COPYING for more details. *) (* *) (* You should have received a copy of the GNU Lesser General Public License *) (* along with this library; if not, write to the Free Software Foundation, *) (* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA *) (******************************************************************************) open OUnit2 open FilePath open FileUtil exception ExpectedException let test_umask = 0o0022 let umask_mutex = OUnitShared.Mutex.create OUnitShared.ScopeProcess let bracket_umask umask = bracket (fun test_ctxt -> OUnitShared.Mutex.lock test_ctxt.OUnitTest.shared umask_mutex; Unix.umask umask) (fun umask test_ctxt -> let _i: int = Unix.umask umask in OUnitShared.Mutex.unlock test_ctxt.OUnitTest.shared umask_mutex) let with_bracket_umask test_ctxt umask f = OUnitBracket.with_bracket test_ctxt (bracket_umask umask) f module SetFilename = Set.Make (struct type t = FilePath.DefaultPath.filename let compare = FilePath.DefaultPath.compare end) let assert_equal_string ~msg = assert_equal ~printer:(fun x -> x) ~msg:msg module DiffSetFilename = OUnitDiff.SetMake (struct type t = string let compare = FilePath.DefaultPath.compare let pp_printer = Format.pp_print_string let pp_print_sep = OUnitDiff.pp_comma_separator end) (** Check that two set of file are equal *) let assert_equal_set_filename ?msg st_ref st = DiffSetFilename.assert_equal ?msg (DiffSetFilename.of_list (SetFilename.elements st_ref)) (DiffSetFilename.of_list (SetFilename.elements st)) let assert_perm fn exp = assert_equal ~msg:(Printf.sprintf "permission of '%s'" fn) ~printer:(Printf.sprintf "0o%04o") exp (Unix.lstat fn).Unix.st_perm let assert_error msg e f = assert_raises ~msg ExpectedException (fun () -> f (fun _ err -> if e err then raise ExpectedException)) (** Ensure that we are dealing with generated file (and not random file on the filesystem). *) module SafeFS = struct module S = Set.Make (struct type t = int * int let compare = Pervasives.compare end) type t = { mutable files: SetFilename.t; mutable dirs: SetFilename.t; mutable markers: S.t; } let default () = { files = SetFilename.empty; dirs = SetFilename.empty; markers = S.empty; } let marker fn = let st = Unix.lstat fn in (st.Unix.st_dev, st.Unix.st_ino) let mark t fn = t.markers <- S.add (marker fn) t.markers let touch t fn = if Sys.file_exists fn then begin failwith (Printf.sprintf "File %S already exists." fn) end else begin let chn = open_out fn in close_out chn; mark t fn; t.files <- SetFilename.add fn t.files end let mkdir t dn = if Sys.file_exists dn then begin failwith (Printf.sprintf "Directory %S already exists." dn) end else begin Unix.mkdir dn 0o755; mark t dn; t.dirs <- SetFilename.add dn t.dirs end let auto_ask_user t = Ask (fun fn -> S.mem (marker fn) t.markers) let create dn dirs files = let t = default () in mark t dn; t.dirs <- SetFilename.add dn t.dirs; List.iter (fun fn -> mkdir t (Filename.concat dn fn)) dirs; List.iter (fun fn -> touch t (Filename.concat dn fn)) files; t end module Test = functor (OsPath: PATH_STRING_SPECIFICATION) -> struct let os_string = ref "" let test_label s value = (!os_string)^" : "^s^" \""^value^"\"" let test_label_list s lst = test_label s ("["^(String.concat ";" lst)^"]") let test_label_pair s (a, b) = test_label s (a^"\" \""^b) let test_name s = (s) let reduce (exp, res) = (test_name "reduce") >:: (fun _ -> assert_equal_string ~msg:(test_label "reduce" exp) res (OsPath.reduce ~no_symlink:true exp)) let make_path (exp, res) = (test_name "make_path") >:: (fun _ -> assert_equal_string ~msg:(test_label_list "make_path" exp) res (OsPath.string_of_path exp)) let make_absolute (base, rela, res) = (test_name "make_absolute") >:: (fun _ -> assert_equal_string ~msg:(test_label_pair "make_absolute" (base, rela)) res (OsPath.reduce ~no_symlink:true (OsPath.make_absolute base rela))) let make_relative (base, abs, res) = (test_name "make_relative") >:: (fun _ -> assert_equal_string ~msg:(test_label_pair "make_relative" (base, abs)) res (OsPath.make_relative base abs)) let valid exp = (test_name "valid") >:: (fun _ -> assert_bool (test_label "is_valid" exp) (OsPath.is_valid exp)) let identity exp = (test_name "identity") >:: (fun _ -> assert_equal_string ~msg:(test_label "identity" exp) exp (OsPath.identity exp)) let extension (filename, basename, extension) = (test_name "extension") >:: (fun _ -> assert_equal_string ~msg:(test_label "chop_extension" filename) (OsPath.chop_extension filename) basename; assert_equal_string ~msg:(test_label "get_extension" filename) (OsPath.string_of_extension (OsPath.get_extension filename)) extension; assert_bool (test_label "check_extension" filename) (OsPath.check_extension filename (OsPath.extension_of_string extension)); assert_bool (test_label "check_extension (false) " filename) (not (OsPath.check_extension filename (OsPath.extension_of_string "dummy")))) let is_relative (filename, res) = (test_name "is_relative") >:: (fun _ -> assert_equal res (OsPath.is_relative filename)) end module TestUnix = Test(UnixPath) module TestMacOS = Test(MacOSPath) module TestWin32 = Test(Win32Path) let () = TestUnix.os_string := "Unix"; TestMacOS.os_string := "MacOS"; TestWin32.os_string := "Win32" (** Static test *) let _ = assert(UnixPath.get_extension "test.txt" = "txt"); assert(MacOSPath.get_extension "test.txt" = "txt"); assert(Win32Path.get_extension "test.txt" = "txt") (*********************) (* Unix FilePath test*) (*********************) let test_unix = let test_path = [ ("/"); ("/a/b"); ("/a/b/c/"); ("/a/../b/c"); ("/a/../b/../c"); ("a/b/c/"); ("../a/b"); (""); ("."); ("./"); (".."); ("../") ] in "Unix FilePath" >::: ( (* Is_valid *) ( List.map TestUnix.valid test_path ) (* Identity *) @ ( List.map TestUnix.identity test_path ) (* Reduce path *) @ ( List.map TestUnix.reduce [ ("/a/b/c", "/a/b/c"); ("/a/b/c/", "/a/b/c"); ("/a/b/c/d/..", "/a/b/c"); ("/a/b/c/.", "/a/b/c"); ("/a/d/../b/c", "/a/b/c"); ("/a/./b/c", "/a/b/c"); ("/a/b/c/d/./..", "/a/b/c"); ("/a/b/c/d/../.", "/a/b/c"); ("/a/b/d/./../c", "/a/b/c"); ("/a/b/d/.././c", "/a/b/c"); ("/a/b/../d/../b/c", "/a/b/c"); ("/a/./././b/./c", "/a/b/c"); ("/a/../a/./b/../c/../b/./c", "/a/b/c"); ("/a/../..", "/"); ("./d/../a/b/c", "a/b/c"); ("a/b/c/../../../", ""); ("", ""); (".", ""); ("./", ""); ("..", ".."); ("../", ".."); ] ) (* Create path *) @ ( List.map TestUnix.make_path [ (["/a"; "b"; "/c/d"], "/a:b:/c/d"); ([], ""); ] ) (* Convert to absolute *) @ ( List.map TestUnix.make_absolute [ ("/a/b/c", ".", "/a/b/c"); ("/a/b/c", "./d", "/a/b/c/d"); ("/a/b/c", "../d", "/a/b/d"); ("/a/b/c", "", "/a/b/c"); ("/a/b/c", ".", "/a/b/c"); ("/a/b/c", "./", "/a/b/c"); ("/a/b/c", "..", "/a/b"); ("/a/b/c", "../", "/a/b") ] ) (* Convert to relative *) @ ( List.map TestUnix.make_relative [ ("/a/b/c", "/a/b/c", ""); ("/a/b/c", "/a/b/d", "../d") ] ) (* Check extension *) @ ( List.map TestUnix.extension [ ("/a/b/c.d", "/a/b/c", "d"); ("/a/b.c/d.e", "/a/b.c/d", "e"); ("a.", "a", ""); ] ) ) (**********************) (* Win32 FilePath test*) (**********************) let test_win32 = let test_path = [ ("c:\\"); ("c:\\a\\b"); ("c:\\a\\b\\c\\"); ("c:\\a\\..\\b\\c"); ("c:\\a\\..\\b\\..\\c"); ("a\\b\\c\\"); ("..\\a\\b"); (""); ("."); (".\\"); (".."); ("..\\") ] in "Win32 FilePath" >::: ( (* Is_valid *) (List.map TestWin32.valid test_path) (* Identity *) @ (List.map TestWin32.identity test_path) (* Reduce path *) @ (List.map TestWin32.reduce [("c:\\a\\b\\c", "c:\\a\\b\\c"); ("c:\\a\\b\\c\\", "c:\\a\\b\\c"); ("c:\\a\\b\\c\\d\\..", "c:\\a\\b\\c"); ("c:\\a\\b\\c\\.", "c:\\a\\b\\c"); ("c:\\a\\d\\..\\b\\c", "c:\\a\\b\\c"); ("c:\\a\\.\\b\\c", "c:\\a\\b\\c"); ("c:\\a\\b\\c\\d\\.\\..", "c:\\a\\b\\c"); ("c:\\a\\b\\c\\d\\..\\.", "c:\\a\\b\\c"); ("c:\\a\\b\\d\\.\\..\\c", "c:\\a\\b\\c"); ("c:\\a\\b\\d\\..\\.\\c", "c:\\a\\b\\c"); ("c:\\a\\b\\..\\d\\..\\b\\c", "c:\\a\\b\\c"); ("c:\\a\\.\\.\\.\\b\\.\\c", "c:\\a\\b\\c"); ("c:\\a\\..\\a\\.\\b\\..\\c\\..\\b\\.\\c", "c:\\a\\b\\c"); ("a\\..\\b", "b"); ("", ""); (".", ""); (".\\", ""); ("..", ".."); ("..\\", "..")]) (* Create path *) @ (List.map TestWin32.make_path [(["c:/a"; "b"; "c:/c\\d"], "c:\\a;b;c:\\c\\d"); ([], "")]) (* Convert to absolute *) @ ( List.map TestWin32.make_absolute [ ("c:\\a\\b\\c", ".", "c:\\a\\b\\c"); ("c:\\a\\b\\c", ".\\d", "c:\\a\\b\\c\\d"); ("c:\\a\\b\\c", "..\\d", "c:\\a\\b\\d"); ("c:\\a\\b\\c", "", "c:\\a\\b\\c"); ("c:\\a\\b\\c", ".", "c:\\a\\b\\c"); ("c:\\a\\b\\c", ".\\", "c:\\a\\b\\c"); ("c:\\a\\b\\c", "..", "c:\\a\\b"); ("c:\\a\\b\\c", "..\\", "c:\\a\\b"); ] ) (* Convert to relative *) @ ( List.map TestWin32.make_relative [ ("c:\\a\\b\\c", "c:/a\\b\\c", ""); ("c:\\a\\b\\c", "c:/a\\b\\d", "..\\d") ] ) (* Check extension *) @ ( List.map TestWin32.extension [ ("c:\\a\\b\\c.d", "c:\\a\\b\\c", "d"); ("c:\\a\\b.c\\d.e", "c:\\a\\b.c\\d", "e"); ("a.", "a", ""); ] ) @ ( List.map TestWin32.is_relative [ "c:/a", false; "c:\\a", false; "./a", true; ".\\a", true; "../a", true; "..\\a", true; ] ) ) (**********************) (* MacOS FilePath test*) (**********************) let test_macos = let test_path = [ ("a:"); ("a:::"); (":a:b:c"); (""); (":"); ("::"); ] in "MacOS FilePath" >::: ( (* Is_valid *) ( List.map TestMacOS.valid test_path ) (* Identity *) @ ( List.map TestMacOS.identity test_path ) (* Reduce path *) @ ( List.map TestMacOS.reduce [ ("root:a:b:c", "root:a:b:c"); ("root:a:b:c:", "root:a:b:c"); ("root:a:b:c:d::", "root:a:b:c"); ("root:a:d::b:c", "root:a:b:c"); ("root:a:b:c:d::", "root:a:b:c"); ("root:a:b:d::c", "root:a:b:c"); ("root:a:b::d::b:c", "root:a:b:c"); ("", ""); (":", ""); ("::", "::"); ] ) (* Create path *) @ ( List.map TestMacOS.make_path [ ([":a"; "b"; ":c:d"], ":a;b;:c:d"); ([], ""); ] ) (* Convert to absolute *) @ ( List.map TestMacOS.make_absolute [ ("root:a:b:c", ":", "root:a:b:c"); ("root:a:b:c", ":d", "root:a:b:c:d"); ("root:a:b:c", "::d", "root:a:b:d"); ("root:a:b:c", "", "root:a:b:c"); ("root:a:b:c", ":", "root:a:b:c"); ("root:a:b:c", "::", "root:a:b"); ] ) (* Convert to relative *) @ ( List.map TestMacOS.make_relative [ ("root:a:b:c", "root:a:b:c", ""); ("root:a:b:c", "root:a:b:d", "::d") ] ) (* Check extension *) @ ( List.map TestMacOS.extension [ ("root:a:b:c.d", "root:a:b:c", "d"); ("root:a:b.c:d.e", "root:a:b.c:d", "e"); ("a.", "a", ""); ] ) ) (*****************) (* FileUtil test *) (*****************) (* Test to be performed *) let test_fileutil = "FileUtil" >::: ["Test" >:: (fun test_ctxt -> let tmp_dir = bracket_tmpdir test_ctxt in let file_test = let fn, chn = bracket_tmpfile test_ctxt in output_string chn "foo"; close_out chn; fn in let non_fatal_test file (stest, expr, res) = non_fatal test_ctxt (fun _ -> assert_bool ("Test "^stest^" on "^file) (res = (test expr file))) in non_fatal_test file_test ("Size_not_null", Size_not_null, true); List.iter (non_fatal_test tmp_dir) [ "True", True, true; "False", False, false; "Is_dir", Is_dir, true; "Not Is_dir", (Not Is_dir), false; "Is_dev_block", Is_dev_block, false; "Is_dev_char", Is_dev_char, false; "Exists", Exists, true; "Is_file", Is_file, false; "Is_set_group_ID", Is_set_group_ID, false; "Has_sticky_bit", Has_sticky_bit, false; "Is_link", Is_link, false; "Is_pipe", Is_pipe, false; "Is_readable", Is_readable, true; "Is_writeable", Is_writeable, true; "Is_socket", Is_socket, false; "Has_set_user_ID", Has_set_user_ID, false; "Is_exec", Is_exec, true; "Match", Match(tmp_dir), true; "And of test_file * test_file", And(True, False), false; "Or of test_file * test_file", Or(True, False), true; "Is_newer_than", (Is_newer_than tmp_dir), false; "Is_older_than", (Is_older_than tmp_dir), false; ]; if Sys.os_type <> "Win32" then begin List.iter (non_fatal_test tmp_dir) [ "Is_owned_by_user_ID", Is_owned_by_user_ID, true; "Is_owned_by_group_ID", Is_owned_by_group_ID, true; ] end); "Test with FileUtilStr.Match" >:: (fun test_ctxt -> let tmp_dir = bracket_tmpdir ~prefix:"fileutil-foobar" test_ctxt in assert_bool "FileUtilStr.Match = true" (FileUtilStr.test (Match ".*fileutil-") tmp_dir); assert_bool "FileUtilStr.Match = false" (not (FileUtilStr.test (Match "fileutil") tmp_dir))); "Mode" >::: [ "to_string" >:: (fun _ -> List.iter (fun (str, mode) -> assert_equal ~printer:(fun s -> s) str (FileUtilMode.to_string mode)) [ "u+r", [`User (`Add `Read)]; "u+rw", [`User (`Add (`List [`Read; `Write]))]; "+rw,u=rw,g=rwx", [ `None (`Add (`List [`Read; `Write])); `User (`Set (`List [`Read; `Write])); `Group (`Set (`List [`Read; `Write; `Exec])); ]; ]); "apply" >:: (fun _ -> List.iter (fun (is_dir, umask, i, m, e) -> assert_equal ~msg:(Printf.sprintf "0o%04o + %s" i (FileUtilMode.to_string m)) ~printer:(Printf.sprintf "0o%04o") e (FileUtilMode.apply ~is_dir ~umask i m)) [ false, 0o022, 0o0600, [`Group (`Add `Read)], 0o0640; false, 0o022, 0o0600, [`Group (`Add (`List [`Read; `Write]))], 0o0660; false, 0o022, 0o0600, [`Other (`Add (`List [`Read; `Write]))], 0o0606; false, 0o022, 0o0600, [`User (`Set (`List [`Read; `Write; `Exec]))], 0o0700; false, 0o022, 0o0600, [`User (`Set (`List [`Read; `Write; `Exec]))], 0o0700; false, 0o022, 0o0600, [`None (`Add (`List [`Read; `Write; `Exec]))], 0o0755; false, 0o022, 0o0600, [`Group (`Add `ExecX)], 0o0600; false, 0o022, 0o0700, [`Group (`Add `ExecX)], 0o0710; true, 0o022, 0o0600, [`Group (`Add `ExecX)], 0o0610; false, 0o022, 0o0600, [`Group (`Set `User)], 0o0660; false, 0o022, 0o0600, [`Group (`Add `StickyO)], 0o0600; false, 0o022, 0o0600, [`Group (`Add `Sticky)], 0o2600; false, 0o022, 0o0600, [`Other (`Add `StickyO)], 0o1600; false, 0o022, 0o0600, [`Other (`Add `Sticky)], 0o0600; ] ) ]; "Touch in not existing subdir" >:: (fun test_ctxt -> let tmp_dir = bracket_tmpdir test_ctxt in try let file = make_filename [tmp_dir; "doesntexist"; "essai0"] in touch file; assert_failure "Touch should have failed, since intermediate directory is missing" with _ -> ()); "Touch in existing dir v1" >:: (fun test_ctxt -> let tmp_dir = bracket_tmpdir test_ctxt in let file = make_filename [tmp_dir; "essai0"] in touch file; assert_bool "touch" (test Exists file); ); "Touch in existing dir with no create" >:: (fun test_ctxt -> let tmp_dir = bracket_tmpdir test_ctxt in let file = make_filename [tmp_dir; "essai2"] in touch ~create:false file; assert_bool "touch" (not (test Exists file))); "Touch in existing dir v2" >:: (fun test_ctxt -> let tmp_dir = bracket_tmpdir test_ctxt in let file = make_filename [tmp_dir; "essai1"] in touch file; assert_bool "touch" (test Exists file)); "Touch precedence" >:: (fun test_ctxt -> let tmp_dir = bracket_tmpdir test_ctxt in let time = Unix.gettimeofday () in let fn1 = make_filename [tmp_dir; "essai1"] in let fn2 = make_filename [tmp_dir; "essai0"] in touch ~time:(Touch_timestamp time) fn1; touch ~time:(Touch_timestamp (time +. 1.0)) fn2; assert_bool "touch precedence 1" (test (Is_newer_than fn1) fn2); assert_bool "touch precedence 2" (test (Is_older_than fn2) fn1)); "Mkdir simple v1" >:: (fun test_ctxt -> let tmp_dir = bracket_tmpdir test_ctxt in let dir = make_filename [tmp_dir; "essai2"] in mkdir dir; assert_bool "mkdir" (test Is_dir dir)); "Mkdir simple && mode 700" >:: (fun test_ctxt -> let tmp_dir = bracket_tmpdir test_ctxt in let dir = make_filename [tmp_dir; "essai3"] in mkdir ~mode:(`Octal 0o0700) dir; assert_bool "mkdir" (test Is_dir dir)); "Mkdir recurse v2" >:: (fun test_ctxt -> let tmp_dir = bracket_tmpdir test_ctxt in let dir = make_filename [tmp_dir; "essai4"; "essai5"] in assert_error "missing component path" (function | `MissingComponentPath _ -> true | _ -> false) (fun error -> mkdir ~error dir)); "Mkdir && already exist v3" >:: (fun test_ctxt -> let tmp_dir = bracket_tmpdir test_ctxt in let dir = make_filename [tmp_dir; "essai0"] in touch dir; assert_error "dirname already used" (function | `DirnameAlreadyUsed _ -> true | _ -> false) (fun error -> mkdir ~error dir)); "Mkdir recurse v4" >:: (fun test_ctxt -> let tmp_dir = bracket_tmpdir test_ctxt in let dir1 = (make_filename [tmp_dir; "essai4"]) in let dir2 = (make_filename [dir1; "essai5"]) in mkdir ~parent:true dir2; assert_bool "mkdir" (test Is_dir dir2); assert_perm dir1 0o0755; assert_perm dir2 0o0755; rm ~recurse:true [dir1]; assert_bool "no dir" (not (test Exists dir2)); mkdir ~parent:true ~mode:(`Symbolic [`Group (`Add `Write); `Other (`Set (`List []))]) dir2; assert_bool "mkdir" (test Is_dir dir2); assert_perm dir1 0o0755; assert_perm dir2 0o0770; rm ~recurse:true [dir1]; assert_bool "no dir" (not (test Exists dir2)); mkdir ~parent:true ~mode:(`Octal 0o0770) dir2; assert_bool "mkdir" (test Is_dir dir2); assert_perm dir1 0o0755; assert_perm dir2 0o0770; rm ~recurse:true [dir1]; assert_bool "no dir" (not (test Exists dir2))); "Find v0" >:: (fun test_ctxt -> let tmp_dir = bracket_tmpdir test_ctxt in with_bracket_chdir test_ctxt tmp_dir (fun _ -> let find_acc _ = find True "." (fun acc x -> reduce x :: acc) [] in let lst_dot = find_acc "." in let lst_empty = find_acc "" in assert_bool "find '.' is empty" (lst_dot <> []); assert_bool "find '' is empty" (lst_empty <> []); assert_bool "find '.' <> find ''" (lst_dot = lst_empty))); "Find v1" >:: (fun test_ctxt -> let tmp_dir = bracket_tmpdir test_ctxt in let sfs = SafeFS.create tmp_dir ["essai_dir"] ["essai_file"] in let set = find True tmp_dir (fun set fln -> SetFilename.add fln set) SetFilename.empty in assert_equal_set_filename (SetFilename.union sfs.SafeFS.dirs sfs.SafeFS.files) set); "Find v2" >:: (fun test_ctxt -> let tmp_dir = bracket_tmpdir test_ctxt in let sfs = SafeFS.create tmp_dir ["essai_dir"] ["essai_file"] in let set = find Is_dir tmp_dir (fun set fln -> SetFilename.add fln set) SetFilename.empty in assert_equal_set_filename sfs.SafeFS.dirs set); "Find v3" >:: (fun test_ctxt -> let tmp_dir = bracket_tmpdir test_ctxt in let sfs = SafeFS.create tmp_dir ["essai_dir"] ["essai_file"] in let set = find Is_file tmp_dir (fun set fln -> SetFilename.add fln set) SetFilename.empty in assert_equal_set_filename sfs.SafeFS.files set); "Find v4" >:: (fun test_ctxt -> let tmp_dir = bracket_tmpdir test_ctxt in let sfs = SafeFS.create tmp_dir ["essai_dir"] ["essai_file"] in let set = find Is_file (Filename.concat tmp_dir "") (fun set fln -> SetFilename.add fln set) SetFilename.empty in assert_equal_set_filename sfs.SafeFS.files set); "Unix specific" >::: ( let mk_symlink test_ctxt = let () = skip_if (Sys.os_type <> "Unix") "Symlink only works on Unix." in let tmp_dir = bracket_tmpdir test_ctxt in let symlink = make_filename [tmp_dir; "recurse"] in let sfs = SafeFS.create tmp_dir ["essai_dir"] ["essai_file"] in Unix.symlink current_dir symlink; SafeFS.mark sfs symlink; tmp_dir, symlink, sfs in let mk_filelink test_ctxt = let () = skip_if (Sys.os_type <> "Unix") "Symlink only works on Unix." in let tmp_dir = bracket_tmpdir test_ctxt in let symlink = make_filename [tmp_dir; "recurse"] in let source = make_filename [tmp_dir; "essai_file"] in let sfs = SafeFS.create tmp_dir [] ["essai_file"] in Unix.symlink source symlink; SafeFS.mark sfs symlink; tmp_dir, symlink, sfs in let mk_deadlink test_ctxt = let () = skip_if (Sys.os_type <> "Unix") "Symlink only works on Unix." in let tmp_dir = bracket_tmpdir test_ctxt in let dir = make_filename [tmp_dir; "dir1"] in let symlink = make_filename [dir; "dead"] in mkdir dir; Unix.symlink "non_existing.txt" symlink; tmp_dir, symlink, dir in [ "Unix symlink" >:: (fun test_ctxt -> let _, symlink, _ = mk_symlink test_ctxt in assert_bool "symlink is not a link" (test Is_link symlink); assert_bool "symlink is not a dir" (test Is_dir symlink)); "Find v4 (link follow)" >:: (fun test_ctxt -> let tmp_dir, _, _ = mk_symlink test_ctxt in try find ~follow:Follow Is_dir tmp_dir (fun () _ -> ()) (); assert_failure "find follow should have failed, since there is \ recursive symlink" with RecursiveLink _ -> ()); "Find v5 (no link follow)" >:: (fun test_ctxt -> let tmp_dir, fn, sfs = mk_symlink test_ctxt in let set = find ~follow:Skip Is_dir tmp_dir (fun set fln -> SetFilename.add fln set) SetFilename.empty in assert_bool "find symlink skip fails" (SetFilename.equal set (SetFilename.add fn sfs.SafeFS.dirs))); "Unix delete symlink" >:: (fun test_ctxt -> let _, symlink, _ = mk_symlink test_ctxt in rm [symlink]; try let _st: Unix.stats = Unix.lstat symlink in assert_failure "rm symlink failed" with Unix.Unix_error(Unix.ENOENT, _, _) -> ()); "Dead link + stat" >:: (fun test_ctxt -> let _, symlink, _ = mk_deadlink test_ctxt in let st = stat symlink in assert_bool "is marked as a link" st.is_link; assert_equal ~msg:"is a link" Symlink st.kind; assert_raises ~msg:"cannot dereference" (FileDoesntExist symlink) (fun () -> stat ~dereference:true symlink)); "Dead link + test" >:: (fun test_ctxt -> let _, symlink, _ = mk_deadlink test_ctxt in assert_bool "dead link exists" (test Is_link symlink)); "Dead symlink + rm" >:: (fun test_ctxt -> let _, _, dir = mk_deadlink test_ctxt in rm ~recurse:true [dir]); "Dead symlink + cp -r" >:: (fun test_ctxt -> let tmp_dir, _, dir1 = mk_deadlink test_ctxt in let dir2 = make_filename [tmp_dir; "dir2"] in cp ~recurse:true [dir1] dir2; try (* test Is_link *) let _st: Unix.stats = Unix.lstat (make_filename [dir2; "dead"]) in () with Unix.Unix_error(Unix.ENOENT, _, _) -> assert_failure "dead link not copied."); "Dead symlink + cp -r v2" >:: (fun test_ctxt -> let tmp_dir, symlink, _ = mk_deadlink test_ctxt in let dir2 = make_filename [tmp_dir; "dir2"] in cp ~recurse:true [symlink] dir2; try (* test Is_link *) let _st: Unix.stats = Unix.lstat dir2 in () with Unix.Unix_error(Unix.ENOENT, _, _) -> assert_failure "dead link not copied."); "Dead symlink + cp" >:: (fun test_ctxt -> let tmp_dir, symlink, _ = mk_deadlink test_ctxt in let dir2 = make_filename [tmp_dir; "dir2"] in try cp [symlink] dir2; assert_failure "dead link should not copied." with FileDoesntExist _ -> ()); "Live filelink + cp" >:: (fun test_ctxt -> let tmp_dir, symlink, _ = mk_filelink test_ctxt in let dest = make_filename [tmp_dir; "dest"] in cp [symlink] dest; assert_bool "regular" (not(test Is_link dest))); "Readlink" >:: (fun test_ctxt -> let tmp_dir, fn, _ = mk_symlink test_ctxt in assert_equal ~printer:(Printf.sprintf "%S") tmp_dir (readlink fn)); ] ); "Chmod" >:: (fun test_ctxt -> let fn, chn = bracket_tmpfile test_ctxt in let () = close_out chn in let iter_chmod = List.iter (fun (ini, mode, exp) -> Unix.chmod fn ini; chmod mode [fn]; assert_perm fn exp) in let () = if Sys.os_type = "Unix" then begin iter_chmod [ 0o0000, `Symbolic [`User (`Add `Exec)], 0o0100; 0o0100, `Symbolic [`User (`Remove `Exec)], 0o0000; 0o0000, `Symbolic [`Group (`Add `Exec)], 0o0010; 0o0010, `Symbolic [`Group (`Remove `Exec)], 0o0000; 0o0000, `Symbolic [`Other (`Add `Exec)], 0o0001; 0o0001, `Symbolic [`Other (`Remove `Exec)], 0o0000; 0o0000, `Symbolic [`All (`Add `Exec)], 0o0111; 0o0111, `Symbolic [`All (`Remove `Exec)], 0o0000; 0o0000, `Symbolic [`User (`Add `ExecX)], 0o0000; 0o0010, `Symbolic [`User (`Add `ExecX)], 0o0110; 0o0001, `Symbolic [`User (`Add `ExecX)], 0o0101; ] end; iter_chmod [ 0o0200, `Symbolic [`User (`Add `Write)], 0o0200; 0o0000, `Symbolic [`User (`Add `Write)], 0o0200; 0o0200, `Symbolic [`User (`Remove `Write)], 0o0000; 0o0000, `Symbolic [`Group (`Add `Write)], 0o0020; 0o0020, `Symbolic [`Group (`Remove `Write)], 0o0000; 0o0000, `Symbolic [`Other (`Add `Write)], 0o0002; 0o0002, `Symbolic [`Other (`Remove `Write)], 0o0000; 0o0000, `Symbolic [`All (`Add `Write)], 0o0222; 0o0222, `Symbolic [`All (`Remove `Write)], 0o0000; 0o0000, `Symbolic [`User (`Add `Read)], 0o0400; 0o0400, `Symbolic [`User (`Remove `Read)], 0o0000; 0o0000, `Symbolic [`Group (`Add `Read)], 0o0040; 0o0040, `Symbolic [`Group (`Remove `Read)], 0o0000; 0o0000, `Symbolic [`Other (`Add `Read)], 0o0004; 0o0004, `Symbolic [`Other (`Remove `Read)], 0o0000; 0o0000, `Symbolic [`All (`Add `Read)], 0o0444; 0o0444, `Symbolic [`All (`Remove `Read)], 0o0000; 0o0000, `Octal 0o644, 0o0644; 0o0100, (* u=r,g=u,u+w *) `Symbolic [`User (`Set `Read); `Group (`Set `User); `User (`Add `Write)], 0o640; ] in let tmp_dir = bracket_tmpdir test_ctxt in let fn = make_filename [tmp_dir; "essai6"] in touch fn; Unix.chmod fn 0o0000; chmod ~recurse:true (`Symbolic [`User (`Add `Read)]) [tmp_dir]; assert_perm fn 0o0400); "Cp v1" >:: (fun test_ctxt -> let tmp_dir = bracket_tmpdir test_ctxt in let file = make_filename [tmp_dir; "essai6"] in let fn0 = make_filename [tmp_dir; "essai0"] in touch fn0; cp [fn0] file; assert_bool "cp" (test Exists file)); "Cp v2" >:: (fun test_ctxt -> let tmp_dir = bracket_tmpdir test_ctxt in let file = make_filename [tmp_dir; "essai4"] in let fn0 = make_filename [tmp_dir; "essai0"] in touch fn0; cp [fn0] file; assert_bool "cp" (test Exists file)); "Cp with space" >:: (fun test_ctxt -> let tmp_dir = bracket_tmpdir test_ctxt in let dirspace = make_filename [tmp_dir; "essai 7"] in let file = make_filename [dirspace; "essai0"] in let fn0 = make_filename [tmp_dir; "essai0"] in touch fn0; mkdir dirspace; cp [fn0] file; assert_bool "cp" (test Exists file)); "Cp dir to dir" >:: (fun test_ctxt -> let tmp_dir = bracket_tmpdir test_ctxt in let dir1 = make_filename [tmp_dir; "dir1"] in let dir2 = make_filename [tmp_dir; "dir2"] in mkdir dir1; touch (make_filename [dir1; "file.txt"]); cp ~recurse:true [dir1] dir2; assert_bool "cp" (test Exists (make_filename [dir2; "file.txt"])); cp ~recurse:true [dir1] dir2; assert_bool "cp dir" (test Is_dir (make_filename [dir2; "dir1"]))); "Cp ACL" >:: (fun test_ctxt -> let tmp_dir = bracket_tmpdir test_ctxt in let fn1 = make_filename [tmp_dir; "foo1.txt"] in let fn2 = make_filename [tmp_dir; "foo2.txt"] in let fn3 = make_filename [tmp_dir; "foo3.txt"] in touch fn1; Unix.chmod fn1 0o444; assert_perm fn1 0o444; cp [fn1] fn2; assert_perm fn2 0o444; if Sys.os_type = "Unix" then begin Unix.chmod fn1 0o555; assert_perm fn1 0o555; cp [fn1] fn3; assert_perm fn3 0o555 end); "Cp preserve" >:: (fun test_ctxt -> let tmp_dir = bracket_tmpdir test_ctxt in let dir1 = make_filename [tmp_dir; "dir1"] in let fn1 = make_filename [dir1; "fn1.txt"] in let dir2 = make_filename [tmp_dir; "dir2"] in let fn2 = make_filename [dir2; "fn1.txt"] in let assert_equal_time ?msg exp got = assert_equal ?msg ~printer:string_of_float exp got in mkdir dir1; touch ~time:(Touch_timestamp 1.0) ~mtime:true fn1; touch ~time:(Touch_timestamp 2.0) ~atime:true fn1; touch ~time:(Touch_timestamp 3.0) ~mtime:true dir1; touch ~time:(Touch_timestamp 4.0) ~atime:true dir1; assert_equal_time ~msg:"fn1 mtime" 1.0 (stat fn1).modification_time; assert_equal_time ~msg:"fn1 atime" 2.0 (stat fn1).access_time; assert_equal_time ~msg:"dir1 mtime" 3.0 (stat dir1).modification_time; assert_equal_time ~msg:"dir1 atime" 4.0 (stat dir1).access_time; cp ~recurse:true ~preserve:true [dir1] dir2; assert_equal_time ~msg:"fn2 mtime" 1.0 (stat fn2).modification_time; assert_equal_time ~msg:"fn2 atime" 2.0 (stat fn2).access_time; assert_equal_time ~msg:"dir2 mtime" 3.0 (stat dir2).modification_time; assert_equal_time ~msg:"dir2 atime" 4.0 (stat dir2).access_time); "Cp POSIX" >:: (fun test_ctxt -> let tmp_dir1 = bracket_tmpdir test_ctxt in let tmp_dir2 = bracket_tmpdir test_ctxt in touch (concat tmp_dir1 "foo.txt"); with_bracket_chdir test_ctxt tmp_dir1 (fun _ -> cp ~recurse:true [current_dir] tmp_dir2); assert_bool "file" (test Is_file (concat tmp_dir2 "foo.txt"))); "Mv simple" >:: (fun test_ctxt -> let tmp_dir = bracket_tmpdir test_ctxt in let file0 = make_filename [tmp_dir; "essai0"] in let file1 = make_filename [tmp_dir; "essai10"] in let file2 = make_filename [tmp_dir; "essai9"] in touch file0; cp [file0] file1; mv file1 file2; cp [file0] file1; mv file1 file2; assert_bool "mv" (test Exists file2)); "Mv otherfs" >:: (fun test_ctxt -> let tmp_dir = bracket_tmpdir test_ctxt in let file_test = make_filename [tmp_dir; "essai12"] in let sfs = SafeFS.create tmp_dir [] ["essai12"] in let file = let fn = Filename.temp_file ~temp_dir:(pwd ()) "otherfs" ".txt" in Sys.remove fn; bracket ignore (fun () _ -> rm ~force:(SafeFS.auto_ask_user sfs) [fn]) test_ctxt; fn in mv file_test file; SafeFS.mark sfs file; assert_bool "mv" (test Exists file)); "Rm simple" >:: (fun test_ctxt -> let tmp_dir = bracket_tmpdir test_ctxt in let file = (make_filename [tmp_dir; "essai0"]) in let sfs = SafeFS.create tmp_dir [] ["essai0"] in rm ~force:(SafeFS.auto_ask_user sfs) [file]; assert_bool "rm" (test (Not Exists) file)); "Rm no recurse" >:: (fun test_ctxt -> let tmp_dir = bracket_tmpdir test_ctxt in let dir = (make_filename [tmp_dir; "essai4"]) in let sfs = SafeFS.create tmp_dir ["essai4"] ["essai0"] in mkdir dir; assert_error "rm should have failed trying to delete a directory" (function | `NoRecurse _ -> true | _ -> false) (fun error -> rm ~error ~force:(SafeFS.auto_ask_user sfs) [dir])); "Rm ask duplicate" >:: (fun test_ctxt -> let tmp_dir = bracket_tmpdir test_ctxt in let dir = make_filename [tmp_dir; "ask-duplicate"] in let sfs = SafeFS.create tmp_dir ["ask-duplicate"] [make_filename ["ask-duplicate"; "toto.txt"]] in let set_asked = ref SetFilename.empty in let set_duplicated = ref SetFilename.empty in let ask_register fn = if SetFilename.mem fn !set_asked then set_duplicated := SetFilename.add fn !set_duplicated; set_asked := SetFilename.add fn !set_asked; match SafeFS.auto_ask_user sfs with | Ask f -> f fn | _ -> false in rm ~force:(Ask ask_register) ~recurse:true [dir]; assert_equal ~msg:"duplicate file asked when removing" SetFilename.empty !set_duplicated); "Which ocamlc" >:: (fun _ -> try let _str: string = which "ocamlc" in () with Not_found -> assert_failure "Cannot find ocamlc"); "Umask" >:: (fun test_ctxt -> assert_equal ~printer:(Printf.sprintf "0o%04o") test_umask (umask (`Octal (fun i -> i))); assert_equal ~printer:FileUtilMode.to_string [`User (`Set (`List [`Read; `Write; `Exec])); `Group (`Set (`List [`Read; `Exec])); `Other (`Set (`List [`Read; `Exec]))] (umask (`Symbolic (fun s -> s))); List.iter (fun (i, e) -> assert_equal ~printer:(Printf.sprintf "0o%04o") e (umask_apply i)) [ 0o777, 0o755; 0o1777, 0o1755 ]; with_bracket_umask test_ctxt test_umask (fun _ _ -> umask ~mode:(`Octal 0o0222) (`Octal ignore); assert_equal ~printer:(Printf.sprintf "0o%04o") 0o0222 (umask (`Octal (fun i -> i)))); with_bracket_umask test_ctxt test_umask (fun _ _ -> assert_raises (UmaskError("Cannot set sticky bit in umask 0o1222")) (fun () -> umask ~mode:(`Octal 0o1222) (`Octal ignore))); List.iter (fun (s, e) -> with_bracket_umask test_ctxt test_umask (fun msk _ -> assert_equal ~msg:(Printf.sprintf "0o%04o + %s -> 0o%04o" msk (FileUtilMode.to_string s) e) ~printer:(Printf.sprintf "0o%04o") e (umask ~mode:(`Symbolic s) (`Octal (fun i -> i))))) [ [`None (`Add `Read)], 0o0022; [`None (`Add (`List [`Read; `Write]))], 0o0000; [`All (`Remove `Read)], 0o0466; [`Group (`Set (`List [`Read; `Write; `Exec]))], 0o0002; ]; () ); "Size" >::: [ "string_of_size" >::: ( let i64_unit = 1025L in let i64_unit2 = Int64.succ (Int64.mul 1024L 1024L) in let test_of_vector fuzzy (str, sz) = test_case (fun _ -> assert_equal ~printer:(fun s -> s) str (string_of_size ~fuzzy:fuzzy sz)) in [ "exact" >::: (List.map (test_of_vector false) [ "0 TB", TB 0L; "0 GB", GB 0L; "0 MB", MB 0L; "0 KB", KB 0L; "0 B", B 0L; "1 TB", TB 1L; "1 GB", GB 1L; "1 MB", MB 1L; "1 KB", KB 1L; "1 B", B 1L; "1025 TB", TB i64_unit; "1 TB 1 GB", GB i64_unit; "1 GB 1 MB", MB i64_unit; "1 MB 1 KB", KB i64_unit; "1 KB 1 B", B i64_unit; "1024 TB 1 GB", GB i64_unit2; "1 TB 1 MB", MB i64_unit2; "1 GB 1 KB", KB i64_unit2; "1 MB 1 B", B i64_unit2; "97 MB 728 KB 349 B", B 102457693L; ]); "fuzzy" >::: (List.map (test_of_vector true) [ "0.00 TB", TB 0L; "0.00 GB", GB 0L; "0.00 MB", MB 0L; "0.00 KB", KB 0L; "0.00 B", B 0L; "1.00 TB", TB 1L; "1.00 GB", GB 1L; "1.00 MB", MB 1L; "1.00 KB", KB 1L; "1.00 B", B 1L; "1025.00 TB", TB i64_unit; "1.00 TB", GB i64_unit; "1.00 GB", MB i64_unit; "1.00 MB", KB i64_unit; "1.00 KB", B i64_unit; "1024.00 TB", GB i64_unit2; "1.00 TB", MB i64_unit2; "1.00 GB", KB i64_unit2; "1.00 MB", B i64_unit2; "97.71 MB", B 102457693L; ]); ]); "size_add" >::: (let test_of_vector (str, szs) = test_case (fun _ -> assert_equal ~printer:(fun s -> s) str (string_of_size (List.fold_left size_add (B 0L) szs))) in List.map test_of_vector [ "1 TB 10 MB 12 KB", [TB 1L; KB 12L; MB 10L]; "2 MB 976 KB", [KB 2000L; MB 1L] ]); "size_compare" >::: ( let test_of_vector (sz1, sz2, res) = test_case (fun _ -> let cmp = size_compare sz1 sz2 in let norm i = if i < 0 then -1 else if i > 0 then 1 else 0 in assert_equal ~printer:string_of_int (norm res) cmp) in List.map test_of_vector [ TB 1L, TB 1L, 0; GB 1L, GB 1L, 0; MB 1L, MB 1L, 0; KB 1L, KB 1L, 0; B 1L, B 1L, 0; TB 1L, B 1L, 1; GB 1L, B 1L, 1; MB 1L, B 1L, 1; KB 1L, B 1L, 1; B 2L, B 1L, 1; ]); ]; ] let () = let _i: int = Unix.umask test_umask in run_test_tt_main ("ocaml-fileutils" >::: [ "FilePath" >::: [ test_unix; test_win32; test_macos; ]; test_fileutil; ]) ocaml-fileutils-0.5.3/website/000077500000000000000000000000001320170427200162505ustar00rootroot00000000000000ocaml-fileutils-0.5.3/website/Makefile000066400000000000000000000056401320170427200177150ustar00rootroot00000000000000############################################################################## # ocaml-fileutils: files and filenames common operations # # # # Copyright (C) 2003-2014, Sylvain Le Gall # # # # This library is free software; you can redistribute it and/or modify it # # under the terms of the GNU Lesser General Public License as published by # # the Free Software Foundation; either version 2.1 of the License, or (at # # your option) any later version, with the OCaml static compilation # # exception. # # # # This library is distributed in the hope that it will be useful, but # # WITHOUT ANY WARRANTY; without even the implied warranty of # # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the file # # COPYING for more details. # # # # You should have received a copy of the GNU Lesser General Public License # # along with this library; if not, write to the Free Software Foundation, # # Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA # ############################################################################## INKSCAPE=inkscape COMPOSITE=composite PANDOC=pandoc TAR=tar CURL=curl FAB=fab LINKCHECKER=linkchecker # Name of the product. NAME = ocaml-fileutils API_NAME = fileutils # Determine if we can scrape host. ONLINE := $(shell (ping -c 1 forge.ocamlcore.org > /dev/null 2>&1 && echo true) || echo false) # HTML page to scrape for data. FORGE_PAGE = "http://forge.ocamlcore.org/frs/?group_id=128" # Dev documetation link. DEV_DOC_URL = "file:///$(shell pwd)/dist/ocaml-fileutils-doc-dev.tar.gz" default: all include Makefile.scrape include website-tools/Makefile.common GENERATED_HTML=$(patsubst mkd/%.mkd,html/%.html,$(wildcard mkd/*.mkd)) GENERATED_HTML+= html/index.html GENERATED_IMG=html/logo.png all: $(GENERATED_HTML) $(GENERATED_IMG) extract-api-documentation .PHONY: all clean:: distclean -$(RM) $(GENERATED_HTML) $(GENERATED_IMG) mkd/documentation.mkd mkd/index.mkd -$(RM) Makefile.scrape distclean:: .PHONY: clean html/%.png: images/%.svg inkscape $(INKSCAPEFLAGS) -e $@ $< > /dev/null # # Checkout external modules. # # Get program from gildor478/website-tools to build everything. # GIT_WEBSITE_TOOLS=https://github.com/gildor478/website-tools.git checkout-website-tools: if ! test -d website-tools ; then git clone $(GIT_WEBSITE_TOOLS); fi cd website-tools && git pull website-tools/Makefile.common: checkout-website-tools .PHONY: checkout-website-tools test: all ocaml-fileutils-0.5.3/website/Makefile.scrape.tmpl000066400000000000000000000036461320170427200221500ustar00rootroot00000000000000############################################################################## # ocaml-fileutils: files and filenames common operations # # # # Copyright (C) 2003-2014, Sylvain Le Gall # # # # This library is free software; you can redistribute it and/or modify it # # under the terms of the GNU Lesser General Public License as published by # # the Free Software Foundation; either version 2.1 of the License, or (at # # your option) any later version, with the OCaml static compilation # # exception. # # # # This library is distributed in the hope that it will be useful, but # # WITHOUT ANY WARRANTY; without even the implied warranty of # # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the file # # COPYING for more details. # # # # You should have received a copy of the GNU Lesser General Public License # # along with this library; if not, write to the Free Software Foundation, # # Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA # ############################################################################## DOC_VERSIONS=dev ${ocaml_fileutils_doc.latest.version} cache/ocaml-fileutils-doc-${ocaml_fileutils_doc.latest.version}.tar.gz: URL = ${ocaml_fileutils_doc.latest.url} % for version in ocaml_fileutils_doc.others: DOC_VERSIONS+=${version.version} cache/ocaml-fileutils-doc-${version.version}.tar.gz: URL = ${version.url} % endfor LATEST_VERSION=${ocaml_fileutils.latest.version} ocaml-fileutils-0.5.3/website/fabfile.py000066400000000000000000000003231320170427200202100ustar00rootroot00000000000000 import sys sys.path.insert(0, "website-tools") import fabfilemeta website = fabfilemeta.GenericWebsite('/home/groups/ocaml-fileutils') def deploy(): website.deploy() def rollback(): website.rollback() ocaml-fileutils-0.5.3/website/html/000077500000000000000000000000001320170427200172145ustar00rootroot00000000000000ocaml-fileutils-0.5.3/website/html/caml.ico000066400000000000000000000062761320170427200206370ustar00rootroot00000000000000  ( @   NN::u33fKK::t33f33f33frr]]IIFF懇nncceeTT99r^^GG33f33f}}]]摑晙SS怀UUBBttgg戈pp桡cc撒eeeeffZZff敕kkEE}}__pp^^^^XXttGGwwhhooRR\\XXuuHHpp\\惃hhCC__TTffHH``__晙zzBB__]]NN``WWBB[[SS旗WW33f]]TTWWKK;;vRRYYNN椤၁LLAAPPZZNNZZZZPPDDIIVVTT暚iiXX\\XXEEbbddbb]]YY\\[[LL挌yyeebbVV==z^^ffffeeddee\\FFddjjggddZZFF66k55jFFZZddffffffff]]FFEENN[[ddffeebb\\TTQQWW``eeffffffff^^HHGGMMYYaaeeffffffffeeddddeeffffffffff__II88oSSUU^^ddffffffffffffffffffffffffffffffaaOO;;v````bbeeffffffffffffffffffffffffffffffggee^^RRMMjjhheeffffggffffffffffffffffffffffffffhhlljjeeyyppjjss}}Ԃ||qqhhffffffffffffffffffggiiffff悂wwyyҎ٤Ჲ嬬㒒ssggffffffffffffffffggdd__<s>gM-Ѳ,NuT:gJ[ ¥ - B+}rD%˔7+oaXgTE-um2*>?x \];Vnl4ox]s0EdZ' (o?cnrh~3ZPT)"~ p,ڝ?g?,~ѓ𷉙8`ff \#Ӆ r]lANֽVG_6\1#w]S-ʱqDWe!c&xW k*U23`K՚IP >7 Ht5{ uʉ7 c^A;{e~3:4[ `D,^./,7UZBI T){Quyu)ӣ> gf }Mogl ʘ "sG֪K孻jAyOУ߿i{x,m+w"De(8} {@3аd3ͬ X&it%&Ƴc<)n>D/  G**`+4 dUxE^r+ W`b -IENDB`ocaml-fileutils-0.5.3/website/images/000077500000000000000000000000001320170427200175155ustar00rootroot00000000000000ocaml-fileutils-0.5.3/website/images/logo.svg000066400000000000000000001411231320170427200212000ustar00rootroot00000000000000 image/svg+xml ocaml-fileutils-0.5.3/website/mkd/000077500000000000000000000000001320170427200170235ustar00rootroot00000000000000ocaml-fileutils-0.5.3/website/mkd/contribute.mkd000066400000000000000000000032041320170427200216750ustar00rootroot00000000000000%Contribute to the OCaml Fileutils project ##Bugs and feature requests We really appreciate to get your feedback. Use [bug reports][] or [features requests][], you need to sign-in forge.ocamlcore.org first. [bug reports]: https://forge.ocamlcore.org/tracker/?func=add&group_id=128&atid=589 [features requests]: https://forge.ocamlcore.org/tracker/?atid=592&group_id=128&func=add ##Get the source code The main page for development is the [project on forge.ocamlcore.org][]. You can browse the source code of the [project][]. [project on forge.ocamlcore.org]: http://forge.ocamlcore.org/projects/ocaml-fileutils [project]: http://darcs.ocamlcore.org/cgi-bin/darcsweb.cgi?r=ocaml-fileutils;a=summary To get a copy of the source tree, you must use darcs: $> darcs get http://darcs.ocamlcore.org/repos/ocaml-fileutils $> darcs get scm.ocamlcore.org:/darcsroot/ocaml-fileutils/ocaml-fileutils ocaml-fileutils # if you have write access Once you have the source code, you can pick a [bug][] or a [feature request][] to fix. [bug]: https://forge.ocamlcore.org/tracker/?func=browse&group_id=128&atid=589 [feature request]: https://forge.ocamlcore.org/tracker/?atid=592&group_id=128&func=browse You can send back patches with a [patch report][] [patch report]: https://forge.ocamlcore.org/tracker/?func=add&group_id=128&atid=591 To update the source code with the latest available version: $> darcs pull http://darcs.ocamlcore.org/repos/ocaml-fileutils $> darcs pull scm.ocamlcore.org:/darcsroot/ocaml-fileutils/ocaml-fileutils # if you have write access Further documentation about darcs on [darcs.net](http://darcs.net/manual/) ocaml-fileutils-0.5.3/website/mkd/index.mkd.tmpl000066400000000000000000000027411320170427200216060ustar00rootroot00000000000000${"% OCaml Fileutils "} ocaml-fileutils is a library of pure OCaml functions to manipulate real files and filenames. Features of the project: * pure OCaml * file functions inspired from GNU fileutils (aiming to be POSIX compatible) * cp: copy files and directories * mv: rename files and directories * rm: remove files and directories * test: check file types and compare values * find: find files that match certain criteria * mkdir: create directory and its parents * ls: list content of a directory * touch: change file timestamps * which: locate a command * readlink: resolve symlink * du: compute disk usage * stat: abstract of Unix.stat * cmp: compare files * chmod: change permissions of a file * filename functions support Win32/Unix/MacOS and Cygwin filenames: * Compare: is_subdir, is_updir, compare * Transform: make_absolute, make_relative, reduce * Extension: chop_extension, check_extension You can browse the online API documentation of the latest version. * [API for version ${ocaml_fileutils.latest.version}, the latest stable version](api-fileutils/index.html) % for version in ocaml_fileutils_doc.others: * [API for version ${version.version}](api-fileutils-${version.version}/index.html) % endfor * [API for the version under development](api-fileutils-dev/index.html) ocaml-fileutils-0.5.3/website/mkd/part-after-body.html000066400000000000000000000013231320170427200227100ustar00rootroot00000000000000 ocaml-fileutils-0.5.3/website/mkd/part-before-body.html000066400000000000000000000012671320170427200230600ustar00rootroot00000000000000
ocaml-fileutils-0.5.3/website/mkd/part-header.html000066400000000000000000000001021320170427200220760ustar00rootroot00000000000000