marcattacks 1.0.0

package/Dockerfile

@@ -0,0 +1,23 @@
+FROM node:20
+
+WORKDIR /app
+
+COPY package*.json ./
+
+RUN npm install
+
+FROM node:20-alpine3.20
+
+ENV NODE_ENV=production
+
+WORKDIR /app
+
+COPY package*.json ./
+
+COPY --from=0 /app/node_modules /app/node_modules
+
+COPY . .
+
+ENTRYPOINT [ "node","dist/index.js" ]
+
+CMD [ "--help"]

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 Patrick Hochstenbach
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README-docker.md

@@ -0,0 +1,39 @@
+# Docker
+
+## Build marcattacks
+
+Build a version of a docker image:
+
+```
+docker build . -t hochstenbach/marcattacks:v0.0.1
+```
+
+Run a docker image:
+
+```
+docker run --rm -v `pwd`/data:/app/data -it hochstenbach/marcattacks:v0.0.1 --rdf data/sample.xml
+```
+
+Push it to DockerHub:
+
+```
+docker push hochstenbach/marcattacks:v0.0.1
+```
+
+### S3 development
+
+Start S3 service:
+
+```
+docker compose up -d
+```
+
+Stop everything:
+
+```
+docker compose down
+```
+
+Connect to the admin interface: http://localhost:3372/login
+
+Username/password: minioadmin/minioadmin

package/README.md

@@ -0,0 +1,111 @@
+# marcattacks!
+
+<img src="logo.jpg" width="10%">
+
+Turn your MARC exports into something else.
+
+
+## Build
+
+```
+npm install
+```
+
+```
+npm run build:ts
+```
+
+```
+npm link
+```
+
+### Run
+
+Generate JSON:
+
+```
+marcattacks --to json <file>
+```
+
+Generate Aleph sequential:
+
+```
+marcattacks --to alephseq <file>
+```
+
+Generate RDF:
+
+```
+marcattacks --to rdf --map rdf <file>
+```
+
+Generate XML:
+
+```
+marcattacks --to xml <file>
+```
+
+Transform the MARC input using a [JSONata](https://docs.jsonata.org/overview.html) expression or file:
+
+```
+marcattacks <file> --fix ./demo/demo.jsonata
+```
+
+## Remote files
+
+A remote SFTP path:
+
+```
+marcattacks --key ~/.ssh/privatekey sftp://username@hostname:port/remote/path
+```
+
+The latest XML file in a remote SFTP:
+
+```
+marcattacks --key ~/.ssh/privatekey sftp://username@hostname:port/remote/path/@latest:xml
+```
+
+An HTTP path
+
+```
+marcattacks http://somewhere.org/data.xml
+```
+
+An S3 path
+
+```
+marcattacks s3://accessKey:secretKey@host:port/bucket/key
+```
+
+use `s3s://...` for using a SSL layer.
+
+## Formats
+
+### Input (--from)
+
+- xml
+- alephseq (Aleph sequential)
+- json
+- jsonl
+
+### Output (--to)
+
+- xml
+- alephseq (Aleph sequential)
+- json
+- jsonl
+- rdf
+
+### Transform (--map)
+
+- rdf
+
+Provide your own transformers using JavaScript plugins. See: ./plugin/demo.js for an example.
+
+### Writable (--out)
+
+- _default_: stdout
+- _file path_
+- sftp://username@host:port/path
+- s3://accessKey:secretKey@host:port/bucket/key (or s3s://)
+ 

package/TYPESCRIPT.txt

@@ -0,0 +1,6 @@
+npm init -y && npm i -D typescript ts-node eslint prettier @types/node && npx tsc --init
+
+tsconfig.json:
+    - uncomment rootDir, outDir
+
+npx tsc