https://github.com/clj-commons/fs
File system utilities for Clojure. (forked from Raynes/fs)
https://github.com/clj-commons/fs
Last synced: 3 months ago
JSON representation
File system utilities for Clojure. (forked from Raynes/fs)
- Host: GitHub
- URL: https://github.com/clj-commons/fs
- Owner: clj-commons
- Created: 2018-12-02T21:53:12.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2024-02-26T18:09:55.000Z (over 1 year ago)
- Last Synced: 2024-05-08T19:08:48.790Z (about 1 year ago)
- Language: Clojure
- Size: 326 KB
- Stars: 72
- Watchers: 9
- Forks: 9
- Open Issues: 1
-
Metadata Files:
- Readme: README.markdown
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# fs - File system utilities for Clojure
[](https://clojars.org/clj-commons/fs)
[](https://cljdoc.org/d/clj-commons/fs)
[](https://circleci.com/gh/clj-commons/fs)
This library defines some utilities for working with the file system in Clojure. Mostly, it wants to fill the gap that
`clojure.java.io` leaves and add on (and prettify) what `java.io.File` provides.
This library is the continuation of Raynes/fs. Sadly Raynes passed away in 2016 so the clj-commons clojure organisation has taken over maintenance of this excellent library to keep it alive.
## Maintenance mode
This library is in maintenance mode. That means that it's no longer actively developed, but we still provide maintenance. If you're looking for an actively developed fs lib, please consider using [babashka/fs](https://github.com/babashka/fs)
## Usage
This library is simple. It is just a collection of functions that do things with the file system. The one thing
you should understand is `*cwd*`. This library wraps a lot of built-in Java file systemy things because it
pays attention to the `*cwd*` as the current working directory. Java has no way to change the cwd of a JVM so
if you want that behavior, you have to simulate it. This library tries to do that.
The foundation of the library is the `file` function. It is just like `clojure.java.io/file`, but it pays
attention to the value of `*cwd*`.
This is 100% a utility library. If you have something useful that it doesn't already have, open a pull request,
because I probably want it. Make sure you include tests. Also, make sure they pass.
fs is *not* an I/O utility library. We should try to keep things limited to file system activities.
## Artifacts
Library artifacts are [released to Clojars](https://clojars.org/clj-commons/fs). If you are using Maven, add the following repository
definition to your `pom.xml`:
``` xml
clojars.org
http://clojars.org/repo
```
### The Most Recent Release
With Leiningen:
[clj-commons/fs "1.6.307"]
With Maven:
clj-commons
fs
1.6.307
## License
Copyright (C) 2010-2013 Miki Tebeka, Anthony Grimes
Distributed under the Eclipse Public License, the same as Clojure.