Metadata-Version: 2.4
Name: silver-nitrate
Version: 1.6.2
Summary: Python utilities used by the Flickr Foundation
Author-email: Flickr Foundation <hello@flickr.org>
Maintainer-email: Alex Chan <alex@flickr.org>
Project-URL: Homepage, https://github.com/Flickr-Foundation/silver-nitrate
Project-URL: Changelog, https://github.com/Flickr-Foundation/silver-nitrate/blob/main/CHANGELOG.md
Keywords: flickr
Classifier: Development Status :: 5 - Production/Stable
Classifier: License :: OSI Approved :: Apache Software License
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE-APACHE
License-File: LICENSE-MIT
Provides-Extra: cassettes
Requires-Dist: pytest; extra == "cassettes"
Requires-Dist: pytest-vcr; extra == "cassettes"
Provides-Extra: comments
Requires-Dist: httpx; extra == "comments"
Requires-Dist: hyperlink; extra == "comments"
Provides-Extra: json
Provides-Extra: login
Requires-Dist: authlib; extra == "login"
Requires-Dist: httpx; extra == "login"
Requires-Dist: silver-nitrate[types]; extra == "login"
Provides-Extra: passwords
Requires-Dist: keyring; extra == "passwords"
Provides-Extra: types
Requires-Dist: pydantic; extra == "types"
Provides-Extra: xml
Dynamic: license-file

# silver-nitrate

This is a collection of Python utilities used by [the Flickr Foundation](https://www.flickr.org/).
It allows us to share certain functions and common code across all our projects.

Think of it as a souped-up version of `utils.py`.

This library is primarily for our use, but the code is fairly generic and may well be useful in other projects.
If you want to use it, copy/paste the code (and the associated tests!) into your own project rather than adding a dependency on this library.

<figure>
  <a href="https://www.flickr.com/photos/podsville/3912488857">
    <img src="https://live.staticflickr.com/3438/3912488857_78a5103b69_c_d.jpg">
  </a>
  <figcaption>
    <em>Builder's Photo of 2-8-0 Locomotive No 1402 "James Archbald," built in 1930 by the Delaware & Hudson Railroad.</em>
    Scan of a silver-halide photo print.
    Photo from Bill Harrison <a href="https://www.flickr.com/photos/podsville/3912488857">on Flickr</a>.
  </figcaption>
</figure>

## What's in a name?

I wanted to pick a name that was:

1.  More interesting than "utils"
2.  Had a connection to photography
3.  Wasn't taken on PyPI

Silver nitrate was a key chemical in the early days of photography, especially in the 19th and early 20th centuries.

Photographers would coat glass plates with a mixture of chemicals, including silver nitrate.
Because silver nitrate reacts when exposed to light, when you put the plate in a camera and open the shutter, different areas would react differently to create an image on the plate.
You could then develop this plate into a photograph.

This code is key to our work at the Flickr Foundation, so I thought it was a fitting name.

## Development

If you want to make changes to the library, there are instructions in [CONTRIBUTING.md](./CONTRIBUTING.md).

## License

This project is dual-licensed as Apache-2.0 and MIT.
